@carlonicora/nextjs-jsonapi 1.109.0 → 1.110.0

package/dist/chunk-YQQHAFBS.js

@@ -1,38 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
-
-var _chunk7QVYU63Ejs = require('./chunk-7QVYU63E.js');
-
-// src/core/registry/helpStore.ts
-var HELP_CONTENT_KEY = /* @__PURE__ */ Symbol.for("nextjs-jsonapi:helpContent");
-var HELP_READER_KEY = /* @__PURE__ */ Symbol.for("nextjs-jsonapi:helpReader");
-var globalStore = globalThis;
-if (globalStore[HELP_CONTENT_KEY] === void 0) {
-  globalStore[HELP_CONTENT_KEY] = null;
-}
-if (globalStore[HELP_READER_KEY] === void 0) {
-  globalStore[HELP_READER_KEY] = null;
-}
-function _setStaticHelpContent(cfg) {
-  globalStore[HELP_CONTENT_KEY] = cfg;
-}
-_chunk7QVYU63Ejs.__name.call(void 0, _setStaticHelpContent, "_setStaticHelpContent");
-function _getStaticHelpContent() {
-  return _nullishCoalesce(globalStore[HELP_CONTENT_KEY], () => ( null));
-}
-_chunk7QVYU63Ejs.__name.call(void 0, _getStaticHelpContent, "_getStaticHelpContent");
-function setHelpReader(reader) {
-  globalStore[HELP_READER_KEY] = reader;
-}
-_chunk7QVYU63Ejs.__name.call(void 0, setHelpReader, "setHelpReader");
-function _getStaticHelpReader() {
-  return _nullishCoalesce(globalStore[HELP_READER_KEY], () => ( null));
-}
-_chunk7QVYU63Ejs.__name.call(void 0, _getStaticHelpReader, "_getStaticHelpReader");
-
-
-
-
-
-
-exports._setStaticHelpContent = _setStaticHelpContent; exports._getStaticHelpContent = _getStaticHelpContent; exports.setHelpReader = setHelpReader; exports._getStaticHelpReader = _getStaticHelpReader;
-//# sourceMappingURL=chunk-YQQHAFBS.js.map

package/dist/chunk-YQQHAFBS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/chunk-YQQHAFBS.js","../src/core/registry/helpStore.ts"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACA;ACWA,IAAM,iBAAA,kBAAmB,MAAA,CAAO,GAAA,CAAI,4BAA4B,CAAA;AAChE,IAAM,gBAAA,kBAAkB,MAAA,CAAO,GAAA,CAAI,2BAA2B,CAAA;AAE9D,IAAM,YAAA,EAAc,UAAA;AAKpB,GAAA,CAAI,WAAA,CAAY,gBAAgB,EAAA,IAAM,KAAA,CAAA,EAAW;AAC/C,EAAA,WAAA,CAAY,gBAAgB,EAAA,EAAI,IAAA;AAClC;AACA,GAAA,CAAI,WAAA,CAAY,eAAe,EAAA,IAAM,KAAA,CAAA,EAAW;AAC9C,EAAA,WAAA,CAAY,eAAe,EAAA,EAAI,IAAA;AACjC;AAEO,SAAS,qBAAA,CAAsB,GAAA,EAA2B;AAC/D,EAAA,WAAA,CAAY,gBAAgB,EAAA,EAAI,GAAA;AAClC;AAFgB,qCAAA,qBAAA,EAAA,uBAAA,CAAA;AAIT,SAAS,qBAAA,CAAA,EAA+C;AAC7D,EAAA,wBAAQ,WAAA,CAAY,gBAAgB,CAAA,UAAkB,MAAA;AACxD;AAFgB,qCAAA,qBAAA,EAAA,uBAAA,CAAA;AAIT,SAAS,aAAA,CAAc,MAAA,EAA0B;AACtD,EAAA,WAAA,CAAY,eAAe,EAAA,EAAI,MAAA;AACjC;AAFgB,qCAAA,aAAA,EAAA,eAAA,CAAA;AAIT,SAAS,oBAAA,CAAA,EAA0C;AACxD,EAAA,wBAAO,WAAA,CAAY,eAAe,CAAA,UAAK,MAAA;AACzC;AAFgB,qCAAA,oBAAA,EAAA,sBAAA,CAAA;ADZhB;AACA;AACE;AACA;AACA;AACA;AACF,yMAAC","file":"/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/chunk-YQQHAFBS.js","sourcesContent":[null,"/**\n * Centralized help-content store accessible from client and server contexts.\n * Uses globalThis Symbol keys to persist across HMR/Turbopack reloads and to\n * bridge between the client-side `configureJsonApi` (in `client/config.ts`)\n * and server-side consumers (HelpProvider, getHelpContent, serializeHelpArticle).\n *\n * NO external dependencies to avoid circular imports.\n *\n * Pattern mirrors `bootstrapStore.ts`.\n */\n\n// Help content config shape is duplicated here as `unknown` to avoid pulling\n// the help feature into this core file. Callers cast on read.\ntype HelpReader = (article: { path: string }) => Promise<string>;\n\nconst HELP_CONTENT_KEY = Symbol.for(\"nextjs-jsonapi:helpContent\");\nconst HELP_READER_KEY = Symbol.for(\"nextjs-jsonapi:helpReader\");\n\nconst globalStore = globalThis as unknown as {\n  [HELP_CONTENT_KEY]?: unknown | null;\n  [HELP_READER_KEY]?: HelpReader | null;\n};\n\nif (globalStore[HELP_CONTENT_KEY] === undefined) {\n  globalStore[HELP_CONTENT_KEY] = null;\n}\nif (globalStore[HELP_READER_KEY] === undefined) {\n  globalStore[HELP_READER_KEY] = null;\n}\n\nexport function _setStaticHelpContent(cfg: unknown | null): void {\n  globalStore[HELP_CONTENT_KEY] = cfg;\n}\n\nexport function _getStaticHelpContent<T = unknown>(): T | null {\n  return (globalStore[HELP_CONTENT_KEY] as T | null) ?? null;\n}\n\nexport function setHelpReader(reader: HelpReader): void {\n  globalStore[HELP_READER_KEY] = reader;\n}\n\nexport function _getStaticHelpReader(): HelpReader | null {\n  return globalStore[HELP_READER_KEY] ?? null;\n}\n"]}

