@flamingo-stack/openframe-frontend-core 0.0.204 → 0.0.205

package/dist/contexts/chat-runtime-context.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Runtime config consumed by the chat panel.
+ */
+export interface ChatRuntime {
+    endpoints: {
+        /** POST streaming chat. Hub: '/api/docs/chat'. */
+        chatStreamUrl: string;
+        /** POST agent approve/reject. Hub: '/api/chat/agent/confirm-tool'. */
+        approvalToolUrl: string;
+        /** GET slash-command catalog. Hub: '/api/docs/commands'. */
+        commandsUrl: string;
+        /** Build entity-card list URL for a content type + ids. Hub delegates
+         *  to the rag-table-config registry; embedded app provides its own
+         *  per-type URL builder against the reverse proxy. Returns null when
+         *  the type has no list endpoint (caller skips rendering). */
+        buildListUrl: (type: string, ids: string[]) => string | null;
+        /** Chat-attachment endpoints — added for the v2 attachment feature.
+         *
+         *  Three concerns:
+         *    - `attachmentUploadUrl` — POSTed by the chat-attachment hook
+         *      to mint a Supabase signed-upload-URL + HMAC view token.
+         *    - `attachmentViewUrlPrefix` — embedded in markdown URLs the
+         *      chat hosts in user message bubbles (`![]()` / `[Attached]`).
+         *      Stored in chat history; chosen at SEND time. In host mode the
+         *      relative `/api/storage/view/chat-attachments/` is sufficient
+         *      (same-origin); embedders supply an absolute hub URL so the
+         *      browser can fetch cross-origin.
+         *    - `chatIdentityUrl` — GET endpoint the `useChatIdentity` hook
+         *      hits to learn the `{authTier, source, attachmentsEnabled}`
+         *      capability bag for the current session. */
+        attachmentUploadUrl: string;
+        attachmentViewUrlPrefix: string;
+        chatIdentityUrl: string;
+        /** Optional URL prefix for the image proxy (`<prefix>?url=<external>`).
+         *  When unset, lib's `getProxiedImageUrl` returns the original URL
+         *  unchanged. Hub default: '/api/image-proxy'. Embedders that don't
+         *  host an image-proxy route leave this undefined → images load
+         *  directly cross-origin (CORS-permitting). */
+        imageProxyUrlPrefix?: string;
+        /** Optional list of hostnames that should bypass the image proxy
+         *  (rendered direct). Hub uses ['openmsp.ai']; embedders typically
+         *  leave it unset. Matches the `skipDomains` parameter of
+         *  `getProxiedImageUrl`. */
+        imageProxySkipDomains?: string[];
+    };
+    navigation: {
+        /** ONE knob, two behaviors:
+         *  - 'host' = use the host page's existing click-routing untouched.
+         *    The chat panel calls `navigate?.()` for in-app routing.
+         *  - 'embed' = guest inside another app: short-circuit at the top
+         *    of click handlers to force new-tab + absolutize via
+         *    resolveExternalNavigation. */
+        mode: 'host' | 'embed';
+        /** Embed-only fallback origin for relative URLs whose target platform
+         *  can't be inferred. Used by resolveExternalNavigation when
+         *  `targetPlatform` is null — without this, a relative `/foo` href would
+         *  window.open against the embedder's origin, which is WRONG.
+         *  Set to your content host (e.g. 'https://hub.openframe.ai').
+         *  Required by the embedded app whenever mode='embed'. */
+        defaultContentOrigin?: string;
+        /** Override for opening external URLs. MUST BE SYNCHRONOUS —
+         *  Safari/Firefox block popups opened outside a direct user gesture.
+         *  Default: window.open(href, '_blank', 'noopener,noreferrer'). */
+        openExternal?: (href: string) => void;
+        /** Optional in-app navigation callback (host-mode only).
+         *  Returns `true` if the host handled the click in-app
+         *  (router.push + docNav.navigate); returns `false`, `undefined`,
+         *  or `void` → lib falls back to window.location.assign(href).
+         *  Hub wires this via HubRuntimeProvider's HubNavigationWiring;
+         *  embedders not in Next.js leave it undefined. */
+        navigate?: (input: {
+            href: string;
+            path?: string | null;
+            targetPlatform?: string | null;
+        }) => boolean | void;
+        /** Optional new-tab decision callback. Returns true → lib opens in
+         *  new tab; false → same tab via `navigate`. Hub wires the existing
+         *  `decideNewTab` logic from use-nav-link.tsx (re-imports the pure
+         *  helper from lib). Embedders may omit; lib defaults to:
+         *  same-origin/same-platform → same tab, else new tab. */
+        decideNewTab?: (args: {
+            href: string;
+            targetPlatform?: string | null;
+        }) => boolean;
+    };
+    /** Chat source identifier — REQUIRED. Used for localStorage
+     *  namespacing (`mingo-chat-<source>-v1`). Hub sets via
+     *  `currentPlatform()`; embedders set explicitly.
+     *  `useEmbeddedChat()` throws if source is empty/missing. */
+    source: string;
+}
+export declare const ChatRuntimeContext: import("react").Context<ChatRuntime | null>;
+/**
+ * Returns the active runtime, or null when no provider is mounted.
+ * NULL is a first-class value — it signals "no chat runtime configured."
+ * Optional consumers fall back to no-op behavior; strict consumers
+ * use `useRequiredChatRuntime` (below).
+ */
+export declare function useChatRuntime(): ChatRuntime | null;
+/**
+ * Strict variant used INSIDE the chat panel. Throws if no provider.
+ * The hub guarantees one exists by mounting `<HubRuntimeProvider>` at
+ * root; the embedded app mounts its own `<ChatRuntimeContext.Provider>`
+ * at the tree root. In Jest / Storybook tests that render chat
+ * internals directly, wrap with `<HubRuntimeProvider>` (hub defaults)
+ * or supply `<ChatRuntimeContext.Provider value={mockedRuntime}>`.
+ */
+export declare function useRequiredChatRuntime(): ChatRuntime;
+//# sourceMappingURL=chat-runtime-context.d.ts.map

