@flamingo-stack/openframe-frontend-core 0.0.739 → 0.0.741

package/dist/components/product-demo/screens/scripts.js

@@ -0,0 +1,130 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useMemo } from "react";
+import {
+  EXECUTION_COLUMNS,
+  ScriptExecutionResult,
+  ScriptExecutionsTable,
+  ScriptShellBadge
+} from "../../features/scripts/index.js";
+import { TimerIcon } from "../../icons-v2-generated/date-and-time/timer-icon.js";
+import { TruncateText } from "../../ui/truncate-text.js";
+import { useProductDemoCast } from "../cast.js";
+import { buildScriptsFixture } from "../fixtures/scripts.js";
+const WIDE_HIDDEN_COLUMNS = ["result", "open"];
+const COMPACT_COLUMNS = [
+  { ...EXECUTION_COLUMNS.machineId, width: "flex-1 min-w-0", hideAt: void 0 },
+  EXECUTION_COLUMNS.status
+];
+const COMPACT_ROWS = 4;
+const TOKEN_CLASS = {
+  comment: "italic text-ods-text-tertiary",
+  keyword: "text-ods-warning",
+  string: "text-ods-flamingo-cyan",
+  variable: "text-ods-flamingo-cyan",
+  command: "text-ods-success",
+  parameter: "text-ods-text-secondary",
+  number: "text-ods-open-yellow",
+  plain: "text-ods-text-primary"
+};
+const TOKEN_PATTERN = /(#.*$)|("(?:[^"\\]|\\.)*"|'[^']*')|(\$[\w:]+)|\b(foreach|in|if|else|exit|return|param)\b|\b([A-Z][a-z]+-[A-Z][A-Za-z]+)\b|(-[A-Za-z]+)\b|\b(\d+(?:GB|MB|KB)?)\b/g;
+const TOKEN_KINDS = [
+  "comment",
+  "string",
+  "variable",
+  "keyword",
+  "command",
+  "parameter",
+  "number"
+];
+function tokenize(line) {
+  const tokens = [];
+  let last = 0;
+  for (const match of line.matchAll(TOKEN_PATTERN)) {
+    const start = match.index ?? 0;
+    if (start > last) tokens.push({ text: line.slice(last, start), kind: "plain" });
+    const group = match.slice(1).findIndex(Boolean);
+    tokens.push({ text: match[0], kind: TOKEN_KINDS[group] ?? "plain" });
+    last = start + match[0].length;
+  }
+  if (last < line.length) tokens.push({ text: line.slice(last), kind: "plain" });
+  return tokens;
+}
+function ScriptCodePicture({ script }) {
+  const lines = useMemo(
+    () => script.code.split("\n").map((line, index) => ({ number: index + 1, tokens: tokenize(line) })),
+    [script.code]
+  );
+  const { schedule, provenance } = script;
+  return /* @__PURE__ */ jsxs(
+    "section",
+    {
+      "aria-label": script.name,
+      className: "flex h-full min-w-0 flex-col overflow-hidden rounded-[8px] border border-ods-border bg-ods-card",
+      children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-[var(--spacing-system-xxs)] border-b border-ods-border p-[var(--spacing-system-m)]", children: [
+          /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 items-center justify-between gap-[var(--spacing-system-m)]", children: [
+            /* @__PURE__ */ jsx(TruncateText, { variant: "h4", children: script.name }),
+            /* @__PURE__ */ jsxs("span", { className: "flex shrink-0 items-center gap-[var(--spacing-system-xxs)] text-ods-text-primary text-h6", children: [
+              /* @__PURE__ */ jsx(TimerIcon, { className: "size-4 text-ods-text-secondary" }),
+              `${schedule.repeat} ${schedule.time} \xB7 ${schedule.deviceCount} devices`
+            ] })
+          ] }),
+          /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 items-center justify-between gap-[var(--spacing-system-m)]", children: [
+            /* @__PURE__ */ jsx(TruncateText, { variant: "h6", tone: "secondary", children: `Written by ${provenance.author} \xB7 approved by ${provenance.approver}` }),
+            /* @__PURE__ */ jsx(
+              ScriptShellBadge,
+              {
+                value: script.shellType,
+                className: "shrink-0 text-ods-text-secondary text-h6",
+                iconClassName: "size-4"
+              }
+            )
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx("pre", { className: "m-0 min-h-0 flex-1 overflow-hidden bg-ods-bg py-3 font-mono text-[14px] leading-[22px]", children: lines.map((line) => /* @__PURE__ */ jsxs("div", { className: "flex", children: [
+          /* @__PURE__ */ jsx("span", { className: "w-[46px] shrink-0 select-none pr-[4px] text-right text-ods-text-tertiary", children: line.number }),
+          /* @__PURE__ */ jsx("code", { className: "whitespace-pre pl-[32px]", children: line.tokens.map((token, at) => /* @__PURE__ */ jsx("span", { className: TOKEN_CLASS[token.kind], children: token.text }, `${at}-${token.text}`)) })
+        ] }, line.number)) })
+      ]
+    }
+  );
+}
+function ScriptsScreen({ compact = false }) {
+  const cast = useProductDemoCast();
+  const fixture = useMemo(() => buildScriptsFixture(cast), [cast]);
+  if (compact) {
+    return (
+      // Four runs of the card's row height fill the frame; the padding is what is left round them.
+      /* @__PURE__ */ jsx("div", { className: "h-full overflow-hidden bg-ods-bg p-[var(--spacing-system-xsf)]", children: /* @__PURE__ */ jsx(
+        ScriptExecutionsTable,
+        {
+          rows: fixture.executions.slice(0, COMPACT_ROWS),
+          columns: COMPACT_COLUMNS,
+          showHeader: false,
+          compact: true
+        }
+      ) })
+    );
+  }
+  const renderOutput = (row) => row.id === fixture.openExecutionId ? /* @__PURE__ */ jsx(ScriptExecutionResult, { result: row.result, empty: "\u2014" }) : null;
+  return (
+    // The frame's tighter padding and no header row: the output opened under a run needs the height.
+    /* @__PURE__ */ jsxs("div", { className: "flex h-full gap-[var(--spacing-system-m)] overflow-hidden bg-ods-bg p-[var(--spacing-system-m)]", children: [
+      /* @__PURE__ */ jsx("div", { className: "w-[39%] shrink-0", children: /* @__PURE__ */ jsx(ScriptCodePicture, { script: fixture.script }) }),
+      /* @__PURE__ */ jsx("div", { className: "min-w-0 flex-1 overflow-hidden", children: /* @__PURE__ */ jsx(
+        ScriptExecutionsTable,
+        {
+          rows: fixture.executions,
+          hideColumns: WIDE_HIDDEN_COLUMNS,
+          renderSubRow: renderOutput,
+          showHeader: false,
+          compact: true
+        }
+      ) })
+    ] })
+  );
+}
+export {
+  ScriptsScreen as default
+};