package/dist/features/help/server/createHelpAssetRouteHandler.d.mts

@@ -1,11 +0,0 @@
-import { NextResponse } from 'next/server';
-
-declare function createHelpAssetRouteHandler({ srcRoot }: {
-    srcRoot: string;
-}): (_req: Request, { params }: {
-    params: Promise<{
-        path: string[];
-    }>;
-}) => Promise<NextResponse<unknown>>;
-
-export { createHelpAssetRouteHandler };

package/dist/features/help/server/createHelpAssetRouteHandler.d.ts

@@ -1,11 +0,0 @@
-import { NextResponse } from 'next/server';
-
-declare function createHelpAssetRouteHandler({ srcRoot }: {
-    srcRoot: string;
-}): (_req: Request, { params }: {
-    params: Promise<{
-        path: string[];
-    }>;
-}) => Promise<NextResponse<unknown>>;
-
-export { createHelpAssetRouteHandler };

package/dist/features/help/server/createHelpAssetRouteHandler.js

@@ -1,43 +0,0 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
-
-var _chunk7QVYU63Ejs = require('../../../chunk-7QVYU63E.js');
-
-// src/features/help/server/createHelpAssetRouteHandler.ts
-var _server = require('next/server');
-var _promises = require('fs/promises');
-var _path = require('path');
-var MIME = {
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".webp": "image/webp",
-  ".gif": "image/gif",
-  ".svg": "image/svg+xml",
-  ".mp4": "video/mp4",
-  ".webm": "video/webm"
-};
-function createHelpAssetRouteHandler({ srcRoot }) {
-  return /* @__PURE__ */ _chunk7QVYU63Ejs.__name.call(void 0, async function GET(_req, { params }) {
-    const { path } = await params;
-    const safe = path.filter((p) => p !== ".." && !p.includes("/")).join("/");
-    const filePath = _path.join.call(void 0, srcRoot, safe);
-    try {
-      const s = await _promises.stat.call(void 0, filePath);
-      if (!s.isFile()) return new (0, _server.NextResponse)("Not found", { status: 404 });
-      const ext = filePath.toLowerCase().slice(filePath.lastIndexOf("."));
-      const mime = _nullishCoalesce(MIME[ext], () => ( "application/octet-stream"));
-      const data = await _promises.readFile.call(void 0, filePath);
-      return new (0, _server.NextResponse)(data, {
-        status: 200,
-        headers: { "Content-Type": mime, "Cache-Control": "public, max-age=3600" }
-      });
-    } catch (e) {
-      return new (0, _server.NextResponse)("Not found", { status: 404 });
-    }
-  }, "GET");
-}
-_chunk7QVYU63Ejs.__name.call(void 0, createHelpAssetRouteHandler, "createHelpAssetRouteHandler");
-
-
-exports.createHelpAssetRouteHandler = createHelpAssetRouteHandler;
-//# sourceMappingURL=createHelpAssetRouteHandler.js.map

