@santi020k/lumen-core 4.0.0 → 4.1.0

package/README.md

@@ -73,6 +73,13 @@ It also publishes shared web behavior contracts such as `LumenTabsChangeDetail`
 `LumenTabsChangeEvent`. Import them from the root or `@santi020k/lumen-core/tabs` when application
 code listens for `ui:tabs-change`.
 
+Loading helpers are available from the root export for custom web adapters:
+`normalizeLumenProgress(max, value)` produces finite, clamped progress values;
+`resolveLumenSkeletonShape`, `resolveLumenSkeletonAnimation`, and `resolveLumenSkeletonSize`
+normalize placeholder options. Numeric sizes become pixels, and bounded CSS size expressions retain
+custom-property casing. `resolveLumenLoadingSemantics` supplies decorative or named status defaults;
+adapters must preserve explicit consumer ARIA attributes when applying those defaults.
+
 Cross-platform foundations originate in `tokens/lumen.tokens.json` and are published as
 `@santi020k/lumen-tokens`. Core also exports generated hexadecimal light/dark palettes and native
 numeric spacing, radius, typography, duration, easing, and elevation values. The legacy
@@ -347,6 +354,20 @@ same-origin iframe documents.
 Data-mode collections preserve iframe keyboard focus across distant scrolling and keyed updates,
 and return focus to the list when the focused record is removed.
 
+## Floating panel placement
+
+`connectLumenFloatingPanel(panel, trigger, { onDismiss })` shows a panel anchored to its trigger. When the
+Popover API exists the panel enters the top layer, so scrolling or transformed dialogs cannot clip it;
+older browsers keep fixed placement. The panel flips above or below to stay in the visual viewport,
+aligns to the trigger's logical start or end in RTL, and follows scroll, resize, and enclosing transform
+transitions or animations once they settle. `onDismiss` runs when focus moves outside the panel and
+trigger, when the trigger's containing dialog closes, or when the trigger or panel leaves the document.
+Pass `placement`, `offset`, `collisionPadding`, or an `initialFocus` selector when needed. Connecting
+makes the panel visible, and the caller owns hiding it again: on dismissal, set your closed state and hide the
+panel, then call the returned cleanup. Cleanup leaves the top layer, returns owned focus to the trigger
+without stealing focus handed elsewhere, restores the panel's inline styles and popover attributes, and
+removes every listener and observer. React, Astro, and Elements date pickers and React menus share this helper.
+
 ## Virtual collections and direction
 
 `createLumenVirtualCollectionController(root, { items, getKey, renderItem, itemSize, overscan })`

package/dist/floating-panel.d.ts

@@ -0,0 +1,24 @@
+export type LumenFloatingPanelPlacement = 'bottom-end' | 'bottom-start' | 'top-end' | 'top-start';
+export interface LumenFloatingPanelOptions {
+    /** Logical alignment follows the trigger's inherited text direction. */
+    placement?: LumenFloatingPanelPlacement | undefined;
+    offset?: number | undefined;
+    collisionPadding?: number | undefined;
+    /** Focus the first matching element inside the panel after it opens. A malformed selector skips focus. */
+    initialFocus?: string | undefined;
+    /**
+     * Called when the panel should close: focus moves outside, its containing dialog closes, or the trigger
+     * or panel leaves the document. The caller hides the panel and calls the cleanup.
+     */
+    onDismiss: () => void;
+}
+/**
+ * Shows `panel` anchored to `trigger`: in the top layer when the Popover API exists, otherwise fixed. The
+ * panel follows scroll, resize, visual viewport, and enclosing animation changes, flips to stay visible,
+ * honors RTL, and calls `onDismiss` on outside focus, when its containing dialog closes, or when the trigger
+ * or panel leaves the document. Connecting makes the panel visible; the caller owns hiding it again. The returned
+ * cleanup leaves the top layer, returns owned focus to the trigger, restores the panel's previous inline
+ * styles and popover attributes, and removes every listener and observer.
+ */
+export declare const connectLumenFloatingPanel: (panel: HTMLElement, trigger: HTMLElement, { placement, offset, collisionPadding, initialFocus, onDismiss }: LumenFloatingPanelOptions) => (() => void);
+//# sourceMappingURL=floating-panel.d.ts.map