package/dist/components/shared/legal-document/index.d.ts

@@ -5,6 +5,7 @@
  * formerly-duplicated `PrivacyPolicyPage` + `TermsOfServicePage`
  * (95% identical, differing only in copy strings).
  */
-export { LegalDocumentPage, type LegalDocumentPageProps, type LegalDocumentMarkdownRendererProps, } from './legal-document-page';
+export { LegalDocumentPage, legalDocumentStampLabel, type LegalDocumentPageProps, type LegalDocumentMarkdownRendererProps, } from './legal-document-page';
 export { useLegalDocs, type LegalDocument, type UseLegalDocsOptions, type UseLegalDocsReturn } from './use-legal-docs';
+export { useLegalDocuments, toLegalDocumentSummaries, type LegalDocumentSummary, type UseLegalDocumentsOptions, type UseLegalDocumentsReturn, } from './use-legal-documents';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/shared/legal-document/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/legal-document/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,kCAAkC,GACxC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/legal-document/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,kCAAkC,GACxC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACvH,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAC"}

package/dist/components/shared/legal-document/index.js

@@ -1,8 +1,16 @@
 import {
-  LegalDocumentPage
+  LegalDocumentPage,
+  legalDocumentStampLabel
 } from "./legal-document-page.js";
 import { useLegalDocs } from "./use-legal-docs.js";