package/dist/features/help/server/createHelpAssetRouteHandler.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/features/help/server/createHelpAssetRouteHandler.js","../../../../src/features/help/server/createHelpAssetRouteHandler.ts"],"names":[],"mappings":"AAAA;AACE;AACF,6DAAmC;AACnC;AACA;ACJA,qCAA6B;AAC7B,uCAA+B;AAC/B,4BAAqB;AAErB,IAAM,KAAA,EAA+B;AAAA,EACnC,MAAA,EAAQ,WAAA;AAAA,EACR,MAAA,EAAQ,YAAA;AAAA,EACR,OAAA,EAAS,YAAA;AAAA,EACT,OAAA,EAAS,YAAA;AAAA,EACT,MAAA,EAAQ,WAAA;AAAA,EACR,MAAA,EAAQ,eAAA;AAAA,EACR,MAAA,EAAQ,WAAA;AAAA,EACR,OAAA,EAAS;AACX,CAAA;AAEO,SAAS,2BAAA,CAA4B,EAAE,QAAQ,CAAA,EAAwB;AAC5E,EAAA,uBAAO,qCAAA,MAAA,SAAe,GAAA,CAAI,IAAA,EAAe,EAAE,OAAO,CAAA,EAA4C;AAC5F,IAAA,MAAM,EAAE,KAAK,EAAA,EAAI,MAAM,MAAA;AACvB,IAAA,MAAM,KAAA,EAAO,IAAA,CAAK,MAAA,CAAO,CAAC,CAAA,EAAA,GAAM,EAAA,IAAM,KAAA,GAAQ,CAAC,CAAA,CAAE,QAAA,CAAS,GAAG,CAAC,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AACxE,IAAA,MAAM,SAAA,EAAW,wBAAA,OAAK,EAAS,IAAI,CAAA;AACnC,IAAA,IAAI;AACF,MAAA,MAAM,EAAA,EAAI,MAAM,4BAAA,QAAa,CAAA;AAC7B,MAAA,GAAA,CAAI,CAAC,CAAA,CAAE,MAAA,CAAO,CAAA,EAAG,OAAO,IAAI,yBAAA,CAAa,WAAA,EAAa,EAAE,MAAA,EAAQ,IAAI,CAAC,CAAA;AACrE,MAAA,MAAM,IAAA,EAAM,QAAA,CAAS,WAAA,CAAY,CAAA,CAAE,KAAA,CAAM,QAAA,CAAS,WAAA,CAAY,GAAG,CAAC,CAAA;AAClE,MAAA,MAAM,KAAA,mBAAO,IAAA,CAAK,GAAG,CAAA,UAAK,4BAAA;AAC1B,MAAA,MAAM,KAAA,EAAO,MAAM,gCAAA,QAAiB,CAAA;AACpC,MAAA,OAAO,IAAI,yBAAA,CAAa,IAAA,EAAM;AAAA,QAC5B,MAAA,EAAQ,GAAA;AAAA,QACR,OAAA,EAAS,EAAE,cAAA,EAAgB,IAAA,EAAM,eAAA,EAAiB,uBAAuB;AAAA,MAC3E,CAAC,CAAA;AAAA,IACH,EAAA,UAAQ;AACN,MAAA,OAAO,IAAI,yBAAA,CAAa,WAAA,EAAa,EAAE,MAAA,EAAQ,IAAI,CAAC,CAAA;AAAA,IACtD;AAAA,EACF,CAAA,EAjBO,KAAA,CAAA;AAkBT;AAnBgB,qCAAA,2BAAA,EAAA,6BAAA,CAAA;ADwBhB;AACE;AACF,kEAAC","file":"/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/features/help/server/createHelpAssetRouteHandler.js","sourcesContent":[null,"import { NextResponse } from \"next/server\";\nimport { readFile, stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\nconst MIME: Record<string, string> = {\n  \".png\": \"image/png\",\n  \".jpg\": \"image/jpeg\",\n  \".jpeg\": \"image/jpeg\",\n  \".webp\": \"image/webp\",\n  \".gif\": \"image/gif\",\n  \".svg\": \"image/svg+xml\",\n  \".mp4\": \"video/mp4\",\n  \".webm\": \"video/webm\",\n};\n\nexport function createHelpAssetRouteHandler({ srcRoot }: { srcRoot: string }) {\n  return async function GET(_req: Request, { params }: { params: Promise<{ path: string[] }> }) {\n    const { path } = await params;\n    const safe = path.filter((p) => p !== \"..\" && !p.includes(\"/\")).join(\"/\");\n    const filePath = join(srcRoot, safe);\n    try {\n      const s = await stat(filePath);\n      if (!s.isFile()) return new NextResponse(\"Not found\", { status: 404 });\n      const ext = filePath.toLowerCase().slice(filePath.lastIndexOf(\".\"));\n      const mime = MIME[ext] ?? \"application/octet-stream\";\n      const data = await readFile(filePath);\n      return new NextResponse(data, {\n        status: 200,\n        headers: { \"Content-Type\": mime, \"Cache-Control\": \"public, max-age=3600\" },\n      });\n    } catch {\n      return new NextResponse(\"Not found\", { status: 404 });\n    }\n  };\n}\n"]}

package/dist/features/help/server/createHelpAssetRouteHandler.mjs

