@santi020k/lumen-core 3.0.1 → 4.1.0

package/dist/loading.d.ts

@@ -0,0 +1,34 @@
+export declare const lumenSkeletonShapes: readonly ["rectangle", "text", "circle"];
+export type LumenSkeletonShape = (typeof lumenSkeletonShapes)[number];
+export declare const lumenSkeletonAnimations: readonly ["shimmer", "pulse", "none"];
+export type LumenSkeletonAnimation = (typeof lumenSkeletonAnimations)[number];
+export type LumenSkeletonSize = number | string;
+export interface LumenProgressState {
+    max: number;
+    percentage: number;
+    value: number;
+}
+export interface LumenLoadingSemanticsInput {
+    ariaHidden?: boolean | string | null | undefined;
+    ariaLabel?: string | null | undefined;
+    ariaLabelledby?: string | null | undefined;
+    role?: string | null | undefined;
+}
+export interface LumenLoadingSemantics {
+    ariaHidden: 'true' | undefined;
+    role: 'status' | undefined;
+}
+/**
+ * Normalizes progress input to finite ARIA values. Non-finite or non-positive maxima fall back to
+ * 100, and missing or non-finite values fall back to 0 before clamping.
+ */
+export declare const normalizeLumenProgress: (max?: unknown, value?: unknown) => LumenProgressState;
+export declare const resolveLumenSkeletonShape: (value: unknown) => LumenSkeletonShape;
+export declare const resolveLumenSkeletonAnimation: (value: unknown) => LumenSkeletonAnimation;
+export declare const resolveLumenSkeletonSize: (value: unknown) => string | undefined;
+/**
+ * Loading indicators are decorative unless named. A named indicator becomes a status region, and
+ * explicit `aria-hidden` or `role` values always win.
+ */
+export declare const resolveLumenLoadingSemantics: ({ ariaHidden, ariaLabel, ariaLabelledby, role }: LumenLoadingSemanticsInput) => LumenLoadingSemantics;
+//# sourceMappingURL=loading.d.ts.map

package/dist/loading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading.d.ts","sourceRoot":"","sources":["../src/loading.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,0CAA2C,CAAA;AAE3E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAErE,eAAO,MAAM,uBAAuB,uCAAwC,CAAA;AAE5E,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7E,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,CAAA;AAE/C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAChD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IACrC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;IAC1C,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAA;CAC3B;AAeD;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,OAAO,EAAE,QAAQ,OAAO,KAAG,kBAMvE,CAAA;AAED,eAAO,MAAM,yBAAyB,GAAI,OAAO,OAAO,KAAG,kBAE1D,CAAA;AAED,eAAO,MAAM,6BAA6B,GAAI,OAAO,OAAO,KAAG,sBAE9D,CAAA;AA6BD,eAAO,MAAM,wBAAwB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAYlE,CAAA;AAKD;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,iDAK1C,0BAA0B,KAAG,qBAS/B,CAAA"}

package/dist/loading.js