+import {
+  useLegalDocuments,
+  toLegalDocumentSummaries
+} from "./use-legal-documents.js";
 export {
   LegalDocumentPage,
-  useLegalDocs
+  legalDocumentStampLabel,
+  toLegalDocumentSummaries,
+  useLegalDocs,
+  useLegalDocuments
 };

package/dist/components/shared/legal-document/legal-document-page.d.ts

@@ -28,25 +28,24 @@ export interface LegalDocumentMarkdownRendererProps {
 }
 export interface LegalDocumentPageProps {
     /** Document type identifier — drives the default API endpoint
-     *  `/api/legal/<docType>` AND the error-log prefix. Common values:
-     *  `'privacy'`, `'terms'`. Embedders may use any string. */
+     *  `/api/legal/<docType>` AND the error-log prefix. One of the types the
+     *  host's list answers (`useLegalDocuments`). */
     docType: string;
-    /** Heading text (e.g. "Privacy Policy", "Terms of Service"). */
-    title: string;
-    /** Fallback subtitle shown when no `lastUpdated` date is available
-     *  (e.g. "Our privacy policy and data protection practices"). */
-    fallbackDescription: string;
-    /** Email shown in the error + empty-state copy
-     *  (e.g. `'privacy@openframe.io'`, `'legal@openframe.io'`). */
-    contactEmail: string;
-    /** Prompt shown above the contact link in the error state
-     *  (e.g. "For privacy-related questions, please contact:"). */
-    errorContactPrompt: string;
-    /** Title for the error block (e.g. "Unable to load privacy policy"). */
-    errorTitle: string;
-    /** Sentence shown when the API returns no document
-     *  (e.g. "Privacy policy content is not available at this time."). */
-    emptyStateMessage: string;
+    /** Heading text. Default: the title the served document carries, so a host
+     *  that shows whatever the list holds states no per-document copy. */
+    title?: string;
+    /** Subtitle shown when the document states neither a version nor a date. */
+    fallbackDescription?: string;
+    /** Email shown in the error + empty-state copy. Absent: no contact line. */
+    contactEmail?: string;
+    /** Prompt shown above the contact link in the error state.
+     *  Default "For questions about this document, please contact:". */
+    errorContactPrompt?: string;
+    /** Title for the error block. Default "Unable to load <title>". */
+    errorTitle?: string;
+    /** Sentence shown when the API returns no document.
+     *  Default "<title> is not available at this time.". */
+    emptyStateMessage?: string;
     /** SSR-prepared document, if available. */
     initialData?: LegalDocument | null;
     /** SSR-prepared formatted "Last Updated" label. Stable across hydration. */
@@ -63,15 +62,28 @@ export interface LegalDocumentPageProps {
         href?: string;
     } | false;
     /**
-     * The page's own FAQ block: the topic the page is about (stated by the host,
-     * never read from its address) and where the host serves the FAQs. Rendered
-     * after the page's content, inside its container. Absent: no FAQ block.
+     * The hub's list of legal documents (`GET /api/legal`). Given it, the page
+     * takes the document's title and FAQ topic from the list, so a host passes
+     * only the type and its endpoints and states nothing per document; the title
+     * then names the document even when its text fails to load.
      */
-    faq?: PageFaqSlot;
+    documentsEndpoint?: string;
+    /**
+     * The page's own FAQ block: the topic the page is about and where the host
+     * serves the FAQs. Rendered after the page's content, inside its container.
+     * Without a `topic`, the topic is the one the list (`documentsEndpoint`)
+     * gives the document. Absent, or no topic known: no FAQ block.
+     */
+    faq?: PageFaqSlot | Omit<PageFaqSlot, 'topic'>;
     /** Render the standalone `<PageShell>`. Default true. Pass false when the host
      *  layout already provides the page container — only the padding box renders,
      *  avoiding a nested `<main>`. */
     shell?: boolean;
 }