@@ -1,43 +0,0 @@
-import {
-  __name
-} from "../../../chunk-PAWJFY3S.mjs";
-
-// src/features/help/server/createHelpAssetRouteHandler.ts
-import { NextResponse } from "next/server";
-import { readFile, stat } from "fs/promises";
-import { join } from "path";
-var MIME = {
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".webp": "image/webp",
-  ".gif": "image/gif",
-  ".svg": "image/svg+xml",
-  ".mp4": "video/mp4",
-  ".webm": "video/webm"
-};
-function createHelpAssetRouteHandler({ srcRoot }) {
-  return /* @__PURE__ */ __name(async function GET(_req, { params }) {
-    const { path } = await params;
-    const safe = path.filter((p) => p !== ".." && !p.includes("/")).join("/");
-    const filePath = join(srcRoot, safe);
-    try {
-      const s = await stat(filePath);
-      if (!s.isFile()) return new NextResponse("Not found", { status: 404 });
-      const ext = filePath.toLowerCase().slice(filePath.lastIndexOf("."));
-      const mime = MIME[ext] ?? "application/octet-stream";
-      const data = await readFile(filePath);
-      return new NextResponse(data, {
-        status: 200,
-        headers: { "Content-Type": mime, "Cache-Control": "public, max-age=3600" }
-      });
-    } catch {
-      return new NextResponse("Not found", { status: 404 });
-    }
-  }, "GET");
-}
-__name(createHelpAssetRouteHandler, "createHelpAssetRouteHandler");
-export {
-  createHelpAssetRouteHandler
-};
-//# sourceMappingURL=createHelpAssetRouteHandler.mjs.map

package/dist/features/help/server/createHelpAssetRouteHandler.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../src/features/help/server/createHelpAssetRouteHandler.ts"],"sourcesContent":["import { NextResponse } from \"next/server\";\nimport { readFile, stat } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\nconst MIME: Record<string, string> = {\n  \".png\": \"image/png\",\n  \".jpg\": \"image/jpeg\",\n  \".jpeg\": \"image/jpeg\",\n  \".webp\": \"image/webp\",\n  \".gif\": \"image/gif\",\n  \".svg\": \"image/svg+xml\",\n  \".mp4\": \"video/mp4\",\n  \".webm\": \"video/webm\",\n};\n\nexport function createHelpAssetRouteHandler({ srcRoot }: { srcRoot: string }) {\n  return async function GET(_req: Request, { params }: { params: Promise<{ path: string[] }> }) {\n    const { path } = await params;\n    const safe = path.filter((p) => p !== \"..\" && !p.includes(\"/\")).join(\"/\");\n    const filePath = join(srcRoot, safe);\n    try {\n      const s = await stat(filePath);\n      if (!s.isFile()) return new NextResponse(\"Not found\", { status: 404 });\n      const ext = filePath.toLowerCase().slice(filePath.lastIndexOf(\".\"));\n      const mime = MIME[ext] ?? \"application/octet-stream\";\n      const data = await readFile(filePath);\n      return new NextResponse(data, {\n        status: 200,\n        headers: { \"Content-Type\": mime, \"Cache-Control\": \"public, max-age=3600\" },\n      });\n    } catch {\n      return new NextResponse(\"Not found\", { status: 404 });\n    }\n  };\n}\n"],"mappings":";;;;;AAAA,SAAS,oBAAoB;AAC7B,SAAS,UAAU,YAAY;AAC/B,SAAS,YAAY;AAErB,IAAM,OAA+B;AAAA,EACnC,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AAAA,EACT,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,SAAS;AACX;AAEO,SAAS,4BAA4B,EAAE,QAAQ,GAAwB;AAC5E,SAAO,sCAAe,IAAI,MAAe,EAAE,OAAO,GAA4C;AAC5F,UAAM,EAAE,KAAK,IAAI,MAAM;AACvB,UAAM,OAAO,KAAK,OAAO,CAAC,MAAM,MAAM,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,EAAE,KAAK,GAAG;AACxE,UAAM,WAAW,KAAK,SAAS,IAAI;AACnC,QAAI;AACF,YAAM,IAAI,MAAM,KAAK,QAAQ;AAC7B,UAAI,CAAC,EAAE,OAAO,EAAG,QAAO,IAAI,aAAa,aAAa,EAAE,QAAQ,IAAI,CAAC;AACrE,YAAM,MAAM,SAAS,YAAY,EAAE,MAAM,SAAS,YAAY,GAAG,CAAC;AAClE,YAAM,OAAO,KAAK,GAAG,KAAK;AAC1B,YAAM,OAAO,MAAM,SAAS,QAAQ;AACpC,aAAO,IAAI,aAAa,MAAM;AAAA,QAC5B,QAAQ;AAAA,QACR,SAAS,EAAE,gBAAgB,MAAM,iBAAiB,uBAAuB;AAAA,MAC3E,CAAC;AAAA,IACH,QAAQ;AACN,aAAO,IAAI,aAAa,aAAa,EAAE,QAAQ,IAAI,CAAC;AAAA,IACtD;AAAA,EACF,GAjBO;AAkBT;AAnBgB;","names":[]}

package/dist/help-content-config.interface-B9L02u9i.d.mts

