@carlonicora/nextjs-jsonapi 1.108.0 → 1.109.0

package/dist/chunk-MZTKPPET.mjs

@@ -0,0 +1,123 @@
+import {
+  Modules
+} from "./chunk-MSNNAHDB.mjs";
+import {
+  __name
+} from "./chunk-PAWJFY3S.mjs";
+
+// src/features/help/types/help-article.types.ts
+var HELP_MODES = ["tutorial", "how-to", "reference", "explanation"];
+
+// src/features/help/utils/helpNavigation.ts
+function buildHelpNav(manifest) {
+  return HELP_MODES.map((mode) => ({
+    mode,
+    articles: manifest.filter((a) => a.mode === mode && !a.draft).sort((a, b) => a.order - b.order)
+  }));
+}
+__name(buildHelpNav, "buildHelpNav");
+function findHelpArticle(manifest, mode, slug) {
+  return manifest.find((a) => a.mode === mode && a.slug === slug);
+}
+__name(findHelpArticle, "findHelpArticle");
+function prevNextWithinMode(manifest, current) {
+  const siblings = manifest.filter((a) => a.mode === current.mode && !a.draft).sort((a, b) => a.order - b.order);
+  const idx = siblings.findIndex((a) => a.slug === current.slug);
+  return {
+    prev: idx > 0 ? siblings[idx - 1] : null,
+    next: idx >= 0 && idx < siblings.length - 1 ? siblings[idx + 1] : null
+  };
+}
+__name(prevNextWithinMode, "prevNextWithinMode");
+
+// src/features/help/components/mdx/Callout.tsx
+import { InfoIcon, AlertTriangleIcon, LightbulbIcon, XCircleIcon } from "lucide-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var STYLES = {
+  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" }
+};
+function Callout({ type = "info", children }) {
+  const { icon: Icon, ring } = STYLES[type];
+  return /* @__PURE__ */ jsxs("div", { className: `my-4 flex gap-3 rounded-md ring-1 p-3 ${ring}`, children: [
+    /* @__PURE__ */ jsx(Icon, { className: "mt-0.5 h-4 w-4 shrink-0" }),
+    /* @__PURE__ */ jsx("div", { className: "text-sm leading-relaxed", children })
+  ] });
+}
+__name(Callout, "Callout");
+
+// src/features/help/components/mdx/Steps.tsx
+import { Children } from "react";
+import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function Steps({ children }) {
+  const items = Children.toArray(children);
+  return /* @__PURE__ */ jsx2("ol", { className: "my-4 list-none space-y-3 pl-0", children: items.map((child, i) => /* @__PURE__ */ jsxs2("li", { className: "flex gap-3", children: [
+    /* @__PURE__ */ jsx2("span", { className: "bg-muted text-muted-foreground flex h-6 w-6 shrink-0 items-center justify-center rounded-full text-xs", children: i + 1 }),
+    /* @__PURE__ */ jsx2("div", { className: "flex-1 [&>p:first-child]:mt-0", children: child })
+  ] }, i)) });
+}
+__name(Steps, "Steps");
+function Step({ children }) {
+  return /* @__PURE__ */ jsx2(Fragment, { children });
+}
+__name(Step, "Step");
+
+// src/features/help/components/mdx/Screenshot.tsx
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function Screenshot({ src, alt, caption }) {
+  const url = src.startsWith("/") ? src : `/help-assets/${src}`;
+  return /* @__PURE__ */ jsxs3("figure", { className: "my-4", children: [
+    /* @__PURE__ */ jsx3("img", { src: url, alt: alt ?? caption ?? "", className: "rounded-md ring-1 ring-border" }),
+    caption ? /* @__PURE__ */ jsx3("figcaption", { className: "text-muted-foreground mt-1 text-xs", children: caption }) : null
+  ] });
+}
+__name(Screenshot, "Screenshot");
+
+// src/features/help/components/mdx/EntityRef.tsx
+import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
+function EntityRef({ type, children }) {
+  let Icon = null;
+  try {
+    const m = Modules.findByName(type);
+    Icon = m.icon ?? null;
+  } catch {
+    Icon = null;
+  }
+  return /* @__PURE__ */ jsxs4("span", { className: "bg-muted text-foreground/90 inline-flex items-center gap-1 rounded px-1.5 py-0.5 align-middle text-xs", children: [
+    Icon ? /* @__PURE__ */ jsx4(Icon, { className: "h-3 w-3" }) : null,
+    children
+  ] });
+}
+__name(EntityRef, "EntityRef");
+
+// src/features/help/components/mdx/KeyBinding.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+function KeyBinding({ children }) {
+  return /* @__PURE__ */ jsx5("kbd", { className: "bg-muted text-muted-foreground rounded border px-1.5 py-0.5 text-xs font-medium", children });
+}
+__name(KeyBinding, "KeyBinding");
+
+// src/features/help/components/mdx/Video.tsx
+import { jsx as jsx6 } from "react/jsx-runtime";
+function Video({ src, poster }) {
+  const url = src.startsWith("/") ? src : `/help-assets/${src}`;
+  return /* @__PURE__ */ jsx6("video", { controls: true, preload: "metadata", poster, className: "my-4 w-full rounded-md ring-1 ring-border", children: /* @__PURE__ */ jsx6("source", { src: url }) });
+}
+__name(Video, "Video");
+
+export {
+  HELP_MODES,
+  buildHelpNav,
+  findHelpArticle,
+  prevNextWithinMode,
+  Callout,
+  Steps,
+  Step,
+  Screenshot,
+  EntityRef,
+  KeyBinding,
+  Video
+};
+//# sourceMappingURL=chunk-MZTKPPET.mjs.map