package/dist/floating-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating-panel.d.ts","sourceRoot":"","sources":["../src/floating-panel.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GAAG,YAAY,GAAG,cAAc,GAAG,SAAS,GAAG,WAAW,CAAA;AAEjG,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,SAAS,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAA;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,0GAA0G;IAC1G,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC;;;OAGG;IACH,SAAS,EAAE,MAAM,IAAI,CAAA;CACtB;AA4MD;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GACpC,OAAO,WAAW,EAClB,SAAS,WAAW,EACpB,kEAAmF,yBAAyB,KAC3G,CAAC,MAAM,IAAI,CA8Db,CAAA"}

package/dist/floating-panel.js

@@ -0,0 +1,203 @@
+const finiteDistance = (value, fallback) => {
+    if (value === undefined || !Number.isFinite(value))
+        return fallback;
+    return Math.max(0, value);
+};
+const clamp = (value, minimum, maximum) => {
+    const upperBound = Math.max(minimum, maximum);
+    return Math.max(minimum, Math.min(value, upperBound));
+};
+const styleKeys = [
+    'box-sizing',
+    'position',
+    'inset',
+    'left',
+    'top',
+    'right',
+    'bottom',
+    'margin',
+    'max-width',
+    'max-height',
+    'overflow-y'
+];
+const viewportBounds = ({ view, padding }) => {
+    const viewport = view.visualViewport;
+    const left = (viewport?.offsetLeft ?? 0) + padding;
+    const top = (viewport?.offsetTop ?? 0) + padding;
+    const width = Math.max(0, (viewport?.width ?? view.innerWidth) - padding * 2);
+    const height = Math.max(0, (viewport?.height ?? view.innerHeight) - padding * 2);
+    return { left, top, width, height, right: left + width, bottom: top + height };
+};
+const shouldPlaceBelow = (placement, above, below, height) => placement.startsWith('bottom') ? below >= height || below >= above : !(above >= height || above >= below);
+const positionPanel = (context) => {
+    const { panel, trigger, view, placement, gap } = context;
+    const viewport = viewportBounds(context);
+    const anchor = trigger.getBoundingClientRect();
+    panel.style.boxSizing = 'border-box';
+    panel.style.position = 'fixed';
+    panel.style.inset = 'auto';
+    panel.style.margin = '0';
+    panel.style.maxWidth = `${viewport.width}px`;
+    panel.style.maxHeight = `${viewport.height}px`;
+    panel.style.overflowY = 'auto';
+    const below = Math.max(0, viewport.bottom - anchor.bottom - gap);
+    const above = Math.max(0, anchor.top - viewport.top - gap);
+    const placeBelow = shouldPlaceBelow(placement, above, below, panel.getBoundingClientRect().height);
+    const availableHeight = placeBelow ? below : above;
+    panel.style.maxHeight = `${Math.min(viewport.height, availableHeight || viewport.height)}px`;
+    const bounds = panel.getBoundingClientRect();
+    const rtl = view.getComputedStyle(trigger).direction === 'rtl';
+    const alignRight = placement.endsWith('end') !== rtl;
+    const x = alignRight ? anchor.right - bounds.width : anchor.left;
+    const y = placeBelow ? anchor.bottom + gap : anchor.top - bounds.height - gap;
+    const alignment = placement.endsWith('end') ? 'end' : 'start';
+    panel.style.left = `${clamp(x, viewport.left, viewport.right - bounds.width)}px`;
+    panel.style.top = `${clamp(y, viewport.top, viewport.bottom - bounds.height)}px`;
+    panel.dataset.placement = `${placeBelow ? 'bottom' : 'top'}-${alignment}`;
+};
+// Transform transitions and animations move the trigger without resizing it, so ResizeObserver stays quiet.
+const settleEvents = ['animationend', 'animationcancel', 'transitionend', 'transitioncancel'];
+const observePosition = (context, dismiss) => {
+    const { panel, trigger, view } = context;
+    const document = panel.ownerDocument;
+    const NodeType = view.Node;
+    const dialog = trigger.closest('dialog');
+    const position = () => {
+        positionPanel(context);
+    };
+    const focusOutside = (event) => {
+        if (event.target instanceof NodeType &&
+            !panel.contains(event.target) && !trigger.contains(event.target))
+            dismiss();
+    };
+    const scroll = (event) => {
+        if (!(event.target instanceof NodeType) || !panel.contains(event.target))
+            position();
+    };
+    const observer = typeof view.ResizeObserver === 'function' ? new view.ResizeObserver(position) : undefined;
+    // Removing an open panel's owner must not leave document listeners or an expanded trigger behind.
+    const removal = typeof view.MutationObserver === 'function' ?
+        new view.MutationObserver(() => {
+            if (!trigger.isConnected || !panel.isConnected ||
+                trigger.ownerDocument !== document || panel.ownerDocument !== document)
+                dismiss();
+        }) :
+        undefined;
+    removal?.observe(document, { childList: true, subtree: true });
+    observer?.observe(trigger);
+    observer?.observe(panel);
+    document.addEventListener('focusin', focusOutside);
+    document.addEventListener('scroll', scroll, true);
+    for (const type of settleEvents)
+        document.addEventListener(type, position, true);
+    // Some engines move focus to the body without a focusin when a containing dialog closes.
+    dialog?.addEventListener('close', dismiss);
+    view.addEventListener('resize', position);
+    view.visualViewport?.addEventListener('resize', position);
+    view.visualViewport?.addEventListener('scroll', position);
+    return () => {
+        observer?.disconnect();
+        removal?.disconnect();
+        document.removeEventListener('focusin', focusOutside);
+        document.removeEventListener('scroll', scroll, true);
+        for (const type of settleEvents)
+            document.removeEventListener(type, position, true);
+        dialog?.removeEventListener('close', dismiss);
+        view.removeEventListener('resize', position);
+        view.visualViewport?.removeEventListener('resize', position);
+        view.visualViewport?.removeEventListener('scroll', position);
+    };
+};
+const restoreExternalFocus = (owner, focused) => {
+    const ElementType = owner.defaultView?.HTMLElement;
+    if (ElementType && focused instanceof ElementType && focused.isConnected && owner.activeElement !== focused) {
+        focused.focus({ preventScroll: true });
+    }
+};
+const restoreFocus = (panel, trigger, topLayer) => {
+    const document = panel.ownerDocument;
+    const focused = document.activeElement;
+    const ownedFocus = focused !== null && panel.contains(focused);
+    if (topLayer && panel.matches(':popover-open'))
+        panel.hidePopover();
+    if (ownedFocus && trigger.isConnected)
+        trigger.focus({ preventScroll: true });
+    // Closing a panel must not steal focus from a dialog opened by its action.
+    if (!ownedFocus)
+        restoreExternalFocus(document, focused);
+};
+const restoreAttribute = (panel, name, value) => {
+    if (value === null)
+        panel.removeAttribute(name);
+    else
+        panel.setAttribute(name, value);
+};
+// A malformed selector must not abort after the panel is shown, so it is resolved first and only skips focus.
+const findInitialFocus = (panel, view, selector) => {
+    if (!selector)
+        return null;
+    try {
+        return panel.querySelector(selector);
+    }
+    catch (error) {
+        if (error instanceof view.DOMException && error.name === 'SyntaxError')
+            return null;
+        throw error;
+    }
+};
+/**
+ * Shows `panel` anchored to `trigger`: in the top layer when the Popover API exists, otherwise fixed. The
+ * panel follows scroll, resize, visual viewport, and enclosing animation changes, flips to stay visible,
+ * honors RTL, and calls `onDismiss` on outside focus, when its containing dialog closes, or when the trigger
+ * or panel leaves the document. Connecting makes the panel visible; the caller owns hiding it again. The returned
+ * cleanup leaves the top layer, returns owned focus to the trigger, restores the panel's previous inline
+ * styles and popover attributes, and removes every listener and observer.
+ */
+export const connectLumenFloatingPanel = (panel, trigger, { placement = 'bottom-start', offset, collisionPadding, initialFocus, onDismiss }) => {
+    const view = panel.ownerDocument.defaultView;
+    if (!view)
+        return () => undefined;
+    const context = {
+        panel,
+        trigger,
+        view,
+        placement,
+        gap: finiteDistance(offset, 6),
+        padding: finiteDistance(collisionPadding, 8)
+    };
+    const focusTarget = findInitialFocus(panel, view, initialFocus);
+    const previousPopover = panel.getAttribute('popover');
+    const previousPlacement = panel.getAttribute('data-placement');
+    const previousStyles = styleKeys.map(key => [
+        key, panel.style.getPropertyValue(key), panel.style.getPropertyPriority(key)
+    ]);
+    const topLayer = typeof panel.showPopover === 'function';
+    panel.hidden = false;
+    if (topLayer) {
+        panel.setAttribute('popover', 'manual');
+        panel.showPopover();
+    }
+    positionPanel(context);
+    focusTarget?.focus({ preventScroll: true });
+    let connected = true;
+    const dismiss = () => {
+        if (connected)
+            onDismiss();
+    };
+    const stopObserving = observePosition(context, dismiss);
+    return () => {
+        if (!connected)
+            return;
+        connected = false;
+        stopObserving();
+        restoreFocus(panel, trigger, topLayer);
+        restoreAttribute(panel, 'popover', previousPopover);
+        restoreAttribute(panel, 'data-placement', previousPlacement);
+        for (const [key, value, priority] of previousStyles) {
+            if (value)
+                panel.style.setProperty(key, value, priority);
+            else
+                panel.style.removeProperty(key);
+        }
+    };
+};