@@ -1,50 +0,0 @@
-/**
- * Local copy of the help-article types to keep this published frontend library
- * decoupled from `@carlonicora/nestjs-neo4jsonapi`. Must stay in sync with
- * `packages/nestjs-neo4jsonapi/src/foundations/help-content-sync/interfaces/help-article.interface.ts`.
- */
-declare const HELP_MODES: readonly ["tutorial", "how-to", "reference", "explanation"];
-type HelpMode = (typeof HELP_MODES)[number];
-interface HelpHeading {
-    depth: 2 | 3;
-    slug: string;
-    text: string;
-}
-interface HelpArticle {
-    id: string;
-    slug: string;
-    mode: HelpMode;
-    title: string;
-    summary: string;
-    order: number;
-    tags: readonly string[];
-    contextualKeys: readonly string[];
-    aiIndexed: boolean;
-    draft: boolean;
-    contentHash: string;
-    path: string;
-    headings: readonly HelpHeading[];
-    relatedSlugs: readonly string[];
-    lastUpdated: string;
-}
-interface HelpRedirect {
-    from: string;
-    to: string;
-}
-
-interface HelpBrandConfig {
-    /** URL of the brand logo image (served by the consuming app). */
-    logo?: string;
-    /** Brand label shown in the help header. */
-    label?: string;
-    /** Where the "Open app" button navigates for logged-in users. Defaults to "/". */
-    appHref?: string;
-}
-interface HelpContentConfig {
-    manifest: readonly HelpArticle[];
-    namespaceUuid: string;
-    redirects?: readonly HelpRedirect[];
-    brand?: HelpBrandConfig;
-}
-
-export { type HelpContentConfig as H, type HelpArticle as a, type HelpMode as b, type HelpBrandConfig as c, HELP_MODES as d, type HelpHeading as e, type HelpRedirect as f };

package/dist/help-content-config.interface-B9L02u9i.d.ts

@@ -1,50 +0,0 @@
-/**
- * Local copy of the help-article types to keep this published frontend library
- * decoupled from `@carlonicora/nestjs-neo4jsonapi`. Must stay in sync with
- * `packages/nestjs-neo4jsonapi/src/foundations/help-content-sync/interfaces/help-article.interface.ts`.
- */
-declare const HELP_MODES: readonly ["tutorial", "how-to", "reference", "explanation"];
-type HelpMode = (typeof HELP_MODES)[number];
-interface HelpHeading {
-    depth: 2 | 3;
-    slug: string;
-    text: string;
-}
-interface HelpArticle {
-    id: string;
-    slug: string;
-    mode: HelpMode;
-    title: string;
-    summary: string;
-    order: number;
-    tags: readonly string[];
-    contextualKeys: readonly string[];
-    aiIndexed: boolean;
-    draft: boolean;
-    contentHash: string;
-    path: string;
-    headings: readonly HelpHeading[];
-    relatedSlugs: readonly string[];
-    lastUpdated: string;
-}
-interface HelpRedirect {
-    from: string;
-    to: string;
-}
-
-interface HelpBrandConfig {
-    /** URL of the brand logo image (served by the consuming app). */
-    logo?: string;
-    /** Brand label shown in the help header. */
-    label?: string;
-    /** Where the "Open app" button navigates for logged-in users. Defaults to "/". */
-    appHref?: string;
-}
-interface HelpContentConfig {
-    manifest: readonly HelpArticle[];
-    namespaceUuid: string;
-    redirects?: readonly HelpRedirect[];
-    brand?: HelpBrandConfig;
-}
-
-export { type HelpContentConfig as H, type HelpArticle as a, type HelpMode as b, type HelpBrandConfig as c, HELP_MODES as d, type HelpHeading as e, type HelpRedirect as f };

package/src/features/help/components/mdx/Callout.tsx

@@ -1,21 +0,0 @@
-import { InfoIcon, AlertTriangleIcon, LightbulbIcon, XCircleIcon, LucideIcon } from "lucide-react";
-import { ReactNode } from "react";
-
-type CalloutType = "info" | "warning" | "tip" | "danger";
-
-const STYLES: Record<CalloutType, { icon: LucideIcon; ring: string }> = {
-  info: { icon: InfoIcon, ring: "ring-blue-500/30 bg-blue-500/5" },
-  warning: { icon: AlertTriangleIcon, ring: "ring-amber-500/30 bg-amber-500/5" },
-  tip: { icon: LightbulbIcon, ring: "ring-emerald-500/30 bg-emerald-500/5" },
-  danger: { icon: XCircleIcon, ring: "ring-rose-500/30 bg-rose-500/5" },
-};
-
-export function Callout({ type = "info", children }: { type?: CalloutType; children: ReactNode }) {
-  const { icon: Icon, ring } = STYLES[type];
-  return (
-    <div className={`my-4 flex gap-3 rounded-md ring-1 p-3 ${ring}`}>
-      <Icon className="mt-0.5 h-4 w-4 shrink-0" />
-      <div className="text-sm leading-relaxed">{children}</div>
-    </div>
-  );
-}

package/src/features/help/components/mdx/EntityRef.tsx