package/dist/chunk-MZTKPPET.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/features/help/types/help-article.types.ts","../src/features/help/utils/helpNavigation.ts","../src/features/help/components/mdx/Callout.tsx","../src/features/help/components/mdx/Steps.tsx","../src/features/help/components/mdx/Screenshot.tsx","../src/features/help/components/mdx/EntityRef.tsx","../src/features/help/components/mdx/KeyBinding.tsx","../src/features/help/components/mdx/Video.tsx"],"sourcesContent":["/**\n * Local copy of the help-article types to keep this published frontend library\n * decoupled from `@carlonicora/nestjs-neo4jsonapi`. Must stay in sync with\n * `packages/nestjs-neo4jsonapi/src/foundations/help-content-sync/interfaces/help-article.interface.ts`.\n */\n\nexport const HELP_MODES = [\"tutorial\", \"how-to\", \"reference\", \"explanation\"] as const;\nexport type HelpMode = (typeof HELP_MODES)[number];\n\nexport interface HelpHeading {\n  depth: 2 | 3;\n  slug: string;\n  text: string;\n}\n\nexport interface HelpArticle {\n  id: string;\n  slug: string;\n  mode: HelpMode;\n  title: string;\n  summary: string;\n  order: number;\n  tags: readonly string[];\n  contextualKeys: readonly string[];\n  aiIndexed: boolean;\n  draft: boolean;\n  contentHash: string;\n  path: string;\n  headings: readonly HelpHeading[];\n  relatedSlugs: readonly string[];\n  lastUpdated: string;\n}\n\nexport interface HelpRedirect {\n  from: string;\n  to: string;\n}\n","import { HELP_MODES, type HelpArticle, type HelpMode } from \"../types/help-article.types\";\n\nexport interface HelpNavGroup {\n  mode: HelpMode;\n  articles: HelpArticle[];\n}\n\nexport function buildHelpNav(manifest: readonly HelpArticle[]): HelpNavGroup[] {\n  return HELP_MODES.map((mode) => ({\n    mode,\n    articles: manifest.filter((a) => a.mode === mode && !a.draft).sort((a, b) => a.order - b.order),\n  }));\n}\n\nexport function findHelpArticle(manifest: readonly HelpArticle[], mode: string, slug: string): HelpArticle | undefined {\n  return manifest.find((a) => a.mode === mode && a.slug === slug);\n}\n\nexport function prevNextWithinMode(\n  manifest: readonly HelpArticle[],\n  current: HelpArticle,\n): { prev: HelpArticle | null; next: HelpArticle | null } {\n  const siblings = manifest.filter((a) => a.mode === current.mode && !a.draft).sort((a, b) => a.order - b.order);\n  const idx = siblings.findIndex((a) => a.slug === current.slug);\n  return {\n    prev: idx > 0 ? siblings[idx - 1] : null,\n    next: idx >= 0 && idx < siblings.length - 1 ? siblings[idx + 1] : null,\n  };\n}\n","import { InfoIcon, AlertTriangleIcon, LightbulbIcon, XCircleIcon, LucideIcon } from \"lucide-react\";\nimport { ReactNode } from \"react\";\n\ntype CalloutType = \"info\" | \"warning\" | \"tip\" | \"danger\";\n\nconst STYLES: Record<CalloutType, { icon: LucideIcon; ring: string }> = {\n  info: { icon: InfoIcon, ring: \"ring-blue-500/30 bg-blue-500/5\" },\n  warning: { icon: AlertTriangleIcon, ring: \"ring-amber-500/30 bg-amber-500/5\" },\n  tip: { icon: LightbulbIcon, ring: \"ring-emerald-500/30 bg-emerald-500/5\" },\n  danger: { icon: XCircleIcon, ring: \"ring-rose-500/30 bg-rose-500/5\" },\n};\n\nexport function Callout({ type = \"info\", children }: { type?: CalloutType; children: ReactNode }) {\n  const { icon: Icon, ring } = STYLES[type];\n  return (\n    <div className={`my-4 flex gap-3 rounded-md ring-1 p-3 ${ring}`}>\n      <Icon className=\"mt-0.5 h-4 w-4 shrink-0\" />\n      <div className=\"text-sm leading-relaxed\">{children}</div>\n    </div>\n  );\n}\n","import { ReactNode, Children } from \"react\";\n\nexport function Steps({ children }: { children: ReactNode }) {\n  const items = Children.toArray(children);\n  return (\n    <ol className=\"my-4 list-none space-y-3 pl-0\">\n      {items.map((child, i) => (\n        <li key={i} className=\"flex gap-3\">\n          <span className=\"bg-muted text-muted-foreground flex h-6 w-6 shrink-0 items-center justify-center rounded-full text-xs\">\n            {i + 1}\n          </span>\n          <div className=\"flex-1 [&>p:first-child]:mt-0\">{child}</div>\n        </li>\n      ))}\n    </ol>\n  );\n}\n\nexport function Step({ children }: { children: ReactNode }) {\n  return <>{children}</>;\n}\n","export function Screenshot({ src, alt, caption }: { src: string; alt?: string; caption?: string }) {\n  const url = src.startsWith(\"/\") ? src : `/help-assets/${src}`;\n  return (\n    <figure className=\"my-4\">\n      <img src={url} alt={alt ?? caption ?? \"\"} className=\"rounded-md ring-1 ring-border\" />\n      {caption ? <figcaption className=\"text-muted-foreground mt-1 text-xs\">{caption}</figcaption> : null}\n    </figure>\n  );\n}\n","import { Modules } from \"../../../../core\";\nimport { ReactNode } from \"react\";\n\nexport function EntityRef({ type, children }: { type: string; children: ReactNode }) {\n  let Icon: React.ComponentType<{ className?: string }> | null = null;\n  try {\n    const m = Modules.findByName(type);\n    Icon = m.icon ?? null;\n  } catch {\n    Icon = null;\n  }\n  return (\n    <span className=\"bg-muted text-foreground/90 inline-flex items-center gap-1 rounded px-1.5 py-0.5 align-middle text-xs\">\n      {Icon ? <Icon className=\"h-3 w-3\" /> : null}\n      {children}\n    </span>\n  );\n}\n","import { ReactNode } from \"react\";\nexport function KeyBinding({ children }: { children: ReactNode }) {\n  return (\n    <kbd className=\"bg-muted text-muted-foreground rounded border px-1.5 py-0.5 text-xs font-medium\">{children}</kbd>\n  );\n}\n","export function Video({ src, poster }: { src: string; poster?: string }) {\n  const url = src.startsWith(\"/\") ? src : `/help-assets/${src}`;\n  return (\n    <video controls preload=\"metadata\" poster={poster} className=\"my-4 w-full rounded-md ring-1 ring-border\">\n      <source src={url} />\n    </video>\n  );\n}\n"],"mappings":"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","names":["jsx","jsxs","jsx","jsxs","jsx","jsxs","jsx","jsx"]}