@@ -0,0 +1,70 @@
+export const lumenSkeletonShapes = ['rectangle', 'text', 'circle'];
+export const lumenSkeletonAnimations = ['shimmer', 'pulse', 'none'];
+const defaultProgressMax = 100;
+const maxSizeLength = 64;
+const toFiniteNumber = (value) => {
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : undefined;
+    if (typeof value !== 'string' || !value.trim())
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+};
+/**
+ * Normalizes progress input to finite ARIA values. Non-finite or non-positive maxima fall back to
+ * 100, and missing or non-finite values fall back to 0 before clamping.
+ */
+export const normalizeLumenProgress = (max, value) => {
+    const finiteMax = toFiniteNumber(max);
+    const safeMax = finiteMax !== undefined && finiteMax > 0 ? finiteMax : defaultProgressMax;
+    const safeValue = Math.min(safeMax, Math.max(0, toFiniteNumber(value) ?? 0));
+    return { max: safeMax, percentage: (safeValue / safeMax) * 100, value: safeValue };
+};
+export const resolveLumenSkeletonShape = (value) => (lumenSkeletonShapes.find(shape => shape === value) ?? 'rectangle');
+export const resolveLumenSkeletonAnimation = (value) => (lumenSkeletonAnimations.find(animation => animation === value) ?? 'shimmer');
+// Letters keep their case because custom property names in var() are case-sensitive.
+const isSafeSizeCharacter = (character) => ((character >= 'a' && character <= 'z') ||
+    (character >= 'A' && character <= 'Z') ||
+    (character >= '0' && character <= '9') ||
+    '%.+-*/(), _'.includes(character));
+/**
+ * Resolves a Skeleton width or height to a CSS length. Finite non-negative numbers become pixels;
+ * strings may be lengths, percentages, or math and `var()` expressions, limited to ASCII letters,
+ * digits, and math characters so they cannot add declarations.
+ */
+const toPixelSize = (value) => (Number.isFinite(value) && value >= 0 ? `${value}px` : undefined);
+const isSafeSizeExpression = (size) => {
+    if (!size || size.length > maxSizeLength)
+        return false;
+    for (const character of size) {
+        if (!isSafeSizeCharacter(character))
+            return false;
+    }
+    return true;
+};
+export const resolveLumenSkeletonSize = (value) => {
+    if (typeof value === 'number')
+        return toPixelSize(value);
+    if (typeof value !== 'string')
+        return undefined;
+    const size = value.trim();
+    if (!isSafeSizeExpression(size))
+        return undefined;
+    const pixels = toFiniteNumber(size);
+    return pixels === undefined ? size : toPixelSize(pixels);
+};
+// Names come from untyped markup and props at runtime, so only non-blank strings count.
+const hasAccessibleNameText = (value) => typeof value === 'string' && value.trim() !== '';
+/**
+ * Loading indicators are decorative unless named. A named indicator becomes a status region, and
+ * explicit `aria-hidden` or `role` values always win.
+ */
+export const resolveLumenLoadingSemantics = ({ ariaHidden, ariaLabel, ariaLabelledby, role }) => {
+    const isNamed = hasAccessibleNameText(ariaLabel) || hasAccessibleNameText(ariaLabelledby);
+    const hasExplicitHidden = ariaHidden !== undefined && ariaHidden !== null;
+    const hasExplicitRole = role !== undefined && role !== null;
+    return {
+        ariaHidden: hasExplicitHidden || isNamed ? undefined : 'true',
+        role: hasExplicitRole || !isNamed ? undefined : 'status'
+    };
+};

package/dist/media-viewport.d.ts

@@ -0,0 +1,24 @@
+import { type LumenMediaViewportAction, type LumenMediaViewportValue } from './media-workspace.js';
+export interface LumenMediaViewportLabels {
+    down: string;
+    fit: string;
+    left: string;
+    right: string;
+    up: string;
+    'zoom-in': string;
+    'zoom-out': string;
+}
+export declare const lumenMediaViewportLabels: LumenMediaViewportLabels;
+export declare const lumenMediaViewportActions: readonly ["zoom-in", "zoom-out", "fit", "left", "right", "up", "down"];
+export declare const isLumenMediaViewportAction: (value: unknown) => value is LumenMediaViewportAction;
+export declare const formatLumenMediaZoom: (zoom: number, locale?: string) => string;
+/** Shared pointer/keyboard interaction; the consumer decides whether to accept each requested value. */
+export declare const bindLumenMediaViewport: (root: HTMLElement, options: {
+    disabled: () => boolean;
+    getValue: () => LumenMediaViewportValue;
+    maxZoom: () => number;
+    onValueChange: (value: LumenMediaViewportValue) => void;
+}) => (() => void);
+/** Writes only Lumen-owned styles and controls; image loading and contents stay application-owned. */
+export declare const syncLumenMediaViewport: (root: HTMLElement, value: LumenMediaViewportValue, maxZoom?: number, disabled?: boolean, locale?: string) => void;
+//# sourceMappingURL=media-viewport.d.ts.map