-export declare function LegalDocumentPage({ docType, title, fallbackDescription, contactEmail, errorContactPrompt, errorTitle, emptyStateMessage, initialData, initialLastUpdatedLabel, apiEndpoint, MarkdownRenderer, backButton, faq, shell, }: LegalDocumentPageProps): import("react").JSX.Element;
+/**
+ * "Version 1.0 · Effective October 14, 2026" for a document that states them;
+ * null for one that states neither. One wording for every legal surface.
+ */
+export declare function legalDocumentStampLabel(doc: Pick<LegalDocument, 'version' | 'effectiveDate'> | null | undefined): string | null;
+export declare function LegalDocumentPage({ docType, title: titleProp, fallbackDescription, contactEmail, errorContactPrompt, errorTitle: errorTitleProp, emptyStateMessage: emptyStateMessageProp, initialData, initialLastUpdatedLabel, apiEndpoint, MarkdownRenderer, documentsEndpoint, backButton, faq, shell, }: LegalDocumentPageProps): import("react").JSX.Element;
 //# sourceMappingURL=legal-document-page.d.ts.map

package/dist/components/shared/legal-document/legal-document-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legal-document-page.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/legal-document/legal-document-page.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAI3C,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGnF,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC;;gEAE4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd;qEACiE;IACjE,mBAAmB,EAAE,MAAM,CAAC;IAC5B;mEAC+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB;mEAC+D;IAC/D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB;0EACsE;IACtE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,4EAA4E;IAC5E,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC;0DACsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,aAAa,CAAC,kCAAkC,CAAC,CAAC;IACrE;mEAC+D;IAC/D,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IACvD;;;;OAIG;IACH,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB;;sCAEkC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,KAAK,EACL,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,WAAkB,EAClB,uBAA8B,EAC9B,WAAW,EACX,gBAAuC,EACvC,UAAU,EACV,GAAG,EACH,KAAY,GACb,EAAE,sBAAsB,+BAkFxB"}
+{"version":3,"file":"legal-document-page.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/legal-document/legal-document-page.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAI3C,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGnF,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGpE,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC;;qDAEiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB;0EACsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;wEACoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;4DACwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,4EAA4E;IAC5E,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC;0DACsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,aAAa,CAAC,kCAAkC,CAAC,CAAC;IACrE;mEAC+D;IAC/D,UAAU,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC;IACvD;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC/C;;sCAEkC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,eAAe,CAAC,GAAG,IAAI,GAAG,SAAS,GACvE,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,KAAK,EAAE,SAAS,EAChB,mBAAwB,EACxB,YAAY,EACZ,kBAAyE,EACzE,UAAU,EAAE,cAAc,EAC1B,iBAAiB,EAAE,qBAAqB,EACxC,WAAkB,EAClB,uBAA8B,EAC9B,WAAW,EACX,gBAAuC,EACvC,iBAAiB,EACjB,UAAU,EACV,GAAG,EACH,KAAY,GACb,EAAE,sBAAsB,+BAkGxB"}

package/dist/components/shared/legal-document/legal-document-page.js

@@ -7,18 +7,27 @@ import { FaqSection, pageFaqProps } from "../../faq/faq-section.js";
 import { PageShell, PageLayout } from "../../ui/index.js";
 import { RichMarkdownRenderer } from "../../ui/markdown/index.js";
 import { useLegalDocs } from "./use-legal-docs.js";