package/dist/index.d.ts

@@ -19,12 +19,14 @@ export { getLumenDirectionalKey } from './direction.js';
 export { type LumenErrorStateAnnouncement, lumenErrorStateAnnouncements, type LumenErrorStateContent, type LumenErrorStateKind, lumenErrorStateKinds, type LumenErrorStateLayout, lumenErrorStateLayouts } from './error-state.js';
 export * from './extended-charts.js';
 export { createFigmaVariableName, exportThemeDesignTokens, exportThemeFigmaVariables, hslTokenToFigmaColor, hslTokenToHexColor, type LumenDesignToken, type LumenDesignTokenExport, type LumenDesignTokenType, type LumenEffectDesignToken, type LumenFigmaColorValue, type LumenFigmaVariable, type LumenFigmaVariableCollection, type LumenFigmaVariableExportOptions, type LumenFigmaVariableMode, type LumenStructureDesignToken } from './figma.js';
+export { connectLumenFloatingPanel, type LumenFloatingPanelOptions, type LumenFloatingPanelPlacement } from './floating-panel.js';
 export { createLumenFormFailure, createLumenFormSuccess, getLumenFieldErrors, type LumenFieldError, type LumenFormErrorInput, type LumenFormErrors, type LumenFormFailure, type LumenFormResult, type LumenFormStatus, lumenFormStatuses, type LumenFormSuccess, normalizeLumenFormErrors } from './forms.js';
 export { getLumenIcon, getLumenIconPack, getRegisteredLumenIconNames, type LumenIconData, type LumenIconName, lumenIconNames, type LumenIconNode, type LumenIconPack, lumenIcons, type LumenIconStyle, registerLumenIconPack, renderLumenIconSvg, resolveLumenIconName } from './icons.js';
 export { type LumenIllustrationElement, type LumenIllustrationName, lumenIllustrationNames, lumenIllustrations, type LumenIllustrationToneRole, renderLumenIllustrationSvg } from './illustrations.generated.js';
 export { formatLumenImageComparisonValue, type LumenImageComparisonChangeDetail, type LumenImageComparisonChangeEvent, type LumenImageComparisonMode, normalizeLumenImageComparisonMode, normalizeLumenImageComparisonRatio, normalizeLumenImageComparisonValue, syncLumenImageComparisonMode } from './image-comparison.js';
 export { createLumenKanbanMoveDetail, getAdjacentKanbanColumn, type LumenKanbanMoveDetail, type LumenKanbanMoveInput } from './kanban.js';
 export { formatLumenLanguageLabel, getLumenLocalePair, lumenDefaultLocales, type LumenLocaleOption, normalizeLumenLocales } from './language.js';