@@ -1,18 +0,0 @@
-import { Modules } from "../../../../core";
-import { ReactNode } from "react";
-
-export function EntityRef({ type, children }: { type: string; children: ReactNode }) {
-  let Icon: React.ComponentType<{ className?: string }> | null = null;
-  try {
-    const m = Modules.findByName(type);
-    Icon = m.icon ?? null;
-  } catch {
-    Icon = null;
-  }
-  return (
-    <span className="bg-muted text-foreground/90 inline-flex items-center gap-1 rounded px-1.5 py-0.5 align-middle text-xs">
-      {Icon ? <Icon className="h-3 w-3" /> : null}
-      {children}
-    </span>
-  );
-}

package/src/features/help/components/mdx/KeyBinding.tsx

@@ -1,6 +0,0 @@
-import { ReactNode } from "react";
-export function KeyBinding({ children }: { children: ReactNode }) {
-  return (
-    <kbd className="bg-muted text-muted-foreground rounded border px-1.5 py-0.5 text-xs font-medium">{children}</kbd>
-  );
-}

package/src/features/help/components/mdx/Related.tsx

@@ -1,33 +0,0 @@
-"use client";
-import Link from "next/link";
-import { useTranslations } from "next-intl";
-import { useHelp } from "../../contexts/HelpContext";
-import { usePageUrlGenerator } from "../../../../client";
-import { articleUrl } from "../../utils/articleUrl";
-
-export function Related({ slugs }: { slugs: string[] }) {
-  const t = useTranslations();
-  const generateUrl = usePageUrlGenerator();
-  const { manifest } = useHelp();
-  const items = slugs
-    .map((s) => manifest.find((a) => `${a.mode}/${a.slug}` === s))
-    .filter((a): a is NonNullable<typeof a> => Boolean(a));
-  if (items.length === 0) return null;
-  return (
-    <aside className="my-6">
-      <h3 className="text-muted-foreground mb-2 text-xs font-semibold tracking-wider uppercase">
-        {t("help.article.related")}
-      </h3>
-      <ul className="grid gap-2 sm:grid-cols-2">
-        {items.map((a) => (
-          <li key={a.id}>
-            <Link href={articleUrl(generateUrl, a)} className="hover:bg-muted block rounded border p-3">
-              <div className="font-medium">{a.title}</div>
-              <div className="text-muted-foreground text-xs">{a.summary}</div>
-            </Link>
-          </li>
-        ))}
-      </ul>
-    </aside>
-  );
-}

package/src/features/help/components/mdx/Screenshot.tsx

@@ -1,9 +0,0 @@
-export function Screenshot({ src, alt, caption }: { src: string; alt?: string; caption?: string }) {
-  const url = src.startsWith("/") ? src : `/help-assets/${src}`;
-  return (
-    <figure className="my-4">
-      <img src={url} alt={alt ?? caption ?? ""} className="rounded-md ring-1 ring-border" />
-      {caption ? <figcaption className="text-muted-foreground mt-1 text-xs">{caption}</figcaption> : null}
-    </figure>
-  );
-}

package/src/features/help/components/mdx/Steps.tsx

@@ -1,21 +0,0 @@
-import { ReactNode, Children } from "react";
-
-export function Steps({ children }: { children: ReactNode }) {
-  const items = Children.toArray(children);
-  return (
-    <ol className="my-4 list-none space-y-3 pl-0">
-      {items.map((child, i) => (
-        <li key={i} className="flex gap-3">
-          <span className="bg-muted text-muted-foreground flex h-6 w-6 shrink-0 items-center justify-center rounded-full text-xs">
-            {i + 1}
-          </span>
-          <div className="flex-1 [&>p:first-child]:mt-0">{child}</div>
-        </li>
-      ))}
-    </ol>
-  );
-}
-
-export function Step({ children }: { children: ReactNode }) {
-  return <>{children}</>;
-}

package/src/features/help/components/mdx/Video.tsx

@@ -1,8 +0,0 @@
-export function Video({ src, poster }: { src: string; poster?: string }) {
-  const url = src.startsWith("/") ? src : `/help-assets/${src}`;
-  return (
-    <video controls preload="metadata" poster={poster} className="my-4 w-full rounded-md ring-1 ring-border">
-      <source src={url} />
-    </video>
-  );
-}

package/src/features/help/components/mdx/mdx-server-components.ts

@@ -1,23 +0,0 @@
-// Server-safe subset of MDX_COMPONENTS used by `renderHelpArticle`.
-// Mirrors `mdxComponents.ts` but EXCLUDES `Related` (which is a client
-// component that uses `useHelp` + `usePageUrlGenerator`). Server-side rendering
-// of `<Related>` would require passing the manifest by prop, which the standard
-// MDX components map cannot do — articles that need related links should be
-// extended via a server-side render hook rather than the MDX shortcode.
-
-import { Callout } from "./Callout";
-import { Steps, Step } from "./Steps";
-import { Screenshot } from "./Screenshot";
-import { EntityRef } from "./EntityRef";
-import { KeyBinding } from "./KeyBinding";
-import { Video } from "./Video";
-
-export const MDX_SERVER_COMPONENTS = {
-  Callout,
-  Steps,
-  Step,
-  Screenshot,
-  EntityRef,
-  KeyBinding,
-  Video,
-} as const;