package/dist/contexts/chat-runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-runtime-context.d.ts","sourceRoot":"","sources":["../../src/contexts/chat-runtime-context.tsx"],"names":[],"mappings":"AAqCA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE;QACT,kDAAkD;QAClD,aAAa,EAAE,MAAM,CAAA;QACrB,sEAAsE;QACtE,eAAe,EAAE,MAAM,CAAA;QACvB,4DAA4D;QAC5D,WAAW,EAAE,MAAM,CAAA;QACnB;;;sEAG8D;QAC9D,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,IAAI,CAAA;QAC5D;;;;;;;;;;;;;0DAakD;QAClD,mBAAmB,EAAE,MAAM,CAAA;QAC3B,uBAAuB,EAAE,MAAM,CAAA;QAC/B,eAAe,EAAE,MAAM,CAAA;QACvB;;;;uDAI+C;QAC/C,mBAAmB,CAAC,EAAE,MAAM,CAAA;QAC5B;;;oCAG4B;QAC5B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAA;KACjC,CAAA;IACD,UAAU,EAAE;QACV;;;;;2CAKmC;QACnC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;QACtB;;;;;kEAK0D;QAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAA;QAC7B;;2EAEmE;QACnE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;QACrC;;;;;2DAKmD;QACnD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,KAAK,OAAO,GAAG,IAAI,CAAA;QAC5G;;;;kEAI0D;QAC1D,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,KAAK,OAAO,CAAA;KACnF,CAAA;IACD;;;iEAG6D;IAC7D,MAAM,EAAE,MAAM,CAAA;CAQf;AAED,eAAO,MAAM,kBAAkB,6CAA0C,CAAA;AAEzE;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,WAAW,CAapD"}

package/dist/contexts/endpoints-runtime-context.d.ts

@@ -0,0 +1,28 @@
+export interface EndpointsRuntime {
+    /** GET active announcement (used by `<AnnouncementBar>` polling). */
+    announcementsUrl: string;
+    accessCode: {
+        /** POST validate access code. */
+        validateUrl: string;
+        /** POST consume / redeem access code after registration. */
+        consumeUrl: string;
+    };
+    /** POST contact-form submission. */
+    contactUrl: string;
+}
+export declare const EndpointsRuntimeContext: import("react").Context<EndpointsRuntime | null>;
+/**
+ * Optional read — returns null when no provider is mounted. Use for
+ * surfaces that should silently skip the fetch (e.g. announcement
+ * polling on a page rendered outside the provider tree).
+ */
+export declare function useEndpointsRuntime(): EndpointsRuntime | null;
+/**
+ * Strict variant — throws on missing provider. Use for consumers that
+ * cannot function without an endpoint (form submission, code
+ * validation). In tests/Storybook, wrap with the hub's
+ * `<HubRuntimeProvider>` or a stub
+ * `<EndpointsRuntimeContext.Provider value={mockedEndpoints}>`.
+ */
+export declare function useRequiredEndpointsRuntime(): EndpointsRuntime;
+//# sourceMappingURL=endpoints-runtime-context.d.ts.map

package/dist/contexts/endpoints-runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints-runtime-context.d.ts","sourceRoot":"","sources":["../../src/contexts/endpoints-runtime-context.tsx"],"names":[],"mappings":"AAyBA,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE;QACV,iCAAiC;QACjC,WAAW,EAAE,MAAM,CAAA;QACnB,4DAA4D;QAC5D,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,uBAAuB,kDAA+C,CAAA;AAEnF;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,IAAI,gBAAgB,CAW9D"}