+export { type LumenLoadingSemantics, type LumenLoadingSemanticsInput, type LumenProgressState, type LumenSkeletonAnimation, lumenSkeletonAnimations, type LumenSkeletonShape, lumenSkeletonShapes, type LumenSkeletonSize, normalizeLumenProgress, resolveLumenLoadingSemantics, resolveLumenSkeletonAnimation, resolveLumenSkeletonShape, resolveLumenSkeletonSize } from './loading.js';
 export { bindLumenMediaViewport, formatLumenMediaZoom, isLumenMediaViewportAction, lumenMediaViewportActions, type LumenMediaViewportLabels, lumenMediaViewportLabels, syncLumenMediaViewport } from './media-viewport.js';
 export { applyLumenMediaViewportAction, type LumenMediaIdentity, type LumenMediaViewportAction, type LumenMediaViewportValue, moveLumenMediaItem, normalizeLumenMediaViewport, panLumenMediaViewport, resolveLumenMediaMaxZoom, resolveLumenMediaSelection, toggleLumenMediaSelection } from './media-workspace.js';
 export { createLumenMessageScrollerController, type LumenMessageScrollerController, type LumenMessageScrollerOptions, type LumenMessageScrollState } from './message-scroller.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,OAAO,EAAE,gCAAgC,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,KAAK,uBAAuB,EAAE,KAAK,0BAA0B,EAAE,KAAK,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAChO,OAAO,EACL,sCAAsC,EACtC,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,4BAA4B,EAC5B,KAAK,2BAA2B,EAChC,kCAAkC,EACnC,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,yBAAyB,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAC7G,cAAc,wBAAwB,CAAA;AACtC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,oCAAoC,EACpC,+BAA+B,EAC/B,iCAAiC,EACjC,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,+BAA+B,EAC/B,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,uBAAuB,EACvB,gCAAgC,EAChC,iBAAiB,EACjB,eAAe,EACf,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,8BAA8B,EACnC,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAClC,KAAK,eAAe,EACpB,KAAK,+BAA+B,EACpC,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,eAAe,EACf,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,yBAAyB,EAC9B,yBAAyB,EACzB,8BAA8B,EAC9B,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAI,KAAK,qBAAqB,EAAE,KAAK,6BAA6B,EAAE,KAAK,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACnM,OAAO,EACL,KAAK,cAAc,EACnB,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,6BAA6B,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAC3F,OAAO,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,KAAK,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACrJ,OAAO,EACL,KAAK,sBAAsB,EAC3B,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,qBAAqB,EACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,wBAAwB,EACxB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,eAAe,EACpB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,sBAAsB,EAAE,KAAK,2BAA2B,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAA;AAC/P,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,EACL,KAAK,2BAA2B,EAChC,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,sBAAsB,EACvB,MAAM,kBAAkB,CAAA;AACzB,cAAc,sBAAsB,CAAA;AACpC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC/B,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AACjI,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,wBAAwB,EACzB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,2BAA2B,EAC3B,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,cAAc,EACd,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,UAAU,EACV,KAAK,cAAc,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,0BAA0B,EAC3B,MAAM,8BAA8B,CAAA;AACrC,OAAO,EACL,+BAA+B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,EACpC,KAAK,wBAAwB,EAC7B,iCAAiC,EACjC,kCAAkC,EAClC,kCAAkC,EAClC,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,qBAAqB,EACtB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,kBAAkB,EAClB,2BAA2B,EAC3B,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EAC1B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,oCAAoC,EAAE,KAAK,8BAA8B,EAAE,KAAK,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACjL,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvJ,cAAc,uBAAuB,CAAA;AACrC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,2BAA2B,EAC5B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,4BAA4B,EAC5B,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAChD,cAAc,oBAAoB,CAAA;AAClC,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,sBAAsB,EACvB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,KAAK,yBAAyB,EAC9B,0BAA0B,EAC1B,KAAK,mBAAmB,EACxB,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,4BAA4B,EAC5B,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,wBAAwB,EACxB,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,eAAe,EACf,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,2BAA2B,EAAE,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAC3J,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AACxH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EACL,8BAA8B,EAC9B,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,cAAc,EACd,YAAY,EACZ,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,UAAU,EACV,WAAW,EACX,KAAK,kBAAkB,EACvB,WAAW,EACX,YAAY,EACZ,mBAAmB,EACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,sCAAsC,EAAE,KAAK,gCAAgC,EAAE,KAAK,6BAA6B,EAAE,MAAM,yBAAyB,CAAA;AAC3J,OAAO,EAAE,gCAAgC,EAAE,KAAK,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AACrG,OAAO,EAAE,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAC/I,cAAc,qBAAqB,CAAA;AACnC,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,KAAK,4BAA4B,EACjC,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,+BAA+B,EAC/B,0CAA0C,EAC1C,6BAA6B,EAC7B,8BAA8B,EAC9B,gCAAgC,EACjC,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -19,12 +19,14 @@ export { getLumenDirectionalKey } from './direction.js';
 export { lumenErrorStateAnnouncements, lumenErrorStateKinds, lumenErrorStateLayouts } from './error-state.js';
 export * from './extended-charts.js';
 export { createFigmaVariableName, exportThemeDesignTokens, exportThemeFigmaVariables, hslTokenToFigmaColor, hslTokenToHexColor } from './figma.js';