package/src/features/help/components/mdx/mdxComponents.ts

@@ -1,9 +0,0 @@
-import { Callout } from "./Callout";
-import { Steps, Step } from "./Steps";
-import { Screenshot } from "./Screenshot";
-import { EntityRef } from "./EntityRef";
-import { KeyBinding } from "./KeyBinding";
-import { Video } from "./Video";
-import { Related } from "./Related";
-
-export const MDX_COMPONENTS = { Callout, Steps, Step, Screenshot, EntityRef, KeyBinding, Video, Related };

package/src/features/help/hooks/useHelpArticle.ts

@@ -1,7 +0,0 @@
-"use client";
-import { useHelp } from "../contexts/HelpContext";
-import { findHelpArticle } from "../utils/helpNavigation";
-
-export function useHelpArticle(mode: string, slug: string) {
-  return findHelpArticle(useHelp().manifest, mode, slug);
-}

package/src/features/help/hooks/useHelpManifest.ts

@@ -1,5 +0,0 @@
-"use client";
-import { useHelp } from "../contexts/HelpContext";
-export function useHelpManifest() {
-  return useHelp().manifest;
-}

package/src/features/help/server/__tests__/createHelpAssetRouteHandler.spec.ts

@@ -1,43 +0,0 @@
-import { describe, it, expect, beforeAll, afterAll } from "vitest";
-import { mkdtemp, writeFile, mkdir, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { createHelpAssetRouteHandler } from "../createHelpAssetRouteHandler";
-
-describe("createHelpAssetRouteHandler", () => {
-  let srcRoot: string;
-
-  beforeAll(async () => {
-    srcRoot = await mkdtemp(join(tmpdir(), "help-assets-"));
-    await mkdir(srcRoot, { recursive: true });
-    await writeFile(join(srcRoot, "ok.png"), Buffer.from([0x89, 0x50, 0x4e, 0x47]));
-  });
-  afterAll(async () => {
-    await rm(srcRoot, { recursive: true, force: true });
-  });
-
-  it("returns 200 with correct MIME for an existing PNG", async () => {
-    const GET = createHelpAssetRouteHandler({ srcRoot });
-    const res = await GET(new Request("http://localhost/help-assets/ok.png"), {
-      params: Promise.resolve({ path: ["ok.png"] }),
-    });
-    expect(res.status).toBe(200);
-    expect(res.headers.get("Content-Type")).toBe("image/png");
-  });
-
-  it("returns 404 for missing files", async () => {
-    const GET = createHelpAssetRouteHandler({ srcRoot });
-    const res = await GET(new Request("http://localhost/help-assets/missing.png"), {
-      params: Promise.resolve({ path: ["missing.png"] }),
-    });
-    expect(res.status).toBe(404);
-  });
-
-  it("sanitizes path traversal attempts", async () => {
-    const GET = createHelpAssetRouteHandler({ srcRoot });
-    const res = await GET(new Request("http://localhost/help-assets/etc/passwd"), {
-      params: Promise.resolve({ path: ["..", "..", "etc", "passwd"] }),
-    });
-    expect(res.status).toBe(404);
-  });
-});

package/src/features/help/server/createHelpAssetRouteHandler.ts

@@ -1,35 +0,0 @@
-import { NextResponse } from "next/server";
-import { readFile, stat } from "node:fs/promises";
-import { join } from "node:path";
-
-const MIME: Record<string, string> = {
-  ".png": "image/png",
-  ".jpg": "image/jpeg",
-  ".jpeg": "image/jpeg",
-  ".webp": "image/webp",
-  ".gif": "image/gif",
-  ".svg": "image/svg+xml",
-  ".mp4": "video/mp4",
-  ".webm": "video/webm",
-};
-
-export function createHelpAssetRouteHandler({ srcRoot }: { srcRoot: string }) {
-  return async function GET(_req: Request, { params }: { params: Promise<{ path: string[] }> }) {
-    const { path } = await params;
-    const safe = path.filter((p) => p !== ".." && !p.includes("/")).join("/");
-    const filePath = join(srcRoot, safe);
-    try {
-      const s = await stat(filePath);
-      if (!s.isFile()) return new NextResponse("Not found", { status: 404 });
-      const ext = filePath.toLowerCase().slice(filePath.lastIndexOf("."));
-      const mime = MIME[ext] ?? "application/octet-stream";
-      const data = await readFile(filePath);
-      return new NextResponse(data, {
-        status: 200,
-        headers: { "Content-Type": mime, "Cache-Control": "public, max-age=3600" },
-      });
-    } catch {
-      return new NextResponse("Not found", { status: 404 });
-    }
-  };
-}

package/src/features/help/server/generateHelpArticleMetadata.ts

@@ -1,18 +0,0 @@
-import type { Metadata } from "next";
-import { findHelpArticle } from "../utils/helpNavigation";
-import { getHelpContent } from "./getHelpContent";
-
-export async function generateHelpArticleMetadata({
-  params,
-}: {
-  params: Promise<{ mode: string; slug: string }>;
-}): Promise<Metadata> {
-  const { mode, slug } = await params;
-  const article = findHelpArticle(getHelpContent().manifest, mode, slug);
-  if (!article) return {};
-  return {
-    title: article.title,
-    description: article.summary,
-    openGraph: { title: article.title, description: article.summary },
-  };
-}

package/src/features/help/server/generateHelpArticleStaticParams.ts

@@ -1,7 +0,0 @@
-import { getHelpContent } from "./getHelpContent";
-
-export function generateHelpArticleStaticParams(): { mode: string; slug: string }[] {
-  return getHelpContent()
-    .manifest.filter((a) => !a.draft)
-    .map((a) => ({ mode: a.mode, slug: a.slug }));
-}

package/src/features/help/server/generateHelpModeStaticParams.ts

@@ -1,5 +0,0 @@
-import { HELP_MODES } from "../types/help-article.types";
-
-export function generateHelpModeStaticParams(): { mode: string }[] {
-  return HELP_MODES.map((mode) => ({ mode }));
-}

package/src/features/help/server/getHelpContent.ts

@@ -1,17 +0,0 @@
-import { _getStaticHelpContent } from "../../../core/registry/helpStore";
-import type { HelpContentConfig } from "../interfaces/help-content-config.interface";
-
-/**
- * Server-side accessor for the help-content config set via configureJsonApi().
- * Returns the same value <HelpProvider> exposes via React Context to client components.
- * Throws with a setup error if helpContent was never configured.
- */
-export function getHelpContent(): HelpContentConfig {
-  const cfg = _getStaticHelpContent<HelpContentConfig>();
-  if (!cfg) {
-    throw new Error(
-      "Help content not configured — call configureJsonApi({ helpContent: {...} }) before importing help pages.",
-    );
-  }
-  return cfg;
-}

package/src/features/help/server/index.ts

@@ -1,8 +0,0 @@
-export { getHelpContent } from "./getHelpContent";
-export { renderHelpArticle, serializeHelpArticle } from "./serializeHelpArticle";
-export { generateHelpArticleStaticParams } from "./generateHelpArticleStaticParams";
-export { generateHelpArticleMetadata } from "./generateHelpArticleMetadata";
-export { generateHelpModeStaticParams } from "./generateHelpModeStaticParams";
-// NOTE: `createHelpAssetRouteHandler` is intentionally NOT re-exported here.
-// It uses `node:fs/promises` and must only be reachable via the dedicated
-// `@carlonicora/nextjs-jsonapi/help-asset-route` subpath, never the main bundle.

package/src/features/help/server/serializeHelpArticle.tsx

@@ -1,46 +0,0 @@
-import { MDXRemote } from "next-mdx-remote/rsc";
-import remarkGfm from "remark-gfm";
-import rehypeSlug from "rehype-slug";
-import rehypeAutolinkHeadings from "rehype-autolink-headings";
-import type { ReactElement } from "react";
-import type { HelpArticle } from "../types/help-article.types";
-import { _getStaticHelpReader } from "../../../core/registry/helpStore";
-import { MDX_SERVER_COMPONENTS } from "../components/mdx/mdx-server-components";
-
-/**
- * Server-side: read the article's raw markdown via the registered help reader
- * and render it through `next-mdx-remote/rsc`'s server-side MDXRemote, using
- * the server-safe MDX components (Callout, Steps, Screenshot, EntityRef,
- * KeyBinding, Video). The returned React element can be embedded inside a
- * server component (e.g. as `children` of `<HelpArticleBody>`).
- *
- * Note: `<Related>` is intentionally not part of the server map — it's a client
- * component that reads HelpContext. Articles that reference `<Related>` would
- * need a separate render path that injects the manifest by prop.
- */
-export async function renderHelpArticle(article: HelpArticle): Promise<ReactElement> {
-  const readRawMarkdown = _getStaticHelpReader();
-  if (!readRawMarkdown) {
-    throw new Error(
-      "Help reader not configured. Call setHelpReader(fn) from a server-only entrypoint (e.g. Next.js instrumentation register()) before rendering help articles.",
-    );
-  }
-  const source = await readRawMarkdown(article);
-  return (
-    <MDXRemote
-      source={source}
-      components={MDX_SERVER_COMPONENTS}
-      options={{
-        parseFrontmatter: true,
-        mdxOptions: {
-          remarkPlugins: [remarkGfm],
-          rehypePlugins: [rehypeSlug, [rehypeAutolinkHeadings, { behavior: "wrap" }]],
-        },
-      }}
-    />
-  );
-}
-
-/** @deprecated Use `renderHelpArticle` instead — the legacy serialize + client
- *  MDXRemote pattern is incompatible with App Router RSC. */
-export const serializeHelpArticle = renderHelpArticle;