package/dist/media-viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-viewport.d.ts","sourceRoot":"","sources":["../src/media-viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAG7B,MAAM,sBAAsB,CAAA;AAE7B,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,eAAO,MAAM,wBAAwB,EAAE,wBAQtC,CAAA;AAED,eAAO,MAAM,yBAAyB,wEAAyE,CAAA;AAE/G,eAAO,MAAM,0BAA0B,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,wBAEpE,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,MAMpE,CAAA;AAUD,wGAAwG;AACxG,eAAO,MAAM,sBAAsB,GACjC,MAAM,WAAW,EACjB,SAAS;IACP,QAAQ,EAAE,MAAM,OAAO,CAAA;IACvB,QAAQ,EAAE,MAAM,uBAAuB,CAAA;IACvC,OAAO,EAAE,MAAM,MAAM,CAAA;IACrB,aAAa,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAA;CACxD,KACA,CAAC,MAAM,IAAI,CAwFb,CAAA;AAQD,sGAAsG;AACtG,eAAO,MAAM,sBAAsB,GACjC,MAAM,WAAW,EAAE,OAAO,uBAAuB,EAAE,gBAAW,EAAE,kBAAgB,EAAE,SAAS,MAAM,KAChG,IAwBF,CAAA"}

package/dist/media-viewport.js

@@ -0,0 +1,119 @@
+import { applyLumenMediaViewportAction, normalizeLumenMediaViewport, panLumenMediaViewport } from './media-workspace.js';
+export const lumenMediaViewportLabels = {
+    down: 'Pan down',
+    fit: 'Fit to view',
+    left: 'Pan left',
+    right: 'Pan right',
+    up: 'Pan up',
+    'zoom-in': 'Zoom in',
+    'zoom-out': 'Zoom out'
+};
+export const lumenMediaViewportActions = ['zoom-in', 'zoom-out', 'fit', 'left', 'right', 'up', 'down'];
+export const isLumenMediaViewportAction = (value) => (value === 'zoom-in' || value === 'zoom-out' || value === 'fit' || value === 'left' || value === 'right' || value === 'up' || value === 'down');
+export const formatLumenMediaZoom = (zoom, locale) => {
+    try {
+        return new Intl.NumberFormat(locale, { style: 'percent', maximumFractionDigits: 0 }).format(zoom);
+    }
+    catch {
+        return new Intl.NumberFormat('en', { style: 'percent', maximumFractionDigits: 0 }).format(zoom);
+    }
+};
+const closestViewportElement = (target, selector) => {
+    try {
+        return Element.prototype.closest.call(target, selector);
+    }
+    catch {
+        return null;
+    }
+};
+/** Shared pointer/keyboard interaction; the consumer decides whether to accept each requested value. */
+export const bindLumenMediaViewport = (root, options) => {
+    const stage = root.querySelector('[data-ui-media-viewport-stage]');
+    if (!stage)
+        return () => undefined;
+    const view = root.ownerDocument.defaultView;
+    const abort = new (view?.AbortController ?? AbortController)();
+    const { signal } = abort;
+    let drag;
+    const act = (action) => {
+        if (options.disabled())
+            return;
+        options.onValueChange(applyLumenMediaViewportAction(options.getValue(), action, options.maxZoom()));
+    };
+    root.addEventListener('click', event => {
+        const button = closestViewportElement(event.target, 'button[data-ui-media-viewport-action]');
+        const action = button?.getAttribute('data-ui-media-viewport-action');
+        if (!button || button.hasAttribute('disabled') || !root.contains(button) || !isLumenMediaViewportAction(action))
+            return;
+        act(action);
+    }, { signal });
+    const keys = {
+        ArrowDown: 'down', ArrowLeft: 'left', ArrowRight: 'right', ArrowUp: 'up', Home: 'fit', '+': 'zoom-in', '=': 'zoom-in', '-': 'zoom-out'
+    };
+    stage.addEventListener('keydown', event => {
+        if (event.target !== stage || event.altKey || event.ctrlKey || event.metaKey || options.disabled())
+            return;
+        const action = keys[event.key];
+        if (!action)
+            return;
+        event.preventDefault();
+        act(action);
+    }, { signal });
+    stage.addEventListener('pointerdown', event => {
+        if (options.disabled() || drag || event.button !== 0 || options.getValue().zoom <= 1)
+            return;
+        if (closestViewportElement(event.target, 'button, input, a, select, textarea, [contenteditable]'))
+            return;
+        drag = { id: event.pointerId, x: event.clientX, y: event.clientY, value: options.getValue() };
+        stage.setPointerCapture(event.pointerId);
+        event.preventDefault();
+    }, { signal });
+    stage.addEventListener('pointermove', event => {
+        if (drag?.id !== event.pointerId || options.disabled())
+            return;
+        const bounds = stage.getBoundingClientRect();
+        options.onValueChange(panLumenMediaViewport(drag.value, event.clientX - drag.x, event.clientY - drag.y, bounds.width, bounds.height, options.maxZoom()));
+    }, { signal });
+    const stopDrag = (event) => {
+        if (drag?.id !== event.pointerId)
+            return;
+        drag = undefined;
+        if (stage.hasPointerCapture(event.pointerId))
+            stage.releasePointerCapture(event.pointerId);
+    };
+    stage.addEventListener('pointerup', stopDrag, { signal });
+    stage.addEventListener('pointercancel', stopDrag, { signal });
+    stage.addEventListener('lostpointercapture', stopDrag, { signal });
+    stage.addEventListener('dragstart', event => {
+        event.preventDefault();
+    }, { signal });
+    return () => {
+        if (drag && stage.hasPointerCapture(drag.id))
+            stage.releasePointerCapture(drag.id);
+        drag = undefined;
+        abort.abort();
+    };
+};
+const viewportTouchAction = (zoom, disabled) => zoom > 1 && !disabled ? 'none' : 'pan-y';
+const sameViewportValue = (left, right) => (left.zoom === right.zoom && left.x === right.x && left.y === right.y);
+/** Writes only Lumen-owned styles and controls; image loading and contents stay application-owned. */
+export const syncLumenMediaViewport = (root, value, maxZoom = 4, disabled = false, locale) => {
+    const current = normalizeLumenMediaViewport(value, maxZoom);
+    const content = root.querySelector('[data-ui-media-viewport-content]');
+    const stage = root.querySelector('[data-ui-media-viewport-stage]');
+    const status = root.querySelector('[data-ui-media-viewport-status]');
+    if (content) {
+        content.style.transform = `translate(${current.x * (current.zoom - 1) * 50}%, ${current.y * (current.zoom - 1) * 50}%) scale(${current.zoom})`;
+    }
+    if (stage) {
+        stage.style.touchAction = viewportTouchAction(current.zoom, disabled);
+        stage.setAttribute('aria-disabled', String(disabled));
+    }
+    if (status)
+        status.textContent = formatLumenMediaZoom(current.zoom, locale);
+    for (const button of root.querySelectorAll('button[data-ui-media-viewport-action]')) {
+        const action = button.dataset.uiMediaViewportAction;
+        const next = isLumenMediaViewportAction(action) ? applyLumenMediaViewportAction(current, action, maxZoom) : current;
+        button.disabled = disabled || sameViewportValue(next, current);
+    }
+};

