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

package/dist/chunk-3MCHAFHB.js

@@ -1,89 +0,0 @@
-"use client";
-import {
-  embedAuthedFetch,
-  hasEmbedAuthAdapter
-} from "./chunk-POKKCWKF.js";
-
-// src/hooks/use-near-viewport.ts
-import { useEffect, useRef, useState, useCallback } from "react";
-var observers = /* @__PURE__ */ new Map();
-var subscribers = /* @__PURE__ */ new WeakMap();
-function getObserverFor(rootMargin) {
-  const existing = observers.get(rootMargin);
-  if (existing) return existing;
-  const io = new IntersectionObserver(
-    (entries) => {
-      entries.forEach((entry) => {
-        if (!entry.isIntersecting) return;
-        const cb = subscribers.get(entry.target);
-        if (cb) {
-          cb();
-          io.unobserve(entry.target);
-          subscribers.delete(entry.target);
-        }
-      });
-    },
-    { rootMargin }
-  );
-  observers.set(rootMargin, io);
-  return io;
-}
-function useNearViewport(rootMargin = "500px") {
-  const [isNear, setIsNear] = useState(false);
-  const elRef = useRef(null);
-  const ref = useCallback(
-    (node) => {
-      const prev = elRef.current;
-      if (prev) {
-        const stillOurs = subscribers.get(prev);
-        if (stillOurs) {
-          subscribers.delete(prev);
-          observers.get(rootMargin)?.unobserve(prev);
-        }
-      }
-      elRef.current = node;
-      if (!node) return;
-      const cb = () => setIsNear(true);
-      subscribers.set(node, cb);
-      getObserverFor(rootMargin).observe(node);
-    },
-    [rootMargin]
-  );
-  useEffect(() => {
-    return () => {
-      const el = elRef.current;
-      if (!el) return;
-      if (subscribers.get(el)) {
-        subscribers.delete(el);
-        observers.get(rootMargin)?.unobserve(el);
-      }
-    };
-  }, [rootMargin]);
-  return { ref, isNear };
-}
-
-// src/hooks/use-og-placeholder.ts
-import { useMemo } from "react";
-function useOgPlaceholder(buildUrl, title, siteName = "", enabled = true, aspect = "wide") {
-  return useMemo(() => {
-    if (!enabled || !title) return null;
-    const options = {};
-    if (siteName) options.site = siteName;
-    if (aspect === "square") options.aspect = "square";
-    return buildUrl(title, options);
-  }, [buildUrl, title, siteName, enabled, aspect]);
-}
-
-// src/utils/embed-content-fetch.ts
-var contentFetch = (input, init) => {
-  if (!hasEmbedAuthAdapter()) return fetch(input, init);
-  const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
-  return embedAuthedFetch(url, init);
-};
-
-export {
-  contentFetch,
-  useNearViewport,
-  useOgPlaceholder
-};
-//# sourceMappingURL=chunk-3MCHAFHB.js.map