+export { connectLumenFloatingPanel } from './floating-panel.js';
 export { createLumenFormFailure, createLumenFormSuccess, getLumenFieldErrors, lumenFormStatuses, normalizeLumenFormErrors } from './forms.js';
 export { getLumenIcon, getLumenIconPack, getRegisteredLumenIconNames, lumenIconNames, lumenIcons, registerLumenIconPack, renderLumenIconSvg, resolveLumenIconName } from './icons.js';
 export { lumenIllustrationNames, lumenIllustrations, renderLumenIllustrationSvg } from './illustrations.generated.js';
 export { formatLumenImageComparisonValue, normalizeLumenImageComparisonMode, normalizeLumenImageComparisonRatio, normalizeLumenImageComparisonValue, syncLumenImageComparisonMode } from './image-comparison.js';
 export { createLumenKanbanMoveDetail, getAdjacentKanbanColumn } from './kanban.js';
 export { formatLumenLanguageLabel, getLumenLocalePair, lumenDefaultLocales, normalizeLumenLocales } from './language.js';
+export { lumenSkeletonAnimations, lumenSkeletonShapes, normalizeLumenProgress, resolveLumenLoadingSemantics, resolveLumenSkeletonAnimation, resolveLumenSkeletonShape, resolveLumenSkeletonSize } from './loading.js';
 export { bindLumenMediaViewport, formatLumenMediaZoom, isLumenMediaViewportAction, lumenMediaViewportActions, lumenMediaViewportLabels, syncLumenMediaViewport } from './media-viewport.js';
 export { applyLumenMediaViewportAction, moveLumenMediaItem, normalizeLumenMediaViewport, panLumenMediaViewport, resolveLumenMediaMaxZoom, resolveLumenMediaSelection, toggleLumenMediaSelection } from './media-workspace.js';
 export { createLumenMessageScrollerController } from './message-scroller.js';

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@santi020k/lumen-core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "publishConfig": {
     "access": "public"
   },