package/dist/media-workspace.d.ts

@@ -0,0 +1,27 @@
+/** Media content, loading and persistence remain owned by each framework's consumer. */
+export interface LumenMediaIdentity {
+    disabled?: boolean;
+    id: string;
+}
+/** Returns a new collection; stale requests and out-of-range destinations leave its order intact. */
+export declare const moveLumenMediaItem: <Item extends LumenMediaIdentity>(items: readonly Item[], id: string, targetIndex: number) => Item[];
+/** Prunes missing IDs and duplicates, preserving the displayed media order. */
+export declare const resolveLumenMediaSelection: (items: readonly LumenMediaIdentity[], selectedIds: readonly string[]) => string[];
+export declare const toggleLumenMediaSelection: (items: readonly LumenMediaIdentity[], selectedIds: readonly string[], id: string) => string[];
+/** Zoom relative to fit; x/y are fractions of the available pan extent, from -1 to 1. */
+export interface LumenMediaViewportValue {
+    x: number;
+    y: number;
+    zoom: number;
+}
+export type LumenMediaViewportAction = 'zoom-in' | 'zoom-out' | 'left' | 'right' | 'up' | 'down' | 'fit';
+export declare const resolveLumenMediaMaxZoom: (maxZoom?: number) => number;
+export declare const normalizeLumenMediaViewport: (value?: unknown, maxZoom?: number) => LumenMediaViewportValue;
+export declare const applyLumenMediaViewportAction: (value: LumenMediaViewportValue, action: LumenMediaViewportAction, maxZoom?: number) => LumenMediaViewportValue;
+/** Maps pointer movement to bounded pan coordinates without allowing media outside its viewport. */
+export declare const panLumenMediaViewport: (value: LumenMediaViewportValue, deltaX: number, deltaY: number, width: number, height: number, maxZoom?: number) => LumenMediaViewportValue;
+export type LumenMediaThumbnailState = 'ready' | 'loading' | 'error';
+export declare const resolveLumenMediaThumbnailState: (state: unknown) => LumenMediaThumbnailState;
+export declare const resolveLumenMediaOrder: (order?: number) => number | undefined;
+export declare const formatLumenMediaThumbnailState: (state: LumenMediaThumbnailState, label?: string) => string;
+//# sourceMappingURL=media-workspace.d.ts.map