package/dist/contexts/index.cjs

@@ -0,0 +1,30 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }"use client";
+
+
+
+
+var _chunk6RZYJICVcjs = require('../chunk-6RZYJICV.cjs');
+
+
+
+
+var _chunk27APPAJNcjs = require('../chunk-27APPAJN.cjs');
+require('../chunk-VRHGVLSL.cjs');
+
+// src/contexts/use-outer-or-default.ts
+var _react = require('react');
+function useOuterOrDefault(context, factory, deps = []) {
+  const outer = _react.useContext.call(void 0, context);
+  const fallback = _react.useMemo.call(void 0, factory, deps);
+  return _nullishCoalesce(outer, () => ( fallback));
+}
+
+
+
+
+
+
+
+
+exports.ChatRuntimeContext = _chunk6RZYJICVcjs.ChatRuntimeContext; exports.EndpointsRuntimeContext = _chunk27APPAJNcjs.EndpointsRuntimeContext; exports.useChatRuntime = _chunk6RZYJICVcjs.useChatRuntime; exports.useEndpointsRuntime = _chunk27APPAJNcjs.useEndpointsRuntime; exports.useOuterOrDefault = useOuterOrDefault; exports.useRequiredChatRuntime = _chunk6RZYJICVcjs.useRequiredChatRuntime; exports.useRequiredEndpointsRuntime = _chunk27APPAJNcjs.useRequiredEndpointsRuntime;
+//# sourceMappingURL=index.cjs.map

