@carlonicora/nextjs-jsonapi 1.109.0 → 1.110.0

package/src/features/help/components/HelpArticleBody.tsx

@@ -1,48 +1,56 @@
 "use client";
+
 import { ReactNode } from "react";
 import Link from "next/link";
 import { useFormatter, useTranslations } from "next-intl";
-import type { HelpArticle } from "../types/help-article.types";
 import { usePageUrlGenerator } from "../../../client";
-import { useHelp } from "../contexts/HelpContext";
-import { articleUrl } from "../utils/articleUrl";
-import { prevNextWithinMode } from "../utils/helpNavigation";
 
-export function HelpArticleBody({ article, children }: { article: HelpArticle; children: ReactNode }) {
+type Sibling = { howToType: string; slug: string; title: string };
+
+export function HelpArticleBody(props: {
+  howToType: string;
+  title: string;
+  summary?: string;
+  updatedAt?: string;
+  prev?: Sibling | null;
+  next?: Sibling | null;
+  children: ReactNode;
+}) {
   const t = useTranslations();
   const format = useFormatter();
   const generateUrl = usePageUrlGenerator();
-  const { manifest } = useHelp();
-  const { prev, next } = prevNextWithinMode(manifest, article);
+  const { howToType, title, summary, updatedAt, prev, next, children } = props;
 
   return (
     <article className="prose dark:prose-invert max-w-none">
       <nav className="text-muted-foreground mb-2 text-xs">
         <Link href={generateUrl({ page: "/help" })}>Help</Link>
         {" · "}
-        <Link href={generateUrl({ page: `/help/${article.mode}` })}>{t(`help.modes.${article.mode}`)}</Link>
+        <Link href={generateUrl({ page: `/help/${howToType}` })}>{t(`help.modes.${howToType}`)}</Link>
       </nav>
-      <h1>{article.title}</h1>
-      <p className="text-muted-foreground !mt-0 text-base">{article.summary}</p>
+      <h1>{title}</h1>
+      {summary ? <p className="text-muted-foreground !mt-0 text-base">{summary}</p> : null}
       {children}
       <hr className="my-6" />
-      <div className="text-muted-foreground text-xs">
-        <span>
-          {t("help.article.lastUpdated", {
-            date: format.dateTime(new Date(article.lastUpdated), { dateStyle: "short" }),
-          })}
-        </span>
-      </div>
+      {updatedAt ? (
+        <div className="text-muted-foreground text-xs">
+          <span>
+            {t("help.article.lastUpdated", {
+              date: format.dateTime(new Date(updatedAt), { dateStyle: "short" }),
+            })}
+          </span>
+        </div>
+      ) : null}
       <div className="mt-4 flex justify-between text-sm">
         {prev ? (
-          <Link href={articleUrl(generateUrl, prev)} className="hover:underline">
+          <Link href={generateUrl({ page: `/help/${prev.howToType}/${prev.slug}` })} className="hover:underline">
             ← {t("help.article.previous")}: {prev.title}
           </Link>
         ) : (
           <span />
         )}
         {next ? (
-          <Link href={articleUrl(generateUrl, next)} className="hover:underline">
+          <Link href={generateUrl({ page: `/help/${next.howToType}/${next.slug}` })} className="hover:underline">
             {t("help.article.next")}: {next.title} →
           </Link>
         ) : (

package/src/features/help/components/HelpHint.tsx

@@ -1,5 +1,5 @@
 "use client";
-import { useMemo, useState } from "react";
+import { useEffect, useMemo, useState } from "react";
 import { useTranslations } from "next-intl";
 import Link from "next/link";
 import { HelpCircleIcon } from "lucide-react";
@@ -13,20 +13,29 @@ import {
   SheetDescription,
 } from "../../../shadcnui";
 import { usePageUrlGenerator } from "../../../client";
-import { useHelp } from "../contexts/HelpContext";
-import { articleUrl } from "../utils/articleUrl";
-import type { HelpArticle } from "../types/help-article.types";
+import { HowToService } from "../../how-to/data/HowToService";
+import type { HowToInterface } from "../../how-to/data/HowToInterface";
 
 export function HelpHint({ contextKey }: { contextKey: string }) {
   const t = useTranslations();
   const generateUrl = usePageUrlGenerator();
-  const { manifest } = useHelp();
   const [open, setOpen] = useState(false);
-  const [picked, setPicked] = useState<HelpArticle | null>(null);
+  const [picked, setPicked] = useState<HowToInterface | null>(null);
+
+  const [articles, setArticles] = useState<HowToInterface[]>([]);
+  useEffect(() => {
+    let active = true;
+    HowToService.findPublished()
+      .then((list) => active && setArticles(list))
+      .catch(() => active && setArticles([]));
+    return () => {
+      active = false;
+    };
+  }, []);
 
   const matches = useMemo(
-    () => manifest.filter((a) => a.contextualKeys.includes(contextKey) && !a.draft),
-    [manifest, contextKey],
+    () => articles.filter((a) => a.contextualKeys.includes(contextKey) && !a.draft),
+    [articles, contextKey],
   );
 
   if (matches.length === 0) return null;
@@ -45,13 +54,13 @@ export function HelpHint({ contextKey }: { contextKey: string }) {
       </SheetTrigger>
       <SheetContent side="right" className="w-full max-w-md sm:max-w-lg">
         <SheetHeader>
-          <SheetTitle>{active ? active.title : t("help.hint.pickArticle")}</SheetTitle>
+          <SheetTitle>{active ? active.name : t("help.hint.pickArticle")}</SheetTitle>
           <SheetDescription>{active?.summary ?? ""}</SheetDescription>
         </SheetHeader>
         {active ? (
           <div className="mt-4 space-y-3">
             <p className="text-muted-foreground text-sm">{active.summary}</p>
-            <Link href={articleUrl(generateUrl, active)} className="text-sm">
+            <Link href={generateUrl({ page: `/help/${active.howToType}/${active.slug}` })} className="text-sm">
               {t("help.hint.viewArticle")}
             </Link>
           </div>
@@ -64,7 +73,7 @@ export function HelpHint({ contextKey }: { contextKey: string }) {
                   onClick={() => setPicked(a)}
                   className="hover:bg-muted block w-full rounded px-2 py-1 text-left text-sm"
                 >
-                  <div className="font-medium">{a.title}</div>
+                  <div className="font-medium">{a.name}</div>
                   <div className="text-muted-foreground text-xs">{a.summary}</div>
                 </button>
               </li>

package/src/features/help/components/HelpSearchResultRow.tsx

@@ -1,10 +1,12 @@
 "use client";
 import Link from "next/link";
 import { useTranslations } from "next-intl";
+import { useEffect, useState } from "react";
 import { LifeBuoyIcon, ArrowUpRightIcon } from "lucide-react";
 import { CommandItem } from "../../../shadcnui";
 import { usePageUrlGenerator } from "../../../client";
-import { useHelp } from "../contexts/HelpContext";
+import { HowToService } from "../../how-to/data/HowToService";
+import type { HowToInterface } from "../../how-to/data/HowToInterface";
 
 export interface HelpSearchResultRowProps {
   result: { id: string; name: string; entityType: string };
@@ -14,8 +16,16 @@ export interface HelpSearchResultRowProps {
 export function HelpSearchResultRow({ result, onSelect }: HelpSearchResultRowProps) {
   const t = useTranslations();
   const generateUrl = usePageUrlGenerator();
-  const { manifest } = useHelp();
-  const article = manifest.find((a) => a.id === result.id);
+  const [article, setArticle] = useState<HowToInterface | null>(null);
+  useEffect(() => {
+    let active = true;
+    HowToService.findOne({ id: result.id })
+      .then((a) => active && setArticle(a))
+      .catch(() => active && setArticle(null));
+    return () => {
+      active = false;
+    };
+  }, [result.id]);
 
   if (!article) {
     return (
@@ -32,16 +42,16 @@ export function HelpSearchResultRow({ result, onSelect }: HelpSearchResultRowPro
   return (
     <CommandItem value={result.id} onSelect={onSelect} className="cursor-pointer p-0">
       <Link
-        href={generateUrl({ page: `/help/${article.mode}/${article.slug}` })}
+        href={generateUrl({ page: `/help/${article.howToType}/${article.slug}` })}
         className="hover:bg-muted flex w-full items-center gap-3 rounded px-3 py-2"
       >
         <div className="bg-muted text-muted-foreground flex h-10 w-10 shrink-0 items-center justify-center rounded-full">
           <LifeBuoyIcon className="h-5 w-5" />
         </div>
         <div className="flex min-w-0 flex-1 flex-col">
-          <span className="text-foreground truncate text-sm font-semibold">{article.title}</span>
+          <span className="text-foreground truncate text-sm font-semibold">{article.name}</span>
           <span className="text-muted-foreground truncate text-xs">
-            {t(`help.modes.${article.mode}`)} · {article.summary}
+            {t(`help.modes.${article.howToType}`)} · {article.summary}
           </span>
         </div>
         <ArrowUpRightIcon className="text-muted-foreground h-5 w-5 shrink-0" />

package/src/features/help/components/HelpSideNav.tsx

@@ -1,24 +1,60 @@
 "use client";
+
+import { useEffect, useMemo, useState } from "react";
 import { useTranslations } from "next-intl";
 import Link from "next/link";
 import { usePathname } from "next/navigation";
 import { HELP_MODES } from "../types/help-article.types";
 import { usePageUrlGenerator } from "../../../client";
-import { useHelp } from "../contexts/HelpContext";
 import { useHelpFilter } from "../hooks/useHelpFilter";
-import { buildHelpNav } from "../utils/helpNavigation";
-import { articleUrl, modeUrl } from "../utils/articleUrl";
+import { HowToService } from "../../how-to/data/HowToService";
+import type { HowToInterface } from "../../how-to/data/HowToInterface";
 
 export function HelpSideNav() {
   const t = useTranslations();
   const generateUrl = usePageUrlGenerator();
   const pathname = usePathname();
-  const { manifest } = useHelp();
-  const groups = buildHelpNav(manifest);
-  const allArticles = groups.flatMap((g) => g.articles);
-  const { query, setQuery, filtered } = useHelpFilter(allArticles);
+  const [articles, setArticles] = useState<HowToInterface[]>([]);
+
+  useEffect(() => {
+    let active = true;
+    HowToService.findPublished()
+      .then((list) => active && setArticles(list))
+      .catch(() => active && setArticles([]));
+    return () => {
+      active = false;
+    };
+  }, []);
+
+  // useHelpFilter indexes by title/summary/tags — map HowTo getters into the shape it expects.
+  const indexable = useMemo(
+    () =>
+      articles.map((a) => ({
+        id: a.id,
+        title: a.name,
+        summary: a.summary ?? "",
+        tags: a.tags,
+        mode: a.howToType ?? "",
+        slug: a.slug ?? "",
+      })),
+    [articles],
+  );
+  const { query, setQuery, filtered } = useHelpFilter(indexable as any);
   const filtering = query.trim().length > 0;
 
+  const groups = useMemo(
+    () =>
+      HELP_MODES.map((mode) => ({
+        mode,
+        articles: articles
+          .filter((a) => a.howToType === mode && !a.draft)
+          .sort((x, y) => (x.order ?? 0) - (y.order ?? 0)),
+      })),
+    [articles],
+  );
+
+  const isActive = (mode: string, slug: string) => pathname.endsWith(`/help/${mode}/${slug}`);
+
   return (
     <nav aria-label="Help navigation" className="flex h-full flex-col gap-3 overflow-y-auto p-4">
       <input
@@ -29,17 +65,17 @@ export function HelpSideNav() {
         className="border-input bg-background w-full rounded-md border px-3 py-2 text-sm"
       />
       {filtering ? (
-        filtered.length === 0 ? (
+        (filtered as any[]).length === 0 ? (
           <p className="text-muted-foreground text-sm">{t("help.sideNav.noMatches")}</p>
         ) : (
           <ul className="space-y-1">
-            {filtered.map((a) => (
+            {(filtered as any[]).map((a) => (
               <li key={a.id}>
                 <Link
-                  href={articleUrl(generateUrl, a)}
+                  href={generateUrl({ page: `/help/${a.mode}/${a.slug}` })}
                   className={
                     "hover:bg-muted block rounded px-2 py-1 text-sm " +
-                    (pathname.endsWith(`/help/${a.mode}/${a.slug}`) ? "bg-muted font-medium" : "")
+                    (isActive(a.mode, a.slug) ? "bg-muted font-medium" : "")
                   }
                 >
                   {a.title}
@@ -49,28 +85,27 @@ export function HelpSideNav() {
           </ul>
         )
       ) : (
-        HELP_MODES.map((mode) => {
-          const group = groups.find((g) => g.mode === mode)!;
+        groups.map((group) => {
           if (group.articles.length === 0) return null;
           return (
-            <div key={mode}>
+            <div key={group.mode}>
               <Link
-                href={modeUrl(generateUrl, mode)}
+                href={generateUrl({ page: `/help/${group.mode}` })}
                 className="text-muted-foreground hover:text-foreground mb-1 block text-xs font-semibold tracking-wider uppercase"
               >
-                {t(`help.modes.${mode}`)}
+                {t(`help.modes.${group.mode}`)}
               </Link>
               <ul className="space-y-0.5">
                 {group.articles.map((a) => (
                   <li key={a.id}>
                     <Link
-                      href={articleUrl(generateUrl, a)}
+                      href={generateUrl({ page: `/help/${a.howToType}/${a.slug}` })}
                       className={
                         "hover:bg-muted block rounded px-2 py-1 text-sm " +
-                        (pathname.endsWith(`/help/${a.mode}/${a.slug}`) ? "bg-muted font-medium" : "")
+                        (isActive(a.howToType ?? "", a.slug ?? "") ? "bg-muted font-medium" : "")
                       }
                     >
-                      {a.title}
+                      {a.name}
                     </Link>
                   </li>
                 ))}

package/src/features/help/components/__tests__/HelpAskAi.spec.tsx

@@ -17,7 +17,7 @@ vi.mock("../HelpAssistantSheet", () => ({
 function setupConfig() {
   configureJsonApi({
     apiUrl: "http://localhost",
-    helpContent: { manifest: [], namespaceUuid: "00000000-0000-5000-8000-000000000000" },
+    helpContent: { brand: { label: "narr8" } },
   });
 }
 

package/src/features/help/components/__tests__/HelpHint.spec.tsx

@@ -1,50 +1,50 @@
-import { describe, it, expect, beforeEach } from "vitest";
-import { render, screen } from "@testing-library/react";
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { render, screen, waitFor } from "@testing-library/react";
 import { configureJsonApi } from "../../../../client/config";
 import { HelpProvider } from "../../contexts/HelpContext";
 import { HelpHint } from "../HelpHint";
+import { HowToService } from "../../../how-to/data/HowToService";
+
+vi.mock("../../../how-to/data/HowToService", () => ({
+  HowToService: { findPublished: vi.fn() },
+}));
 
 const article = {
   id: "1",
   slug: "x",
-  mode: "how-to",
-  title: "X",
+  howToType: "how-to",
+  name: "X",
   summary: "S",
-  order: 1,
-  tags: [],
   contextualKeys: ["npc.editor"],
-  aiIndexed: true,
   draft: false,
-  contentHash: "h",
-  path: "how-to/x.mdx",
-  headings: [],
-  relatedSlugs: [],
-  lastUpdated: "2026-01-01T00:00:00Z",
-};
+} as any;
 
 beforeEach(() => {
+  vi.clearAllMocks();
+  vi.mocked(HowToService.findPublished).mockResolvedValue([article]);
   configureJsonApi({
     apiUrl: "http://localhost",
-    helpContent: { manifest: [article], namespaceUuid: "00000000-0000-5000-8000-000000000000" },
+    helpContent: { brand: { label: "narr8" } },
   });
 });
 
 describe("HelpHint", () => {
-  it("renders null when no article matches the contextKey", () => {
+  it("renders null when no published article matches the contextKey", async () => {
     const { container } = render(
       <HelpProvider>
         <HelpHint contextKey="nope.absent" />
       </HelpProvider>,
     );
+    await waitFor(() => expect(HowToService.findPublished).toHaveBeenCalled());
     expect(container.querySelector("button")).toBeNull();
   });
 
-  it("renders the trigger when at least one article matches", () => {
+  it("renders the trigger when at least one published article matches", async () => {
     render(
       <HelpProvider>
         <HelpHint contextKey="npc.editor" />
       </HelpProvider>,
     );
-    expect(screen.getByLabelText(/help on this|hint/i)).toBeTruthy();
+    expect(await screen.findByLabelText(/help on this|hint/i)).toBeTruthy();
   });
 });

package/src/features/help/components/__tests__/HelpSearchResultRow.spec.tsx

@@ -1,37 +1,34 @@
-import { describe, it, expect, beforeEach } from "vitest";
-import { render, screen } from "@testing-library/react";
+import { describe, it, expect, beforeEach, vi } from "vitest";
+import { render, screen, waitFor } from "@testing-library/react";
 import { Command, CommandList } from "../../../../shadcnui";
 import { configureJsonApi } from "../../../../client/config";
 import { HelpProvider } from "../../contexts/HelpContext";
 import { HelpSearchResultRow } from "../HelpSearchResultRow";
+import { HowToService } from "../../../how-to/data/HowToService";
+
+vi.mock("../../../how-to/data/HowToService", () => ({
+  HowToService: { findOne: vi.fn() },
+}));
 
 const article = {
   id: "abc",
   slug: "x",
-  mode: "how-to" as const,
-  title: "X title",
+  howToType: "how-to",
+  name: "X title",
   summary: "S",
-  order: 1,
-  tags: [],
-  contextualKeys: [],
-  aiIndexed: true,
-  draft: false,
-  contentHash: "h",
-  path: "how-to/x.mdx",
-  headings: [],
-  relatedSlugs: [],
-  lastUpdated: "2026-01-01T00:00:00Z",
-};
+} as any;
 
 beforeEach(() => {
+  vi.clearAllMocks();
   configureJsonApi({
     apiUrl: "http://localhost",
-    helpContent: { manifest: [article], namespaceUuid: "00000000-0000-5000-8000-000000000000" },
+    helpContent: { brand: { label: "narr8" } },
   });
 });
 
 describe("HelpSearchResultRow", () => {
-  it("renders the article title when manifest contains the id", () => {
+  it("renders the article title when the service returns the how-to", async () => {
+    vi.mocked(HowToService.findOne).mockResolvedValue(article);
     render(
       <HelpProvider>
         <Command>
@@ -41,10 +38,11 @@ describe("HelpSearchResultRow", () => {
         </Command>
       </HelpProvider>,
     );
-    expect(screen.getByText("X title")).toBeTruthy();
+    expect(await screen.findByText("X title")).toBeTruthy();
   });
 
-  it("renders disabled removed-state row when id is missing", () => {
+  it("renders disabled removed-state row when the service has no how-to", async () => {
+    vi.mocked(HowToService.findOne).mockRejectedValue(new Error("not found"));
     render(
       <HelpProvider>
         <Command>
@@ -54,6 +52,7 @@ describe("HelpSearchResultRow", () => {
         </Command>
       </HelpProvider>,
     );
+    await waitFor(() => expect(HowToService.findOne).toHaveBeenCalledWith({ id: "ghost" }));
     expect(screen.queryByText("X title")).toBeNull();
   });
 });

package/src/features/help/components/__tests__/HelpSideNav.spec.tsx

@@ -1,50 +1,48 @@
-import { describe, it, expect, beforeEach } from "vitest";
+import { describe, it, expect, beforeEach, vi } from "vitest";
 import { render, screen, fireEvent } from "@testing-library/react";
 import { configureJsonApi } from "../../../../client/config";
 import { HelpProvider } from "../../contexts/HelpContext";
 import { HelpSideNav } from "../HelpSideNav";
 
-const base = {
-  tags: [],
-  contextualKeys: [],
-  aiIndexed: true,
-  draft: false,
-  contentHash: "h",
-  headings: [],
-  relatedSlugs: [],
-  lastUpdated: "2026-01-01T00:00:00Z",
-};
+// HelpSideNav now sources its list from the public API via
+// HowToService.findPublished() (Plan 3b) instead of the help manifest, so the
+// test mocks the service rather than seeding the manifest.
+vi.mock("../../../how-to/data/HowToService", () => ({
+  HowToService: { findPublished: vi.fn() },
+}));
+import { HowToService } from "../../../how-to/data/HowToService";
+
+const published = [
+  { id: "a", name: "Alpha", summary: "s", tags: [], howToType: "how-to", slug: "a", order: 1, draft: false },
+  { id: "b", name: "Beta", summary: "s", tags: [], howToType: "how-to", slug: "b", order: 2, draft: false },
+];
 
 beforeEach(() => {
   configureJsonApi({
     apiUrl: "http://localhost",
-    helpContent: {
-      manifest: [
-        { ...base, id: "a", slug: "a", mode: "how-to", title: "Alpha", summary: "s", order: 1, path: "how-to/a.mdx" },
-        { ...base, id: "b", slug: "b", mode: "how-to", title: "Beta", summary: "s", order: 2, path: "how-to/b.mdx" },
-      ],
-      namespaceUuid: "00000000-0000-5000-8000-000000000000",
-    },
+    helpContent: { brand: { label: "narr8" } },
   });
+  (HowToService.findPublished as ReturnType<typeof vi.fn>).mockResolvedValue(published as any);
 });
 
 describe("HelpSideNav", () => {
-  it("lists every non-draft article", () => {
+  it("lists every non-draft article", async () => {
     render(
       <HelpProvider>
         <HelpSideNav />
       </HelpProvider>,
     );
-    expect(screen.getByText("Alpha")).toBeTruthy();
-    expect(screen.getByText("Beta")).toBeTruthy();
+    expect(await screen.findByText("Alpha")).toBeTruthy();
+    expect(await screen.findByText("Beta")).toBeTruthy();
   });
 
-  it("filters by query", () => {
+  it("filters by query", async () => {
     render(
       <HelpProvider>
         <HelpSideNav />
       </HelpProvider>,
     );
+    await screen.findByText("Alpha");
     fireEvent.change(screen.getByPlaceholderText(/filter/i), { target: { value: "Bet" } });
     expect(screen.queryByText("Alpha")).toBeNull();
     expect(screen.getByText("Beta")).toBeTruthy();

package/src/features/help/contexts/HelpContext.spec.tsx

@@ -6,8 +6,6 @@ import { HelpProvider, useHelp } from "./HelpContext";
 
 describe("HelpProvider / useHelp", () => {
   const cfg = {
-    manifest: [],
-    namespaceUuid: "00000000-0000-5000-8000-000000000000",
     brand: { logo: "/logo.png", label: "Test", appHref: "/" },
   };
 
@@ -18,8 +16,8 @@ describe("HelpProvider / useHelp", () => {
   it("exposes the configured helpContent via useHelp()", () => {
     const wrapper = ({ children }: { children: ReactNode }) => <HelpProvider>{children}</HelpProvider>;
     const { result } = renderHook(() => useHelp(), { wrapper });
-    expect(result.current.manifest).toBe(cfg.manifest);
     expect(result.current.brand?.label).toBe("Test");
+    expect(result.current.brand?.appHref).toBe("/");
   });
 
   it("throws when useHelp() is called outside HelpProvider", () => {

package/src/features/help/index.ts

@@ -2,11 +2,11 @@
 // Consumed via `@carlonicora/nextjs-jsonapi/help`. Tsup adds a top-level
 // "use client" directive to the bundled output via clientEntries.
 //
-// Pair this with `@carlonicora/nextjs-jsonapi/help/server` (server) for the
-// pure server utilities (serializeHelpArticle, generate*StaticParams, etc.).
+// Pair this with `@carlonicora/nextjs-jsonapi/help/server` for the server-safe
+// HELP_MODES constant + article types (imported by server-component pages).
 // Consumers compose page shells themselves: import the client primitives below
 // (HelpProvider, HelpHeader, HelpSideNav, HelpArticleBody, HelpTOC, etc.) and
-// the server utilities from /help/server, then assemble pages in app routes.
+// assemble pages in app routes.
 
 export { HelpProvider, useHelp } from "./contexts/HelpContext";
 export { HelpHeader } from "./components/HelpHeader";
@@ -16,9 +16,6 @@ export { HelpTOC } from "./components/HelpTOC";
 export { HelpHint } from "./components/HelpHint";
 export { HelpAskAi } from "./components/HelpAskAi";
 export { HelpSearchResultRow } from "./components/HelpSearchResultRow";
-export { MDX_COMPONENTS } from "./components/mdx/mdxComponents";
-export { useHelpManifest } from "./hooks/useHelpManifest";
-export { useHelpArticle } from "./hooks/useHelpArticle";
 export { useHelpFilter } from "./hooks/useHelpFilter";
 export { articleUrl, modeUrl } from "./utils/articleUrl";
 export { HELP_I18N_KEYS } from "./i18n-keys";

package/src/features/help/interfaces/help-content-config.interface.ts

@@ -1,5 +1,3 @@
-import type { HelpArticle, HelpRedirect } from "../types/help-article.types";
-
 export interface HelpBrandConfig {
   /** URL of the brand logo image (served by the consuming app). */
   logo?: string;
@@ -10,8 +8,5 @@ export interface HelpBrandConfig {
 }
 
 export interface HelpContentConfig {
-  manifest: readonly HelpArticle[];
-  namespaceUuid: string;
-  redirects?: readonly HelpRedirect[];
   brand?: HelpBrandConfig;
 }

package/src/features/help/server-entry.ts

@@ -1,20 +1,11 @@
-// Server-only public barrel for the help feature.
+// Server-safe public barrel for the help feature.
 // Consumed via `@carlonicora/nextjs-jsonapi/help/server`. Must NOT receive a
-// "use client" directive.
+// "use client" directive — server components (e.g. the /help index + mode pages)
+// import HELP_MODES/HelpMode from here without pulling the client bundle.
 //
-// This barrel exposes only server-safe utilities (no React components). The
-// React Server Component / Client Component boundary is enforced by tsup-level
-// bundle splitting: server containers cannot directly import client components
-// without leaking client-only modules (react-dom/client, hook usage at module
-// init) into server scopes. Consumers therefore compose the page shells in
-// their own route files, importing client primitives from
-// `@carlonicora/nextjs-jsonapi/help` and server utilities from here.
+// Now that help articles are served from the API (HowTo) rather than the MDX
+// manifest, this barrel exposes only the shared mode constant + article types.
+// Client primitives live in `@carlonicora/nextjs-jsonapi/help`.
 
-export { getHelpContent } from "./server/getHelpContent";
-export { renderHelpArticle, serializeHelpArticle } from "./server/serializeHelpArticle";
-export { generateHelpArticleStaticParams, generateHelpArticleMetadata, generateHelpModeStaticParams } from "./server";
-export { findHelpArticle, prevNextWithinMode, buildHelpNav } from "./utils/helpNavigation";
-export { setHelpReader } from "../../core/registry/helpStore";
-export type { HelpContentConfig, HelpBrandConfig } from "./interfaces/help-content-config.interface";
 export { HELP_MODES } from "./types/help-article.types";
 export type { HelpArticle, HelpHeading, HelpMode, HelpRedirect } from "./types/help-article.types";