package/dist/media-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-workspace.d.ts","sourceRoot":"","sources":["../src/media-workspace.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,EAAE,EAAE,MAAM,CAAA;CACX;AAYD,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,GAAI,IAAI,SAAS,kBAAkB,EAChE,OAAO,SAAS,IAAI,EAAE,EAAE,IAAI,MAAM,EAAE,aAAa,MAAM,KACtD,IAAI,EAeN,CAAA;AAED,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,GACrC,OAAO,SAAS,kBAAkB,EAAE,EAAE,aAAa,SAAS,MAAM,EAAE,KACnE,MAAM,EAMR,CAAA;AAED,eAAO,MAAM,yBAAyB,GACpC,OAAO,SAAS,kBAAkB,EAAE,EAAE,aAAa,SAAS,MAAM,EAAE,EAAE,IAAI,MAAM,KAC/E,MAAM,EAUR,CAAA;AAED,yFAAyF;AACzF,MAAM,WAAW,uBAAuB;IACtC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,CAAA;AAExG,eAAO,MAAM,wBAAwB,GAAI,gBAAW,KAAG,MAEtD,CAAA;AAMD,eAAO,MAAM,2BAA2B,GACtC,QAAO,OAAY,EAAE,gBAAW,KAC/B,uBASF,CAAA;AAED,eAAO,MAAM,6BAA6B,GACxC,OAAO,uBAAuB,EAAE,QAAQ,wBAAwB,EAAE,gBAAW,KAC5E,uBAkBF,CAAA;AAED,oGAAoG;AACpG,eAAO,MAAM,qBAAqB,GAChC,OAAO,uBAAuB,EAAE,QAAQ,MAAM,EAAE,QAAQ,MAAM,EAC9D,OAAO,MAAM,EAAE,QAAQ,MAAM,EAAE,gBAAW,KACzC,uBAWF,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;AAEpE,eAAO,MAAM,+BAA+B,GAAI,OAAO,OAAO,KAAG,wBAEhE,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAEhE,CAAA;AAED,eAAO,MAAM,8BAA8B,GAAI,OAAO,wBAAwB,EAAE,QAAQ,MAAM,KAAG,MAIhG,CAAA"}

package/dist/media-workspace.js

