add: ver()

Signed-off-by: Kenneth Obsequio <k80308392@gmail.com>
2026-09-27 00:12:54 +08:00 · 2026-07-08 11:31:54 +08:00
parent 6624c0d27f
commit 182bd93d10
46 changed files with 4407 additions and 98 deletions
@@ -26,6 +26,15 @@ export default function CourseList() {
              <Link to="/admin/tiers/plans" className="text-primary hover:underline font-medium">
                Manage Tier Plans
              </Link>
+              {" "}· Units and Lessons now run independently — build them once in the{" "}
+              <Link to="/admin/units" className="text-primary hover:underline font-medium">
+                Units Library
+              </Link>
+              {" "}and{" "}
+              <Link to="/admin/lessons" className="text-primary hover:underline font-medium">
+                Lessons Library
+              </Link>
+              , then attach them to any course.
            </p>
          </div>
          <CoursesTable />
@@ -11,6 +11,11 @@ import { PreviewContent, PreviewChrome } from "../../../components/courses/Lesso
 export default function ViewLessonPage() {
  const navigate = useNavigate();
  const { courseId, unitId, lessonId } = useParams();
+
+  // Junction revamp — runs course-scoped AND from the standalone Lesson Library.
+  const builderPath = unitId
+    ? `/admin/courses/${courseId}/units/${unitId}/lessons/${lessonId}/page`
+    : `/admin/lessons/${lessonId}/page`;
  const { fetchLesson, lesson, lessonPage } = useCourses();
  const [initializing, setInitializing] = useState(true);

@@ -43,7 +48,7 @@ export default function ViewLessonPage() {
            </div>
            <Button
              type="button"
-              onClick={() => navigate(`/admin/courses/${courseId}/units/${unitId}/lessons/${lessonId}/page`)}
+              onClick={() => navigate(builderPath)}
            >
              Edit Page
            </Button>
@@ -73,7 +78,7 @@ export default function ViewLessonPage() {
                        type="button"
                        variant="outline"
                        size="sm"
-                        onClick={() => navigate(`/admin/courses/${courseId}/units/${unitId}/lessons/${lessonId}/page`)}
+                        onClick={() => navigate(builderPath)}
                      >
                        Go to Page Builder
                      </Button>
@@ -223,19 +223,32 @@ export default function ModifyQuiz() {
  const headerRef        = useRef(null);
  const initialSnapshot  = useRef(null);

-  const breadcrumbItems = [
-    { label: "Home", icon: <House className="size-4" />, to: "/admin" },
-    { label: "Courses", to: "/admin/courses" },
-    { label: course?.title ?? "…", to: `/admin/courses/${courseId}` },
-    { label: unit?.title ?? "…", to: `/admin/courses/${courseId}/units/${unitId}` },
-    { label: "Quiz" },
-  ];
+  // Junction revamp — this builder runs course-scoped AND from the standalone
+  // Unit Library (/admin/units/:unitId/quiz/edit, no :courseId param).
+  const scopeBase = courseId
+    ? `/admin/courses/${courseId}/units/${unitId}`
+    : `/admin/units/${unitId}`;
+
+  const breadcrumbItems = courseId
+    ? [
+        { label: "Home", icon: <House className="size-4" />, to: "/admin" },
+        { label: "Courses", to: "/admin/courses" },
+        { label: course?.title ?? "…", to: `/admin/courses/${courseId}` },
+        { label: unit?.title ?? "…", to: `/admin/courses/${courseId}/units/${unitId}` },
+        { label: "Quiz" },
+      ]
+    : [
+        { label: "Home", icon: <House className="size-4" />, to: "/admin" },
+        { label: "Units Library", to: "/admin/units" },
+        { label: unit?.title ?? "…", to: `/admin/units/${unitId}/view` },
+        { label: "Quiz" },
+      ];

  // ── Fetch — silently treat 404 as "no quiz yet" (create mode) ─────────────
  useEffect(() => {
    (async () => {
      try {
-        const { data } = await api.get(`/admin/courses/${courseId}/units/${unitId}/quiz`);
+        const { data } = await api.get(`${scopeBase}/quiz`);
        const result = data?.data?.data ?? null;
        setLocalQuiz(result);
      } catch (err) {
@@ -245,6 +245,11 @@ export default function ViewUnitQuiz() {
  const navigate = useNavigate();
  const { courseId, unitId } = useParams();

+  // Junction revamp — runs course-scoped AND from the standalone Unit Library.
+  const scopeBase = courseId
+    ? `/admin/courses/${courseId}/units/${unitId}`
+    : `/admin/units/${unitId}`;
+
  const {
    fetchQuiz, quiz,
    fetchQuizCompletions, completions,
@@ -293,7 +298,7 @@ export default function ViewUnitQuiz() {
            <Button
              variant="outline"
              size="sm"
-              onClick={() => navigate(`/admin/courses/${courseId}/units/${unitId}/quiz/edit`)}
+              onClick={() => navigate(`${scopeBase}/quiz/edit`)}
            >
              <NotebookPen className="h-4 w-4 mr-2" />
              Modify Quiz
@@ -330,7 +335,7 @@ export default function ViewUnitQuiz() {
            <div className="rounded-lg border border-dashed bg-card p-12 flex flex-col items-center gap-3 text-center">
              <HelpCircle className="h-8 w-8 text-muted-foreground/40" />
              <p className="text-sm text-muted-foreground">No quiz has been created for this unit yet.</p>
-              <Button size="sm" variant="outline" onClick={() => navigate(`/admin/courses/${courseId}/units/${unitId}/quiz/edit`)}>
+              <Button size="sm" variant="outline" onClick={() => navigate(`${scopeBase}/quiz/edit`)}>
                <NotebookPen className="h-4 w-4 mr-2" />
                Create Quiz
              </Button>
@@ -0,0 +1,100 @@
+import { useNavigate, useSearchParams } from "react-router-dom";
+import { useForm } from "react-hook-form";
+import { z } from "zod";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { ArrowLeft } from "lucide-react";
+
+import { useLibrary } from "@/contexts/AdminLibraryContext";
+import { useAuth } from "@/contexts/AuthContext";
+import { PageMeta } from "@/contexts/MetadataContext";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import { Spinner } from "@/components/ui/spinner";
+
+const schema = z.object({
+  title: z.string().min(1, "Title is required."),
+  description: z.string().optional(),
+});
+
+function FieldError({ message }) {
+  if (!message) return null;
+  return <p className="text-xs text-destructive mt-1">{message}</p>;
+}
+
+export default function AddLibraryLesson() {
+  const navigate = useNavigate();
+  const [searchParams] = useSearchParams();
+  const { createLesson, loading } = useLibrary();
+  const { user } = useAuth();
+
+  // ?unit_id=… → create-and-attach in one call (from the unit lessons manager)
+  const attachUnitId = searchParams.get("unit_id");
+
+  const { register, handleSubmit, formState: { errors } } = useForm({
+    resolver: zodResolver(schema),
+    defaultValues: { title: "", description: "" },
+  });
+
+  const onSubmit = async (data) => {
+    const result = await createLesson({
+      ...data,
+      ...(attachUnitId ? { unit_id: attachUnitId } : {}),
+      createdBy: user?.user_id,
+    });
+    if (!result) return;
+    navigate(attachUnitId ? `/admin/units/${attachUnitId}/view` : "/admin/lessons");
+  };
+
+  return (
+    <section className="bg-muted h-full">
+      <PageMeta title="Add Lesson - STARR" />
+      <div className="lg:container lg:mx-auto lg:px-0 flex flex-col items-center px-4 py-10">
+
+        <div className="w-full max-w-2xl mx-auto">
+          <div className="flex items-center gap-3 mb-6">
+            <Button type="button" variant="ghost" size="icon" onClick={() => navigate(-1)}>
+              <ArrowLeft className="h-4 w-4" />
+            </Button>
+            <div>
+              <h1 className="text-xl font-semibold">Create Lesson</h1>
+              <p className="text-sm text-muted-foreground">
+                {attachUnitId
+                  ? "This lesson will be created and attached to the unit you came from."
+                  : "Lessons are standalone — attach this one to any unit later, or run it on its own."}
+              </p>
+            </div>
+          </div>
+
+          <form onSubmit={handleSubmit(onSubmit)} className="space-y-6">
+            <div className="rounded-lg border bg-card p-6 space-y-5">
+
+              <div className="space-y-1.5">
+                <Label htmlFor="title">Title <span className="text-destructive">*</span></Label>
+                <Input id="title" placeholder="Lesson title" {...register("title")} />
+                <FieldError message={errors.title?.message} />
+              </div>
+
+              <div className="space-y-1.5">
+                <Label htmlFor="description">Description</Label>
+                <Textarea id="description" placeholder="Optional description" rows={3} {...register("description")} />
+              </div>
+
+            </div>
+
+            <div className="flex justify-end gap-3">
+              <Button type="button" variant="outline" onClick={() => navigate(-1)} disabled={loading}>
+                Cancel
+              </Button>
+              <Button type="submit" disabled={loading}>
+                {loading && <Spinner className="h-4 w-4 mr-2" />}
+                Create Lesson
+              </Button>
+            </div>
+          </form>
+        </div>
+      </div>
+    </section>
+  );
+}
@@ -0,0 +1,26 @@
+import { House } from "lucide-react";
+import AppBreadcrumb from "@/components/generic/Breadcrumb/AppBreadcrumb";
+import ArchivedLessonLibraryTable from "../../../components/library/ArchivedLessonLibraryTable";
+import { PageMeta } from "@/contexts/MetadataContext";
+
+export default function ArchivedLessonLibraryList() {
+  const items = [
+    { label: "Home", icon: <House className="size-4" />, to: "/admin" },
+    { label: "Lessons", to: "/admin/lessons" },
+    { label: "Archived" },
+  ];
+
+  return (
+    <section className="bg-muted h-full">
+      <PageMeta title="Archived Lessons - STARR" />
+      <div className="lg:container lg:mx-auto lg:px-0 flex flex-col items-start px-4">
+        <div className="flex flex-col gap-2 my-6">
+          <AppBreadcrumb items={items} />
+        </div>
+        <div className="w-full">
+          <ArchivedLessonLibraryTable />
+        </div>
+      </div>
+    </section>
+  );
+}
@@ -0,0 +1,102 @@
+import { useEffect } from "react";
+import { useNavigate, useParams } from "react-router-dom";
+import { useForm } from "react-hook-form";
+import { z } from "zod";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { ArrowLeft } from "lucide-react";
+
+import { useLibrary } from "@/contexts/AdminLibraryContext";
+import { useAuth } from "@/contexts/AuthContext";
+import { PageMeta } from "@/contexts/MetadataContext";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import { Spinner } from "@/components/ui/spinner";
+
+const schema = z.object({
+  title: z.string().min(1, "Title is required."),
+  description: z.string().optional(),
+});
+
+function FieldError({ message }) {
+  if (!message) return null;
+  return <p className="text-xs text-destructive mt-1">{message}</p>;
+}
+
+export default function EditLibraryLesson() {
+  const navigate = useNavigate();
+  const { lessonId } = useParams();
+  const { fetchLesson, updateLesson, lesson, loading } = useLibrary();
+  const { user } = useAuth();
+
+  const { register, handleSubmit, reset, formState: { errors } } = useForm({
+    resolver: zodResolver(schema),
+    defaultValues: { title: "", description: "" },
+  });
+
+  useEffect(() => {
+    fetchLesson(lessonId);
+  }, [lessonId]);
+
+  useEffect(() => {
+    if (lesson && String(lesson.lesson_id) === String(lessonId)) {
+      reset({ title: lesson.title ?? "", description: lesson.description ?? "" });
+    }
+  }, [lesson, lessonId, reset]);
+
+  const onSubmit = async (data) => {
+    const result = await updateLesson(lessonId, { ...data, updatedBy: user?.user_id });
+    if (!result) return;
+    navigate(`/admin/lessons/${lessonId}/view`);
+  };
+
+  return (
+    <section className="bg-muted h-full">
+      <PageMeta title={lesson ? `Edit Lesson – ${lesson.title} - STARR` : undefined} />
+      <div className="lg:container lg:mx-auto lg:px-0 flex flex-col items-center px-4 py-10">
+
+        <div className="w-full max-w-2xl mx-auto">
+          <div className="flex items-center gap-3 mb-6">
+            <Button type="button" variant="ghost" size="icon" onClick={() => navigate(-1)}>
+              <ArrowLeft className="h-4 w-4" />
+            </Button>
+            <div>
+              <h1 className="text-xl font-semibold">Edit Lesson</h1>
+              <p className="text-sm text-muted-foreground">
+                Changes apply everywhere this lesson is attached.
+              </p>
+            </div>
+          </div>
+
+          <form onSubmit={handleSubmit(onSubmit)} className="space-y-6">
+            <div className="rounded-lg border bg-card p-6 space-y-5">
+
+              <div className="space-y-1.5">
+                <Label htmlFor="title">Title <span className="text-destructive">*</span></Label>
+                <Input id="title" placeholder="Lesson title" {...register("title")} />
+                <FieldError message={errors.title?.message} />
+              </div>
+
+              <div className="space-y-1.5">
+                <Label htmlFor="description">Description</Label>
+                <Textarea id="description" placeholder="Optional description" rows={3} {...register("description")} />
+              </div>
+
+            </div>
+
+            <div className="flex justify-end gap-3">
+              <Button type="button" variant="outline" onClick={() => navigate(-1)} disabled={loading}>
+                Cancel
+              </Button>
+              <Button type="submit" disabled={loading}>
+                {loading && <Spinner className="h-4 w-4 mr-2" />}
+                Save Changes
+              </Button>
+            </div>
+          </form>
+        </div>
+      </div>
+    </section>
+  );
+}
@@ -0,0 +1,37 @@
+import { House, Layers } from "lucide-react";
+import { Link } from "react-router-dom";
+import AppBreadcrumb from "@/components/generic/Breadcrumb/AppBreadcrumb";
+import LessonLibraryTable from "../../../components/library/LessonLibraryTable";
+import { PageMeta } from "@/contexts/MetadataContext";
+
+export default function LessonLibraryList() {
+  const items = [
+    { label: "Home", icon: <House className="size-4" />, to: "/admin" },
+    { label: "Lessons" },
+  ];
+
+  return (
+    <section className="bg-muted h-full">
+      <PageMeta title="Lessons Library - STARR" description="Manage standalone lessons — attach them to any unit." />
+      <div className="lg:container lg:mx-auto lg:px-0 flex flex-col items-start px-4">
+        <div className="flex flex-col gap-2 my-6">
+          <AppBreadcrumb items={items} />
+        </div>
+        <div className="w-full space-y-4">
+          <div className="flex items-start gap-3 rounded-lg border bg-card p-4 text-sm">
+            <Layers className="h-4 w-4 mt-0.5 shrink-0 text-muted-foreground" />
+            <p className="text-muted-foreground">
+              Lessons run <span className="font-medium text-foreground">independently</span> — build content here once,
+              then attach it to any number of{" "}
+              <Link to="/admin/units" className="text-primary hover:underline font-medium">
+                Units
+              </Link>
+              . Removing a lesson from a unit only detaches it; the lesson stays in this library.
+            </p>
+          </div>
+          <LessonLibraryTable />
+        </div>
+      </div>
+    </section>
+  );
+}
@@ -0,0 +1,134 @@
+import { useEffect, useState } from "react";
+import { useNavigate, useParams, Link } from "react-router-dom";
+import {
+  House, Pencil, LayoutTemplate, FileText, Clock, BookCheck,
+} from "lucide-react";
+
+import { useLibrary } from "@/contexts/AdminLibraryContext";
+import { PageMeta } from "@/contexts/MetadataContext";
+import AppBreadcrumb from "@/components/generic/Breadcrumb/AppBreadcrumb";
+import { Button } from "@/components/ui/button";
+import { Badge } from "@/components/ui/badge";
+import { Spinner } from "@/components/ui/spinner";
+import { formatDuration } from "@/utils/timestamp.util";
+
+export default function ViewLibraryLesson() {
+  const navigate = useNavigate();
+  const { lessonId } = useParams();
+  const { fetchLesson, lesson, loading } = useLibrary();
+  const [initializing, setInitializing] = useState(true);
+
+  useEffect(() => {
+    (async () => {
+      await fetchLesson(lessonId);
+      setInitializing(false);
+    })();
+  }, [lessonId]);
+
+  const items = [
+    { label: "Home", icon: <House className="size-4" />, to: "/admin" },
+    { label: "Lessons", to: "/admin/lessons" },
+    { label: lesson?.title ?? "..." },
+  ];
+
+  const units = lesson?.units ?? [];
+  const blocks = lesson?.page?.blocks ?? [];
+  const objectives = lesson?.objectives ?? [];
+
+  if (initializing) {
+    return (
+      <div className="flex items-center justify-center h-64">
+        <Spinner className="h-6 w-6" />
+      </div>
+    );
+  }
+
+  return (
+    <section className="bg-muted h-full">
+      <PageMeta title={lesson ? `${lesson.title} - Lessons - STARR` : undefined} />
+      <div className="lg:container lg:mx-auto lg:px-0 flex flex-col items-start px-4">
+        <div className="flex flex-col gap-2 my-6">
+          <AppBreadcrumb items={items} />
+        </div>
+
+        <div className="w-full space-y-6 pb-10">
+
+          {/* ── Lesson header ── */}
+          <div className="bg-card rounded-xl border p-6 space-y-4">
+            <div className="flex items-start justify-between gap-4">
+              <div>
+                <h6 className="text-xs tracking-widest mb-1">STANDALONE LESSON</h6>
+                <h1 className="text-xl font-semibold">{lesson?.title}</h1>
+                {lesson?.description && (
+                  <p className="text-sm text-muted-foreground mt-0.5">{lesson.description}</p>
+                )}
+              </div>
+              <div className="flex gap-2 shrink-0">
+                <Button size="sm" variant="outline" onClick={() => navigate(`/admin/lessons/${lessonId}/edit`)}>
+                  <Pencil className="h-3.5 w-3.5 mr-1.5" /> Edit
+                </Button>
+                <Button size="sm" variant="outline" onClick={() => navigate(`/admin/lessons/${lessonId}/page/view`)}>
+                  <FileText className="h-3.5 w-3.5 mr-1.5" /> View Page
+                </Button>
+                <Button size="sm" onClick={() => navigate(`/admin/lessons/${lessonId}/page`)}>
+                  <LayoutTemplate className="h-3.5 w-3.5 mr-1.5" /> Page Builder
+                </Button>
+              </div>
+            </div>
+
+            {/* Stats row */}
+            <div className="grid grid-cols-2 lg:grid-cols-4 gap-3">
+              <div className="bg-muted/60 rounded-lg p-3 space-y-1">
+                <p className="text-xs text-muted-foreground uppercase tracking-wide font-medium">Blocks</p>
+                <p className="font-semibold text-sm">{blocks.length}</p>
+              </div>
+              <div className="bg-muted/60 rounded-lg p-3 space-y-1">
+                <p className="text-xs text-muted-foreground uppercase tracking-wide font-medium">Duration</p>
+                <p className="font-semibold text-sm flex items-center gap-1">
+                  <Clock className="h-3.5 w-3.5 text-muted-foreground" />
+                  {formatDuration(lesson?.duration_seconds ?? 0)}
+                </p>
+              </div>
+              <div className="bg-muted/60 rounded-lg p-3 space-y-1">
+                <p className="text-xs text-muted-foreground uppercase tracking-wide font-medium">Objectives</p>
+                <p className="font-semibold text-sm">{objectives.length}</p>
+              </div>
+              <div className="bg-muted/60 rounded-lg p-3 space-y-1">
+                <p className="text-xs text-muted-foreground uppercase tracking-wide font-medium">Used In</p>
+                <p className="font-semibold text-sm">
+                  {units.length > 0 ? `${units.length} unit${units.length === 1 ? "" : "s"}` : "Standalone"}
+                </p>
+              </div>
+            </div>
+
+            {/* Attached units */}
+            {units.length > 0 && (
+              <div className="flex flex-wrap items-center gap-2 pt-1">
+                <span className="text-xs text-muted-foreground uppercase tracking-wide font-medium">Units:</span>
+                {units.map((u) => (
+                  <Link key={u.unit_id} to={`/admin/units/${u.unit_id}/view`}>
+                    <Badge variant="secondary" className="hover:bg-muted cursor-pointer">
+                      <BookCheck className="h-3 w-3 mr-1" /> {u.title}
+                    </Badge>
+                  </Link>
+                ))}
+              </div>
+            )}
+          </div>
+
+          {/* ── Objectives ── */}
+          {objectives.length > 0 && (
+            <div className="bg-card rounded-xl border p-6 space-y-3">
+              <h2 className="font-semibold">Objectives</h2>
+              <ul className="list-disc list-inside space-y-1 text-sm text-muted-foreground">
+                {[...objectives]
+                  .sort((a, b) => (a.order_index ?? 0) - (b.order_index ?? 0))
+                  .map((o) => <li key={o.objective_id}>{o.text}</li>)}
+              </ul>
+            </div>
+          )}
+        </div>
+      </div>
+    </section>
+  );
+}
@@ -0,0 +1,90 @@
+import { useNavigate } from "react-router-dom";
+import { useForm } from "react-hook-form";
+import { z } from "zod";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { ArrowLeft } from "lucide-react";
+
+import { useLibrary } from "@/contexts/AdminLibraryContext";
+import { useAuth } from "@/contexts/AuthContext";
+import { PageMeta } from "@/contexts/MetadataContext";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import { Spinner } from "@/components/ui/spinner";
+
+const schema = z.object({
+  title: z.string().min(1, "Title is required."),
+  description: z.string().optional(),
+});
+
+function FieldError({ message }) {
+  if (!message) return null;
+  return <p className="text-xs text-destructive mt-1">{message}</p>;
+}
+
+export default function AddLibraryUnit() {
+  const navigate = useNavigate();
+  const { createUnit, loading } = useLibrary();
+  const { user } = useAuth();
+
+  const { register, handleSubmit, formState: { errors } } = useForm({
+    resolver: zodResolver(schema),
+    defaultValues: { title: "", description: "" },
+  });
+
+  const onSubmit = async (data) => {
+    const result = await createUnit({ ...data, createdBy: user?.user_id });
+    if (!result) return;
+    navigate("/admin/units");
+  };
+
+  return (
+    <section className="bg-muted h-full">
+      <PageMeta title="Add Unit - STARR" />
+      <div className="lg:container lg:mx-auto lg:px-0 flex flex-col items-center px-4 py-10">
+
+        <div className="w-full max-w-2xl mx-auto">
+          <div className="flex items-center gap-3 mb-6">
+            <Button type="button" variant="ghost" size="icon" onClick={() => navigate(-1)}>
+              <ArrowLeft className="h-4 w-4" />
+            </Button>
+            <div>
+              <h1 className="text-xl font-semibold">Create Unit</h1>
+              <p className="text-sm text-muted-foreground">
+                Units are standalone — attach this one to any course later, or run it on its own.
+              </p>
+            </div>
+          </div>
+
+          <form onSubmit={handleSubmit(onSubmit)} className="space-y-6">
+            <div className="rounded-lg border bg-card p-6 space-y-5">
+
+              <div className="space-y-1.5">
+                <Label htmlFor="title">Title <span className="text-destructive">*</span></Label>
+                <Input id="title" placeholder="Unit title" {...register("title")} />
+                <FieldError message={errors.title?.message} />
+              </div>
+
+              <div className="space-y-1.5">
+                <Label htmlFor="description">Description</Label>
+                <Textarea id="description" placeholder="Optional description" rows={3} {...register("description")} />
+              </div>
+
+            </div>
+
+            <div className="flex justify-end gap-3">
+              <Button type="button" variant="outline" onClick={() => navigate(-1)} disabled={loading}>
+                Cancel
+              </Button>
+              <Button type="submit" disabled={loading}>
+                {loading && <Spinner className="h-4 w-4 mr-2" />}
+                Create Unit
+              </Button>
+            </div>
+          </form>
+        </div>
+      </div>
+    </section>
+  );
+}
@@ -0,0 +1,26 @@
+import { House } from "lucide-react";
+import AppBreadcrumb from "@/components/generic/Breadcrumb/AppBreadcrumb";
+import ArchivedUnitLibraryTable from "../../../components/library/ArchivedUnitLibraryTable";
+import { PageMeta } from "@/contexts/MetadataContext";
+
+export default function ArchivedUnitLibraryList() {
+  const items = [
+    { label: "Home", icon: <House className="size-4" />, to: "/admin" },
+    { label: "Units", to: "/admin/units" },
+    { label: "Archived" },
+  ];
+
+  return (
+    <section className="bg-muted h-full">
+      <PageMeta title="Archived Units - STARR" />
+      <div className="lg:container lg:mx-auto lg:px-0 flex flex-col items-start px-4">
+        <div className="flex flex-col gap-2 my-6">
+          <AppBreadcrumb items={items} />
+        </div>
+        <div className="w-full">
+          <ArchivedUnitLibraryTable />
+        </div>
+      </div>
+    </section>
+  );
+}
@@ -0,0 +1,102 @@
+import { useEffect } from "react";
+import { useNavigate, useParams } from "react-router-dom";
+import { useForm } from "react-hook-form";
+import { z } from "zod";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { ArrowLeft } from "lucide-react";
+
+import { useLibrary } from "@/contexts/AdminLibraryContext";
+import { useAuth } from "@/contexts/AuthContext";
+import { PageMeta } from "@/contexts/MetadataContext";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import { Spinner } from "@/components/ui/spinner";
+
+const schema = z.object({
+  title: z.string().min(1, "Title is required."),
+  description: z.string().optional(),
+});
+
+function FieldError({ message }) {
+  if (!message) return null;
+  return <p className="text-xs text-destructive mt-1">{message}</p>;
+}
+
+export default function EditLibraryUnit() {
+  const navigate = useNavigate();
+  const { unitId } = useParams();
+  const { fetchUnit, updateUnit, unit, loading } = useLibrary();
+  const { user } = useAuth();
+
+  const { register, handleSubmit, reset, formState: { errors } } = useForm({
+    resolver: zodResolver(schema),
+    defaultValues: { title: "", description: "" },
+  });
+
+  useEffect(() => {
+    fetchUnit(unitId);
+  }, [unitId]);
+
+  useEffect(() => {
+    if (unit && String(unit.unit_id) === String(unitId)) {
+      reset({ title: unit.title ?? "", description: unit.description ?? "" });
+    }
+  }, [unit, unitId, reset]);
+
+  const onSubmit = async (data) => {
+    const result = await updateUnit(unitId, { ...data, updatedBy: user?.user_id });
+    if (!result) return;
+    navigate(`/admin/units/${unitId}/view`);
+  };
+
+  return (
+    <section className="bg-muted h-full">
+      <PageMeta title={unit ? `Edit Unit – ${unit.title} - STARR` : undefined} />
+      <div className="lg:container lg:mx-auto lg:px-0 flex flex-col items-center px-4 py-10">
+
+        <div className="w-full max-w-2xl mx-auto">
+          <div className="flex items-center gap-3 mb-6">
+            <Button type="button" variant="ghost" size="icon" onClick={() => navigate(-1)}>
+              <ArrowLeft className="h-4 w-4" />
+            </Button>
+            <div>
+              <h1 className="text-xl font-semibold">Edit Unit</h1>
+              <p className="text-sm text-muted-foreground">
+                Changes apply everywhere this unit is attached.
+              </p>
+            </div>
+          </div>
+
+          <form onSubmit={handleSubmit(onSubmit)} className="space-y-6">
+            <div className="rounded-lg border bg-card p-6 space-y-5">
+
+              <div className="space-y-1.5">
+                <Label htmlFor="title">Title <span className="text-destructive">*</span></Label>
+                <Input id="title" placeholder="Unit title" {...register("title")} />
+                <FieldError message={errors.title?.message} />
+              </div>
+
+              <div className="space-y-1.5">
+                <Label htmlFor="description">Description</Label>
+                <Textarea id="description" placeholder="Optional description" rows={3} {...register("description")} />
+              </div>
+
+            </div>
+
+            <div className="flex justify-end gap-3">
+              <Button type="button" variant="outline" onClick={() => navigate(-1)} disabled={loading}>
+                Cancel
+              </Button>
+              <Button type="submit" disabled={loading}>
+                {loading && <Spinner className="h-4 w-4 mr-2" />}
+                Save Changes
+              </Button>
+            </div>
+          </form>
+        </div>
+      </div>
+    </section>
+  );
+}
@@ -0,0 +1,37 @@
+import { House, Layers } from "lucide-react";
+import { Link } from "react-router-dom";
+import AppBreadcrumb from "@/components/generic/Breadcrumb/AppBreadcrumb";
+import UnitLibraryTable from "../../../components/library/UnitLibraryTable";
+import { PageMeta } from "@/contexts/MetadataContext";
+
+export default function UnitLibraryList() {
+  const items = [
+    { label: "Home", icon: <House className="size-4" />, to: "/admin" },
+    { label: "Units" },
+  ];
+
+  return (
+    <section className="bg-muted h-full">
+      <PageMeta title="Units Library - STARR" description="Manage standalone units — attach them to any course." />
+      <div className="lg:container lg:mx-auto lg:px-0 flex flex-col items-start px-4">
+        <div className="flex flex-col gap-2 my-6">
+          <AppBreadcrumb items={items} />
+        </div>
+        <div className="w-full space-y-4">
+          <div className="flex items-start gap-3 rounded-lg border bg-card p-4 text-sm">
+            <Layers className="h-4 w-4 mt-0.5 shrink-0 text-muted-foreground" />
+            <p className="text-muted-foreground">
+              Units run <span className="font-medium text-foreground">independently</span> — build them here once,
+              then attach them to any number of{" "}
+              <Link to="/admin/courses" className="text-primary hover:underline font-medium">
+                Courses
+              </Link>
+              . Removing a unit from a course only detaches it; the unit stays in this library.
+            </p>
+          </div>
+          <UnitLibraryTable />
+        </div>
+      </div>
+    </section>
+  );
+}
@@ -0,0 +1,237 @@
+import { useEffect, useState } from "react";
+import { useNavigate, useParams, Link } from "react-router-dom";
+import {
+  ArrowLeft, House, Plus, Link2, Unlink, Pencil,
+  ChevronUp, ChevronDown, Clock, ClipboardList, PlusCircle,
+  LayoutTemplate, BookOpen,
+} from "lucide-react";
+
+import { useLibrary } from "@/contexts/AdminLibraryContext";
+import { PageMeta } from "@/contexts/MetadataContext";
+import AppBreadcrumb from "@/components/generic/Breadcrumb/AppBreadcrumb";
+import AttachLessonsDialog from "../../../components/library/AttachLessonsDialog";
+import { Button } from "@/components/ui/button";
+import { Badge } from "@/components/ui/badge";
+import { Spinner } from "@/components/ui/spinner";
+import { formatDuration } from "@/utils/timestamp.util";
+
+export default function ViewLibraryUnit() {
+  const navigate = useNavigate();
+  const { unitId } = useParams();
+  const {
+    fetchUnit, unit, loading,
+    attachLessonsToUnit, detachLessonFromUnit, reorderUnitLessons,
+  } = useLibrary();
+
+  const [initializing, setInitializing] = useState(true);
+  const [attachOpen, setAttachOpen] = useState(false);
+
+  useEffect(() => {
+    (async () => {
+      await fetchUnit(unitId);
+      setInitializing(false);
+    })();
+  }, [unitId]);
+
+  const items = [
+    { label: "Home", icon: <House className="size-4" />, to: "/admin" },
+    { label: "Units", to: "/admin/units" },
+    { label: unit?.title ?? "..." },
+  ];
+
+  const lessons = unit?.lessons ?? [];
+  const courses = unit?.courses ?? [];
+
+  const moveLesson = async (index, direction) => {
+    const target = index + direction;
+    if (target < 0 || target >= lessons.length) return;
+    const reordered = [...lessons];
+    [reordered[index], reordered[target]] = [reordered[target], reordered[index]];
+    await reorderUnitLessons(unitId, reordered.map((l) => l.lesson_id));
+    fetchUnit(unitId);
+  };
+
+  const handleDetach = async (lessonId) => {
+    await detachLessonFromUnit(unitId, lessonId);
+    fetchUnit(unitId);
+  };
+
+  const handleAttach = async (lessonIds) => {
+    await attachLessonsToUnit(unitId, lessonIds);
+    fetchUnit(unitId);
+  };
+
+  if (initializing) {
+    return (
+      <div className="flex items-center justify-center h-64">
+        <Spinner className="h-6 w-6" />
+      </div>
+    );
+  }
+
+  return (
+    <section className="bg-muted h-full">
+      <PageMeta title={unit ? `${unit.title} - Units - STARR` : undefined} />
+      <div className="lg:container lg:mx-auto lg:px-0 flex flex-col items-start px-4">
+        <div className="flex flex-col gap-2 my-6">
+          <AppBreadcrumb items={items} />
+        </div>
+
+        <div className="w-full space-y-6 pb-10">
+
+          {/* ── Unit header ── */}
+          <div className="bg-card rounded-xl border p-6 space-y-4">
+            <div className="flex items-start justify-between gap-4">
+              <div>
+                <h6 className="text-xs tracking-widest mb-1">STANDALONE UNIT</h6>
+                <h1 className="text-xl font-semibold">{unit?.title}</h1>
+                {unit?.description && (
+                  <p className="text-sm text-muted-foreground mt-0.5">{unit.description}</p>
+                )}
+              </div>
+              <div className="flex gap-2 shrink-0">
+                <Button size="sm" variant="outline" onClick={() => navigate(`/admin/units/${unitId}/edit`)}>
+                  <Pencil className="h-3.5 w-3.5 mr-1.5" /> Edit
+                </Button>
+                {unit?.quiz ? (
+                  <Button size="sm" variant="outline" onClick={() => navigate(`/admin/units/${unitId}/quiz/view`)}>
+                    <ClipboardList className="h-3.5 w-3.5 mr-1.5" /> View Quiz
+                  </Button>
+                ) : (
+                  <Button size="sm" variant="outline" onClick={() => navigate(`/admin/units/${unitId}/quiz/edit`)}>
+                    <PlusCircle className="h-3.5 w-3.5 mr-1.5" /> Create Quiz
+                  </Button>
+                )}
+              </div>
+            </div>
+
+            {/* Stats row */}
+            <div className="grid grid-cols-2 lg:grid-cols-4 gap-3">
+              <div className="bg-muted/60 rounded-lg p-3 space-y-1">
+                <p className="text-xs text-muted-foreground uppercase tracking-wide font-medium">Lessons</p>
+                <p className="font-semibold text-sm">{lessons.length}</p>
+              </div>
+              <div className="bg-muted/60 rounded-lg p-3 space-y-1">
+                <p className="text-xs text-muted-foreground uppercase tracking-wide font-medium">Duration</p>
+                <p className="font-semibold text-sm">{formatDuration(unit?.duration_seconds ?? 0)}</p>
+              </div>
+              <div className="bg-muted/60 rounded-lg p-3 space-y-1">
+                <p className="text-xs text-muted-foreground uppercase tracking-wide font-medium">Quiz</p>
+                <p className="font-semibold text-sm">{unit?.quiz ? unit.quiz.title || "Unit Quiz" : "None"}</p>
+              </div>
+              <div className="bg-muted/60 rounded-lg p-3 space-y-1">
+                <p className="text-xs text-muted-foreground uppercase tracking-wide font-medium">Used In</p>
+                <p className="font-semibold text-sm">
+                  {courses.length > 0 ? `${courses.length} course${courses.length === 1 ? "" : "s"}` : "Standalone"}
+                </p>
+              </div>
+            </div>
+
+            {/* Attached courses */}
+            {courses.length > 0 && (
+              <div className="flex flex-wrap items-center gap-2 pt-1">
+                <span className="text-xs text-muted-foreground uppercase tracking-wide font-medium">Courses:</span>
+                {courses.map((c) => (
+                  <Link key={c.course_id} to={`/admin/courses/${c.course_id}/view`}>
+                    <Badge variant="secondary" className="hover:bg-muted cursor-pointer">
+                      <BookOpen className="h-3 w-3 mr-1" /> {c.title}
+                    </Badge>
+                  </Link>
+                ))}
+              </div>
+            )}
+          </div>
+
+          {/* ── Lessons manager ── */}
+          <div className="bg-card rounded-xl border">
+            <div className="flex items-center justify-between p-4 border-b">
+              <div>
+                <h2 className="font-semibold">Lessons</h2>
+                <p className="text-xs text-muted-foreground">
+                  Lessons are standalone too — attach existing ones or create new. Order here is this unit's order.
+                </p>
+              </div>
+              <div className="flex gap-2">
+                <Button size="sm" variant="outline" onClick={() => setAttachOpen(true)}>
+                  <Link2 className="h-3.5 w-3.5 mr-1.5" /> Attach Existing
+                </Button>
+                <Button size="sm" onClick={() => navigate(`/admin/lessons/add?unit_id=${unitId}`)}>
+                  <Plus className="h-3.5 w-3.5 mr-1.5" /> New Lesson
+                </Button>
+              </div>
+            </div>
+
+            {lessons.length === 0 ? (
+              <p className="text-sm text-muted-foreground text-center py-10">
+                No lessons attached yet — attach one from the library or create a new one.
+              </p>
+            ) : (
+              <div className="divide-y">
+                {lessons.map((l, i) => (
+                  <div key={l.lesson_id} className="flex items-center gap-3 px-4 py-3">
+                    <span className="text-xs font-mono text-muted-foreground w-6 text-right shrink-0">
+                      {i + 1}.
+                    </span>
+                    <div className="flex flex-col gap-0.5 shrink-0">
+                      <button
+                        type="button"
+                        className="text-muted-foreground hover:text-foreground disabled:opacity-30"
+                        disabled={i === 0 || loading}
+                        onClick={() => moveLesson(i, -1)}
+                        aria-label="Move up"
+                      >
+                        <ChevronUp className="h-3.5 w-3.5" />
+                      </button>
+                      <button
+                        type="button"
+                        className="text-muted-foreground hover:text-foreground disabled:opacity-30"
+                        disabled={i === lessons.length - 1 || loading}
+                        onClick={() => moveLesson(i, 1)}
+                        aria-label="Move down"
+                      >
+                        <ChevronDown className="h-3.5 w-3.5" />
+                      </button>
+                    </div>
+                    <div className="flex-1 min-w-0">
+                      <p className="text-sm font-medium truncate">{l.title}</p>
+                      {l.description && (
+                        <p className="text-xs text-muted-foreground truncate">{l.description}</p>
+                      )}
+                    </div>
+                    <Badge variant="secondary" className="text-xs shrink-0 tabular-nums">
+                      <Clock className="h-3 w-3 mr-1" /> {formatDuration(l.duration_seconds ?? 0)}
+                    </Badge>
+                    <Button
+                      size="sm" variant="ghost"
+                      onClick={() => navigate(`/admin/lessons/${l.lesson_id}/page`)}
+                      title="Page Builder"
+                    >
+                      <LayoutTemplate className="h-3.5 w-3.5" />
+                    </Button>
+                    <Button
+                      size="sm" variant="ghost"
+                      className="text-destructive hover:text-destructive"
+                      onClick={() => handleDetach(l.lesson_id)}
+                      disabled={loading}
+                      title="Detach from unit (lesson stays in library)"
+                    >
+                      <Unlink className="h-3.5 w-3.5" />
+                    </Button>
+                  </div>
+                ))}
+              </div>
+            )}
+          </div>
+        </div>
+      </div>
+
+      <AttachLessonsDialog
+        open={attachOpen}
+        onOpenChange={setAttachOpen}
+        attachedLessonIds={lessons.map((l) => l.lesson_id)}
+        onAttach={handleAttach}
+        loading={loading}
+      />
+    </section>
+  );
+}