package/dist/chunk-3MCHAFHB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/use-near-viewport.ts","../src/hooks/use-og-placeholder.ts","../src/utils/embed-content-fetch.ts"],"sourcesContent":["/**\n * useNearViewport — module-level shared IntersectionObserver in hook form.\n *\n * Single IO instance per `rootMargin` value, shared across every component\n * that mounts the hook. Reduces overhead vs. one IO per component on\n * grid/list pages where many subscribers observe the viewport with the same\n * margin. Promoted from the inline singleton at\n * `multi-platform-hub/components/shared/video-bites-display.tsx:21-43`,\n * which is the only IO pattern in either repo today.\n *\n * Usage:\n * ```tsx\n * function MyCard() {\n *   const { ref, isNear } = useNearViewport('500px');\n *   return <div ref={ref}>{isNear ? <HeavyChild /> : <Placeholder />}</div>;\n * }\n * ```\n *\n * StrictMode safety: cleanup uses an identity check on the registered\n * callback so React's dev double-mount (mount → cleanup → re-mount) does\n * not drop the second mount's freshly-set subscription. The IO callback\n * also checks `subscribers.get(target)` before invoking so a fire that\n * races with unmount cannot crash on a torn-down component.\n *\n * The hook fires once — on first intersection it sets `isNear=true` and\n * unobserves the element. Callers that need re-observation should\n * unmount and remount (or fork the hook for two-way behavior).\n */\n\nimport { useEffect, useRef, useState, useCallback } from 'react';\n\n// Per-rootMargin IO map. Multiple call sites with different margins each\n// get their own singleton observer.\nconst observers = new Map<string, IntersectionObserver>();\nconst subscribers = new WeakMap<Element, () => void>();\n\nfunction getObserverFor(rootMargin: string): IntersectionObserver {\n  const existing = observers.get(rootMargin);\n  if (existing) return existing;\n\n  const io = new IntersectionObserver(\n    (entries) => {\n      entries.forEach((entry) => {\n        if (!entry.isIntersecting) return;\n        // Race-safe: re-read the callback at fire time. A late IO firing\n        // after cleanup must not invoke a stale callback.\n        const cb = subscribers.get(entry.target);\n        if (cb) {\n          cb();\n          io.unobserve(entry.target);\n          subscribers.delete(entry.target);\n        }\n      });\n    },\n    { rootMargin }\n  );\n  observers.set(rootMargin, io);\n  return io;\n}\n\nexport interface UseNearViewportResult<T extends Element = HTMLElement> {\n  /** Ref to attach to the element you want to gate on visibility. */\n  ref: (node: T | null) => void;\n  /** Flips to `true` once the element enters within `rootMargin` of the viewport. Never flips back. */\n  isNear: boolean;\n}\n\n/**\n * @param rootMargin Margin around the viewport (CSS-style string).\n *                   '500px' = element starts mounting 500px before scroll-in.\n *                   '1000px' = a full viewport's worth of lookahead.\n *                   '0px' = strict on-screen detection.\n */\nexport function useNearViewport<T extends Element = HTMLElement>(\n  rootMargin: string = '500px'\n): UseNearViewportResult<T> {\n  const [isNear, setIsNear] = useState(false);\n  const elRef = useRef<T | null>(null);\n\n  // Subscribe/unsubscribe on element change.\n  const ref = useCallback(\n    (node: T | null) => {\n      const prev = elRef.current;\n\n      // Unsubscribe previous, if any. Identity-check the callback so a\n      // StrictMode re-mount that has already re-registered keeps its sub.\n      if (prev) {\n        const stillOurs = subscribers.get(prev);\n        if (stillOurs) {\n          subscribers.delete(prev);\n          observers.get(rootMargin)?.unobserve(prev);\n        }\n      }\n\n      elRef.current = node;\n      if (!node) return;\n\n      const cb = () => setIsNear(true);\n      subscribers.set(node, cb);\n      getObserverFor(rootMargin).observe(node);\n    },\n    [rootMargin]\n  );\n\n  // Unsubscribe on unmount. Identity check guards the StrictMode race.\n  useEffect(() => {\n    return () => {\n      const el = elRef.current;\n      if (!el) return;\n      if (subscribers.get(el)) {\n        subscribers.delete(el);\n        observers.get(rootMargin)?.unobserve(el);\n      }\n    };\n  }, [rootMargin]);\n\n  return { ref, isNear };\n}\n","'use client'\n\nimport { useMemo } from 'react'\n\n/**\n * Hook that generates a branded placeholder image URL using the\n * host's `/api/og-placeholder` server-side image generator (or any\n * builder the caller supplies).\n *\n * THIS HOOK IS A THIN CLIENT-SIDE WRAPPER. The hub-side wrapper\n * (`hooks/use-og-placeholder.ts` in multi-platform-hub) injects its\n * canonical `buildOgPlaceholderUrl` from `lib/utils/entity-image.ts`.\n * The lib version takes the builder as an argument so the lib has no\n * hub dependency.\n *\n * @param buildUrl - Function that builds the placeholder URL from a\n *                   title + options object (`{ site?, aspect? }`).\n *                   Hub passes `buildOgPlaceholderUrl` from\n *                   `lib/utils/entity-image.ts`. Embedded apps can\n *                   wire any equivalent that hits their own placeholder\n *                   route.\n * @param title    - Text to display on the placeholder\n * @param siteName - Site name shown below the title (optional —\n *                   defaults to empty)\n * @param enabled  - Whether to generate the URL (default: true)\n * @param aspect   - `'wide'` (1200×630 social-card; default) or `'square'`\n *                   (1024×1024 — used by compact chat-inline card slots\n *                   so `object-cover` doesn't crop the title off).\n * @returns Placeholder image URL or null if disabled / no title\n */\nexport function useOgPlaceholder(\n  buildUrl: (title: string, options: { site?: string; aspect?: 'wide' | 'square' }) => string,\n  title: string | undefined | null,\n  siteName: string = '',\n  enabled: boolean = true,\n  aspect: 'wide' | 'square' = 'wide',\n): string | null {\n  return useMemo(() => {\n    if (!enabled || !title) return null\n    const options: { site?: string; aspect?: 'wide' | 'square' } = {}\n    if (siteName) options.site = siteName\n    if (aspect === 'square') options.aspect = 'square'\n    return buildUrl(title, options)\n  }, [buildUrl, title, siteName, enabled, aspect])\n}\n","'use client'\n\n/**\n * `contentFetch` — the fetch the lib's SELF-FETCHING content surfaces use:\n * roadmap (list + vote + per-task refresh), delivery, product releases,\n * onboarding guides (catalog + detail), legal docs, and the release-detail\n * injected roadmap/delivery sections.\n *\n * It deliberately reuses the SINGLE embed-auth knob — the registered\n * `EmbedAuthAdapter` — instead of introducing a second registration:\n *   - adapter registered (host opted into embedded auth, e.g. openframe-frontend\n *     for its embedded chat) → route through `embedAuthedFetch`, so content GETs/\n *     POSTs carry the SAME bearer/cookie + 401-refresh as the chat.\n *   - no adapter (the public hub, or the embedding example whose proxy injects\n *     auth server-side) → a plain, byte-for-byte unchanged `fetch`.\n *\n * So a host wires auth ONCE (the chat adapter) and content inherits it; there is\n * no content-specific fetcher to configure.\n */\n\nimport { embedAuthedFetch, hasEmbedAuthAdapter } from './embed-authed-fetch'\n\nexport const contentFetch: typeof fetch = (input, init) => {\n  if (!hasEmbedAuthAdapter()) return fetch(input, init)\n  // embedAuthedFetch takes a string url; coerce the broader `fetch` input shape\n  // (content surfaces always pass strings, but handle URL/Request defensively).\n  const url =\n    typeof input === 'string' ? input : input instanceof URL ? input.href : (input as Request).url\n  return embedAuthedFetch(url, init)\n}\n"],"mappings":";;;;;;;AA6BA,SAAS,WAAW,QAAQ,UAAU,mBAAmB;AAIzD,IAAM,YAAY,oBAAI,IAAkC;AACxD,IAAM,cAAc,oBAAI,QAA6B;AAErD,SAAS,eAAe,YAA0C;AAChE,QAAM,WAAW,UAAU,IAAI,UAAU;AACzC,MAAI,SAAU,QAAO;AAErB,QAAM,KAAK,IAAI;AAAA,IACb,CAAC,YAAY;AACX,cAAQ,QAAQ,CAAC,UAAU;AACzB,YAAI,CAAC,MAAM,eAAgB;AAG3B,cAAM,KAAK,YAAY,IAAI,MAAM,MAAM;AACvC,YAAI,IAAI;AACN,aAAG;AACH,aAAG,UAAU,MAAM,MAAM;AACzB,sBAAY,OAAO,MAAM,MAAM;AAAA,QACjC;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA,EAAE,WAAW;AAAA,EACf;AACA,YAAU,IAAI,YAAY,EAAE;AAC5B,SAAO;AACT;AAeO,SAAS,gBACd,aAAqB,SACK;AAC1B,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,KAAK;AAC1C,QAAM,QAAQ,OAAiB,IAAI;AAGnC,QAAM,MAAM;AAAA,IACV,CAAC,SAAmB;AAClB,YAAM,OAAO,MAAM;AAInB,UAAI,MAAM;AACR,cAAM,YAAY,YAAY,IAAI,IAAI;AACtC,YAAI,WAAW;AACb,sBAAY,OAAO,IAAI;AACvB,oBAAU,IAAI,UAAU,GAAG,UAAU,IAAI;AAAA,QAC3C;AAAA,MACF;AAEA,YAAM,UAAU;AAChB,UAAI,CAAC,KAAM;AAEX,YAAM,KAAK,MAAM,UAAU,IAAI;AAC/B,kBAAY,IAAI,MAAM,EAAE;AACxB,qBAAe,UAAU,EAAE,QAAQ,IAAI;AAAA,IACzC;AAAA,IACA,CAAC,UAAU;AAAA,EACb;AAGA,YAAU,MAAM;AACd,WAAO,MAAM;AACX,YAAM,KAAK,MAAM;AACjB,UAAI,CAAC,GAAI;AACT,UAAI,YAAY,IAAI,EAAE,GAAG;AACvB,oBAAY,OAAO,EAAE;AACrB,kBAAU,IAAI,UAAU,GAAG,UAAU,EAAE;AAAA,MACzC;AAAA,IACF;AAAA,EACF,GAAG,CAAC,UAAU,CAAC;AAEf,SAAO,EAAE,KAAK,OAAO;AACvB;;;ACnHA,SAAS,eAAe;AA4BjB,SAAS,iBACd,UACA,OACA,WAAmB,IACnB,UAAmB,MACnB,SAA4B,QACb;AACf,SAAO,QAAQ,MAAM;AACnB,QAAI,CAAC,WAAW,CAAC,MAAO,QAAO;AAC/B,UAAM,UAAyD,CAAC;AAChE,QAAI,SAAU,SAAQ,OAAO;AAC7B,QAAI,WAAW,SAAU,SAAQ,SAAS;AAC1C,WAAO,SAAS,OAAO,OAAO;AAAA,EAChC,GAAG,CAAC,UAAU,OAAO,UAAU,SAAS,MAAM,CAAC;AACjD;;;ACtBO,IAAM,eAA6B,CAAC,OAAO,SAAS;AACzD,MAAI,CAAC,oBAAoB,EAAG,QAAO,MAAM,OAAO,IAAI;AAGpD,QAAM,MACJ,OAAO,UAAU,WAAW,QAAQ,iBAAiB,MAAM,MAAM,OAAQ,MAAkB;AAC7F,SAAO,iBAAiB,KAAK,IAAI;AACnC;","names":[]}