@sonordev/site-kit 5.7.0 → 5.8.1

package/dist/motion/gsap.js

@@ -17,9 +17,39 @@ function loadGsap() {
   }
   return pending;
 }
+var pluginCache = /* @__PURE__ */ new Map();
+function pickPlugin(mod, name) {
+  const m = mod;
+  return (m && (m[name] ?? m.default)) ?? mod;
+}
+async function loadGsapPlugins(gsap, loaders = {}) {
+  const entries = await Promise.all(
+    Object.entries(loaders).map(async ([name, load]) => {
+      let pending2 = pluginCache.get(name);
+      if (!pending2) {
+        pending2 = load().then((mod) => pickPlugin(mod, name));
+        pluginCache.set(name, pending2);
+      }
+      return [name, await pending2];
+    })
+  );
+  const plugins = Object.fromEntries(entries);
+  const list = Object.values(plugins);
+  if (list.length) gsap.registerPlugin(...list);
+  return plugins;
+}
+function runGsapSetup(bundle, el, plugins, setup) {
+  let cleanup = void 0;
+  const context = bundle.gsap.context((self) => {
+    cleanup = setup({ ...bundle, el, plugins, context: self });
+  }, el);
+  return { context, cleanup };
+}
 function useGsap(ref, setup, deps = [], options = {}) {
   const setupRef = react.useRef(setup);
   setupRef.current = setup;
+  const pluginsRef = react.useRef(options.plugins);
+  pluginsRef.current = options.plugins;
   const { near = "200px 0px", reducedMotion = "skip" } = options;
   react.useEffect(() => {
     const el = ref.current;
@@ -32,11 +62,9 @@ function useGsap(ref, setup, deps = [], options = {}) {
       ([entry]) => {
         if (!entry?.isIntersecting) return;
         io.disconnect();
-        loadGsap().then(({ gsap, ScrollTrigger }) => {
+        loadGsap().then(async (bundle) => ({ bundle, plugins: await loadGsapPlugins(bundle.gsap, pluginsRef.current) })).then(({ bundle, plugins }) => {
           if (cancelled || !el.isConnected) return;
-          ctx = gsap.context(() => {
-            cleanup = setupRef.current({ gsap, ScrollTrigger, el });
-          }, el);
+          ({ context: ctx, cleanup } = runGsapSetup(bundle, el, plugins, setupRef.current));
         });
       },
       { rootMargin: near }
@@ -97,6 +125,8 @@ function useExpandCollapse(isOpen, options = {}) {
 }
 
 exports.loadGsap = loadGsap;
+exports.loadGsapPlugins = loadGsapPlugins;
+exports.runGsapSetup = runGsapSetup;
 exports.useExpandCollapse = useExpandCollapse;
 exports.useGsap = useGsap;
 //# sourceMappingURL=gsap.js.map

package/dist/motion/gsap.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/motion/gsap.ts"],"names":["useRef","useEffect","prefersReducedMotion"],"mappings":"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","file":"gsap.js","sourcesContent":["/**\n * @sonordev/site-kit/motion/gsap — the Upforge motion standard, tier 1.\n *\n * GSAP for the moments that earn it: sequenced timelines, SplitText,\n * Flip, MorphSVG. Requires the optional peer `gsap` (all plugins are free\n * since 3.13):\n *\n *     npm i gsap\n *\n * A site that never imports this subpath never installs gsap. NOTHING\n * outside this file may import from 'gsap' — that is what keeps the tier\n * boundary real (src/motion/motion.test.tsx enforces it).\n *\n * Cost and where it goes: gsap core + ScrollTrigger is ~46KB gzipped.\n * `useGsap` loads it only when its element comes within 200px of the\n * viewport, so it never sits on the LCP critical path, and it must only be\n * used BELOW the fold. First-paint content renders static.\n *\n * Not included on purpose: ScrollSmoother. It drives scrolling by\n * transforming the page body, which fights native scroll, costs INP on\n * mobile, and breaks every scroll-geometry read on the page. The engine's\n * per-scene lerp gives the liquid feel without hijacking anything.\n */\n\n'use client'\n\nimport { useEffect, useRef, type DependencyList, type RefObject } from 'react'\nimport { prefersReducedMotion } from './engine'\n\ntype GsapModule = typeof import('gsap')\ntype ScrollTriggerModule = typeof import('gsap/ScrollTrigger')\n\nexport type Gsap = GsapModule['gsap']\nexport type ScrollTriggerStatic = ScrollTriggerModule['ScrollTrigger']\n\nexport interface GsapBundle {\n  gsap: Gsap\n  ScrollTrigger: ScrollTriggerStatic\n}\n\nlet pending: Promise<GsapBundle> | null = null\n\n/**\n * Load gsap + ScrollTrigger once, register the plugin, and share the\n * promise. Safe to call from anywhere; resolves the same bundle every time.\n */\nexport function loadGsap(): Promise<GsapBundle> {\n  if (!pending) {\n    pending = Promise.all([import('gsap'), import('gsap/ScrollTrigger')]).then(([g, st]) => {\n      const gsap = g.gsap ?? g.default\n      const ScrollTrigger = st.ScrollTrigger ?? st.default\n      gsap.registerPlugin(ScrollTrigger)\n      return { gsap, ScrollTrigger }\n    })\n  }\n  return pending\n}\n\nexport interface GsapSetupContext extends GsapBundle {\n  /** The element the hook is attached to — use it as the ScrollTrigger trigger and the selector scope. */\n  el: HTMLElement\n}\n\nexport interface UseGsapOptions {\n  /** Preload margin: load gsap when the element is this close. Default \"200px 0px\". */\n  near?: string\n  /** \"skip\" (default) does nothing under prefers-reduced-motion; \"run\" lets setup decide. */\n  reducedMotion?: 'skip' | 'run'\n}\n\n/**\n * Run a GSAP setup against an element, lazily and safely:\n *\n *   - gsap loads only when the element nears the viewport\n *   - setup runs inside `gsap.context(el)`, so selectors are scoped and\n *     everything it creates is reverted on unmount (including ScrollTriggers)\n *   - the element must be server-rendered and visible; hide things inside\n *     `setup` with `gsap.set`, never with a stylesheet\n *\n * @example\n *   const ref = useRef<HTMLDivElement>(null)\n *   useGsap(ref, ({ gsap, el }) => {\n *     gsap.from(el.querySelectorAll('[data-line]'), {\n *       yPercent: 100, opacity: 0, stagger: 0.06, duration: 0.8, ease: 'power3.out',\n *       scrollTrigger: { trigger: el, start: 'top 80%' },\n *     })\n *   })\n */\nexport function useGsap(\n  ref: RefObject<HTMLElement | null>,\n  setup: (ctx: GsapSetupContext) => void | (() => void),\n  deps: DependencyList = [],\n  options: UseGsapOptions = {},\n): void {\n  const setupRef = useRef(setup)\n  setupRef.current = setup\n  const { near = '200px 0px', reducedMotion = 'skip' } = options\n\n  useEffect(() => {\n    const el = ref.current\n    if (!el) return\n    if (reducedMotion === 'skip' && prefersReducedMotion()) return\n\n    let cancelled = false\n    let cleanup: (() => void) | void\n    let ctx: ReturnType<Gsap['context']> | undefined\n\n    const io = new IntersectionObserver(\n      ([entry]) => {\n        if (!entry?.isIntersecting) return\n        io.disconnect()\n        loadGsap().then(({ gsap, ScrollTrigger }) => {\n          if (cancelled || !el.isConnected) return\n          ctx = gsap.context(() => {\n            cleanup = setupRef.current({ gsap, ScrollTrigger, el })\n          }, el)\n        })\n      },\n      { rootMargin: near },\n    )\n    io.observe(el)\n\n    return () => {\n      cancelled = true\n      io.disconnect()\n      if (typeof cleanup === 'function') cleanup()\n      ctx?.revert()\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [ref, near, reducedMotion, ...deps])\n}\n\nexport interface ExpandCollapseOptions {\n  duration?: number\n  ease?: string\n}\n\n/**\n * Animate expand/collapse without mount/unmount. Content stays in the DOM\n * (so it stays indexable) with overflow hidden; gsap animates height and\n * opacity, and loads on the first toggle, not at mount.\n *\n * @example\n *   const { contentRef } = useExpandCollapse(isOpen)\n *   <div ref={contentRef}>{children}</div>\n */\nexport function useExpandCollapse(\n  isOpen: boolean,\n  options: ExpandCollapseOptions = {},\n): { contentRef: RefObject<HTMLDivElement | null> } {\n  const { duration = 0.3, ease = 'power2.inOut' } = options\n  const contentRef = useRef<HTMLDivElement>(null)\n  const initialized = useRef(false)\n\n  useEffect(() => {\n    const el = contentRef.current\n    if (!el) return\n\n    // First render: set the resting state with inline styles, no gsap.\n    if (!initialized.current) {\n      initialized.current = true\n      el.style.overflow = 'hidden'\n      if (!isOpen) {\n        el.style.height = '0px'\n        el.style.opacity = '0'\n      }\n      return\n    }\n\n    let cancelled = false\n    loadGsap().then(({ gsap }) => {\n      if (cancelled || !el.isConnected) return\n      if (prefersReducedMotion()) {\n        gsap.set(el, { height: isOpen ? 'auto' : 0, opacity: isOpen ? 1 : 0 })\n        el.style.overflow = isOpen ? 'visible' : 'hidden'\n        return\n      }\n      if (isOpen) {\n        gsap.to(el, {\n          height: 'auto',\n          opacity: 1,\n          duration,\n          ease,\n          onComplete() {\n            el.style.overflow = 'visible'\n          },\n        })\n      } else {\n        el.style.overflow = 'hidden'\n        gsap.to(el, { height: 0, opacity: 0, duration: duration * 0.85, ease })\n      }\n    })\n    return () => {\n      cancelled = true\n    }\n  }, [isOpen, duration, ease])\n\n  return { contentRef }\n}\n"]}
+{"version":3,"sources":["../../src/motion/gsap.ts"],"names":["pending","useRef","useEffect","prefersReducedMotion"],"mappings":"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","file":"gsap.js","sourcesContent":["/**\n * @sonordev/site-kit/motion/gsap — the Upforge motion standard, tier 1.\n *\n * GSAP for the moments that earn it: sequenced timelines, SplitText,\n * Flip, MorphSVG. Requires the optional peer `gsap` (all plugins are free\n * since 3.13):\n *\n *     npm i gsap\n *\n * A site that never imports this subpath never installs gsap. NOTHING\n * outside this file may import from 'gsap' — that is what keeps the tier\n * boundary real (src/motion/motion.test.tsx enforces it).\n *\n * Cost and where it goes: gsap core + ScrollTrigger is ~46KB gzipped.\n * `useGsap` loads it only when its element comes within 200px of the\n * viewport, so it never sits on the LCP critical path, and it must only be\n * used BELOW the fold. First-paint content renders static.\n *\n * Not included on purpose: ScrollSmoother. It drives scrolling by\n * transforming the page body, which fights native scroll, costs INP on\n * mobile, and breaks every scroll-geometry read on the page. The engine's\n * per-scene lerp gives the liquid feel without hijacking anything.\n */\n\n'use client'\n\nimport { useEffect, useRef, type DependencyList, type RefObject } from 'react'\nimport { prefersReducedMotion } from './engine'\n\ntype GsapModule = typeof import('gsap')\ntype ScrollTriggerModule = typeof import('gsap/ScrollTrigger')\n\nexport type Gsap = GsapModule['gsap']\nexport type ScrollTriggerStatic = ScrollTriggerModule['ScrollTrigger']\n\nexport interface GsapBundle {\n  gsap: Gsap\n  ScrollTrigger: ScrollTriggerStatic\n}\n\nlet pending: Promise<GsapBundle> | null = null\n\n/**\n * Load gsap + ScrollTrigger once, register the plugin, and share the\n * promise. Safe to call from anywhere; resolves the same bundle every time.\n */\nexport function loadGsap(): Promise<GsapBundle> {\n  if (!pending) {\n    pending = Promise.all([import('gsap'), import('gsap/ScrollTrigger')]).then(([g, st]) => {\n      const gsap = g.gsap ?? g.default\n      const ScrollTrigger = st.ScrollTrigger ?? st.default\n      gsap.registerPlugin(ScrollTrigger)\n      return { gsap, ScrollTrigger }\n    })\n  }\n  return pending\n}\n\n/** Dynamic imports of GSAP plugins, by name: `{ SplitText: () => import('gsap/SplitText') }`. */\nexport type GsapPluginLoaders = Record<string, () => Promise<unknown>>\n\ntype GsapContext = ReturnType<Gsap['context']>\n\nexport interface GsapSetupContext extends GsapBundle {\n  /** The element the hook is attached to — use it as the ScrollTrigger trigger and the selector scope. */\n  el: HTMLElement\n  /**\n   * The plugins asked for in `options.plugins`, loaded and registered before\n   * setup runs, by the same names: `plugins.SplitText`.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  plugins: Record<string, any>\n  /**\n   * The gsap.context setup runs in. Anything setup starts asynchronously\n   * (after an await, in a timer, in a plugin callback that fires later)\n   * lands outside it, so wrap that work in `context.add(() => ...)` to have\n   * it scoped and reverted on unmount with the rest.\n   */\n  context: GsapContext\n}\n\nexport interface UseGsapOptions {\n  /** Preload margin: load gsap when the element is this close. Default \"200px 0px\". */\n  near?: string\n  /** \"skip\" (default) does nothing under prefers-reduced-motion; \"run\" lets setup decide. */\n  reducedMotion?: 'skip' | 'run'\n  /**\n   * GSAP plugins to load alongside gsap, as dynamic imports keyed by name:\n   *\n   *     { plugins: { SplitText: () => import('gsap/SplitText') } }\n   *\n   * They're loaded when gsap is, registered, and handed to setup as\n   * `plugins`, so setup can stay synchronous. That matters: gsap.context\n   * only records what runs synchronously inside it, so a plugin imported\n   * from within setup did its work outside the context, unscoped and never\n   * reverted on unmount (vsf-consulting-nextjs's SplitHeading had to build a\n   * second context of its own to clean up).\n   */\n  plugins?: GsapPluginLoaders\n}\n\nconst pluginCache = new Map<string, Promise<unknown>>()\n\n/** The plugin object out of its module: the named export, else the default. */\nfunction pickPlugin(mod: unknown, name: string): unknown {\n  const m = mod as Record<string, unknown> | null\n  return (m && (m[name] ?? m.default)) ?? mod\n}\n\n/**\n * Load plugins by name, once per name for the page, and register them with\n * gsap. Resolves to the plugins keyed by the same names.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function loadGsapPlugins(gsap: Gsap, loaders: GsapPluginLoaders = {}): Promise<Record<string, any>> {\n  const entries = await Promise.all(\n    Object.entries(loaders).map(async ([name, load]) => {\n      let pending = pluginCache.get(name)\n      if (!pending) {\n        pending = load().then(mod => pickPlugin(mod, name))\n        pluginCache.set(name, pending)\n      }\n      return [name, await pending] as const\n    }),\n  )\n  const plugins = Object.fromEntries(entries)\n  const list = Object.values(plugins)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  if (list.length) gsap.registerPlugin(...(list as any[]))\n  return plugins\n}\n\n/**\n * Run a setup inside a gsap.context scoped to `el`, synchronously. Split out\n * of useGsap so the contract (everything setup creates belongs to the\n * returned context, plugins included) is testable without a DOM.\n */\nexport function runGsapSetup(\n  bundle: GsapBundle,\n  el: HTMLElement,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  plugins: Record<string, any>,\n  setup: (ctx: GsapSetupContext) => void | (() => void),\n): { context: GsapContext; cleanup: (() => void) | void } {\n  let cleanup: (() => void) | void = undefined\n  const context = bundle.gsap.context((self: GsapContext) => {\n    cleanup = setup({ ...bundle, el, plugins, context: self })\n  }, el)\n  return { context, cleanup }\n}\n\n/**\n * Run a GSAP setup against an element, lazily and safely:\n *\n *   - gsap loads only when the element nears the viewport\n *   - setup runs inside `gsap.context(el)`, so selectors are scoped and\n *     everything it creates is reverted on unmount (including ScrollTriggers)\n *   - plugins beyond ScrollTrigger (SplitText, Flip, MorphSVG) come in through\n *     `options.plugins`, loaded before setup, so setup stays synchronous and\n *     inside the context. Anything setup must still start later goes through\n *     `context.add()`.\n *   - the element must be server-rendered and visible; hide things inside\n *     `setup` with `gsap.set`, never with a stylesheet\n *\n * @example\n *   const ref = useRef<HTMLDivElement>(null)\n *   useGsap(ref, ({ gsap, el }) => {\n *     gsap.from(el.querySelectorAll('[data-line]'), {\n *       yPercent: 100, opacity: 0, stagger: 0.06, duration: 0.8, ease: 'power3.out',\n *       scrollTrigger: { trigger: el, start: 'top 80%' },\n *     })\n *   })\n *\n * @example With a plugin\n *   useGsap(ref, ({ gsap, el, plugins: { SplitText } }) => {\n *     SplitText.create(el, {\n *       type: 'lines', mask: 'lines', autoSplit: true,\n *       onSplit: self => gsap.from(self.lines, { yPercent: 115, stagger: 0.09, scrollTrigger: { trigger: el } }),\n *     })\n *   }, [], { plugins: { SplitText: () => import('gsap/SplitText') } })\n */\nexport function useGsap(\n  ref: RefObject<HTMLElement | null>,\n  setup: (ctx: GsapSetupContext) => void | (() => void),\n  deps: DependencyList = [],\n  options: UseGsapOptions = {},\n): void {\n  const setupRef = useRef(setup)\n  setupRef.current = setup\n  // A ref, like setup: an inline `plugins` object is new every render and\n  // must not re-run the effect.\n  const pluginsRef = useRef(options.plugins)\n  pluginsRef.current = options.plugins\n  const { near = '200px 0px', reducedMotion = 'skip' } = options\n\n  useEffect(() => {\n    const el = ref.current\n    if (!el) return\n    if (reducedMotion === 'skip' && prefersReducedMotion()) return\n\n    let cancelled = false\n    let cleanup: (() => void) | void\n    let ctx: GsapContext | undefined\n\n    const io = new IntersectionObserver(\n      ([entry]) => {\n        if (!entry?.isIntersecting) return\n        io.disconnect()\n        loadGsap()\n          .then(async bundle => ({ bundle, plugins: await loadGsapPlugins(bundle.gsap, pluginsRef.current) }))\n          .then(({ bundle, plugins }) => {\n            if (cancelled || !el.isConnected) return\n            ;({ context: ctx, cleanup } = runGsapSetup(bundle, el, plugins, setupRef.current))\n          })\n      },\n      { rootMargin: near },\n    )\n    io.observe(el)\n\n    return () => {\n      cancelled = true\n      io.disconnect()\n      if (typeof cleanup === 'function') cleanup()\n      ctx?.revert()\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [ref, near, reducedMotion, ...deps])\n}\n\nexport interface ExpandCollapseOptions {\n  duration?: number\n  ease?: string\n}\n\n/**\n * Animate expand/collapse without mount/unmount. Content stays in the DOM\n * (so it stays indexable) with overflow hidden; gsap animates height and\n * opacity, and loads on the first toggle, not at mount.\n *\n * @example\n *   const { contentRef } = useExpandCollapse(isOpen)\n *   <div ref={contentRef}>{children}</div>\n */\nexport function useExpandCollapse(\n  isOpen: boolean,\n  options: ExpandCollapseOptions = {},\n): { contentRef: RefObject<HTMLDivElement | null> } {\n  const { duration = 0.3, ease = 'power2.inOut' } = options\n  const contentRef = useRef<HTMLDivElement>(null)\n  const initialized = useRef(false)\n\n  useEffect(() => {\n    const el = contentRef.current\n    if (!el) return\n\n    // First render: set the resting state with inline styles, no gsap.\n    if (!initialized.current) {\n      initialized.current = true\n      el.style.overflow = 'hidden'\n      if (!isOpen) {\n        el.style.height = '0px'\n        el.style.opacity = '0'\n      }\n      return\n    }\n\n    let cancelled = false\n    loadGsap().then(({ gsap }) => {\n      if (cancelled || !el.isConnected) return\n      if (prefersReducedMotion()) {\n        gsap.set(el, { height: isOpen ? 'auto' : 0, opacity: isOpen ? 1 : 0 })\n        el.style.overflow = isOpen ? 'visible' : 'hidden'\n        return\n      }\n      if (isOpen) {\n        gsap.to(el, {\n          height: 'auto',\n          opacity: 1,\n          duration,\n          ease,\n          onComplete() {\n            el.style.overflow = 'visible'\n          },\n        })\n      } else {\n        el.style.overflow = 'hidden'\n        gsap.to(el, { height: 0, opacity: 0, duration: duration * 0.85, ease })\n      }\n    })\n    return () => {\n      cancelled = true\n    }\n  }, [isOpen, duration, ease])\n\n  return { contentRef }\n}\n"]}

package/dist/motion/gsap.mjs

@@ -15,9 +15,39 @@ function loadGsap() {
   }
   return pending;
 }
+var pluginCache = /* @__PURE__ */ new Map();
+function pickPlugin(mod, name) {
+  const m = mod;
+  return (m && (m[name] ?? m.default)) ?? mod;
+}
+async function loadGsapPlugins(gsap, loaders = {}) {
+  const entries = await Promise.all(
+    Object.entries(loaders).map(async ([name, load]) => {
+      let pending2 = pluginCache.get(name);
+      if (!pending2) {
+        pending2 = load().then((mod) => pickPlugin(mod, name));
+        pluginCache.set(name, pending2);
+      }
+      return [name, await pending2];
+    })
+  );
+  const plugins = Object.fromEntries(entries);
+  const list = Object.values(plugins);
+  if (list.length) gsap.registerPlugin(...list);
+  return plugins;
+}
+function runGsapSetup(bundle, el, plugins, setup) {
+  let cleanup = void 0;
+  const context = bundle.gsap.context((self) => {
+    cleanup = setup({ ...bundle, el, plugins, context: self });
+  }, el);
+  return { context, cleanup };
+}
 function useGsap(ref, setup, deps = [], options = {}) {
   const setupRef = useRef(setup);
   setupRef.current = setup;
+  const pluginsRef = useRef(options.plugins);
+  pluginsRef.current = options.plugins;
   const { near = "200px 0px", reducedMotion = "skip" } = options;
   useEffect(() => {
     const el = ref.current;
@@ -30,11 +60,9 @@ function useGsap(ref, setup, deps = [], options = {}) {
       ([entry]) => {
         if (!entry?.isIntersecting) return;
         io.disconnect();
-        loadGsap().then(({ gsap, ScrollTrigger }) => {
+        loadGsap().then(async (bundle) => ({ bundle, plugins: await loadGsapPlugins(bundle.gsap, pluginsRef.current) })).then(({ bundle, plugins }) => {
           if (cancelled || !el.isConnected) return;
-          ctx = gsap.context(() => {
-            cleanup = setupRef.current({ gsap, ScrollTrigger, el });
-          }, el);
+          ({ context: ctx, cleanup } = runGsapSetup(bundle, el, plugins, setupRef.current));
         });
       },
       { rootMargin: near }
@@ -94,6 +122,6 @@ function useExpandCollapse(isOpen, options = {}) {
   return { contentRef };
 }
 
-export { loadGsap, useExpandCollapse, useGsap };
+export { loadGsap, loadGsapPlugins, runGsapSetup, useExpandCollapse, useGsap };
 //# sourceMappingURL=gsap.mjs.map
 //# sourceMappingURL=gsap.mjs.map

package/dist/motion/gsap.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/motion/gsap.ts"],"names":[],"mappings":"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","file":"gsap.mjs","sourcesContent":["/**\n * @sonordev/site-kit/motion/gsap — the Upforge motion standard, tier 1.\n *\n * GSAP for the moments that earn it: sequenced timelines, SplitText,\n * Flip, MorphSVG. Requires the optional peer `gsap` (all plugins are free\n * since 3.13):\n *\n *     npm i gsap\n *\n * A site that never imports this subpath never installs gsap. NOTHING\n * outside this file may import from 'gsap' — that is what keeps the tier\n * boundary real (src/motion/motion.test.tsx enforces it).\n *\n * Cost and where it goes: gsap core + ScrollTrigger is ~46KB gzipped.\n * `useGsap` loads it only when its element comes within 200px of the\n * viewport, so it never sits on the LCP critical path, and it must only be\n * used BELOW the fold. First-paint content renders static.\n *\n * Not included on purpose: ScrollSmoother. It drives scrolling by\n * transforming the page body, which fights native scroll, costs INP on\n * mobile, and breaks every scroll-geometry read on the page. The engine's\n * per-scene lerp gives the liquid feel without hijacking anything.\n */\n\n'use client'\n\nimport { useEffect, useRef, type DependencyList, type RefObject } from 'react'\nimport { prefersReducedMotion } from './engine'\n\ntype GsapModule = typeof import('gsap')\ntype ScrollTriggerModule = typeof import('gsap/ScrollTrigger')\n\nexport type Gsap = GsapModule['gsap']\nexport type ScrollTriggerStatic = ScrollTriggerModule['ScrollTrigger']\n\nexport interface GsapBundle {\n  gsap: Gsap\n  ScrollTrigger: ScrollTriggerStatic\n}\n\nlet pending: Promise<GsapBundle> | null = null\n\n/**\n * Load gsap + ScrollTrigger once, register the plugin, and share the\n * promise. Safe to call from anywhere; resolves the same bundle every time.\n */\nexport function loadGsap(): Promise<GsapBundle> {\n  if (!pending) {\n    pending = Promise.all([import('gsap'), import('gsap/ScrollTrigger')]).then(([g, st]) => {\n      const gsap = g.gsap ?? g.default\n      const ScrollTrigger = st.ScrollTrigger ?? st.default\n      gsap.registerPlugin(ScrollTrigger)\n      return { gsap, ScrollTrigger }\n    })\n  }\n  return pending\n}\n\nexport interface GsapSetupContext extends GsapBundle {\n  /** The element the hook is attached to — use it as the ScrollTrigger trigger and the selector scope. */\n  el: HTMLElement\n}\n\nexport interface UseGsapOptions {\n  /** Preload margin: load gsap when the element is this close. Default \"200px 0px\". */\n  near?: string\n  /** \"skip\" (default) does nothing under prefers-reduced-motion; \"run\" lets setup decide. */\n  reducedMotion?: 'skip' | 'run'\n}\n\n/**\n * Run a GSAP setup against an element, lazily and safely:\n *\n *   - gsap loads only when the element nears the viewport\n *   - setup runs inside `gsap.context(el)`, so selectors are scoped and\n *     everything it creates is reverted on unmount (including ScrollTriggers)\n *   - the element must be server-rendered and visible; hide things inside\n *     `setup` with `gsap.set`, never with a stylesheet\n *\n * @example\n *   const ref = useRef<HTMLDivElement>(null)\n *   useGsap(ref, ({ gsap, el }) => {\n *     gsap.from(el.querySelectorAll('[data-line]'), {\n *       yPercent: 100, opacity: 0, stagger: 0.06, duration: 0.8, ease: 'power3.out',\n *       scrollTrigger: { trigger: el, start: 'top 80%' },\n *     })\n *   })\n */\nexport function useGsap(\n  ref: RefObject<HTMLElement | null>,\n  setup: (ctx: GsapSetupContext) => void | (() => void),\n  deps: DependencyList = [],\n  options: UseGsapOptions = {},\n): void {\n  const setupRef = useRef(setup)\n  setupRef.current = setup\n  const { near = '200px 0px', reducedMotion = 'skip' } = options\n\n  useEffect(() => {\n    const el = ref.current\n    if (!el) return\n    if (reducedMotion === 'skip' && prefersReducedMotion()) return\n\n    let cancelled = false\n    let cleanup: (() => void) | void\n    let ctx: ReturnType<Gsap['context']> | undefined\n\n    const io = new IntersectionObserver(\n      ([entry]) => {\n        if (!entry?.isIntersecting) return\n        io.disconnect()\n        loadGsap().then(({ gsap, ScrollTrigger }) => {\n          if (cancelled || !el.isConnected) return\n          ctx = gsap.context(() => {\n            cleanup = setupRef.current({ gsap, ScrollTrigger, el })\n          }, el)\n        })\n      },\n      { rootMargin: near },\n    )\n    io.observe(el)\n\n    return () => {\n      cancelled = true\n      io.disconnect()\n      if (typeof cleanup === 'function') cleanup()\n      ctx?.revert()\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [ref, near, reducedMotion, ...deps])\n}\n\nexport interface ExpandCollapseOptions {\n  duration?: number\n  ease?: string\n}\n\n/**\n * Animate expand/collapse without mount/unmount. Content stays in the DOM\n * (so it stays indexable) with overflow hidden; gsap animates height and\n * opacity, and loads on the first toggle, not at mount.\n *\n * @example\n *   const { contentRef } = useExpandCollapse(isOpen)\n *   <div ref={contentRef}>{children}</div>\n */\nexport function useExpandCollapse(\n  isOpen: boolean,\n  options: ExpandCollapseOptions = {},\n): { contentRef: RefObject<HTMLDivElement | null> } {\n  const { duration = 0.3, ease = 'power2.inOut' } = options\n  const contentRef = useRef<HTMLDivElement>(null)\n  const initialized = useRef(false)\n\n  useEffect(() => {\n    const el = contentRef.current\n    if (!el) return\n\n    // First render: set the resting state with inline styles, no gsap.\n    if (!initialized.current) {\n      initialized.current = true\n      el.style.overflow = 'hidden'\n      if (!isOpen) {\n        el.style.height = '0px'\n        el.style.opacity = '0'\n      }\n      return\n    }\n\n    let cancelled = false\n    loadGsap().then(({ gsap }) => {\n      if (cancelled || !el.isConnected) return\n      if (prefersReducedMotion()) {\n        gsap.set(el, { height: isOpen ? 'auto' : 0, opacity: isOpen ? 1 : 0 })\n        el.style.overflow = isOpen ? 'visible' : 'hidden'\n        return\n      }\n      if (isOpen) {\n        gsap.to(el, {\n          height: 'auto',\n          opacity: 1,\n          duration,\n          ease,\n          onComplete() {\n            el.style.overflow = 'visible'\n          },\n        })\n      } else {\n        el.style.overflow = 'hidden'\n        gsap.to(el, { height: 0, opacity: 0, duration: duration * 0.85, ease })\n      }\n    })\n    return () => {\n      cancelled = true\n    }\n  }, [isOpen, duration, ease])\n\n  return { contentRef }\n}\n"]}
+{"version":3,"sources":["../../src/motion/gsap.ts"],"names":["pending"],"mappings":";;;;AAwCA,IAAI,OAAA,GAAsC,IAAA;AAMnC,SAAS,QAAA,GAAgC;AAC9C,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,OAAA,GAAU,QAAQ,GAAA,CAAI,CAAC,OAAO,MAAM,GAAG,OAAO,oBAAoB,CAAC,CAAC,EAAE,IAAA,CAAK,CAAC,CAAC,CAAA,EAAG,EAAE,CAAA,KAAM;AACtF,MAAA,MAAM,IAAA,GAAO,CAAA,CAAE,IAAA,IAAQ,CAAA,CAAE,OAAA;AACzB,MAAA,MAAM,aAAA,GAAgB,EAAA,CAAG,aAAA,IAAiB,EAAA,CAAG,OAAA;AAC7C,MAAA,IAAA,CAAK,eAAe,aAAa,CAAA;AACjC,MAAA,OAAO,EAAE,MAAM,aAAA,EAAc;AAAA,IAC/B,CAAC,CAAA;AAAA,EACH;AACA,EAAA,OAAO,OAAA;AACT;AA6CA,IAAM,WAAA,uBAAkB,GAAA,EAA8B;AAGtD,SAAS,UAAA,CAAW,KAAc,IAAA,EAAuB;AACvD,EAAA,MAAM,CAAA,GAAI,GAAA;AACV,EAAA,OAAA,CAAQ,CAAA,KAAM,CAAA,CAAE,IAAI,CAAA,IAAK,EAAE,OAAA,CAAA,KAAa,GAAA;AAC1C;AAOA,eAAsB,eAAA,CAAgB,IAAA,EAAY,OAAA,GAA6B,EAAC,EAAiC;AAC/G,EAAA,MAAM,OAAA,GAAU,MAAM,OAAA,CAAQ,GAAA;AAAA,IAC5B,MAAA,CAAO,QAAQ,OAAO,CAAA,CAAE,IAAI,OAAO,CAAC,IAAA,EAAM,IAAI,CAAA,KAAM;AAClD,MAAA,IAAIA,QAAAA,GAAU,WAAA,CAAY,GAAA,CAAI,IAAI,CAAA;AAClC,MAAA,IAAI,CAACA,QAAAA,EAAS;AACZ,QAAAA,QAAAA,GAAU,MAAK,CAAE,IAAA,CAAK,SAAO,UAAA,CAAW,GAAA,EAAK,IAAI,CAAC,CAAA;AAClD,QAAA,WAAA,CAAY,GAAA,CAAI,MAAMA,QAAO,CAAA;AAAA,MAC/B;AACA,MAAA,OAAO,CAAC,IAAA,EAAM,MAAMA,QAAO,CAAA;AAAA,IAC7B,CAAC;AAAA,GACH;AACA,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,WAAA,CAAY,OAAO,CAAA;AAC1C,EAAA,MAAM,IAAA,GAAO,MAAA,CAAO,MAAA,CAAO,OAAO,CAAA;AAElC,EAAA,IAAI,IAAA,CAAK,MAAA,EAAQ,IAAA,CAAK,cAAA,CAAe,GAAI,IAAc,CAAA;AACvD,EAAA,OAAO,OAAA;AACT;AAOO,SAAS,YAAA,CACd,MAAA,EACA,EAAA,EAEA,OAAA,EACA,KAAA,EACwD;AACxD,EAAA,IAAI,OAAA,GAA+B,MAAA;AACnC,EAAA,MAAM,OAAA,GAAU,MAAA,CAAO,IAAA,CAAK,OAAA,CAAQ,CAAC,IAAA,KAAsB;AACzD,IAAA,OAAA,GAAU,KAAA,CAAM,EAAE,GAAG,MAAA,EAAQ,IAAI,OAAA,EAAS,OAAA,EAAS,MAAM,CAAA;AAAA,EAC3D,GAAG,EAAE,CAAA;AACL,EAAA,OAAO,EAAE,SAAS,OAAA,EAAQ;AAC5B;AAgCO,SAAS,OAAA,CACd,KACA,KAAA,EACA,IAAA,GAAuB,EAAC,EACxB,OAAA,GAA0B,EAAC,EACrB;AACN,EAAA,MAAM,QAAA,GAAW,OAAO,KAAK,CAAA;AAC7B,EAAA,QAAA,CAAS,OAAA,GAAU,KAAA;AAGnB,EAAA,MAAM,UAAA,GAAa,MAAA,CAAO,OAAA,CAAQ,OAAO,CAAA;AACzC,EAAA,UAAA,CAAW,UAAU,OAAA,CAAQ,OAAA;AAC7B,EAAA,MAAM,EAAE,IAAA,GAAO,WAAA,EAAa,aAAA,GAAgB,QAAO,GAAI,OAAA;AAEvD,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,KAAK,GAAA,CAAI,OAAA;AACf,IAAA,IAAI,CAAC,EAAA,EAAI;AACT,IAAA,IAAI,aAAA,KAAkB,MAAA,IAAU,oBAAA,EAAqB,EAAG;AAExD,IAAA,IAAI,SAAA,GAAY,KAAA;AAChB,IAAA,IAAI,OAAA;AACJ,IAAA,IAAI,GAAA;AAEJ,IAAA,MAAM,KAAK,IAAI,oBAAA;AAAA,MACb,CAAC,CAAC,KAAK,CAAA,KAAM;AACX,QAAA,IAAI,CAAC,OAAO,cAAA,EAAgB;AAC5B,QAAA,EAAA,CAAG,UAAA,EAAW;AACd,QAAA,QAAA,EAAS,CACN,KAAK,OAAM,MAAA,MAAW,EAAE,MAAA,EAAQ,OAAA,EAAS,MAAM,eAAA,CAAgB,MAAA,CAAO,MAAM,UAAA,CAAW,OAAO,GAAE,CAAE,CAAA,CAClG,KAAK,CAAC,EAAE,MAAA,EAAQ,OAAA,EAAQ,KAAM;AAC7B,UAAA,IAAI,SAAA,IAAa,CAAC,EAAA,CAAG,WAAA,EAAa;AACjC,UAAA,CAAC,EAAE,OAAA,EAAS,GAAA,EAAK,OAAA,EAAQ,GAAI,aAAa,MAAA,EAAQ,EAAA,EAAI,OAAA,EAAS,QAAA,CAAS,OAAO,CAAA;AAAA,QAClF,CAAC,CAAA;AAAA,MACL,CAAA;AAAA,MACA,EAAE,YAAY,IAAA;AAAK,KACrB;AACA,IAAA,EAAA,CAAG,QAAQ,EAAE,CAAA;AAEb,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AACZ,MAAA,EAAA,CAAG,UAAA,EAAW;AACd,MAAA,IAAI,OAAO,OAAA,KAAY,UAAA,EAAY,OAAA,EAAQ;AAC3C,MAAA,GAAA,EAAK,MAAA,EAAO;AAAA,IACd,CAAA;AAAA,EAEF,GAAG,CAAC,GAAA,EAAK,MAAM,aAAA,EAAe,GAAG,IAAI,CAAC,CAAA;AACxC;AAgBO,SAAS,iBAAA,CACd,MAAA,EACA,OAAA,GAAiC,EAAC,EACgB;AAClD,EAAA,MAAM,EAAE,QAAA,GAAW,GAAA,EAAK,IAAA,GAAO,gBAAe,GAAI,OAAA;AAClD,EAAA,MAAM,UAAA,GAAa,OAAuB,IAAI,CAAA;AAC9C,EAAA,MAAM,WAAA,GAAc,OAAO,KAAK,CAAA;AAEhC,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,KAAK,UAAA,CAAW,OAAA;AACtB,IAAA,IAAI,CAAC,EAAA,EAAI;AAGT,IAAA,IAAI,CAAC,YAAY,OAAA,EAAS;AACxB,MAAA,WAAA,CAAY,OAAA,GAAU,IAAA;AACtB,MAAA,EAAA,CAAG,MAAM,QAAA,GAAW,QAAA;AACpB,MAAA,IAAI,CAAC,MAAA,EAAQ;AACX,QAAA,EAAA,CAAG,MAAM,MAAA,GAAS,KAAA;AAClB,QAAA,EAAA,CAAG,MAAM,OAAA,GAAU,GAAA;AAAA,MACrB;AACA,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,SAAA,GAAY,KAAA;AAChB,IAAA,QAAA,EAAS,CAAE,IAAA,CAAK,CAAC,EAAE,MAAK,KAAM;AAC5B,MAAA,IAAI,SAAA,IAAa,CAAC,EAAA,CAAG,WAAA,EAAa;AAClC,MAAA,IAAI,sBAAqB,EAAG;AAC1B,QAAA,IAAA,CAAK,GAAA,CAAI,EAAA,EAAI,EAAE,MAAA,EAAQ,MAAA,GAAS,MAAA,GAAS,CAAA,EAAG,OAAA,EAAS,MAAA,GAAS,CAAA,GAAI,CAAA,EAAG,CAAA;AACrE,QAAA,EAAA,CAAG,KAAA,CAAM,QAAA,GAAW,MAAA,GAAS,SAAA,GAAY,QAAA;AACzC,QAAA;AAAA,MACF;AACA,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,IAAA,CAAK,GAAG,EAAA,EAAI;AAAA,UACV,MAAA,EAAQ,MAAA;AAAA,UACR,OAAA,EAAS,CAAA;AAAA,UACT,QAAA;AAAA,UACA,IAAA;AAAA,UACA,UAAA,GAAa;AACX,YAAA,EAAA,CAAG,MAAM,QAAA,GAAW,SAAA;AAAA,UACtB;AAAA,SACD,CAAA;AAAA,MACH,CAAA,MAAO;AACL,QAAA,EAAA,CAAG,MAAM,QAAA,GAAW,QAAA;AACpB,QAAA,IAAA,CAAK,EAAA,CAAG,EAAA,EAAI,EAAE,MAAA,EAAQ,CAAA,EAAG,OAAA,EAAS,CAAA,EAAG,QAAA,EAAU,QAAA,GAAW,IAAA,EAAM,IAAA,EAAM,CAAA;AAAA,MACxE;AAAA,IACF,CAAC,CAAA;AACD,IAAA,OAAO,MAAM;AACX,MAAA,SAAA,GAAY,IAAA;AAAA,IACd,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,MAAA,EAAQ,QAAA,EAAU,IAAI,CAAC,CAAA;AAE3B,EAAA,OAAO,EAAE,UAAA,EAAW;AACtB","file":"gsap.mjs","sourcesContent":["/**\n * @sonordev/site-kit/motion/gsap — the Upforge motion standard, tier 1.\n *\n * GSAP for the moments that earn it: sequenced timelines, SplitText,\n * Flip, MorphSVG. Requires the optional peer `gsap` (all plugins are free\n * since 3.13):\n *\n *     npm i gsap\n *\n * A site that never imports this subpath never installs gsap. NOTHING\n * outside this file may import from 'gsap' — that is what keeps the tier\n * boundary real (src/motion/motion.test.tsx enforces it).\n *\n * Cost and where it goes: gsap core + ScrollTrigger is ~46KB gzipped.\n * `useGsap` loads it only when its element comes within 200px of the\n * viewport, so it never sits on the LCP critical path, and it must only be\n * used BELOW the fold. First-paint content renders static.\n *\n * Not included on purpose: ScrollSmoother. It drives scrolling by\n * transforming the page body, which fights native scroll, costs INP on\n * mobile, and breaks every scroll-geometry read on the page. The engine's\n * per-scene lerp gives the liquid feel without hijacking anything.\n */\n\n'use client'\n\nimport { useEffect, useRef, type DependencyList, type RefObject } from 'react'\nimport { prefersReducedMotion } from './engine'\n\ntype GsapModule = typeof import('gsap')\ntype ScrollTriggerModule = typeof import('gsap/ScrollTrigger')\n\nexport type Gsap = GsapModule['gsap']\nexport type ScrollTriggerStatic = ScrollTriggerModule['ScrollTrigger']\n\nexport interface GsapBundle {\n  gsap: Gsap\n  ScrollTrigger: ScrollTriggerStatic\n}\n\nlet pending: Promise<GsapBundle> | null = null\n\n/**\n * Load gsap + ScrollTrigger once, register the plugin, and share the\n * promise. Safe to call from anywhere; resolves the same bundle every time.\n */\nexport function loadGsap(): Promise<GsapBundle> {\n  if (!pending) {\n    pending = Promise.all([import('gsap'), import('gsap/ScrollTrigger')]).then(([g, st]) => {\n      const gsap = g.gsap ?? g.default\n      const ScrollTrigger = st.ScrollTrigger ?? st.default\n      gsap.registerPlugin(ScrollTrigger)\n      return { gsap, ScrollTrigger }\n    })\n  }\n  return pending\n}\n\n/** Dynamic imports of GSAP plugins, by name: `{ SplitText: () => import('gsap/SplitText') }`. */\nexport type GsapPluginLoaders = Record<string, () => Promise<unknown>>\n\ntype GsapContext = ReturnType<Gsap['context']>\n\nexport interface GsapSetupContext extends GsapBundle {\n  /** The element the hook is attached to — use it as the ScrollTrigger trigger and the selector scope. */\n  el: HTMLElement\n  /**\n   * The plugins asked for in `options.plugins`, loaded and registered before\n   * setup runs, by the same names: `plugins.SplitText`.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  plugins: Record<string, any>\n  /**\n   * The gsap.context setup runs in. Anything setup starts asynchronously\n   * (after an await, in a timer, in a plugin callback that fires later)\n   * lands outside it, so wrap that work in `context.add(() => ...)` to have\n   * it scoped and reverted on unmount with the rest.\n   */\n  context: GsapContext\n}\n\nexport interface UseGsapOptions {\n  /** Preload margin: load gsap when the element is this close. Default \"200px 0px\". */\n  near?: string\n  /** \"skip\" (default) does nothing under prefers-reduced-motion; \"run\" lets setup decide. */\n  reducedMotion?: 'skip' | 'run'\n  /**\n   * GSAP plugins to load alongside gsap, as dynamic imports keyed by name:\n   *\n   *     { plugins: { SplitText: () => import('gsap/SplitText') } }\n   *\n   * They're loaded when gsap is, registered, and handed to setup as\n   * `plugins`, so setup can stay synchronous. That matters: gsap.context\n   * only records what runs synchronously inside it, so a plugin imported\n   * from within setup did its work outside the context, unscoped and never\n   * reverted on unmount (vsf-consulting-nextjs's SplitHeading had to build a\n   * second context of its own to clean up).\n   */\n  plugins?: GsapPluginLoaders\n}\n\nconst pluginCache = new Map<string, Promise<unknown>>()\n\n/** The plugin object out of its module: the named export, else the default. */\nfunction pickPlugin(mod: unknown, name: string): unknown {\n  const m = mod as Record<string, unknown> | null\n  return (m && (m[name] ?? m.default)) ?? mod\n}\n\n/**\n * Load plugins by name, once per name for the page, and register them with\n * gsap. Resolves to the plugins keyed by the same names.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport async function loadGsapPlugins(gsap: Gsap, loaders: GsapPluginLoaders = {}): Promise<Record<string, any>> {\n  const entries = await Promise.all(\n    Object.entries(loaders).map(async ([name, load]) => {\n      let pending = pluginCache.get(name)\n      if (!pending) {\n        pending = load().then(mod => pickPlugin(mod, name))\n        pluginCache.set(name, pending)\n      }\n      return [name, await pending] as const\n    }),\n  )\n  const plugins = Object.fromEntries(entries)\n  const list = Object.values(plugins)\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  if (list.length) gsap.registerPlugin(...(list as any[]))\n  return plugins\n}\n\n/**\n * Run a setup inside a gsap.context scoped to `el`, synchronously. Split out\n * of useGsap so the contract (everything setup creates belongs to the\n * returned context, plugins included) is testable without a DOM.\n */\nexport function runGsapSetup(\n  bundle: GsapBundle,\n  el: HTMLElement,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  plugins: Record<string, any>,\n  setup: (ctx: GsapSetupContext) => void | (() => void),\n): { context: GsapContext; cleanup: (() => void) | void } {\n  let cleanup: (() => void) | void = undefined\n  const context = bundle.gsap.context((self: GsapContext) => {\n    cleanup = setup({ ...bundle, el, plugins, context: self })\n  }, el)\n  return { context, cleanup }\n}\n\n/**\n * Run a GSAP setup against an element, lazily and safely:\n *\n *   - gsap loads only when the element nears the viewport\n *   - setup runs inside `gsap.context(el)`, so selectors are scoped and\n *     everything it creates is reverted on unmount (including ScrollTriggers)\n *   - plugins beyond ScrollTrigger (SplitText, Flip, MorphSVG) come in through\n *     `options.plugins`, loaded before setup, so setup stays synchronous and\n *     inside the context. Anything setup must still start later goes through\n *     `context.add()`.\n *   - the element must be server-rendered and visible; hide things inside\n *     `setup` with `gsap.set`, never with a stylesheet\n *\n * @example\n *   const ref = useRef<HTMLDivElement>(null)\n *   useGsap(ref, ({ gsap, el }) => {\n *     gsap.from(el.querySelectorAll('[data-line]'), {\n *       yPercent: 100, opacity: 0, stagger: 0.06, duration: 0.8, ease: 'power3.out',\n *       scrollTrigger: { trigger: el, start: 'top 80%' },\n *     })\n *   })\n *\n * @example With a plugin\n *   useGsap(ref, ({ gsap, el, plugins: { SplitText } }) => {\n *     SplitText.create(el, {\n *       type: 'lines', mask: 'lines', autoSplit: true,\n *       onSplit: self => gsap.from(self.lines, { yPercent: 115, stagger: 0.09, scrollTrigger: { trigger: el } }),\n *     })\n *   }, [], { plugins: { SplitText: () => import('gsap/SplitText') } })\n */\nexport function useGsap(\n  ref: RefObject<HTMLElement | null>,\n  setup: (ctx: GsapSetupContext) => void | (() => void),\n  deps: DependencyList = [],\n  options: UseGsapOptions = {},\n): void {\n  const setupRef = useRef(setup)\n  setupRef.current = setup\n  // A ref, like setup: an inline `plugins` object is new every render and\n  // must not re-run the effect.\n  const pluginsRef = useRef(options.plugins)\n  pluginsRef.current = options.plugins\n  const { near = '200px 0px', reducedMotion = 'skip' } = options\n\n  useEffect(() => {\n    const el = ref.current\n    if (!el) return\n    if (reducedMotion === 'skip' && prefersReducedMotion()) return\n\n    let cancelled = false\n    let cleanup: (() => void) | void\n    let ctx: GsapContext | undefined\n\n    const io = new IntersectionObserver(\n      ([entry]) => {\n        if (!entry?.isIntersecting) return\n        io.disconnect()\n        loadGsap()\n          .then(async bundle => ({ bundle, plugins: await loadGsapPlugins(bundle.gsap, pluginsRef.current) }))\n          .then(({ bundle, plugins }) => {\n            if (cancelled || !el.isConnected) return\n            ;({ context: ctx, cleanup } = runGsapSetup(bundle, el, plugins, setupRef.current))\n          })\n      },\n      { rootMargin: near },\n    )\n    io.observe(el)\n\n    return () => {\n      cancelled = true\n      io.disconnect()\n      if (typeof cleanup === 'function') cleanup()\n      ctx?.revert()\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [ref, near, reducedMotion, ...deps])\n}\n\nexport interface ExpandCollapseOptions {\n  duration?: number\n  ease?: string\n}\n\n/**\n * Animate expand/collapse without mount/unmount. Content stays in the DOM\n * (so it stays indexable) with overflow hidden; gsap animates height and\n * opacity, and loads on the first toggle, not at mount.\n *\n * @example\n *   const { contentRef } = useExpandCollapse(isOpen)\n *   <div ref={contentRef}>{children}</div>\n */\nexport function useExpandCollapse(\n  isOpen: boolean,\n  options: ExpandCollapseOptions = {},\n): { contentRef: RefObject<HTMLDivElement | null> } {\n  const { duration = 0.3, ease = 'power2.inOut' } = options\n  const contentRef = useRef<HTMLDivElement>(null)\n  const initialized = useRef(false)\n\n  useEffect(() => {\n    const el = contentRef.current\n    if (!el) return\n\n    // First render: set the resting state with inline styles, no gsap.\n    if (!initialized.current) {\n      initialized.current = true\n      el.style.overflow = 'hidden'\n      if (!isOpen) {\n        el.style.height = '0px'\n        el.style.opacity = '0'\n      }\n      return\n    }\n\n    let cancelled = false\n    loadGsap().then(({ gsap }) => {\n      if (cancelled || !el.isConnected) return\n      if (prefersReducedMotion()) {\n        gsap.set(el, { height: isOpen ? 'auto' : 0, opacity: isOpen ? 1 : 0 })\n        el.style.overflow = isOpen ? 'visible' : 'hidden'\n        return\n      }\n      if (isOpen) {\n        gsap.to(el, {\n          height: 'auto',\n          opacity: 1,\n          duration,\n          ease,\n          onComplete() {\n            el.style.overflow = 'visible'\n          },\n        })\n      } else {\n        el.style.overflow = 'hidden'\n        gsap.to(el, { height: 0, opacity: 0, duration: duration * 0.85, ease })\n      }\n    })\n    return () => {\n      cancelled = true\n    }\n  }, [isOpen, duration, ease])\n\n  return { contentRef }\n}\n"]}

package/dist/og/config.d.ts

@@ -24,6 +24,12 @@ export interface OgTheme {
     surface: string;
     /** Muted text (subtitle). Defaults derived from `text` when omitted. */
     muted?: string;
+    /**
+     * Bottom-bar text, set on `accent`. Defaults to the first of `surface`,
+     * `bg`, `text` that reaches WCAG AA for large text (3:1) against the
+     * accent (see og/contrast.ts).
+     */
+    barText?: string;
 }
 export interface OgFont {
     /** Google Fonts family name, e.g. 'Barlow Condensed'. */

package/dist/og/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/og/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/og/config.ts"],"names":[],"mappings":"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"}

package/dist/og/contrast.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @sonordev/site-kit/og — text color for the card's bottom bar.
+ *
+ * SINGLE SOURCE OF TRUTH for "what color is the bar text", shared by the
+ * build-time template (template.ts) and the runtime card (route.tsx). The two
+ * disagreed: the template set the bar in `theme.surface`, the runtime card in
+ * `theme.text`, and on a site whose text and accent are both strong colors the
+ * runtime bar came out unreadable (navy on crimson on watsonhac.com, ink on
+ * green on reinhart). Both sites dropped the bar rather than ship it.
+ *
+ * `theme.barText` always wins. Otherwise the first candidate that reaches
+ * WCAG AA for large text against the accent is used, in the order the
+ * template always preferred (surface, then bg, then text), so every card
+ * that already read well keeps its color. Failing that, the highest-contrast
+ * candidate.
+ *
+ * Pure: no DOM, no Node built-ins.
+ */
+/** `#abc`, `#aabbcc`, `#aabbccdd` → [r, g, b] in 0-255, or null for anything else. */
+export declare function parseHexColor(color: string): [number, number, number] | null;
+/** WCAG contrast ratio of two hex colors, or null when either isn't hex. */
+export declare function contrastRatio(a: string, b: string): number | null;
+export interface BarTheme {
+    bg: string;
+    text: string;
+    accent: string;
+    surface?: string;
+    /** Explicit bar text color. Always wins. */
+    barText?: string;
+}
+/** The color to set the bottom bar's text in, on `theme.accent`. */
+export declare function barTextColor(theme: BarTheme): string;
+//# sourceMappingURL=contrast.d.ts.map

package/dist/og/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../src/og/contrast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAK5E;AAUD,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMjE;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAUpD"}

package/dist/og/index.d.ts

@@ -5,4 +5,6 @@
 export { defineOgCard, OG_WIDTH, OG_HEIGHT } from './config';
 export type { OgCardConfig, OgTheme, OgFont, OgBackground, OgContent, OgPhoto, OgTemplateHelpers } from './config';
 export { buildOgHtml } from './template';
+export { paramCardImage, paramCardUrl, codeCardImage, PARAM_CARD_DIR } from './pages';
+export type { OgImageDescriptor } from './pages';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/og/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC5D,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAClH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/og/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC5D,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAClH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACrF,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA"}

package/dist/og/index.js

@@ -1,25 +1,43 @@
 'use strict';
 
-var chunk6CJP7BFM_js = require('../chunk-6CJP7BFM.js');
+var chunkOEW2LFOV_js = require('../chunk-OEW2LFOV.js');
+var chunkCUNZAD46_js = require('../chunk-CUNZAD46.js');
+require('../chunk-R7GHP3FY.js');
 require('../chunk-SNAQBZPT.js');
 
 
 
-Object.defineProperty(exports, "OG_HEIGHT", {
+Object.defineProperty(exports, "PARAM_CARD_DIR", {
   enumerable: true,
-  get: function () { return chunk6CJP7BFM_js.OG_HEIGHT; }
+  get: function () { return chunkOEW2LFOV_js.PARAM_CARD_DIR; }
 });
-Object.defineProperty(exports, "OG_WIDTH", {
+Object.defineProperty(exports, "buildOgHtml", {
   enumerable: true,
-  get: function () { return chunk6CJP7BFM_js.OG_WIDTH; }
+  get: function () { return chunkOEW2LFOV_js.buildOgHtml; }
 });
-Object.defineProperty(exports, "buildOgHtml", {
+Object.defineProperty(exports, "codeCardImage", {
+  enumerable: true,
+  get: function () { return chunkOEW2LFOV_js.codeCardImage; }
+});
+Object.defineProperty(exports, "paramCardImage", {
+  enumerable: true,
+  get: function () { return chunkOEW2LFOV_js.paramCardImage; }
+});
+Object.defineProperty(exports, "paramCardUrl", {
+  enumerable: true,
+  get: function () { return chunkOEW2LFOV_js.paramCardUrl; }
+});
+Object.defineProperty(exports, "OG_HEIGHT", {
+  enumerable: true,
+  get: function () { return chunkCUNZAD46_js.OG_HEIGHT; }
+});
+Object.defineProperty(exports, "OG_WIDTH", {
   enumerable: true,
-  get: function () { return chunk6CJP7BFM_js.buildOgHtml; }
+  get: function () { return chunkCUNZAD46_js.OG_WIDTH; }
 });
 Object.defineProperty(exports, "defineOgCard", {
   enumerable: true,
-  get: function () { return chunk6CJP7BFM_js.defineOgCard; }
+  get: function () { return chunkCUNZAD46_js.defineOgCard; }
 });
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/og/index.mjs

@@ -1,4 +1,6 @@
-export { OG_HEIGHT, OG_WIDTH, buildOgHtml, defineOgCard } from '../chunk-UJ6CHZAI.mjs';
+export { PARAM_CARD_DIR, buildOgHtml, codeCardImage, paramCardImage, paramCardUrl } from '../chunk-XZO5I4RS.mjs';
+export { OG_HEIGHT, OG_WIDTH, defineOgCard } from '../chunk-YU7QZ3PP.mjs';
+import '../chunk-4LYW6PMU.mjs';
 import '../chunk-BEXTDHO4.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/og/pages.d.ts

@@ -37,6 +37,18 @@ export interface OgPageRoute {
  * src/og/README.md.)
  */
 export declare const DYNAMIC = "*";
+/**
+ * Trailing brand suffix on a managed title (` | Acme`, ` - Acme`, ` — Acme`).
+ * Managed titles carry the brand because a SERP entry needs it; a card does
+ * not — the logo, the photo and the bar are already saying whose it is, and
+ * every character spent on the brand is one not spent on the page.
+ *
+ * Also drops the two broken suffixes managed titles turn up with, both found
+ * on 2026-09-15 and each worked around by hand in a site's `cards`: a
+ * dangling separator with no brand after it (reinhart's "About Us |", Green
+ * Bay's), and the domain after a comma ("Privacy Policy, abbeyglenapts.com").
+ */
+export declare function stripBrandSuffix(title: string, brand?: string): string;
 /**
  * `/services/walk-in-closets` -> `Walk In Closets`. The no-managed-data path.
  *
@@ -84,6 +96,95 @@ export declare function slugForPath(path: string): string;
  * hand-written card with nothing said about it. The caller reports these.
  */
 export declare function unmatchedCardKeys(cards: Record<string, unknown> | undefined, paths: string[]): string[];
+/**
+ * Does a concrete URL fall under a dynamic route pattern? One `*` matches
+ * exactly one segment: `/properties/tall-pines/about` is under
+ * `/properties/*` + `/about`, and `/floor-plans/1-bedroom` under
+ * `/floor-plans/*`. A key that is itself a pattern matches nothing.
+ */
+export declare function matchesRoutePattern(path: string, pattern: string): boolean;
+/**
+ * The `cards` keys that name one page under a dynamic route: a card per
+ * floor plan, per community, per sub-page of a community. Keyed by the URL
+ * itself (`/floor-plans/1-bedroom`), which any site can build from the same
+ * data its `generateStaticParams` reads.
+ *
+ * A static file in a dynamic segment covers every param of the route, so
+ * these can't be `opengraph-image` files. `sonor-setup og` renders each one to
+ * `public/_og/` (see paramCardUrl), and the page declares it with
+ * `paramCardImage`. The MDG property sites needed a card per floor plan and
+ * per community and rendered them with their own script until this existed.
+ *
+ * Returns each key with the pattern it falls under. Keys that are a real
+ * static route or a pattern are left to the route cards.
+ */
+export declare function paramCardKeys(cards: Record<string, unknown> | undefined, paths: string[]): Array<{
+    path: string;
+    pattern: string;
+}>;
+/**
+ * Public directory (under `public/`) that `sonor-setup og` owns for per-URL
+ * cards. Generated; the command clears it on every run, so keep nothing else
+ * in it.
+ */
+export declare const PARAM_CARD_DIR = "_og";
+/**
+ * Where the per-URL card for a page is served: `/floor-plans/1-bedroom` ->
+ * `/_og/floor-plans/1-bedroom.jpg`. Single source of truth for the file the
+ * CLI writes and the URL `paramCardImage` declares.
+ *
+ * It ends in `.jpg` on purpose. Next serves a code-based `opengraph-image`
+ * route without an extension, and `trailingSlash: true` answers that URL with
+ * a 308 before the card, which some preview bots don't follow. A static file
+ * with an extension is never redirected.
+ */
+export declare function paramCardUrl(path: string): string;
+/** An `openGraph.images` entry. */
+export interface OgImageDescriptor {
+    url: string;
+    width: number;
+    height: number;
+    type: string;
+    alt?: string;
+}
+/**
+ * The page's per-URL card, for its metadata:
+ *
+ * ```ts
+ * const card = paramCardImage(`/floor-plans/${slug}`, { config: ogConfig })
+ * return {
+ *   openGraph: { ...(card && { images: [card] }) },
+ *   twitter: { card: 'summary_large_image', ...(card && { images: [card.url] }) },
+ * }
+ * ```
+ *
+ * Pass `config` (the site's og.config) and it answers undefined for a page
+ * with no `cards` entry, so the page keeps its segment's static card. Without
+ * `config` it always answers, so only call it for URLs you gave a card.
+ */
+export declare function paramCardImage(path: string, options?: {
+    config?: Pick<OgCardConfig, 'cards'>;
+    alt?: string;
+}): OgImageDescriptor | undefined;
+/**
+ * A code-based card (`opengraph-image.tsx`) declared at the URL the site
+ * actually serves it from.
+ *
+ * Next wires such a card in as `<path>/opengraph-image`, with no extension.
+ * With `trailingSlash: true` that URL 308-redirects to the slashed one, so
+ * every share preview starts with a redirect, and bots that don't follow one
+ * show no card (the MDG property sites, 2026-09-15). Declaring the slashed URL
+ * gets a 200 first time. Declared images beat the file convention, so this
+ * replaces Next's own entry rather than adding a second.
+ *
+ * `trailingSlash` defaults to the site's next.config. Without it, this is the
+ * URL Next would have used anyway.
+ */
+export declare function codeCardImage(path: string, options?: {
+    trailingSlash?: boolean;
+    alt?: string;
+    contentType?: string;
+}): OgImageDescriptor;
 /**
  * Build a page's card config by layering its copy over the site's card.
  *

package/dist/og/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/og/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE5C,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,MAAM,CAAA;AAsB1B;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUlF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAM,GAAG,MAAM,GAAG,SAAS,CA2BrF;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAShD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,EAAE,CAIV;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,YAAY,CAsCd"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/og/pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAK5C,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,MAAM,CAAA;AAqB1B;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAYtE;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYlF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAM,GAAG,MAAM,GAAG,SAAS,CA2BrF;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAShD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,EAAE,CAOV;AAQD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAK1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC1C,KAAK,EAAE,MAAM,EAAE,GACd,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAW1C;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAQ,CAAA;AAEnC;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,mCAAmC;AACnC,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,iBAAiB,GAAG,SAAS,CAa/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5E,iBAAiB,CAUnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,YAAY,CAuCd"}

package/dist/og/route-copy.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @sonordev/site-kit/og — what Sonor says about each route, for its card.
+ *
+ * SINGLE SOURCE OF TRUTH for the per-route Sonor lookup, shared by
+ * `sonor-setup og` (card copy, and which pages set managed_og_image) and the
+ * doctor's online `og.card` check (managed_og_image only). One lookup per
+ * route either way; they must not drift on which fields they read.
+ *
+ * Node-only (it's CLI code): never import from browser or client code.
+ */
+import type { OgPageRoute } from './pages';
+/** Concurrent Chrome renders and Sonor lookups. More than this thrashes. */
+export declare const RENDER_CONCURRENCY = 4;
+/** Run tasks with a small concurrency cap. */
+export declare function pooled<T, R>(items: T[], limit: number, fn: (item: T, i: number) => Promise<R>): Promise<R[]>;
+export type RouteCopy = OgPageRoute & {
+    /** seo_pages.managed_og_image, which overrides the route's own card. */
+    managedOgImage?: string;
+};
+/**
+ * Ask Sonor for each route's managed title and description, so a page card
+ * says what the page's own <title> says.
+ *
+ * Best effort by design: one lookup per route, capped concurrency, and any
+ * failure degrades that route to a path-derived title rather than failing the
+ * command. A site with no key still gets a full set of cards.
+ */
+export declare function resolveRouteCopy(paths: string[]): Promise<RouteCopy[]>;
+/**
+ * The site's static routes whose seo_pages row sets managed_og_image, or
+ * undefined when that can't be known (no key, no app directory).
+ */
+export declare function readManagedOgImages(cwd: string): Promise<string[] | undefined>;
+//# sourceMappingURL=route-copy.d.ts.map

package/dist/og/route-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-copy.d.ts","sourceRoot":"","sources":["../../src/og/route-copy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAG1C,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,8CAA8C;AAC9C,wBAAsB,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAWlH;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG;IACpC,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAID;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAyB5E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAOpF"}

package/dist/og/route-fit.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @sonordev/site-kit/og — title fitting for the runtime (Satori) card.
+ *
+ * The build-time card is fitted in the page: Chrome measures the rendered
+ * title and steps it down until it fits (template.ts). The runtime card is
+ * Satori, which has no DOM to measure, so its title sat at a fixed 84px,
+ * uppercase, with no fitting. Beside the 430px photo that holds about 11
+ * characters a line, so a real post title ran off the bottom of the card.
+ * watsonhac.com, reinhart and vsf-consulting-nextjs each worked around it by
+ * dropping the photo past a hand-picked length (40 or 50 characters).
+ *
+ * This does what the build-time fitter does, from an estimate instead of a
+ * measurement: the same size range (TITLE_MAX_PX down to TITLE_MIN_PX, in 2px
+ * steps), word-wrapped at an estimated glyph width against the real column
+ * width and the height the kicker, subtitle and bar leave. When the title
+ * can't fit beside the photo even at the floor, the photo goes and the title
+ * gets the full width.
+ *
+ * The estimate is deliberately wide (uppercase, bold-ish) so an unusual
+ * face errs toward a smaller title, never an overflowing one, and the title
+ * box clips at its height as the backstop.
+ *
+ * Pure: no DOM, no Node built-ins. Geometry constants are the card's own
+ * (route.tsx imports them), so the two can't drift.
+ */
+/** The runtime card's layout, in px. route.tsx renders exactly this. */
+export declare const ROUTE_CARD: {
+    readonly padX: 68;
+    readonly gap: 48;
+    readonly photoWidth: 430;
+    readonly photoHeight: 470;
+    readonly barHeight: 74;
+    /** Breathing room above and below the copy column. */
+    readonly padY: 44;
+    readonly kickerPx: 24;
+    readonly kickerGap: 18;
+    readonly subtitlePx: 30;
+    readonly subtitleGap: 20;
+    readonly subtitleLineHeight: 1.3;
+    readonly titleLineHeight: 1.02;
+};
+/** Estimated width of `text` set uppercase at `px`. */
+export declare function uppercaseWidth(text: string, px: number): number;
+/**
+ * Lines `text` wraps to in a column `width` px wide, greedy by word, the way
+ * the browser and Satori wrap. `\n` is a hard break. Returns Infinity when a
+ * single word is wider than the column: it can't wrap, so no line count fits.
+ */
+export declare function wrappedLines(text: string, width: number, measure: (s: string) => number): number;
+export interface RouteFitInput {
+    title: string;
+    kicker?: string;
+    subtitle?: string;
+    /** A photo was offered. */
+    photo: boolean;
+    /** The card has a bottom bar. */
+    bar: boolean;
+}
+export interface RouteFit {
+    /** Title size in px. */
+    titlePx: number;
+    /** Keep the photo. False when the title only fits at full width. */
+    photo: boolean;
+    /** Height the title box may use; route.tsx clips the title to it. */
+    titleMaxHeight: number;
+    /** The title fits at `titlePx` by the estimate (false only at the floor, full width). */
+    fits: boolean;
+}
+/**
+ * Size the title, and decide whether the photo stays.
+ *
+ * Beside the photo first, since the photo is the page's own image and worth
+ * keeping. If even the floor size doesn't fit there, drop the photo and fit
+ * the full width. If that fails too, the title sits at the floor and clips.
+ */
+export declare function fitRouteTitle(input: RouteFitInput): RouteFit;
+//# sourceMappingURL=route-fit.d.ts.map