@@ -0,0 +1,83 @@
+const assertMediaIdentities = (items) => {
+    const ids = new Set();
+    for (const item of items) {
+        if (!item.id.trim() || ids.has(item.id))
+            throw new Error('Media items require nonempty, unique IDs');
+        ids.add(item.id);
+    }
+};
+/** Returns a new collection; stale requests and out-of-range destinations leave its order intact. */
+export const moveLumenMediaItem = (items, id, targetIndex) => {
+    assertMediaIdentities(items);
+    const next = [...items];
+    const from = items.findIndex(item => item.id === id);
+    const item = items[from];
+    const validTarget = Number.isInteger(targetIndex) && targetIndex >= 0 && targetIndex < items.length;
+    if (!item || item.disabled || !validTarget)
+        return next;
+    next.splice(from, 1);
+    next.splice(targetIndex, 0, item);
+    return next;
+};
+/** Prunes missing IDs and duplicates, preserving the displayed media order. */
+export const resolveLumenMediaSelection = (items, selectedIds) => {
+    assertMediaIdentities(items);
+    const selected = new Set(selectedIds);
+    return items.filter(item => selected.has(item.id)).map(item => item.id);
+};
+export const toggleLumenMediaSelection = (items, selectedIds, id) => {
+    const selected = new Set(resolveLumenMediaSelection(items, selectedIds));
+    const item = items.find(candidate => candidate.id === id);
+    if (!item || item.disabled)
+        return [...selected];
+    if (selected.has(id))
+        selected.delete(id);
+    else
+        selected.add(id);
+    return resolveLumenMediaSelection(items, [...selected]);
+};
+export const resolveLumenMediaMaxZoom = (maxZoom = 4) => (Number.isFinite(maxZoom) ? Math.min(16, Math.max(1, maxZoom)) : 4);
+const panFraction = (value = 0) => Number.isFinite(value) ? Math.max(-1, Math.min(1, value)) : 0;
+const viewportNumber = (value, fallback = 0) => typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+const isViewportRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+export const normalizeLumenMediaViewport = (value = {}, maxZoom = 4) => {
+    if (!isViewportRecord(value))
+        return { x: 0, y: 0, zoom: 1 };
+    const limit = resolveLumenMediaMaxZoom(maxZoom);
+    const zoom = Math.min(limit, Math.max(1, viewportNumber(value.zoom, 1)));
+    const x = panFraction(viewportNumber(value.x));
+    const y = panFraction(viewportNumber(value.y));
+    return { x: zoom === 1 ? 0 : x, y: zoom === 1 ? 0 : y, zoom };
+};
+export const applyLumenMediaViewportAction = (value, action, maxZoom = 4) => {
+    const current = normalizeLumenMediaViewport(value, maxZoom);
+    if (action === 'fit')
+        return { x: 0, y: 0, zoom: 1 };
+    switch (action) {
+        case 'zoom-in': return normalizeLumenMediaViewport({ ...current, zoom: current.zoom + 0.25 }, maxZoom);
+        case 'zoom-out': return normalizeLumenMediaViewport({ ...current, zoom: current.zoom - 0.25 }, maxZoom);
+        case 'left': return normalizeLumenMediaViewport({ ...current, x: current.x - 0.25 }, maxZoom);
+        case 'right': return normalizeLumenMediaViewport({ ...current, x: current.x + 0.25 }, maxZoom);
+        case 'up': return normalizeLumenMediaViewport({ ...current, y: current.y - 0.25 }, maxZoom);
+        case 'down': return normalizeLumenMediaViewport({ ...current, y: current.y + 0.25 }, maxZoom);
+    }
+};
+/** Maps pointer movement to bounded pan coordinates without allowing media outside its viewport. */
+export const panLumenMediaViewport = (value, deltaX, deltaY, width, height, maxZoom = 4) => {
+    const current = normalizeLumenMediaViewport(value, maxZoom);
+    const extent = (current.zoom - 1) / 2;
+    if (extent === 0 || !Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0)
+        return current;
+    return normalizeLumenMediaViewport({
+        ...current,
+        x: current.x + (Number.isFinite(deltaX) ? deltaX / width / extent : 0),
+        y: current.y + (Number.isFinite(deltaY) ? deltaY / height / extent : 0)
+    }, maxZoom);
+};
+export const resolveLumenMediaThumbnailState = (state) => (state === 'loading' || state === 'error' ? state : 'ready');
+export const resolveLumenMediaOrder = (order) => (order !== undefined && Number.isSafeInteger(order) && order > 0 ? order : undefined);
+export const formatLumenMediaThumbnailState = (state, label) => {
+    if (label !== undefined)
+        return label;
+    return state === 'loading' ? 'Loading' : 'Unavailable';
+};

package/dist/message-scroller.d.ts

@@ -0,0 +1,14 @@
+export interface LumenMessageScrollState {
+    atEnd: boolean;
+}
+export interface LumenMessageScrollerOptions {
+    threshold?: number;
+    onStateChange?: (state: LumenMessageScrollState) => void;
+}
+export interface LumenMessageScrollerController {
+    destroy: () => void;
+    scrollToEnd: () => void;
+}
+/** Opt-in follow behavior. The application owns message identity and pagination. */
+export declare const createLumenMessageScrollerController: (viewport: HTMLElement, options?: LumenMessageScrollerOptions) => LumenMessageScrollerController;
+//# sourceMappingURL=message-scroller.d.ts.map