+import { useLegalDocuments } from "./use-legal-documents.js";
+function legalDocumentStampLabel(doc) {
+  const parts = [
+    doc?.version ? `Version ${doc.version}` : null,
+    doc?.effectiveDate ? `Effective ${doc.effectiveDate}` : null
+  ].filter((part) => part !== null);
+  return parts.length > 0 ? parts.join(" \xB7 ") : null;
+}
 function LegalDocumentPage({
   docType,
-  title,
-  fallbackDescription,
+  title: titleProp,
+  fallbackDescription = "",
   contactEmail,
-  errorContactPrompt,
-  errorTitle,
-  emptyStateMessage,
+  errorContactPrompt = "For questions about this document, please contact:",
+  errorTitle: errorTitleProp,
+  emptyStateMessage: emptyStateMessageProp,
   initialData = null,
   initialLastUpdatedLabel = null,
   apiEndpoint,
   MarkdownRenderer = RichMarkdownRenderer,
+  documentsEndpoint,
   backButton,
   faq,
   shell = true
@@ -29,9 +38,16 @@ function LegalDocumentPage({
     label: backButton?.label ?? "Back to home",
     onClick: () => router.push(backButton?.href ?? "/")
   };
+  const { documents } = useLegalDocuments({ apiEndpoint: documentsEndpoint, enabled: Boolean(documentsEndpoint) });
+  const listed = documents.find((doc) => doc.docType === docType);
+  const title = titleProp ?? data?.title ?? listed?.title ?? "Legal document";
+  const faqTopic = faq && "topic" in faq ? faq.topic : listed?.faqTopic;
+  const faqSlot = faq && faqTopic ? { ...faq, topic: faqTopic } : null;
+  const errorTitle = errorTitleProp ?? `Unable to load ${title}`;
+  const emptyStateMessage = emptyStateMessageProp ?? `${title} is not available at this time.`;
   const fallbackLastUpdatedLabel = data?.lastSynced != null ? formatLegalDate(data.lastSynced) : null;
   const effectiveLastUpdatedLabel = initialLastUpdatedLabel ?? fallbackLastUpdatedLabel;
-  const subtitle = effectiveLastUpdatedLabel ? `Last Updated: ${effectiveLastUpdatedLabel}` : fallbackDescription;
+  const subtitle = legalDocumentStampLabel(data) ?? (effectiveLastUpdatedLabel ? `Last Updated: ${effectiveLastUpdatedLabel}` : fallbackDescription);
   const inner = /* @__PURE__ */ jsxs(PageLayout, { title, subtitle, backButton: backCfg, titleSize: "h1", titleWrap: true, children: [
     data?.sourceFile && /* @__PURE__ */ jsxs("p", { className: "text-ods-text-secondary opacity-75 text-h6", children: [
       "Source: ",
@@ -57,13 +73,13 @@ function LegalDocumentPage({
         /* @__PURE__ */ jsx("p", { className: "mb-2 text-ods-error", children: errorTitle }),
         /* @__PURE__ */ jsx("p", { className: "text-ods-error text-h6", children: error })
       ] }),
-      /* @__PURE__ */ jsxs("div", { className: "text-ods-text-secondary", children: [
+      contactEmail && /* @__PURE__ */ jsxs("div", { className: "text-ods-text-secondary", children: [
         /* @__PURE__ */ jsx("p", { children: errorContactPrompt }),
         /* @__PURE__ */ jsx(Link, { href: `mailto:${contactEmail}`, className: "text-ods-accent hover:underline", children: contactEmail })
       ] })
     ] }) : data ? /* @__PURE__ */ jsx(MarkdownRenderer, { content: data.content, sectionIds: data.sections || [], demoteMarkdownH1ToH2: true }) : /* @__PURE__ */ jsxs("div", { className: "py-16 text-center text-ods-text-secondary", children: [
       /* @__PURE__ */ jsx("p", { className: "text-h4", children: emptyStateMessage }),
-      /* @__PURE__ */ jsxs("p", { className: "mt-2", children: [
+      contactEmail && /* @__PURE__ */ jsxs("p", { className: "mt-2", children: [
         "Please contact",
         " ",
         /* @__PURE__ */ jsx(Link, { href: `mailto:${contactEmail}`, className: "text-ods-accent hover:underline", children: contactEmail }),
@@ -71,10 +87,11 @@ function LegalDocumentPage({
         "for more information."
       ] })
     ] }) }) }) }) }),
-    faq && /* @__PURE__ */ jsx(FaqSection, { ...pageFaqProps(faq) })
+    faqSlot && /* @__PURE__ */ jsx(FaqSection, { ...pageFaqProps(faqSlot) })
   ] });
   return shell ? /* @__PURE__ */ jsx(PageShell, { children: inner }) : /* @__PURE__ */ jsx("div", { className: "page-shell-content", children: inner });
 }
 export {
-  LegalDocumentPage
+  LegalDocumentPage,
+  legalDocumentStampLabel
 };

package/dist/components/shared/legal-document/use-legal-docs.d.ts

@@ -10,6 +10,10 @@ export interface LegalDocument {
         level: number;
     }>;
     docType: string;
+    /** The version the document states for itself ("1.0"); null when it states none. */
+    version: string | null;
+    /** The day that version takes effect, as the document words it; null when it states none. */
+    effectiveDate: string | null;
     meta: {
         sectionsCount: number;
         contentLength: number;
@@ -32,9 +36,9 @@ export interface UseLegalDocsOptions {
 /**
  * Hook to fetch a legal document.
  * @param docType — short identifier for the document (drives the
- *   default endpoint path AND the error-log prefix). Common values:
- *   `'privacy'` (SECURITY.md), `'terms'` (LICENSE). Embedders may use
- *   any string — the hook treats it as opaque.
+ *   default endpoint path AND the error-log prefix). The valid values are
+ *   the ones the host's list endpoint answers (`useLegalDocuments`); the
+ *   hook treats it as opaque.
  */
 export declare function useLegalDocs(docType: string, options?: UseLegalDocsOptions): UseLegalDocsReturn;
 //# sourceMappingURL=use-legal-docs.d.ts.map

package/dist/components/shared/legal-document/use-legal-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-legal-docs.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/legal-document/use-legal-docs.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC;mDAC+C;IAC/C,WAAW,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2ED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CAwGnG"}
+{"version":3,"file":"use-legal-docs.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/legal-document/use-legal-docs.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,6FAA6F;IAC7F,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE;QACJ,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC;mDAC+C;IAC/C,WAAW,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA6ED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CAiHnG"}

package/dist/components/shared/legal-document/use-legal-docs.js

@@ -42,6 +42,8 @@ function toLegalDocument(payload, docType) {
     githubSha: typeof githubSha === "string" ? githubSha : null,
     sections,
     docType: readString(payload, "docType") ?? docType,
+    version: readString(payload, "version") ?? null,
+    effectiveDate: readString(payload, "effectiveDate") ?? null,
     meta: {
       sectionsCount: typeof sectionsCount === "number" ? sectionsCount : sections.length,
       contentLength: typeof contentLength === "number" ? contentLength : content.length,
@@ -72,6 +74,11 @@ function useLegalDocs(docType, options = {}) {
     const fetchDocument = async () => {
       try {
         const response = await contentFetch(effectiveEndpoint);
+        if (response.status === 404) {
+          if (!isCurrent()) return;
+          setData(null);
+          return;
+        }
         if (!response.ok) {
           throw new Error(`Failed to fetch ${docType} document: ${response.status} ${response.statusText}`);
         }

package/dist/components/shared/legal-document/use-legal-documents.d.ts

@@ -0,0 +1,31 @@
+export interface LegalDocumentSummary {
+    /** The identifier `useLegalDocs` and `<LegalDocumentPage>` take. */
+    docType: string;
+    title: string;
+    /** One line saying what the document is, for a card that lists it. */
+    summary: string;
+    /** The document's page on the hub's own site (a path). */
+    route: string;
+    sourceFile: string;
+    /** The topic the document's FAQs are written for, when the hub has one. */
+    faqTopic: string | null;
+    version: string | null;
+    effectiveDate: string | null;
+    /** False while the hub has no content for it yet. */
+    published: boolean;
+}
+export interface UseLegalDocumentsOptions {
+    /** Full GET endpoint URL. Default `/api/legal`. */
+    apiEndpoint?: string;
+    /** False: read nothing and answer an empty list. Default true. */
+    enabled?: boolean;
+}
+export interface UseLegalDocumentsReturn {
+    documents: LegalDocumentSummary[];
+    isLoading: boolean;
+    error: string | null;
+}
+/** Decode the endpoint's answer; a row without a type and a title is left out. */
+export declare function toLegalDocumentSummaries(payload: unknown): LegalDocumentSummary[];
+export declare function useLegalDocuments(options?: UseLegalDocumentsOptions): UseLegalDocumentsReturn;
+//# sourceMappingURL=use-legal-documents.d.ts.map

package/dist/components/shared/legal-document/use-legal-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-legal-documents.d.ts","sourceRoot":"","sources":["../../../../src/components/shared/legal-document/use-legal-documents.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAWD,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,oBAAoB,EAAE,CAsBjF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,uBAAuB,CA+BjG"}

package/dist/components/shared/legal-document/use-legal-documents.js

@@ -0,0 +1,67 @@
+"use client";
+import { useEffect, useState } from "react";
+import { contentFetch } from "../../../utils/embed-content-fetch.js";
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function text(source, key) {
+  const value = source[key];
+  return typeof value === "string" && value ? value : null;
+}
+function toLegalDocumentSummaries(payload) {
+  const rows = isRecord(payload) ? payload.documents : null;
+  if (!Array.isArray(rows)) return [];
+  const documents = [];
+  for (const row of rows) {
+    if (!isRecord(row)) continue;
+    const docType = text(row, "docType");
+    const title = text(row, "title");
+    if (!docType || !title) continue;
+    documents.push({
+      docType,
+      title,
+      summary: text(row, "summary") ?? "",
+      route: text(row, "route") ?? "",
+      sourceFile: text(row, "sourceFile") ?? "",
+      faqTopic: text(row, "faqTopic"),
+      version: text(row, "version"),
+      effectiveDate: text(row, "effectiveDate"),
+      published: row.published === true
+    });
+  }
+  return documents;
+}
+function useLegalDocuments(options = {}) {
+  const endpoint = options.apiEndpoint ?? "/api/legal";
+  const enabled = options.enabled ?? true;
+  const [state, setState] = useState({ documents: [], isLoading: enabled, error: null });
+  useEffect(() => {
+    let current = enabled;
+    const load = async () => {
+      try {
+        const response = await contentFetch(endpoint);
+        if (!response.ok) throw new Error(`Failed to fetch legal documents: ${response.status} ${response.statusText}`);
+        const payload = await response.json();
+        if (current) setState({ documents: toLegalDocumentSummaries(payload), isLoading: false, error: null });
+      } catch (err) {
+        console.error("Error fetching legal documents:", err);
+        if (current) {
+          setState({
+            documents: [],
+            isLoading: false,
+            error: err instanceof Error ? err.message : "Unknown error occurred"
+          });
+        }
+      }
+    };
+    if (enabled) void load();
+    return () => {
+      current = false;
+    };
+  }, [endpoint, enabled]);
+  return state;
+}
+export {
+  toLegalDocumentSummaries,
+  useLegalDocuments
+};

package/dist/components/tickets/index.cjs

@@ -14,11 +14,11 @@
 
 
 
-var _chunkRGFT3P3Lcjs = require('../../chunk-RGFT3P3L.cjs');
-require('../../chunk-Q7GG3WC5.cjs');
-require('../../chunk-TF7J6VXG.cjs');
+var _chunkLZ6NOVXXcjs = require('../../chunk-LZ6NOVXX.cjs');
+require('../../chunk-ZJPDGVA6.cjs');
+require('../../chunk-QEUGYHFB.cjs');
 require('../../chunk-WBANGORJ.cjs');
-require('../../chunk-V2ZFH42N.cjs');
+require('../../chunk-HYBMADYO.cjs');
 require('../../chunk-HEVW75L3.cjs');
 
 
@@ -26,8 +26,8 @@ require('../../chunk-HEVW75L3.cjs');
 
 
 
-var _chunkFL6UO7IRcjs = require('../../chunk-FL6UO7IR.cjs');
-require('../../chunk-SB4VWA5V.cjs');
+var _chunk5SVOGLNKcjs = require('../../chunk-5SVOGLNK.cjs');
+require('../../chunk-IK2RJUEA.cjs');
 require('../../chunk-O67V3HJR.cjs');
 require('../../chunk-3HPB4H4C.cjs');
 require('../../chunk-DSVNFRY5.cjs');
@@ -43,7 +43,7 @@ require('../../chunk-YUMFVQIN.cjs');
 
 
 
-var _chunkS2CA5WE4cjs = require('../../chunk-S2CA5WE4.cjs');
+var _chunkCWRVTQUOcjs = require('../../chunk-CWRVTQUO.cjs');
 require('../../chunk-BV5WZVOP.cjs');
 require('../../chunk-GABDE3FM.cjs');
 require('../../chunk-3RFQPQ7Z.cjs');
@@ -1902,4 +1902,4 @@ require('../../chunk-3ATAYP36.cjs');
 
 
 
-exports.HelpCenterCard = _chunkRGFT3P3Lcjs.HelpCenterCard; exports.HelpCenterCreateForm = _chunkRGFT3P3Lcjs.HelpCenterCreateForm; exports.HelpCenterCreateFormSkeleton = _chunkRGFT3P3Lcjs.HelpCenterCreateFormSkeleton; exports.HelpCenterList = _chunkRGFT3P3Lcjs.HelpCenterList; exports.TICKET_OPEN_PARAM = _chunkS2CA5WE4cjs.TICKET_OPEN_PARAM; exports.TICKET_TOAST_COPY = _chunkFL6UO7IRcjs.TOAST_COPY; exports.TicketCenter = _chunkRGFT3P3Lcjs.TicketCenter; exports.TicketDetailDrawer = _chunkRGFT3P3Lcjs.TicketDetailDrawer; exports.TicketLinkedDeliveryCard = _chunkRGFT3P3Lcjs.TicketLinkedDeliveryCard; exports.TicketLiveProvider = _chunkFL6UO7IRcjs.TicketLiveProvider; exports.TicketOpenForm = _chunkRGFT3P3Lcjs.TicketOpenForm; exports.TicketReplyComposer = _chunkRGFT3P3Lcjs.TicketReplyComposer; exports.TicketRow = _chunkRGFT3P3Lcjs.TicketRow; exports.buildTicketOpenHref = _chunkS2CA5WE4cjs.buildTicketOpenHref; exports.isOptimistic = _chunkFL6UO7IRcjs.isOptimistic; exports.mapTicketActionError = _chunkRGFT3P3Lcjs.mapTicketActionError; exports.useOptionalTicketLive = _chunkFL6UO7IRcjs.useOptionalTicketLive; exports.useTicketActions = _chunkRGFT3P3Lcjs.useTicketActions; exports.useTicketEngagements = _chunkRGFT3P3Lcjs.useTicketEngagements; exports.useTicketLive = _chunkFL6UO7IRcjs.useTicketLive; exports.useTicketsList = _chunkRGFT3P3Lcjs.useTicketsList;
+exports.HelpCenterCard = _chunkLZ6NOVXXcjs.HelpCenterCard; exports.HelpCenterCreateForm = _chunkLZ6NOVXXcjs.HelpCenterCreateForm; exports.HelpCenterCreateFormSkeleton = _chunkLZ6NOVXXcjs.HelpCenterCreateFormSkeleton; exports.HelpCenterList = _chunkLZ6NOVXXcjs.HelpCenterList; exports.TICKET_OPEN_PARAM = _chunkCWRVTQUOcjs.TICKET_OPEN_PARAM; exports.TICKET_TOAST_COPY = _chunk5SVOGLNKcjs.TOAST_COPY; exports.TicketCenter = _chunkLZ6NOVXXcjs.TicketCenter; exports.TicketDetailDrawer = _chunkLZ6NOVXXcjs.TicketDetailDrawer; exports.TicketLinkedDeliveryCard = _chunkLZ6NOVXXcjs.TicketLinkedDeliveryCard; exports.TicketLiveProvider = _chunk5SVOGLNKcjs.TicketLiveProvider; exports.TicketOpenForm = _chunkLZ6NOVXXcjs.TicketOpenForm; exports.TicketReplyComposer = _chunkLZ6NOVXXcjs.TicketReplyComposer; exports.TicketRow = _chunkLZ6NOVXXcjs.TicketRow; exports.buildTicketOpenHref = _chunkCWRVTQUOcjs.buildTicketOpenHref; exports.isOptimistic = _chunk5SVOGLNKcjs.isOptimistic; exports.mapTicketActionError = _chunkLZ6NOVXXcjs.mapTicketActionError; exports.useOptionalTicketLive = _chunk5SVOGLNKcjs.useOptionalTicketLive; exports.useTicketActions = _chunkLZ6NOVXXcjs.useTicketActions; exports.useTicketEngagements = _chunkLZ6NOVXXcjs.useTicketEngagements; exports.useTicketLive = _chunk5SVOGLNKcjs.useTicketLive; exports.useTicketsList = _chunkLZ6NOVXXcjs.useTicketsList;