package/dist/contexts/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/contexts/index.cjs","../../src/contexts/use-outer-or-default.ts"],"names":[],"mappings":"AAAA,yLAAY;AACZ;AACE;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACA;ACgBA,8BAAkD;AAE3C,SAAS,iBAAA,CACd,OAAA,EACA,OAAA,EACA,KAAA,EAA+B,CAAC,CAAA,EAC7B;AACH,EAAA,MAAM,MAAA,EAAQ,+BAAA,OAAkB,CAAA;AAGhC,EAAA,MAAM,SAAA,EAAW,4BAAA,OAAQ,EAAS,IAAI,CAAA;AACtC,EAAA,wBAAO,KAAA,UAAS,UAAA;AAClB;ADrBA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,8dAAC","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/contexts/index.cjs","sourcesContent":[null,"'use client'\n\n/**\n * Outer-forward provider helper — used by hub + embedder providers\n * that supply default runtime values while allowing OUTER providers\n * to override.\n *\n * When an embedder mounts an outer `<ChatRuntimeContext.Provider>`\n * (or `<EndpointsRuntimeContext.Provider>`) ABOVE the hub provider,\n * the outer value wins. When no outer is mounted, the hub provider\n * supplies its `factory()` default. Tree shape stays constant —\n * same provider element at the same position regardless of outer\n * presence — so consumers below never remount when an embedder\n * toggles their providers at runtime.\n *\n * `deps` controls factory memoization:\n *   - Empty `[]` (default) → factory runs ONCE per mount; safe ONLY\n *     when factory closes over module-scope/constant values.\n *   - Non-empty → factory re-runs when deps change. Use when the\n *     factory closes over callbacks or other reactive values\n *     (e.g. hub's ChatRuntime which includes `navigate` +\n *     `decideNewTab` callbacks that depend on router + docNav).\n *\n * Returning the SAME reference across renders is critical for\n * downstream `useMemo` consumers. With empty deps, identity is\n * trivially stable. With reactive deps, the caller must memoize\n * the deps themselves (typically via `useCallback`).\n */\n\nimport { useContext, useMemo, type Context } from 'react'\n\nexport function useOuterOrDefault<T>(\n  context: Context<T | null>,\n  factory: () => T,\n  deps: ReadonlyArray<unknown> = [],\n): T {\n  const outer = useContext(context)\n  // eslint-disable-next-line react-hooks/exhaustive-deps -- deps are the contract;\n  // factory identity is intentionally ignored (caller controls re-creation via deps).\n  const fallback = useMemo(factory, deps)\n  return outer ?? fallback\n}\n"]}

package/dist/contexts/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Runtime contexts for embeddable oss-lib components.
+ *
+ * BUNDLE-SPLIT CONVENTION — read before adding new files here:
+ *   Every module in `src/contexts/` calls `createContext()` at module
+ *   top level. The tsup config builds this directory under the CLIENT
+ *   bundle (with `"use client"` banner). Importing anything from here
+ *   into a SERVER-bundled module (`utils/index.ts` and its `export *`
+ *   transitive closure) crashes SSR with
+ *   `createContext is not a function`.
+ *
+ *   Rule of thumb when adding a runtime-aware helper:
+ *     - Pure functions that take endpoints/runtime as args → `utils/`.
+ *     - React hooks that READ the runtime via useContext → `hooks/`
+ *       (with `'use client'` at the top of the file).
+ *     - Never re-export from `utils/*` anything that pulls
+ *       `src/contexts/*` transitively.
+ *
+ *   The split between `utils/access-code-client.ts` (pure) and
+ *   `hooks/use-access-code-integration.ts` (runtime-aware) is the
+ *   reference example.
+ */
+export { EndpointsRuntimeContext, useEndpointsRuntime, useRequiredEndpointsRuntime, type EndpointsRuntime, } from './endpoints-runtime-context';
+export { ChatRuntimeContext, useChatRuntime, useRequiredChatRuntime, type ChatRuntime, } from './chat-runtime-context';
+export { useOuterOrDefault } from './use-outer-or-default';
+//# sourceMappingURL=index.d.ts.map

package/dist/contexts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAA;AAEpC,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/contexts/index.js

@@ -0,0 +1,30 @@
+"use client";
+import {
+  ChatRuntimeContext,
+  useChatRuntime,
+  useRequiredChatRuntime
+} from "../chunk-7L4DWM7P.js";
+import {
+  EndpointsRuntimeContext,
+  useEndpointsRuntime,
+  useRequiredEndpointsRuntime
+} from "../chunk-MJNXIEV2.js";
+import "../chunk-GGWZFCYS.js";
+
+// src/contexts/use-outer-or-default.ts
+import { useContext, useMemo } from "react";
+function useOuterOrDefault(context, factory, deps = []) {
+  const outer = useContext(context);
+  const fallback = useMemo(factory, deps);
+  return outer ?? fallback;
+}
+export {
+  ChatRuntimeContext,
+  EndpointsRuntimeContext,
+  useChatRuntime,
+  useEndpointsRuntime,
+  useOuterOrDefault,
+  useRequiredChatRuntime,
+  useRequiredEndpointsRuntime
+};
+//# sourceMappingURL=index.js.map

package/dist/contexts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/contexts/use-outer-or-default.ts"],"sourcesContent":["'use client'\n\n/**\n * Outer-forward provider helper — used by hub + embedder providers\n * that supply default runtime values while allowing OUTER providers\n * to override.\n *\n * When an embedder mounts an outer `<ChatRuntimeContext.Provider>`\n * (or `<EndpointsRuntimeContext.Provider>`) ABOVE the hub provider,\n * the outer value wins. When no outer is mounted, the hub provider\n * supplies its `factory()` default. Tree shape stays constant —\n * same provider element at the same position regardless of outer\n * presence — so consumers below never remount when an embedder\n * toggles their providers at runtime.\n *\n * `deps` controls factory memoization:\n *   - Empty `[]` (default) → factory runs ONCE per mount; safe ONLY\n *     when factory closes over module-scope/constant values.\n *   - Non-empty → factory re-runs when deps change. Use when the\n *     factory closes over callbacks or other reactive values\n *     (e.g. hub's ChatRuntime which includes `navigate` +\n *     `decideNewTab` callbacks that depend on router + docNav).\n *\n * Returning the SAME reference across renders is critical for\n * downstream `useMemo` consumers. With empty deps, identity is\n * trivially stable. With reactive deps, the caller must memoize\n * the deps themselves (typically via `useCallback`).\n */\n\nimport { useContext, useMemo, type Context } from 'react'\n\nexport function useOuterOrDefault<T>(\n  context: Context<T | null>,\n  factory: () => T,\n  deps: ReadonlyArray<unknown> = [],\n): T {\n  const outer = useContext(context)\n  // eslint-disable-next-line react-hooks/exhaustive-deps -- deps are the contract;\n  // factory identity is intentionally ignored (caller controls re-creation via deps).\n  const fallback = useMemo(factory, deps)\n  return outer ?? fallback\n}\n"],"mappings":";;;;;;;;;;;;;;AA6BA,SAAS,YAAY,eAA6B;AAE3C,SAAS,kBACd,SACA,SACA,OAA+B,CAAC,GAC7B;AACH,QAAM,QAAQ,WAAW,OAAO;AAGhC,QAAM,WAAW,QAAQ,SAAS,IAAI;AACtC,SAAO,SAAS;AAClB;","names":[]}

package/dist/contexts/use-outer-or-default.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Outer-forward provider helper — used by hub + embedder providers
+ * that supply default runtime values while allowing OUTER providers
+ * to override.
+ *
+ * When an embedder mounts an outer `<ChatRuntimeContext.Provider>`
+ * (or `<EndpointsRuntimeContext.Provider>`) ABOVE the hub provider,
+ * the outer value wins. When no outer is mounted, the hub provider
+ * supplies its `factory()` default. Tree shape stays constant —
+ * same provider element at the same position regardless of outer
+ * presence — so consumers below never remount when an embedder
+ * toggles their providers at runtime.
+ *
+ * `deps` controls factory memoization:
+ *   - Empty `[]` (default) → factory runs ONCE per mount; safe ONLY
+ *     when factory closes over module-scope/constant values.
+ *   - Non-empty → factory re-runs when deps change. Use when the
+ *     factory closes over callbacks or other reactive values
+ *     (e.g. hub's ChatRuntime which includes `navigate` +
+ *     `decideNewTab` callbacks that depend on router + docNav).
+ *
+ * Returning the SAME reference across renders is critical for
+ * downstream `useMemo` consumers. With empty deps, identity is
+ * trivially stable. With reactive deps, the caller must memoize
+ * the deps themselves (typically via `useCallback`).
+ */
+import { type Context } from 'react';
+export declare function useOuterOrDefault<T>(context: Context<T | null>, factory: () => T, deps?: ReadonlyArray<unknown>): T;
+//# sourceMappingURL=use-outer-or-default.d.ts.map

package/dist/contexts/use-outer-or-default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-outer-or-default.d.ts","sourceRoot":"","sources":["../../src/contexts/use-outer-or-default.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAuB,KAAK,OAAO,EAAE,MAAM,OAAO,CAAA;AAEzD,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,EAC1B,OAAO,EAAE,MAAM,CAAC,EAChB,IAAI,GAAE,aAAa,CAAC,OAAO,CAAM,GAChC,CAAC,CAMH"}

package/dist/embed-shims/index.cjs

@@ -0,0 +1,51 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkG7UE6RKVcjs = require('../chunk-G7UE6RKV.cjs');
+
+
+
+var _chunkXL4V2PYGcjs = require('../chunk-XL4V2PYG.cjs');
+
+
+
+var _chunkBZFW3FOFcjs = require('../chunk-BZFW3FOF.cjs');
+
+
+
+
+var _chunkWBR7H6E3cjs = require('../chunk-WBR7H6E3.cjs');
+require('../chunk-VRHGVLSL.cjs');
+
+// src/embed-shims/index.ts
+_chunkWBR7H6E3cjs.init_next_link.call(void 0, );
+_chunkG7UE6RKVcjs.init_next_navigation.call(void 0, );
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.Image = _chunkXL4V2PYGcjs.next_image_default; exports.Link = _chunkWBR7H6E3cjs.next_link_default; exports.RedirectType = _chunkG7UE6RKVcjs.RedirectType; exports.ServerInsertedHTMLContext = _chunkG7UE6RKVcjs.ServerInsertedHTMLContext; exports.dynamic = _chunkBZFW3FOFcjs.dynamic; exports.notFound = _chunkG7UE6RKVcjs.notFound; exports.permanentRedirect = _chunkG7UE6RKVcjs.permanentRedirect; exports.redirect = _chunkG7UE6RKVcjs.redirect; exports.registerDynamic = _chunkBZFW3FOFcjs.registerDynamic; exports.registerImage = _chunkXL4V2PYGcjs.registerImage; exports.registerLink = _chunkWBR7H6E3cjs.registerLink; exports.registerNavigation = _chunkG7UE6RKVcjs.registerNavigation; exports.useParams = _chunkG7UE6RKVcjs.useParams; exports.usePathname = _chunkG7UE6RKVcjs.usePathname; exports.useRouter = _chunkG7UE6RKVcjs.useRouter; exports.useSearchParams = _chunkG7UE6RKVcjs.useSearchParams;
+//# sourceMappingURL=index.cjs.map

package/dist/embed-shims/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/embed-shims/index.cjs","../../src/embed-shims/index.ts"],"names":[],"mappings":"AAAA,qFAAY;AACZ;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACF,yDAA8B;AAC9B;AACE;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACA;ACFA,8CAAA,CAAA;AAEA,oDAAA,CAAA;ADGA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,i4BAAC","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/embed-shims/index.cjs","sourcesContent":[null,"/**\n * Barrel for the `embed-shims/` shims.\n *\n * Each shim is environment-aware: by default it renders a plain HTML\n * equivalent so non-Next hosts (Vite, CRA, esbuild) work out of the\n * box. Next.js hosts opt into the REAL Next primitives by calling the\n * `register*` functions ONCE at app init — see each shim's docblock\n * for the host wiring snippet. After registration, every lib component\n * that renders through these shims delegates to the real Next impl\n * (Image Optimization, client-router prefetching, full app-router\n * navigation, etc.) without further config.\n *\n * Lib internals import each shim directly via its relative path\n * (`../embed-shims/next-link`). Hub and external consumers import\n * through this barrel:\n *\n *   import { Link, Image, dynamic, useRouter, usePathname } from\n *     '@flamingo-stack/openframe-frontend-core/embed-shims'\n *\n * Or per-shim:\n *\n *   import Link  from '@flamingo-stack/openframe-frontend-core/embed-shims/next-link'\n *   import Image from '@flamingo-stack/openframe-frontend-core/embed-shims/next-image'\n *\n * Companion to the docblocks on each individual shim file.\n */\nexport { default as Image, registerImage } from './next-image'\nexport { default as Link, registerLink } from './next-link'\nexport { default as dynamic, registerDynamic } from './next-dynamic'\nexport {\n  useRouter,\n  usePathname,\n  useSearchParams,\n  useParams,\n  redirect,\n  permanentRedirect,\n  notFound,\n  RedirectType,\n  ServerInsertedHTMLContext,\n  registerNavigation,\n  type NavigationImpl,\n} from './next-navigation'\n"]}

package/dist/embed-shims/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Barrel for the `embed-shims/` shims.
+ *
+ * Each shim is environment-aware: by default it renders a plain HTML
+ * equivalent so non-Next hosts (Vite, CRA, esbuild) work out of the
+ * box. Next.js hosts opt into the REAL Next primitives by calling the
+ * `register*` functions ONCE at app init — see each shim's docblock
+ * for the host wiring snippet. After registration, every lib component
+ * that renders through these shims delegates to the real Next impl
+ * (Image Optimization, client-router prefetching, full app-router
+ * navigation, etc.) without further config.
+ *
+ * Lib internals import each shim directly via its relative path
+ * (`../embed-shims/next-link`). Hub and external consumers import
+ * through this barrel:
+ *
+ *   import { Link, Image, dynamic, useRouter, usePathname } from
+ *     '@flamingo-stack/openframe-frontend-core/embed-shims'
+ *
+ * Or per-shim:
+ *
+ *   import Link  from '@flamingo-stack/openframe-frontend-core/embed-shims/next-link'
+ *   import Image from '@flamingo-stack/openframe-frontend-core/embed-shims/next-image'
+ *
+ * Companion to the docblocks on each individual shim file.
+ */
+export { default as Image, registerImage } from './next-image';
+export { default as Link, registerLink } from './next-link';
+export { default as dynamic, registerDynamic } from './next-dynamic';
+export { useRouter, usePathname, useSearchParams, useParams, redirect, permanentRedirect, notFound, RedirectType, ServerInsertedHTMLContext, registerNavigation, type NavigationImpl, } from './next-navigation';
+//# sourceMappingURL=index.d.ts.map

package/dist/embed-shims/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/embed-shims/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EACL,SAAS,EACT,WAAW,EACX,eAAe,EACf,SAAS,EACT,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,YAAY,EACZ,yBAAyB,EACzB,kBAAkB,EAClB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAA"}

package/dist/embed-shims/index.js

@@ -0,0 +1,51 @@
+"use client";
+import {
+  RedirectType,
+  ServerInsertedHTMLContext,
+  init_next_navigation,
+  notFound,
+  permanentRedirect,
+  redirect,
+  registerNavigation,
+  useParams,
+  usePathname,
+  useRouter,
+  useSearchParams
+} from "../chunk-PLJLE4A4.js";
+import {
+  next_image_default,
+  registerImage
+} from "../chunk-LXC6P2EO.js";
+import {
+  dynamic,
+  registerDynamic
+} from "../chunk-EL5YVPD5.js";
+import {
+  init_next_link,
+  next_link_default,
+  registerLink
+} from "../chunk-OHPI2HRK.js";
+import "../chunk-GGWZFCYS.js";
+
+// src/embed-shims/index.ts
+init_next_link();
+init_next_navigation();
+export {
+  next_image_default as Image,
+  next_link_default as Link,
+  RedirectType,
+  ServerInsertedHTMLContext,
+  dynamic,
+  notFound,
+  permanentRedirect,
+  redirect,
+  registerDynamic,
+  registerImage,
+  registerLink,
+  registerNavigation,
+  useParams,
+  usePathname,
+  useRouter,
+  useSearchParams
+};
+//# sourceMappingURL=index.js.map

package/dist/embed-shims/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/embed-shims/index.ts"],"sourcesContent":["/**\n * Barrel for the `embed-shims/` shims.\n *\n * Each shim is environment-aware: by default it renders a plain HTML\n * equivalent so non-Next hosts (Vite, CRA, esbuild) work out of the\n * box. Next.js hosts opt into the REAL Next primitives by calling the\n * `register*` functions ONCE at app init — see each shim's docblock\n * for the host wiring snippet. After registration, every lib component\n * that renders through these shims delegates to the real Next impl\n * (Image Optimization, client-router prefetching, full app-router\n * navigation, etc.) without further config.\n *\n * Lib internals import each shim directly via its relative path\n * (`../embed-shims/next-link`). Hub and external consumers import\n * through this barrel:\n *\n *   import { Link, Image, dynamic, useRouter, usePathname } from\n *     '@flamingo-stack/openframe-frontend-core/embed-shims'\n *\n * Or per-shim:\n *\n *   import Link  from '@flamingo-stack/openframe-frontend-core/embed-shims/next-link'\n *   import Image from '@flamingo-stack/openframe-frontend-core/embed-shims/next-image'\n *\n * Companion to the docblocks on each individual shim file.\n */\nexport { default as Image, registerImage } from './next-image'\nexport { default as Link, registerLink } from './next-link'\nexport { default as dynamic, registerDynamic } from './next-dynamic'\nexport {\n  useRouter,\n  usePathname,\n  useSearchParams,\n  useParams,\n  redirect,\n  permanentRedirect,\n  notFound,\n  RedirectType,\n  ServerInsertedHTMLContext,\n  registerNavigation,\n  type NavigationImpl,\n} from './next-navigation'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA;AAEA;","names":[]}

package/dist/embed-shims/next-dynamic.cjs

@@ -0,0 +1,12 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+"use client";
+
+
+
+var _chunkBZFW3FOFcjs = require('../chunk-BZFW3FOF.cjs');
+require('../chunk-VRHGVLSL.cjs');
+
+
+
+exports.default = _chunkBZFW3FOFcjs.dynamic; exports.registerDynamic = _chunkBZFW3FOFcjs.registerDynamic;
+//# sourceMappingURL=next-dynamic.cjs.map

package/dist/embed-shims/next-dynamic.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/embed-shims/next-dynamic.cjs"],"names":[],"mappings":"AAAA,qFAAY;AACZ,YAAY;AACZ;AACE;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACF,yGAAC","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/embed-shims/next-dynamic.cjs"}

package/dist/embed-shims/next-dynamic.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `next/dynamic` shim — environment-aware lazy loader.
+ *
+ * Defaults to `React.lazy` so non-Next hosts (Vite, CRA, esbuild) work
+ * out of the box. Callers MUST be wrapped in a `<Suspense>` boundary
+ * somewhere up the tree (Next.js's runtime provides one automatically;
+ * non-Next embedders provide their own).
+ *
+ * Next.js hosts can opt into the REAL `next/dynamic` (with SSR support,
+ * loading components, prefetch hints) by calling {@link registerDynamic}
+ * ONCE at app init:
+ *
+ *   // hub: lib/embed-shim-registration.ts
+ *   import nextDynamic from 'next/dynamic'
+ *   import { registerDynamic } from '@flamingo-stack/openframe-frontend-core/embed-shims'
+ *   registerDynamic(nextDynamic)
+ *
+ * After registration, every lib call to this shim's default export
+ * delegates to `next/dynamic`. Without registration, `ssr` / `loading`
+ * options are ignored (React.lazy doesn't support them).
+ */
+import { type ComponentType, type ReactNode } from 'react';
+interface DynamicOptions {
+    loading?: (props: {
+        error?: Error | null;
+        isLoading?: boolean;
+        pastDelay?: boolean;
+        retry?: () => void;
+        timedOut?: boolean;
+    }) => ReactNode | null;
+    ssr?: boolean;
+    suspense?: boolean;
+}
+type DynamicLoader<P> = () => Promise<{
+    default: ComponentType<P>;
+} | ComponentType<P>>;
+/** Matches `next/dynamic`'s exported signature. */
+type DynamicFn = <P extends Record<string, any> = Record<string, never>>(loader: DynamicLoader<P>, options?: DynamicOptions) => ComponentType<P>;
+/**
+ * Register the real `next/dynamic` so this shim delegates to it instead
+ * of `React.lazy`. Call ONCE at app init in a Next.js host. The function
+ * signature must match `next/dynamic`'s default export.
+ */
+export declare function registerDynamic(fn: DynamicFn): void;
+export default function dynamic<P extends Record<string, any> = Record<string, never>>(loader: DynamicLoader<P>, options?: DynamicOptions): ComponentType<P>;
+export {};
+//# sourceMappingURL=next-dynamic.d.ts.map

package/dist/embed-shims/next-dynamic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-dynamic.d.ts","sourceRoot":"","sources":["../../src/embed-shims/next-dynamic.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAQ,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEhE,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAChB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;QACpB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,SAAS,CAAC,EAAE,OAAO,CAAA;QACnB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;KACnB,KAAK,SAAS,GAAG,IAAI,CAAA;IACtB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,KAAK,aAAa,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;AAEvF,mDAAmD;AACnD,KAAK,SAAS,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACrE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,cAAc,KACrB,aAAa,CAAC,CAAC,CAAC,CAAA;AAYrB;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAEnD;AAED,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACnF,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,aAAa,CAAC,CAAC,CAAC,CAElB"}

package/dist/embed-shims/next-dynamic.js

@@ -0,0 +1,12 @@
+"use client";
+"use client";
+import {
+  dynamic,
+  registerDynamic
+} from "../chunk-EL5YVPD5.js";
+import "../chunk-GGWZFCYS.js";
+export {
+  dynamic as default,
+  registerDynamic
+};
+//# sourceMappingURL=next-dynamic.js.map

package/dist/embed-shims/next-dynamic.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/embed-shims/next-image.cjs

@@ -0,0 +1,12 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+"use client";
+
+
+
+var _chunkXL4V2PYGcjs = require('../chunk-XL4V2PYG.cjs');
+require('../chunk-VRHGVLSL.cjs');
+
+
+
+exports.default = _chunkXL4V2PYGcjs.next_image_default; exports.registerImage = _chunkXL4V2PYGcjs.registerImage;
+//# sourceMappingURL=next-image.cjs.map

package/dist/embed-shims/next-image.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/embed-shims/next-image.cjs"],"names":[],"mappings":"AAAA,qFAAY;AACZ,YAAY;AACZ;AACE;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACF,gHAAC","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/embed-shims/next-image.cjs"}

package/dist/embed-shims/next-image.d.ts

@@ -0,0 +1,28 @@
+import { type ComponentType, type ImgHTMLAttributes } from 'react';
+/**
+ * Register the real `next/image` so this shim delegates to it instead
+ * of rendering a plain `<img>`. Call ONCE at app init in a Next.js host
+ * — subsequent calls overwrite the registration silently. Safe to skip
+ * entirely in non-Next environments.
+ */
+export declare function registerImage(component: ComponentType<any>): void;
+declare const Image: import("react").ForwardRefExoticComponent<Omit<ImgHTMLAttributes<HTMLImageElement>, "placeholder" | "src"> & {
+    src?: string | {
+        src: string;
+    };
+    alt?: string;
+    width?: number | string;
+    height?: number | string;
+    fill?: boolean;
+    sizes?: string;
+    quality?: number;
+    priority?: boolean;
+    loading?: "eager" | "lazy";
+    placeholder?: "blur" | "empty" | `data:image/${string}`;
+    blurDataURL?: string;
+    unoptimized?: boolean;
+    onLoadingComplete?: (img: HTMLImageElement) => void;
+    loader?: unknown;
+} & import("react").RefAttributes<HTMLImageElement>>;
+export default Image;
+//# sourceMappingURL=next-image.d.ts.map

package/dist/embed-shims/next-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-image.d.ts","sourceRoot":"","sources":["../../src/embed-shims/next-image.tsx"],"names":[],"mappings":"AAsBA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAA;AAqBd;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAEjE;AAED,QAAA,MAAM,KAAK;UA5BH,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;UACxB,MAAM;YACJ,MAAM,GAAG,MAAM;aACd,MAAM,GAAG,MAAM;WACjB,OAAO;YACN,MAAM;cACJ,MAAM;eACL,OAAO;cACR,OAAO,GAAG,MAAM;kBACZ,MAAM,GAAG,OAAO,GAAG,cAAc,MAAM,EAAE;kBACzC,MAAM;kBACN,OAAO;wBACD,CAAC,GAAG,EAAE,gBAAgB,KAAK,IAAI;aAC1C,OAAO;oDAqEhB,CAAA;AAEF,eAAe,KAAK,CAAA"}

package/dist/embed-shims/next-image.js

@@ -0,0 +1,12 @@
+"use client";
+"use client";
+import {
+  next_image_default,
+  registerImage
+} from "../chunk-LXC6P2EO.js";
+import "../chunk-GGWZFCYS.js";
+export {
+  next_image_default as default,
+  registerImage
+};
+//# sourceMappingURL=next-image.js.map

package/dist/embed-shims/next-image.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/embed-shims/next-link.cjs

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});"use client";
+"use client";
+
+
+
+
+var _chunkWBR7H6E3cjs = require('../chunk-WBR7H6E3.cjs');
+require('../chunk-VRHGVLSL.cjs');
+_chunkWBR7H6E3cjs.init_next_link.call(void 0, );
+
+
+
+exports.default = _chunkWBR7H6E3cjs.next_link_default; exports.registerLink = _chunkWBR7H6E3cjs.registerLink;
+//# sourceMappingURL=next-link.cjs.map

package/dist/embed-shims/next-link.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/embed-shims/next-link.cjs"],"names":[],"mappings":"AAAA,qFAAY;AACZ,YAAY;AACZ;AACE;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,8CAAc,CAAE;AAChB;AACE;AACA;AACF,6GAAC","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/embed-shims/next-link.cjs"}