package/dist/message-scroller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-scroller.d.ts","sourceRoot":"","sources":["../src/message-scroller.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IAAG,KAAK,EAAE,OAAO,CAAA;CAAE;AAE3D,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAA;CACzD;AAED,MAAM,WAAW,8BAA8B;IAC7C,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,WAAW,EAAE,MAAM,IAAI,CAAA;CACxB;AAED,oFAAoF;AACpF,eAAO,MAAM,oCAAoC,GAC/C,UAAU,WAAW,EAAE,UAAS,2BAAgC,KAC/D,8BA0JF,CAAA"}

package/dist/message-scroller.js

@@ -0,0 +1,113 @@
+/** Opt-in follow behavior. The application owns message identity and pagination. */
+export const createLumenMessageScrollerController = (viewport, options = {}) => {
+    const view = viewport.ownerDocument.defaultView;
+    if (!view)
+        throw new Error('MessageScroller requires a document with a window.');
+    const threshold = options.threshold ?? 32;
+    if (!Number.isFinite(threshold) || threshold < 0)
+        throw new RangeError('MessageScroller threshold must be a finite nonnegative distance.');
+    let atEnd = true;
+    let anchor;
+    let frame;
+    let destroyed = false;
+    let programmaticTop;
+    const jump = viewport.querySelector('[data-ui-message-jump]');
+    const previousAnchor = viewport.style.overflowAnchor;
+    const previousBehavior = viewport.style.scrollBehavior;
+    const previousTabIndex = viewport.getAttribute('tabindex');
+    viewport.style.overflowAnchor = 'none';
+    viewport.style.scrollBehavior = 'auto';
+    if (previousTabIndex === null)
+        viewport.tabIndex = 0;
+    const captureAnchor = () => {
+        const top = viewport.getBoundingClientRect().top;
+        const item = [...viewport.querySelectorAll('[data-ui-message-item]')].find(element => element.getBoundingClientRect().bottom > top);
+        anchor = item ? { element: item, top: item.getBoundingClientRect().top } : undefined;
+    };
+    const announce = () => {
+        viewport.dataset.atEnd = String(atEnd);
+        if (jump)
+            jump.hidden = atEnd;
+        options.onStateChange?.({ atEnd });
+        viewport.dispatchEvent(new view.CustomEvent('ui:message-scroll-state', { bubbles: true, detail: { atEnd } }));
+    };
+    const scrollToEnd = () => {
+        atEnd = true;
+        // Hiding the jump action changes the scroll extent; measure its final layout.
+        announce();
+        viewport.scrollTop = Math.max(0, viewport.scrollHeight - viewport.clientHeight);
+        programmaticTop = viewport.scrollTop;
+        captureAnchor();
+    };
+    const onScroll = () => {
+        if (viewport.scrollTop === programmaticTop) {
+            programmaticTop = undefined;
+            captureAnchor();
+            return;
+        }
+        programmaticTop = undefined;
+        const next = viewport.scrollHeight - viewport.clientHeight - viewport.scrollTop <= threshold;
+        if (next !== atEnd) {
+            atEnd = next;
+            announce();
+        }
+        captureAnchor();
+    };
+    const refresh = () => {
+        if (frame !== undefined || destroyed)
+            return;
+        frame = view.requestAnimationFrame(() => {
+            frame = undefined;
+            if (destroyed)
+                return;
+            if (atEnd)
+                scrollToEnd();
+            else {
+                if (anchor?.element.isConnected && viewport.contains(anchor.element)) {
+                    viewport.scrollTop += anchor.element.getBoundingClientRect().top - anchor.top;
+                }
+                captureAnchor();
+            }
+        });
+    };
+    const resize = typeof view.ResizeObserver === 'function' ? new view.ResizeObserver(refresh) : undefined;
+    const observeContent = () => {
+        resize?.disconnect();
+        resize?.observe(viewport);
+        for (const child of viewport.children)
+            resize?.observe(child);
+    };
+    const mutation = new view.MutationObserver(records => {
+        if (!records.some(record => record.type === 'childList' || record.type === 'characterData'))
+            return;
+        observeContent();
+        refresh();
+    });
+    mutation.observe(viewport, { childList: true, characterData: true, subtree: true });
+    observeContent();
+    viewport.addEventListener('scroll', onScroll, { passive: true });
+    const jumpToEnd = () => {
+        const focused = viewport.ownerDocument.activeElement === jump;
+        scrollToEnd();
+        if (focused)
+            viewport.focus({ preventScroll: true });
+    };
+    jump?.addEventListener('click', jumpToEnd);
+    scrollToEnd();
+    return {
+        scrollToEnd,
+        destroy: () => {
+            destroyed = true;
+            mutation.disconnect();
+            resize?.disconnect();
+            viewport.removeEventListener('scroll', onScroll);
+            jump?.removeEventListener('click', jumpToEnd);
+            viewport.style.overflowAnchor = previousAnchor;
+            viewport.style.scrollBehavior = previousBehavior;
+            if (previousTabIndex === null)
+                viewport.removeAttribute('tabindex');
+            if (frame !== undefined)
+                view.cancelAnimationFrame(frame);
+        }
+    };
+};

