@flamingo-stack/openframe-frontend-core 0.0.295 → 0.0.296-snapshot.20260621021605

package/dist/types/doc-source.d.ts

@@ -23,6 +23,12 @@ export interface DocNode {
     documentType?: 'markdown' | 'pdf' | 'google_sheet' | 'figma' | 'file';
     children?: DocNode[];
 }
+/**
+ * Named alias for `DocNode['documentType']` (non-nullable). Use this as the
+ * key type when building per-document-type renderer maps — keeps consumers
+ * from re-declaring the union or having to dig into `DocNode`.
+ */
+export type DocumentType = NonNullable<DocNode['documentType']>;
 /**
  * Content payload returned by a doc-source DAL's `getContent` call. Carries
  * everything any consumer's renderer might need; markdown-only fields and
@@ -68,6 +74,20 @@ export interface DocSourceDal<Client = unknown> {
  * never reaches into the registry — this is purely a type-narrowing handle.
  */
 export type DocSourceId = 'openframe-docs' | 'data-room-docs';
+/**
+ * Result returned by the resolve-link endpoint. Discriminator-style: `success`
+ * + `type` jointly decide what the renderer does (navigate, expand folder,
+ * show broken-link badge). Backed by hub `/api/docs/resolve-link` and any
+ * embedder-proxied equivalent.
+ */
+export interface ResolveLinkResult {
+    success: boolean;
+    resolvedPath?: string;
+    type?: string;
+    action?: string;
+    error?: string;
+    message?: string;
+}
 /**
  * Handlers the viewer passes to a consumer's `renderContent` callback.
  * The page shell wires `renderContent` directly — no `DocContentRenderer`
@@ -80,7 +100,17 @@ export interface DocRenderHandlers {
     }) => void;
     currentPath: string;
     /** Registry source id (e.g. `'openframe-docs'`, `'data-room-docs'`) — used by
-     *  the consumer's `/api/resolve-link` POST to disambiguate the doc source. */
+     *  the consumer's `/api/docs/resolve-link` POST to disambiguate the doc source. */
     sourceId: DocSourceId;
+    /**
+     * Async link resolver — POSTs the raw markdown href + the current doc's path
+     * to the embedder's resolve-link endpoint and returns the resolved tree path.
+     * The lib auto-wires this when `DocViewer` knows the resolve-link endpoint
+     * (via `resolveLinkEndpoint` prop, `ChatRuntime.endpoints.docsResolveLinkUrl`,
+     * or the `/api/docs/resolve-link` default). Consumers thread it directly into
+     * their markdown renderer's `onResolveLink` prop — without it, relative
+     * hrefs like `./intro.md` end up fetched verbatim and 404.
+     */
+    onResolveLink?: (href: string, currentPath: string) => Promise<ResolveLinkResult>;
 }
 //# sourceMappingURL=doc-source.d.ts.map

package/dist/types/doc-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc-source.d.ts","sourceRoot":"","sources":["../../src/types/doc-source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,YAAY,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,CAAA;IACrE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAEtC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IAEtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;mFAC+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAChD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;CACrE;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAA;AAE7D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,CACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,KAC7D,IAAI,CAAA;IACT,WAAW,EAAE,MAAM,CAAA;IACnB;kFAC8E;IAC9E,QAAQ,EAAE,WAAW,CAAA;CACtB"}
+{"version":3,"file":"doc-source.d.ts","sourceRoot":"","sources":["../../src/types/doc-source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mFAAmF;IACnF,YAAY,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,CAAA;IACrE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CACrB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAA;AAE/D;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAEtC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IAEtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;mFAC+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAChD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;CACrE;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,gBAAgB,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,CACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,KAC7D,IAAI,CAAA;IACT,WAAW,EAAE,MAAM,CAAA;IACnB;uFACmF;IACnF,QAAQ,EAAE,WAAW,CAAA;IACrB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;CAClF"}

package/dist/utils/index.cjs

@@ -3886,6 +3886,9 @@ function toFigmaOriginalUrl(url) {
   return url.replace(/\?.*$/, "");
 }
 
+// src/utils/page-header-constants.ts
+var SECTION_HERO_ICON_CLASS = "h-10 w-10 text-ods-accent";
+
 exports.ANTHROPIC_SUPPORTED_IMAGE_MIME = ANTHROPIC_SUPPORTED_IMAGE_MIME;
 exports.AUTO_CONTINUATION_DIRECTIVE_PREFIX = AUTO_CONTINUATION_DIRECTIVE_PREFIX;
 exports.CHAT_ATTACHMENT_MARKDOWN_PATTERN = CHAT_ATTACHMENT_MARKDOWN_PATTERN;
@@ -3913,6 +3916,7 @@ exports.PLAY_ICON_PATH = PLAY_ICON_PATH;
 exports.ROADMAP_STATUS_OPTIONS = ROADMAP_STATUS_OPTIONS;
 exports.SCROLL_ANCHOR = SCROLL_ANCHOR;
 exports.SCROLL_ANCHOR_WIRE_KEY = SCROLL_ANCHOR_WIRE_KEY;
+exports.SECTION_HERO_ICON_CLASS = SECTION_HERO_ICON_CLASS;
 exports.SOURCE_ICON_NAMES = SOURCE_ICON_NAMES;
 exports.SOURCE_LABELS_BY_TABLE = SOURCE_LABELS_BY_TABLE;
 exports.STICKY_HEADER_OFFSET_PX = STICKY_HEADER_OFFSET_PX;