@flamingo-stack/openframe-frontend-core 0.0.449 → 0.0.450

package/dist/components/ui/marquee-wall.d.ts

@@ -0,0 +1,159 @@
+import * as React from 'react';
+export type MarqueeWallFadeEdge = 'top' | 'bottom' | 'left' | 'right';
+/** @internal per-instance sync membership (transform writer + driver-role
+ *  promotion callback, so a surviving member can be re-elected). */
+interface MarqueeSyncMember {
+    apply: (pos: number) => void;
+    makeDriver: () => void;
+}
+/**
+ * Pairs two (or more) <MarqueeWall> instances to ONE position driver so their
+ * tracks stay pixel-locked (the FreeTrialCTA resolve strips: a pending and a
+ * resolved copy of the same chips, clip-path'd at the avatar line). The first
+ * mounted instance claims the driver role and runs the shared rAF; the others
+ * only register their `apply` transforms. If the driver unmounts while
+ * members survive, the next member is promoted — the pair must merely be
+ * geometry-identical while mounted together.
+ */
+export interface MarqueeSyncController {
+    /** @internal registered members in mount order. */
+    members: Set<MarqueeSyncMember>;
+    /** @internal current driver member. */
+    driver: MarqueeSyncMember | null;
+    /** @internal last driver-written position — a promoted driver's engine
+     *  seeds from it, so re-election never snaps the pair back to 0. */
+    position: number;
+}
+export declare function useMarqueeSync(): MarqueeSyncController;
+export interface MarqueeTrackOffset {
+    /** Applied translation (px) along each axis. */
+    x: number;
+    y: number;
+    /** Loop wrap size (single copy + seam gap) along each axis; 0 on the
+     *  non-scroll axis. Lets morph engines treat a chip and its loop clone as
+     *  ONE identity `wrap` apart (the Swiper loop-clone model) and fly the
+     *  copy the viewer actually sees. */
+    wrapX: number;
+    wrapY: number;
+}
+/** Last known translation + wrap of the wall registered under `trackId`
+ *  (live or already unmounted). Zeros for unknown ids / static walls. */
+export declare function getMarqueeTrackOffset(trackId: string): MarqueeTrackOffset;
+/**
+ * The translation ACTUALLY applied to a wall's track right now, read from the
+ * DOM of the `data-marquee-track` container. Morph engines use this on the
+ * CAPTURE side (never the registry): a same-id wall freshly remounted in the
+ * current commit has not applied any transform yet, while the registry still
+ * holds its predecessor's final drift for the flight-side lookup.
+ */
+export declare function getMarqueeAppliedOffset(trackContainer: Element): {
+    x: number;
+    y: number;
+};
+/**
+ * The loop-clone twin of an element inside a wall's PRIMARY copy (same index
+ * in the `data-marquee-copy="clone"` copy), or null when there is no clone /
+ * the element isn't in the primary copy. Owns the wall's internal DOM shape
+ * so morph engines don't hardcode it; `selector` scopes which descendants
+ * count as items (default: direct structure-preserving lookup by class is the
+ * caller's job — pass the item selector, e.g. `'.flipchip'`).
+ */
+export declare function getMarqueeCloneTwin(trackContainer: Element, el: Element, selector: string): HTMLElement | null;
+export interface MarqueeWallProps {
+    /**
+     * Presentation mode — the consumer's one switch for "do I want the
+     * blur + marquee here at all":
+     * - `'animated'` (default): endless marquee when content overflows, with
+     *   the overflow fades.
+     * - `'plain'`: no motion, no fades — a plain clipped wall. All marquee
+     *   machinery (engine, clone copy, fades) is skipped entirely.
+     */
+    mode?: 'animated' | 'plain';
+    /**
+     * Marquee axis. Defaults to where the fade sits — the animation's job is to
+     * reveal what the fade hides: a `bottom`/`top` fade clips rows → vertical
+     * (content travels bottom→top); a `left`/`right`-only fade clips columns →
+     * horizontal (content travels right→left). No fade → horizontal.
+     */
+    axis?: 'x' | 'y';
+    /** Reverse travel: `x` reversed moves content right, `y` reversed moves it
+     *  down. Default false (left / up). */
+    reverse?: boolean;
+    /** Scroll speed in px/s (the CardsStrip unit — one speed language across
+     *  every marquee). Default 40: calm chip-wall drift, slower than the 60 the
+     *  card strips cruise at. */
+    speed?: number;
+    /** Master switch. Even when true the marquee auto-disables while the content
+     *  fits the container and under `prefers-reduced-motion` (static wall). */
+    animate?: boolean;
+    /** Freeze while a hover-capable pointer is anywhere over the wall — content
+     *  must never move under a pointing cursor (required for interactive chip
+     *  walls). Default true. */
+    pauseOnHover?: boolean;
+    /** Edge fade(s) — the "there's more" affordance. ONE spelling of the
+     *  clip-and-fade across every wall surface. */
+    fade?: MarqueeWallFadeEdge | ReadonlyArray<MarqueeWallFadeEdge>;
+    /** The color the fades blend INTO — must match the surface behind the wall
+     *  or the gradient paints a visible box. Default the page background. */
+    fadeColor?: string;
+    /** Fade thickness: one value for all edges or a per-edge map. Defaults:
+     *  40px vertical edges, 112px horizontal edges (the shipped hero-wall
+     *  geometry). */
+    fadeSize?: number | string | Partial<Record<MarqueeWallFadeEdge, number | string>>;
+    /** Gap between the two track copies — match the content's own item gap so
+     *  the seam is invisible. A CSS length string (e.g. `var(--tlcl-chipgap)`)
+     *  lets responsive CSS own the value; the true seam distance is MEASURED
+     *  from the rendered copies either way. Default 8. */
+    copyGap?: number | string;
+    /** Outer container class — sizing lives here (height cap for `y`, width for
+     *  `x`). The container is always `relative overflow-hidden`. */
+    className?: string;
+    /** Class on EACH track copy — the wall's own layout (e.g. a wrapping chip
+     *  row `flex flex-wrap gap-2`, or a fixed-width grid). */
+    contentClassName?: string;
+    /** Inline style on EACH track copy — for values classes can't carry (e.g.
+     *  an item gap driven by the same variable as `copyGap`, so chip pitch and
+     *  seam pitch stay one value by construction). */
+    contentStyle?: React.CSSProperties;
+    /**
+     * Wall content — ONE copy; the wall clones it for the endless loop (clone
+     * `aria-hidden` + focus-suppressed but still clickable). Pass a render
+     * callback to vary the clone copy (e.g. omit `data-flip-id`s / render
+     * decorative chips). Children must be clone-safe: ref-free, unique-DOM-id-
+     * free, mount-effect-free (same contract as <CardsStrip> children mode).
+     */
+    children: React.ReactNode | ((ctx: {
+        isClone: boolean;
+    }) => React.ReactNode);
+    /** Pair this wall with sibling walls under one shared position driver. */
+    sync?: MarqueeSyncController;
+    /** Stable id for FLIP coordination: publishes the wall's live offset via
+     *  {@link getMarqueeTrackOffset} and stamps `data-marquee-track` on the
+     *  container so morph engines can drift-correct captured positions. */
+    trackId?: string;
+}
+/** The wall's edge-fade overlays — exported so composite walls (stacked row
+ *  marquees) can draw ONE set of fades over the whole stack instead of
+ *  per-row copies. Parent must be `relative`. Overlays sit at z-1, ABOVE
+ *  FLIP flight ghosts (z-0 by contract): an in-flight chip dissolves under
+ *  the blur exactly like a resting chip. */
+export declare function MarqueeWallFades({ fade, fadeColor, fadeSize, }: {
+    fade?: MarqueeWallFadeEdge | ReadonlyArray<MarqueeWallFadeEdge>;
+    fadeColor?: string;
+    fadeSize?: MarqueeWallProps['fadeSize'];
+}): React.JSX.Element;
+/**
+ * <MarqueeWall> — THE endless-scroll wall container: a clipped area whose
+ * content loops as a marquee along either axis, fading out where the clip
+ * cuts. Built on the same `useMarqueeEngine` core as <CardsStrip> (the news /
+ * logo / bites strips) with a TRANSFORM driver instead of a scroller — no
+ * inner scrollable area is created, so it is safe inside surfaces that forbid
+ * nested scrollers (the deck's mobile single-fold panels).
+ *
+ * Static by circumstance, not by variant: when the content fits the container
+ * (or `prefers-reduced-motion`) the wall renders a single static copy with
+ * its fades — byte-identical to the old non-animated walls.
+ */
+export declare function MarqueeWall({ mode, axis: axisProp, reverse, speed, animate, pauseOnHover, fade, fadeColor, fadeSize, copyGap, className, contentClassName, contentStyle, children, sync, trackId, }: MarqueeWallProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=marquee-wall.d.ts.map

package/dist/components/ui/marquee-wall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marquee-wall.d.ts","sourceRoot":"","sources":["../../../src/components/ui/marquee-wall.tsx"],"names":[],"mappings":"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"}

package/dist/hooks/index.cjs

@@ -64,7 +64,9 @@
 
 
 
-var _chunkAN7MCJTVcjs = require('../chunk-AN7MCJTV.cjs');
+
+
+var _chunkQF3NQW7Ccjs = require('../chunk-QF3NQW7C.cjs');
 require('../chunk-BGD345ZV.cjs');
 require('../chunk-2B6773QM.cjs');
 require('../chunk-SSJNN5BS.cjs');
@@ -139,5 +141,7 @@ require('../chunk-VRHGVLSL.cjs');
 
 
 
-exports.GraphQLIntrospector = _chunkAN7MCJTVcjs.GraphQLIntrospector; exports.NEAR_VIEWPORT_ROOT_MARGIN = _chunkAN7MCJTVcjs.NEAR_VIEWPORT_ROOT_MARGIN; exports.batchFetchAuthenticatedImages = _chunkAN7MCJTVcjs.batchFetchAuthenticatedImages; exports.breakpoints = _chunkAN7MCJTVcjs.breakpoints; exports.clearVariablesParams = _chunkAN7MCJTVcjs.clearParams; exports.coerceValue = _chunkAN7MCJTVcjs.coerceValue; exports.configureAuthenticatedImage = _chunkAN7MCJTVcjs.configureAuthenticatedImage; exports.configureBatchImageFetch = _chunkAN7MCJTVcjs.configureBatchImageFetch; exports.createSearchParams = _chunkAN7MCJTVcjs.createSearchParams; exports.extractVariablesFromQuery = _chunkAN7MCJTVcjs.extractVariablesFromQuery; exports.flattenQueryVariables = _chunkAN7MCJTVcjs.flattenQueryVariables; exports.getArrayParams = _chunkAN7MCJTVcjs.getArrayParams; exports.getNestedValue = _chunkAN7MCJTVcjs.getNestedValue; exports.getRequiredParams = _chunkAN7MCJTVcjs.getRequiredParams; exports.introspector = _chunkAN7MCJTVcjs.introspector; exports.isInputObjectType = _chunkAN7MCJTVcjs.isInputObjectType; exports.isScalarType = _chunkAN7MCJTVcjs.isScalarType; exports.mergeDefaults = _chunkAN7MCJTVcjs.mergeDefaults; exports.mergeVariables = _chunkAN7MCJTVcjs.mergeVariables; exports.setNestedValue = _chunkAN7MCJTVcjs.setNestedValue; exports.shouldIncludeInUrl = _chunkAN7MCJTVcjs.shouldIncludeInUrl; exports.toast = _chunkAN7MCJTVcjs.toast; exports.urlParamsToVariables = _chunkAN7MCJTVcjs.urlParamsToVariables; exports.useAccessCodeIntegration = _chunkAN7MCJTVcjs.useAccessCodeIntegration; exports.useApiParams = _chunkAN7MCJTVcjs.useApiParams; exports.useAuthenticatedImage = _chunkAN7MCJTVcjs.useAuthenticatedImage; exports.useAutoLimitTags = _chunkAN7MCJTVcjs.useAutoLimitTags; exports.useBatchImages = _chunkAN7MCJTVcjs.useBatchImages; exports.useContactSubmission = _chunkAN7MCJTVcjs.useContactSubmission; exports.useCopyToClipboard = _chunkAN7MCJTVcjs.useCopyToClipboard; exports.useCursorPaginationState = _chunkAN7MCJTVcjs.useCursorPaginationState; exports.useDebounce = _chunkAN7MCJTVcjs.useDebounce; exports.useDeferredError = _chunkAN7MCJTVcjs.useDeferredError; exports.useFocusTrap = _chunkAN7MCJTVcjs.useFocusTrap; exports.useHeaderHeight = _chunkAN7MCJTVcjs.useHeaderHeight; exports.useHorizontalScrollbar = _chunkAN7MCJTVcjs.useHorizontalScrollbar; exports.useHumanitySignals = _chunkAN7MCJTVcjs.useHumanitySignals; exports.useImageEdgeColor = _chunkAN7MCJTVcjs.useImageEdgeColor; exports.useLgUp = _chunkAN7MCJTVcjs.useLgUp; exports.useLocalStorage = _chunkAN7MCJTVcjs.useLocalStorage; exports.useMdUp = _chunkAN7MCJTVcjs.useMdUp; exports.useMediaQuery = _chunkAN7MCJTVcjs.useMediaQuery; exports.useMemoizedCallback = _chunkAN7MCJTVcjs.useMemoizedCallback; exports.useNatsClient = _chunkAN7MCJTVcjs.useNatsClient; exports.useNearViewport = _chunkAN7MCJTVcjs.useNearViewport; exports.useNotificationPermission = _chunkAN7MCJTVcjs.useNotificationPermission; exports.useOgPlaceholderUrl = _chunkAN7MCJTVcjs.useOgPlaceholderUrl; exports.useOnboardingState = _chunkAN7MCJTVcjs.useOnboardingState; exports.usePlatformByValue = _chunkAN7MCJTVcjs.usePlatformByValue; exports.usePlatformConfig = _chunkAN7MCJTVcjs.usePlatformConfig; exports.usePreventScroll = _chunkAN7MCJTVcjs.usePreventScroll; exports.useQueryParams = _chunkAN7MCJTVcjs.useQueryParams; exports.useQuickActionHint = _chunkAN7MCJTVcjs.useQuickActionHint; exports.useScrollToHash = _chunkAN7MCJTVcjs.useScrollToHash; exports.useSearch = _chunkAN7MCJTVcjs.useSearch; exports.useSmUp = _chunkAN7MCJTVcjs.useSmUp; exports.useTablePagination = _chunkAN7MCJTVcjs.useTablePagination; exports.useThrottle = _chunkAN7MCJTVcjs.useThrottle; exports.useToast = _chunkAN7MCJTVcjs.useToast; exports.useValidatePlatform = _chunkAN7MCJTVcjs.useValidatePlatform; exports.useWindowSize = _chunkAN7MCJTVcjs.useWindowSize; exports.validateSchema = _chunkAN7MCJTVcjs.validateSchema; exports.validateVariables = _chunkAN7MCJTVcjs.validateVariables; exports.variablesToUrlParams = _chunkAN7MCJTVcjs.variablesToUrlParams;
+
+
+exports.GraphQLIntrospector = _chunkQF3NQW7Ccjs.GraphQLIntrospector; exports.NEAR_VIEWPORT_ROOT_MARGIN = _chunkQF3NQW7Ccjs.NEAR_VIEWPORT_ROOT_MARGIN; exports.batchFetchAuthenticatedImages = _chunkQF3NQW7Ccjs.batchFetchAuthenticatedImages; exports.breakpoints = _chunkQF3NQW7Ccjs.breakpoints; exports.clearVariablesParams = _chunkQF3NQW7Ccjs.clearParams; exports.coerceValue = _chunkQF3NQW7Ccjs.coerceValue; exports.configureAuthenticatedImage = _chunkQF3NQW7Ccjs.configureAuthenticatedImage; exports.configureBatchImageFetch = _chunkQF3NQW7Ccjs.configureBatchImageFetch; exports.createSearchParams = _chunkQF3NQW7Ccjs.createSearchParams; exports.extractVariablesFromQuery = _chunkQF3NQW7Ccjs.extractVariablesFromQuery; exports.flattenQueryVariables = _chunkQF3NQW7Ccjs.flattenQueryVariables; exports.getArrayParams = _chunkQF3NQW7Ccjs.getArrayParams; exports.getNestedValue = _chunkQF3NQW7Ccjs.getNestedValue; exports.getRequiredParams = _chunkQF3NQW7Ccjs.getRequiredParams; exports.introspector = _chunkQF3NQW7Ccjs.introspector; exports.isInputObjectType = _chunkQF3NQW7Ccjs.isInputObjectType; exports.isScalarType = _chunkQF3NQW7Ccjs.isScalarType; exports.mergeDefaults = _chunkQF3NQW7Ccjs.mergeDefaults; exports.mergeVariables = _chunkQF3NQW7Ccjs.mergeVariables; exports.setNestedValue = _chunkQF3NQW7Ccjs.setNestedValue; exports.shouldIncludeInUrl = _chunkQF3NQW7Ccjs.shouldIncludeInUrl; exports.toast = _chunkQF3NQW7Ccjs.toast; exports.urlParamsToVariables = _chunkQF3NQW7Ccjs.urlParamsToVariables; exports.useAccessCodeIntegration = _chunkQF3NQW7Ccjs.useAccessCodeIntegration; exports.useApiParams = _chunkQF3NQW7Ccjs.useApiParams; exports.useAuthenticatedImage = _chunkQF3NQW7Ccjs.useAuthenticatedImage; exports.useAutoLimitTags = _chunkQF3NQW7Ccjs.useAutoLimitTags; exports.useBatchImages = _chunkQF3NQW7Ccjs.useBatchImages; exports.useContactSubmission = _chunkQF3NQW7Ccjs.useContactSubmission; exports.useCopyToClipboard = _chunkQF3NQW7Ccjs.useCopyToClipboard; exports.useCursorPaginationState = _chunkQF3NQW7Ccjs.useCursorPaginationState; exports.useDebounce = _chunkQF3NQW7Ccjs.useDebounce; exports.useDeferredError = _chunkQF3NQW7Ccjs.useDeferredError; exports.useFocusTrap = _chunkQF3NQW7Ccjs.useFocusTrap; exports.useHeaderHeight = _chunkQF3NQW7Ccjs.useHeaderHeight; exports.useHorizontalScrollbar = _chunkQF3NQW7Ccjs.useHorizontalScrollbar; exports.useHumanitySignals = _chunkQF3NQW7Ccjs.useHumanitySignals; exports.useImageEdgeColor = _chunkQF3NQW7Ccjs.useImageEdgeColor; exports.useLgUp = _chunkQF3NQW7Ccjs.useLgUp; exports.useLocalStorage = _chunkQF3NQW7Ccjs.useLocalStorage; exports.useMarqueeEngine = _chunkQF3NQW7Ccjs.useMarqueeEngine; exports.useMdUp = _chunkQF3NQW7Ccjs.useMdUp; exports.useMediaQuery = _chunkQF3NQW7Ccjs.useMediaQuery; exports.useMemoizedCallback = _chunkQF3NQW7Ccjs.useMemoizedCallback; exports.useNatsClient = _chunkQF3NQW7Ccjs.useNatsClient; exports.useNearViewport = _chunkQF3NQW7Ccjs.useNearViewport; exports.useNotificationPermission = _chunkQF3NQW7Ccjs.useNotificationPermission; exports.useOgPlaceholderUrl = _chunkQF3NQW7Ccjs.useOgPlaceholderUrl; exports.useOnboardingState = _chunkQF3NQW7Ccjs.useOnboardingState; exports.usePlatformByValue = _chunkQF3NQW7Ccjs.usePlatformByValue; exports.usePlatformConfig = _chunkQF3NQW7Ccjs.usePlatformConfig; exports.usePreventScroll = _chunkQF3NQW7Ccjs.usePreventScroll; exports.useQueryParams = _chunkQF3NQW7Ccjs.useQueryParams; exports.useQuickActionHint = _chunkQF3NQW7Ccjs.useQuickActionHint; exports.useScrollToHash = _chunkQF3NQW7Ccjs.useScrollToHash; exports.useSearch = _chunkQF3NQW7Ccjs.useSearch; exports.useSmUp = _chunkQF3NQW7Ccjs.useSmUp; exports.useSuppressCloneFocus = _chunkQF3NQW7Ccjs.useSuppressCloneFocus; exports.useTablePagination = _chunkQF3NQW7Ccjs.useTablePagination; exports.useThrottle = _chunkQF3NQW7Ccjs.useThrottle; exports.useToast = _chunkQF3NQW7Ccjs.useToast; exports.useValidatePlatform = _chunkQF3NQW7Ccjs.useValidatePlatform; exports.useWindowSize = _chunkQF3NQW7Ccjs.useWindowSize; exports.validateSchema = _chunkQF3NQW7Ccjs.validateSchema; exports.validateVariables = _chunkQF3NQW7Ccjs.validateVariables; exports.variablesToUrlParams = _chunkQF3NQW7Ccjs.variablesToUrlParams;
 //# sourceMappingURL=index.cjs.map

package/dist/hooks/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/hooks/index.cjs"],"names":[],"mappings":"AAAA,qFAAY;AACZ;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,g+HAAC","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/hooks/index.cjs"}
+{"version":3,"sources":["/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/hooks/index.cjs"],"names":[],"mappings":"AAAA,qFAAY;AACZ;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,yDAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B,iCAA8B;AAC9B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wmIAAC","file":"/home/runner/work/openframe-oss-lib/openframe-oss-lib/openframe-frontend-core/dist/hooks/index.cjs"}

package/dist/hooks/index.js

@@ -40,6 +40,7 @@ import {
   useImageEdgeColor,
   useLgUp,
   useLocalStorage,
+  useMarqueeEngine,
   useMdUp,
   useMediaQuery,
   useMemoizedCallback,
@@ -56,6 +57,7 @@ import {
   useScrollToHash,
   useSearch,
   useSmUp,
+  useSuppressCloneFocus,
   useTablePagination,
   useThrottle,
   useToast,
@@ -64,7 +66,7 @@ import {
   validateSchema,
   validateVariables,
   variablesToUrlParams
-} from "../chunk-TKGCTDQY.js";
+} from "../chunk-MLFFBQ5B.js";
 import "../chunk-OYGFWWLQ.js";
 import "../chunk-KFQXO7QB.js";
 import "../chunk-ZJJERZUA.js";
@@ -115,6 +117,7 @@ export {
   useImageEdgeColor,
   useLgUp,
   useLocalStorage,
+  useMarqueeEngine,
   useMdUp,
   useMediaQuery,
   useMemoizedCallback,
@@ -131,6 +134,7 @@ export {
   useScrollToHash,
   useSearch,
   useSmUp,
+  useSuppressCloneFocus,
   useTablePagination,
   useThrottle,
   useToast,

package/dist/hooks/ui/index.d.ts

@@ -6,11 +6,13 @@ export * from './use-header-height';
 export * from './use-horizontal-scrollbar';
 export * from './use-image-edge-color';
 export * from './use-local-storage';
+export * from './use-marquee-engine';
 export * from './use-media-query';
 export * from './use-memoized-callback';
 export * from './use-notification-permission';
 export * from './use-onboarding-state';
 export * from './use-search';
+export * from './use-suppress-clone-focus';
 export * from './use-table-pagination';
 export * from './use-throttle';
 export * from './use-window-size';

package/dist/hooks/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,wBAAwB,CAAA;AACtC,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AAKjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/index.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,sBAAsB,CAAA;AACpC,cAAc,kBAAkB,CAAA;AAChC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,wBAAwB,CAAA;AACtC,cAAc,cAAc,CAAA;AAC5B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AAKjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/hooks/ui/use-marquee-engine.d.ts

@@ -0,0 +1,73 @@
+import { type MutableRefObject } from 'react';
+/**
+ * THE marquee animation core (single source of truth) — extracted verbatim
+ * from <CardsStrip> so every endless-scroll surface (card strips, logo strips,
+ * quick-action walls, chip marquees) shares ONE rAF position engine ("unify
+ * means delete variations").
+ *
+ * The engine is axis- and driver-agnostic: it owns a FLOAT position ref, a
+ * velocity envelope, seam wrapping, and an optional chevron-style glide; the
+ * caller decides what a position "means" via `apply` — writing
+ * `scroller.scrollLeft` (CardsStrip: a real scroller the user can also drag)
+ * or a `translate` transform (MarqueeWall: decorative tracks, incl. vertical —
+ * mandatory inside surfaces that forbid inner scrollers, e.g. the deck's
+ * mobile single-fold panels).
+ *
+ * Engine semantics (do not "simplify"):
+ * - Position lives in a FLOAT ref, never read-modify-write from the DOM:
+ *   scrollLeft reads back rounded values, so sub-pixel increments
+ *   (speed/fps < 1px) get eaten by rounding — stutter + measurably slower
+ *   than the configured speed.
+ * - Velocity envelope (~250ms time constant) eases between 0 and `speed`
+ *   instead of binary stop/start — pause decelerates, resume accelerates from
+ *   the current position (GSAP-marquee behavior; hard cuts read as jank).
+ * - Glide consumes a signed remaining-distance, wrapping modulo the copy size
+ *   each frame, so seam warps are invisible to it (browser smooth-scroll
+ *   animates toward an ABSOLUTE target and lunges after a warp).
+ * - `isPaused` is evaluated every frame — the caller owns the pause-reason
+ *   set (hover, viewport, tab visibility, suppress windows); the engine only
+ *   turns it into a smooth velocity target.
+ */
+export interface MarqueeEngineOptions {
+    /** Master switch — the rAF runs only while true. On (re)activation the
+     *  position resyncs from `readBack` when provided. */
+    active: boolean;
+    /** Cruise speed in px/s. */
+    speed: number;
+    /** Per-frame pause verdict (caller-owned reason set). `now` is the rAF
+     *  timestamp, for suppress-until comparisons. */
+    isPaused: (now: number) => boolean;
+    /** Single-copy size in px (the wrap modulus). Return <= 0 to disable
+     *  wrapping (position advances unwrapped — callers should size tracks so
+     *  this never happens while active). */
+    getWrapSize: () => number;
+    /** Lower bound of the wrap range: positions stay in
+     *  [wrapMin, wrapMin + wrapSize). Default 0. Scroller drivers with USER
+     *  scrolling pass their seam-warp buffer here so engine-written positions
+     *  never enter the re-center zones — an exact-edge warp check is racy
+     *  against the rAF (the engine nudges the scroller off the edge before the
+     *  scroll handler samples it → "stuck at the left edge"). */
+    getWrapMin?: () => number;
+    /** Write the position to the DOM (scrollLeft assignment or transform). */
+    apply: (pos: number) => void;
+    /** Read the externally-mutated position back (real scrollers: user drag /
+     *  native smooth scroll move scrollLeft under the engine). Omit for
+     *  transform drivers — nothing external can move them. */
+    readBack?: () => number;
+    /** Called at the end of every frame (e.g. hover re-resolution after the
+     *  track moved under a stationary pointer). */
+    onAfterFrame?: () => void;
+}
+export interface MarqueeEngineHandle {
+    /** The engine's float position (px along the axis, 0 ≤ pos < wrap while
+     *  wrapping). Callers may write it together with their own DOM write (seam
+     *  warp on manual scroll). */
+    posRef: MutableRefObject<number>;
+    /** Accumulate a signed glide distance (chevron navigation). Runs through
+     *  the engine's own tween — never native smooth scroll while wrapping. */
+    glideBy: (px: number) => void;
+    /** Wrap an arbitrary position into [0, wrapSize). */
+    wrap: (pos: number) => number;
+}
+export declare function useMarqueeEngine(options: MarqueeEngineOptions): MarqueeEngineHandle;
+//# sourceMappingURL=use-marquee-engine.d.ts.map

package/dist/hooks/ui/use-marquee-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-marquee-engine.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/use-marquee-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkC,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,oBAAoB;IACnC;0DACsD;IACtD,MAAM,EAAE,OAAO,CAAA;IACf,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb;qDACiD;IACjD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IAClC;;4CAEwC;IACxC,WAAW,EAAE,MAAM,MAAM,CAAA;IACzB;;;;;iEAK6D;IAC7D,UAAU,CAAC,EAAE,MAAM,MAAM,CAAA;IACzB,0EAA0E;IAC1E,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B;;8DAE0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;IACvB;mDAC+C;IAC/C,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC;;kCAE8B;IAC9B,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAChC;8EAC0E;IAC1E,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,qDAAqD;IACrD,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;CAC9B;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CA8EnF"}

package/dist/hooks/ui/use-suppress-clone-focus.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Keep a marquee clone's content pointer-CLICKABLE while taking it out of the
+ * accessibility tree and the keyboard tab order. Shared by every endless-loop
+ * surface that renders a second track copy (<CardsStrip> managed cells,
+ * <MarqueeWall> clone copies).
+ *
+ * `inert` (the previous approach) does all three at once: a11y-hidden,
+ * un-focusable AND un-clickable. That third effect was the "news marquee stops
+ * being clickable after you scroll it for a while" bug — the 2-copy endless
+ * loop ALWAYS paints clone cards inside the viewport near the copy seam, so a
+ * user who manually scrolls and parks there is looking at real-looking cards
+ * that silently swallow every click. Clones must therefore stay clickable (a
+ * click on ANY visible card must open its link — mouse, ⌘-click, middle-click
+ * and context-menu all handled natively by the clone's own anchor).
+ *
+ * The a11y contract is still met without `inert`: the caller keeps
+ * `aria-hidden` on the clone wrapper (out of the a11y tree) and this hook
+ * forces every focusable descendant to `tabindex="-1"` (out of the tab order →
+ * no duplicate tab stops, no aria-hidden-focus violation). Re-applied on
+ * subtree mutation. This is the standard loop-clone treatment used by
+ * Swiper/Splide.
+ */
+export declare function useSuppressCloneFocus(active: boolean): import("react").RefObject<HTMLDivElement | null>;
+//# sourceMappingURL=use-suppress-clone-focus.d.ts.map

package/dist/hooks/ui/use-suppress-clone-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-suppress-clone-focus.d.ts","sourceRoot":"","sources":["../../../src/hooks/ui/use-suppress-clone-focus.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,oDA2BpD"}