package/dist/motion-workflows.d.ts

@@ -0,0 +1,24 @@
+import { lumenDurations } from './foundations.generated.js';
+export type LumenWorkflowDuration = keyof typeof lumenDurations;
+export interface LumenMotionGroupOptions {
+    duration?: LumenWorkflowDuration;
+    enterExit?: boolean;
+}
+export interface LumenMotionGroupController {
+    destroy(): void;
+    refresh(): void;
+    update(change: () => void): void;
+}
+/** Resolve shared motion tokens without requiring a browser during import. */
+export declare const getLumenWorkflowTiming: (element: Element, duration?: LumenWorkflowDuration) => {
+    duration: number;
+    easing: string;
+};
+export declare const isLumenWorkflowMotionReduced: (element: Element) => boolean;
+/** Animate keyed direct children while leaving DOM ordering and focus with the application. */
+export declare const createLumenMotionGroupController: (root: HTMLElement, options?: LumenMotionGroupOptions) => LumenMotionGroupController;
+/** Observe application-owned child changes; animation ghosts never trigger another refresh. */
+export declare const bindLumenMotionGroup: (root: HTMLElement, options?: LumenMotionGroupOptions) => (() => void);
+/** Execute application updates exactly once, whether a view transition is available or not. */
+export declare const runLumenViewTransition: (ownerDocument: Document, update: () => void | Promise<void>) => Promise<void>;
+//# sourceMappingURL=motion-workflows.d.ts.map

package/dist/motion-workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motion-workflows.d.ts","sourceRoot":"","sources":["../src/motion-workflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgB,MAAM,4BAA4B,CAAA;AAEzE,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,cAAc,CAAA;AAE/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,qBAAqB,CAAA;IAChC,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,IAAI,IAAI,CAAA;IAEf,OAAO,IAAI,IAAI,CAAA;IAEf,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;CACjC;AAiBD,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,GACjC,SAAS,OAAO,EAAE,WAAU,qBAAkC,KAC7D;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAUpC,CAAA;AAED,eAAO,MAAM,4BAA4B,GAAI,SAAS,OAAO,KAAG,OACoC,CAAA;AAgEpG,+FAA+F;AAC/F,eAAO,MAAM,gCAAgC,GAC3C,MAAM,WAAW,EAAE,UAAS,uBAA4B,KACvD,0BAkIF,CAAA;AAED,+FAA+F;AAC/F,eAAO,MAAM,oBAAoB,GAC/B,MAAM,WAAW,EAAE,UAAS,uBAA4B,KACvD,CAAC,MAAM,IAAI,CAqBb,CAAA;AAED,+FAA+F;AAC/F,eAAO,MAAM,sBAAsB,GACjC,eAAe,QAAQ,EAAE,QAAQ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAC1D,OAAO,CAAC,IAAI,CAqCd,CAAA"}