@apollion-dsi/core 7.2.0 → 7.4.0

package/lib/themes/Layout/Layout.props.d.ts

@@ -1,4 +1,4 @@
-import { ContainerSizesInput, ContainerSizesInterface, LayoutInput, LayoutInterface } from './Layout.interface';
+import { ContainerSizesInput, ContainerSizesInterface, LayoutInput, LayoutInterface, ZIndexInput, ZIndexInterface } from './Layout.interface';
 /**
  * Default container-size scale (ADR-025 §2.2). Calibrated in the S1 spike:
  * `xs` fits a compact rail card, `sm` the classic sidebar widget, `md` a
@@ -16,3 +16,27 @@ export declare const defaultInputLayout: LayoutInput;
 export declare const createContainerSizes: (input: ContainerSizesInput) => ContainerSizesInterface;
 /** Builds the `theme.layout` surface. */
 export declare const createLayout: (input: LayoutInput) => LayoutInterface;
+/**
+ * Default `z-index` scale: `Table` sticky header < `Dropdown`/`InputSelect`
+ * menus < `Notification` toasts and page banner < `Modal`/`Sheet`.
+ */
+export declare const defaultInputZIndex: ZIndexInput;
+/**
+ * Builds the `theme.zIndex` surface — the sibling of `createLayout`. No
+ * derived fields (unlike `createContainerSizes`'s `up()`/`width()`): every
+ * consumer reads the raw number (`themeZIndex(theme).modal`).
+ */
+export declare const createZIndex: (input: ZIndexInput) => ZIndexInterface;
+/**
+ * Reads `theme.zIndex`, falling back to the default scale when a hand-built or
+ * mocked theme predates the slice (same guard as `theme.motion ?? DEFAULT_MOTION`).
+ * Every z-index reader in core goes through it.
+ *
+ * @example
+ * ```ts
+ * z-index: ${({ theme }) => themeZIndex(theme).modal};
+ * ```
+ */
+export declare const themeZIndex: (theme: {
+    zIndex?: ZIndexInterface;
+}) => ZIndexInterface;

package/lib/themes/Layout/index.esm.js

@@ -1 +1 @@
-import{a,b,c,d}from"../../chunks/chunk-YJHYFCT7.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{c as createContainerSizes,d as createLayout,a as defaultInputContainerSizes,b as defaultInputLayout};
+import{a,b,c,d,e,f,g}from"../../chunks/chunk-L7A7RA56.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{c as createContainerSizes,d as createLayout,f as createZIndex,a as defaultInputContainerSizes,b as defaultInputLayout,e as defaultInputZIndex,g as themeZIndex};

package/lib/themes/Motion/Motion.helpers.d.ts

@@ -1,4 +1,4 @@
-import { MotionThemeInterface } from './Motion.interface';
+import { MotionIntentKey, MotionThemeInterface } from './Motion.interface';
 import { RuleSet } from '../../vendors/StyledComponents';
 /**
  * Reduced-motion duration target (ADR-027). `0.01ms` instead of `0ms` so a
@@ -7,6 +7,13 @@ import { RuleSet } from '../../vendors/StyledComponents';
  * never starts a transition and never fires it.
  */
 export declare const REDUCED_MOTION_DURATION = "0.01ms";
+/**
+ * `var(--apollion-motion-intent-<intent>-<channel>, <theme literal>)` — the
+ * fallback literal is mandatory (ADR-027 §2.2): `GlobalStyle` is optional by
+ * contract, so a consumer of the intent vars must resolve without the var
+ * block present.
+ */
+export declare const motionIntentVar: (motion: MotionThemeInterface, intent: MotionIntentKey, channel: "duration" | "easing") => string;
 /**
  * `theme.motion` → `--apollion-motion-*` custom properties, split vars only
  * (duration and easing never share a name, so reduced-motion can zero
@@ -38,17 +45,20 @@ export declare function motionGlobalCss(motion: MotionThemeInterface): string;
  * Opt-in View Transitions wiring (ADR-027 S5, progressive enhancement):
  * binds the browser's root cross-fade (`::view-transition-old/new(root)`)
  * to the motion intent vars — old frame leaves on the `exit` intent, new
- * frame arrives on the `enter` intent. Guarded by `@supports`, so browsers
- * without the API (the Firefox floor) swap instantly: motion never blocks.
+ * frame arrives on the `enter` intent.
+ *
+ * Rule body only: {@link viewTransitionStyles} wraps it in
+ * `supports('view-transitions', …)` (ADR-029 §3), so browsers without the
+ * API swap instantly. A pure string for the same testability reason as
+ * {@link motionGlobalCss}.
  *
  * Reduced motion is inherited for free — the animation durations consume
- * the same vars the global override zeroes. A pure string builder for the
- * same testability reason as {@link motionGlobalCss}; consumers use the
- * {@link viewTransitionStyles} RuleSet.
+ * the same vars the global override zeroes.
  */
 export declare function viewTransitionCss(): string;
 /**
- * Ready-to-extend RuleSet of {@link viewTransitionCss} — pass it to
+ * Ready-to-extend RuleSet wrapping {@link viewTransitionCss} in the
+ * `view-transitions` capability's `@supports` guard — pass it to
  * `<GlobalStyle extend={viewTransitionStyles} />` to time the browser's
  * View Transitions (e.g. `document.startViewTransition(() => setMode(...))`
  * on a theme switch) with the DS motion tokens. Deliberately NOT part of

package/lib/themes/Motion/index.esm.js

@@ -1 +1 @@
-import{a,b,c,d,e,f,g,h,i,j}from"../../chunks/chunk-SF2QSF7E.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as REDUCED_MOTION_DURATION,j as createMotion,g as defaultInputMotion,h as formatMotionDuration,i as formatMotionEasing,d as motionGlobalCss,b as motionVars,c as reducedMotionVars,e as viewTransitionCss,f as viewTransitionStyles};
+import{a,b,c,d,e,f,g,h,i,j,k}from"../../chunks/chunk-R2QEO3KP.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as REDUCED_MOTION_DURATION,k as createMotion,h as defaultInputMotion,i as formatMotionDuration,j as formatMotionEasing,e as motionGlobalCss,b as motionIntentVar,c as motionVars,d as reducedMotionVars,f as viewTransitionCss,g as viewTransitionStyles};

package/lib/themes/Semantic/Semantic.interface.d.ts

@@ -143,8 +143,9 @@ export interface SemanticDimensionSpacing {
     giant: string;
 }
 /**
- * Dimension layer of Semantic. Currently covers only spacing; typography and
- * elevation may land in future iterations without a breaking change.
+ * Dimension layer of Semantic — density only: spacing (elevation may join).
+ * Typography is NOT a density concern since ADR-030 (`textSize` axis); any
+ * semantic type aliases belong in a separate `semantic.type` layer.
  */
 export interface SemanticDimension {
     spacing: SemanticDimensionSpacing;

package/lib/themes/Semantic/index.esm.js

@@ -1 +1 @@
-import"../../chunks/chunk-IA234JY2.esm.js";import{b as a}from"../../chunks/chunk-OSFHXCPW.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as createSemantic};
+import"../../chunks/chunk-IA234JY2.esm.js";import{b as a}from"../../chunks/chunk-ERQXQRK3.esm.js";import"../../chunks/chunk-2TQTHAFO.esm.js";import"../../chunks/chunk-6G22RNUO.esm.js";import"../../chunks/chunk-J6F4PMW4.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as createSemantic};

package/lib/themes/Surface/index.esm.js

@@ -1 +1 @@
-import{a as b}from"../../chunks/chunk-TMIQIUOH.esm.js";import{a}from"../../chunks/chunk-G757UD32.esm.js";import"../../chunks/chunk-OSFHXCPW.esm.js";import"../../chunks/chunk-PFLBU7HG.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{b as SurfaceProvider,a as invertForSurface};
+import{a as b}from"../../chunks/chunk-ZYQJYJIC.esm.js";import{a}from"../../chunks/chunk-76VCAI6X.esm.js";import"../../chunks/chunk-ERQXQRK3.esm.js";import"../../chunks/chunk-PFLBU7HG.esm.js";import"../../chunks/chunk-AZXLTCJK.esm.js";import"../../chunks/chunk-2TQTHAFO.esm.js";import"../../chunks/chunk-6G22RNUO.esm.js";import"../../chunks/chunk-J6F4PMW4.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{b as SurfaceProvider,a as invertForSurface};

package/lib/themes/TextSize/TextSize.helpers.d.ts

@@ -0,0 +1,14 @@
+import { TextSize } from './TextSize.interface';
+/**
+ * Attribute carrying the active text-size level on `<html>` (or any subtree
+ * root). The tokens build's `css/font.css` keys its overrides on it, so the
+ * React theme and the CSS-only surface resolve the same text size.
+ */
+export declare const TEXT_SIZE_ATTRIBUTE = "data-apollion-text-size";
+/**
+ * Writes the resolved text-size level on `element` (`data-apollion-text-size`).
+ * No-op without an element.
+ */
+export declare function syncDocumentTextSize(element: HTMLElement | null | undefined, textSize: TextSize): void;
+/** Removes what {@link syncDocumentTextSize} wrote (provider unmount). */
+export declare function clearDocumentTextSize(element: HTMLElement | null | undefined): void;

package/lib/themes/TextSize/TextSize.interface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Type-size axis (ADR-030, APOLLION-TEXT-SIZE).
+ *
+ * Independent of `Dimension`: `dimension` sets layout density (spacing),
+ * `textSize` sets the reading size (font sizes and `Icon` glyphs). Any pair is
+ * valid — `compact` + `larger` is a dense screen with large text.
+ *
+ * Consumer picks it via `<ApollionProvider textSize="larger">` (prop-only, same
+ * rule as `dimension`).
+ *
+ * @see ../../docs/adr/ADR-030-text-size-axis.md
+ * @see ./TextSize.props.ts
+ */
+export type TextSize = 'smaller' | 'default' | 'larger' | 'largest';

package/lib/themes/TextSize/TextSize.props.d.ts

@@ -0,0 +1,27 @@
+import { TextSize } from './TextSize.interface';
+/**
+ * Font-size ratio per {@link TextSize}, applied to the px design scale.
+ *
+ * - `smaller` = 0.875 → body `small` 14px
+ * - `default` = 1     → body `small` 16px (the px design source, 1:1)
+ * - `larger` = 1.125 → body `small` 18px
+ * - `largest` = 1.25  → body `small` 20px
+ *
+ * @see ../../docs/adr/ADR-030-text-size-axis.md
+ */
+export declare const TEXT_SIZE_MULTIPLIERS: Readonly<Record<TextSize, number>>;
+/**
+ * Default text size when the consumer does not pass `textSize`. `default` maps
+ * the px design source 1:1, under every `dimension`.
+ */
+export declare const DEFAULT_TEXT_SIZE: TextSize;
+/**
+ * Resolve the font-size ratio for a given text size.
+ *
+ * Used by `Font.props.ts#createFont`. An unknown level (plain-JS caller) resolves
+ * to `1` (the `default` ratio) with a development warning, never `NaN`.
+ *
+ * @param textSize - reading-size level (see {@link TextSize})
+ * @returns ratio over the px design source (0.875 / 1 / 1.125 / 1.25)
+ */
+export declare function getMultiplierForTextSize(textSize: TextSize): number;

package/lib/themes/TextSize/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Public barrel of the `TextSize` module (type-size axis — ADR-030).
+ *
+ * Orthogonal to `Dimension` (density): see ./TextSize.interface.ts.
+ */
+export * from './TextSize.helpers';
+export * from './TextSize.interface';
+export * from './TextSize.props';

package/lib/themes/TextSize/index.esm.js

@@ -0,0 +1 @@
+import{a,b,c,d,e,f}from"../../chunks/chunk-WB5XXCKL.esm.js";import"../../chunks/chunk-J6F4PMW4.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{e as DEFAULT_TEXT_SIZE,a as TEXT_SIZE_ATTRIBUTE,d as TEXT_SIZE_MULTIPLIERS,c as clearDocumentTextSize,f as getMultiplierForTextSize,b as syncDocumentTextSize};

package/lib/themes/ThemeProvider/ThemeProvider.interface.d.ts

@@ -9,12 +9,13 @@ import { DepthThemeInterface } from '../Depth';
 import type { Dimension } from '../Dimension';
 import { FontInput, FontThemeInterface, TypeWeight } from '../Font';
 import { FoundationLayer } from '../Foundation';
-import { ContainerSizesInput, ContainerSizesInterface, LayoutInput, LayoutInterface } from '../Layout';
+import { ContainerSizesInput, ContainerSizesInterface, LayoutInput, LayoutInterface, ZIndexInput, ZIndexInterface } from '../Layout';
 import type { A11yMode, ModePreference, PersistOption, ResolvedMode } from '../Mode/Mode.interface';
 import { MotionInput, MotionThemeInterface } from '../Motion';
 import { SemanticLayer } from '../Semantic';
 import { SpacingInput, SpacingThemeInterface } from '../Spacing';
 import type { SurfaceMode } from '../Surface';
+import type { TextSize } from '../TextSize';
 export interface ThemeInputsInterface {
     breakpoints?: BreakpointInput;
     /**
@@ -27,6 +28,13 @@ export interface ThemeInputsInterface {
      * `pageShell` prop applies (previously a magic `1366`).
      */
     layout?: LayoutInput;
+    /**
+     * Named stacking scale for the cross-component overlay layers —
+     * `sticky`/`dropdown`/`toast`/`modal`.
+     * Deep-merged over the defaults, so a partial override (e.g. only
+     * `{ modal: 10000 }`) leaves the rest untouched.
+     */
+    zIndex?: Partial<ZIndexInput>;
     spacing?: SpacingInput;
     colors?: ColorsInput;
     font?: FontInput;
@@ -41,7 +49,8 @@ export interface ThemeInputsInterface {
     /**
      * Density axis introduced in `@apollion-dsi/core` v4 (ADR-006 E2).
      * Overrides `spacing.multiplier` when provided. Default: `'normal'`
-     * (preserves v3.x behavior).
+     * (preserves v3.x behavior). Spacing only — type size is `textSize`
+     * (ADR-030).
      *
      * @see ../Dimension/Dimension.interface.ts (naming disambiguation)
      * @see ../Dimension/Dimension.props.ts (DIMENSION_MULTIPLIERS calibration)
@@ -54,6 +63,15 @@ export interface ThemeInputsInterface {
      * Per-call-site `fontWeight` still overrides.
      */
     typeWeight?: TypeWeight;
+    /**
+     * Text-size axis (ADR-030): scales `font.fontSize` and `font.sizing`
+     * (`Icon` glyphs) by `smaller` 0.875 / `default` 1 / `larger` 1.125 / `largest` 1.25,
+     * independent of `dimension`.
+     *
+     * @default 'default'
+     * @see ../TextSize/TextSize.props.ts
+     */
+    textSize?: TextSize;
     /**
      * Component token tier overrides (ADR-020). Deep-merged over the
      * defaults — override a single size of a single component without
@@ -73,6 +91,15 @@ export type Theme = {
     containerSizes: ContainerSizesInterface;
     /** Page-layout constants (`pageMaxWidth`, ADR-025 §2.3). */
     layout: LayoutInterface;
+    /**
+     * Named `z-index` scale for the cross-component overlay layers:
+     * `sticky` (Table header) < `dropdown`
+     * (Dropdown/InputSelect popovers) < `toast` (Notification) < `modal`
+     * (Modal/Sheet). A component's own internal stacking (e.g. `1`/`2`/`-1`
+     * between two of its own children) is not part of this scale — it stays a
+     * local literal.
+     */
+    zIndex: ZIndexInterface;
     font: FontThemeInterface;
     colors: ColorsThemeInterface;
     breakpoints: BreakpointsInterface;
@@ -231,7 +258,10 @@ export interface ApollionProviderInterface {
     /**
      * Mirror the resolved mode + a11y preset on `<html>` (`data-apollion-mode`,
      * `data-apollion-a11y`, `style.colorScheme`) so native controls, scrollbars
-     * and `light-dark()` follow the engine. Removed on unmount.
+     * and `light-dark()` follow the engine, and the resolved text size
+     * (`data-apollion-text-size`, ADR-030) so the tokens' `css/font.css` agrees
+     * with the React theme — the text-size attribute is written by the outermost
+     * provider only. Removed on unmount.
      *
      * @default true
      */
@@ -296,7 +326,8 @@ export interface ApollionProviderInterface {
     /**
      * Density axis (ADR-006 E2). Convenience prop equivalent to passing
      * `theme={createTheme({ dimension })}`. When set, builds a new theme
-     * on the fly with the chosen density multiplier.
+     * on the fly with the chosen density multiplier. Drives spacing only —
+     * text size is `textSize` (ADR-030).
      *
      * **Prop-only API** (Q-G3 decision): no `theme.dimension()` getter and
      * no `useDimension()` hook are exposed. Consumer expresses density
@@ -314,6 +345,19 @@ export interface ApollionProviderInterface {
      * @default 'regular' (stock ladder)
      */
     typeWeight?: TypeWeight;
+    /**
+     * Text-size axis (ADR-030) — the reading size, independent of
+     * `dimension`: `<ApollionProvider dimension="compact" textSize="larger">` is a
+     * dense layout with large text. Convenience prop equivalent to
+     * `createTheme({ textSize })`; like `dimension`, it only applies when the
+     * provider builds the theme. Set it once at the app root and wire it to the
+     * app's own user preference. A nested provider is not a way to rescale one
+     * region: it rebuilds the whole theme (brand, mode and a11y preset too).
+     *
+     * @default 'default'
+     * @see ../TextSize/TextSize.interface.ts
+     */
+    textSize?: TextSize;
     children?: React.ReactNode;
 }
 export interface ApollionThemeContext {

package/lib/themes/ThemeProvider/ThemeProvider.modes.d.ts

@@ -30,7 +30,7 @@ export declare function forModes<T extends string | undefined>(theme: Theme, fn:
 /**
  * Projects a literal light/dark pair into the single theme the styled tree
  * consumes. Only mode-varying color subtrees are paired (`colors`,
- * `semantic.color`, `foundation.{bg,text,edge}`, `depth`); dimension-driven
+ * `semantic.color`, `foundation.{bg,text,edge}`, `depth`); mode-invariant
  * subtrees (spacing, font, border, component tokens) are shared by
  * construction and keep the light references. Pure: a new object, inputs
  * untouched; `theme.modes` carries the pair.

package/lib/themes/ThemeProvider/index.esm.js

@@ -1 +1 @@
-import"../../chunks/chunk-4L2KOZIQ.esm.js";import{a,e as b,g as c}from"../../chunks/chunk-4TQV5FFJ.esm.js";import"../../chunks/chunk-YJHYFCT7.esm.js";import"../../chunks/chunk-TLIKQFOT.esm.js";import"../../chunks/chunk-IA234JY2.esm.js";import"../../chunks/chunk-TG5BCBO4.esm.js";import"../../chunks/chunk-G757UD32.esm.js";import"../../chunks/chunk-OSFHXCPW.esm.js";import"../../chunks/chunk-BERIBF3O.esm.js";import"../../chunks/chunk-LVVNQRJ2.esm.js";import"../../chunks/chunk-Z7GJDO5T.esm.js";import"../../chunks/chunk-P7RR4ZHS.esm.js";import"../../chunks/chunk-JOKVE3IX.esm.js";import"../../chunks/chunk-CWRWYU7D.esm.js";import"../../chunks/chunk-PFLBU7HG.esm.js";import"../../chunks/chunk-UHABJEDB.esm.js";import"../../chunks/chunk-3DUB5C4Z.esm.js";import"../../chunks/chunk-KT6QQ3UJ.esm.js";import"../../chunks/chunk-HVFI7FHR.esm.js";import"../../chunks/chunk-VMIXRIQ2.esm.js";import"../../chunks/chunk-SF2QSF7E.esm.js";import"../../chunks/chunk-R2B57RMV.esm.js";import"../../chunks/chunk-RFUX53ZX.esm.js";import"../../chunks/chunk-CQASQBD7.esm.js";import"../../chunks/chunk-MREWGN5R.esm.js";import"../../chunks/chunk-PXVTXO3L.esm.js";import"../../chunks/chunk-BV6GHAF7.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{c as ApollionProvider,a as createTheme,b as useApollionTheme};
+import"../../chunks/chunk-4L2KOZIQ.esm.js";import{a,e as b,g as c}from"../../chunks/chunk-B6OC4RV2.esm.js";import"../../chunks/chunk-TLIKQFOT.esm.js";import"../../chunks/chunk-IA234JY2.esm.js";import"../../chunks/chunk-76VCAI6X.esm.js";import"../../chunks/chunk-ERQXQRK3.esm.js";import"../../chunks/chunk-SEPVF2TL.esm.js";import"../../chunks/chunk-ITRAQ6Q2.esm.js";import"../../chunks/chunk-Z7GJDO5T.esm.js";import"../../chunks/chunk-LCCVFIPZ.esm.js";import"../../chunks/chunk-TG5BCBO4.esm.js";import"../../chunks/chunk-WB5XXCKL.esm.js";import"../../chunks/chunk-JOKVE3IX.esm.js";import"../../chunks/chunk-CWRWYU7D.esm.js";import"../../chunks/chunk-PFLBU7HG.esm.js";import"../../chunks/chunk-XUZQE326.esm.js";import"../../chunks/chunk-3DUB5C4Z.esm.js";import"../../chunks/chunk-KT6QQ3UJ.esm.js";import"../../chunks/chunk-L7A7RA56.esm.js";import"../../chunks/chunk-HVFI7FHR.esm.js";import"../../chunks/chunk-4SDDAQ6N.esm.js";import"../../chunks/chunk-R2QEO3KP.esm.js";import"../../chunks/chunk-H7FLNZDA.esm.js";import"../../chunks/chunk-UU62HUHC.esm.js";import"../../chunks/chunk-XBPV4MKV.esm.js";import"../../chunks/chunk-AZXLTCJK.esm.js";import"../../chunks/chunk-2TQTHAFO.esm.js";import"../../chunks/chunk-6G22RNUO.esm.js";import"../../chunks/chunk-J6F4PMW4.esm.js";import"../../chunks/chunk-G5Z7USXC.esm.js";import"../../chunks/chunk-AXUWC2WH.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{c as ApollionProvider,a as createTheme,b as useApollionTheme};

package/lib/themes/index.d.ts

@@ -15,3 +15,4 @@ export * from './Semantic';
 export * from './Spacing';
 export * from './Surface';
 export * from './ThemeProvider';
+export * from './TextSize';

package/lib/themes/index.esm.js

@@ -1 +1 @@
-import"../chunks/chunk-EBOJSNZ5.esm.js";import{a as $a}from"../chunks/chunk-4E3BR56X.esm.js";import{a as ab}from"../chunks/chunk-TMIQIUOH.esm.js";import"../chunks/chunk-4L2KOZIQ.esm.js";import{a as Ya,b as Za}from"../chunks/chunk-MYGV5PMT.esm.js";import{a as Ua,e as Wa,g as Xa}from"../chunks/chunk-4TQV5FFJ.esm.js";import"../chunks/chunk-YJHYFCT7.esm.js";import{a as za,b as Aa,c as Ba,d as Ca,e as Da,f as Ea,g as Fa,h as Ga,i as Ha,j as Ia,k as Ja,l as Ka,m as La,n as Ma,o as Na,p as Oa,q as Pa,r as Qa}from"../chunks/chunk-TLIKQFOT.esm.js";import"../chunks/chunk-IA234JY2.esm.js";import{a as Sa,b as Ta}from"../chunks/chunk-TG5BCBO4.esm.js";import{a as Va}from"../chunks/chunk-G757UD32.esm.js";import{b as Ra}from"../chunks/chunk-OSFHXCPW.esm.js";import{b as qa}from"../chunks/chunk-BERIBF3O.esm.js";import{a as ra}from"../chunks/chunk-LVVNQRJ2.esm.js";import"../chunks/chunk-Z7GJDO5T.esm.js";import{a as va,b as wa,c as xa}from"../chunks/chunk-P7RR4ZHS.esm.js";import{a as sa,b as ta,c as ua}from"../chunks/chunk-JOKVE3IX.esm.js";import"../chunks/chunk-CWRWYU7D.esm.js";import{a as ya}from"../chunks/chunk-PFLBU7HG.esm.js";import{a as _a}from"../chunks/chunk-TG2P4DDY.esm.js";import{a as la}from"../chunks/chunk-UHABJEDB.esm.js";import{a as ma}from"../chunks/chunk-3DUB5C4Z.esm.js";import{a as na,b as oa,c as pa}from"../chunks/chunk-KT6QQ3UJ.esm.js";import"../chunks/chunk-HVFI7FHR.esm.js";import"../chunks/chunk-VMIXRIQ2.esm.js";import"../chunks/chunk-SF2QSF7E.esm.js";import{a as ca,b as da,c as ea,d as fa,e as ga,f as ha,g as ia,h as ja,i as ka}from"../chunks/chunk-YJ6PPJQ4.esm.js";import"../chunks/chunk-R2B57RMV.esm.js";import{a as $,b as aa,c as ba}from"../chunks/chunk-RFUX53ZX.esm.js";import{a as T,b as U,c as V,d as W,e as X,f as Y,g as Z,h as _}from"../chunks/chunk-CQASQBD7.esm.js";import{a as G,b as H,c as I,d as J,e as K,f as L,g as M,h as N,i as O,j as P,k as Q,l as R,m as S}from"../chunks/chunk-MREWGN5R.esm.js";import{A as y,B as z,C as A,D as B,E as C,F as D,G as E,H as F,c as a,d as b,e as c,f as d,g as e,h as f,i as g,j as h,k as i,l as j,m as k,n as l,o as m,p as n,q as o,r as p,s as q,t as r,u as s,v as t,w as u,x as v,y as w,z as x}from"../chunks/chunk-PXVTXO3L.esm.js";import"../chunks/chunk-BV6GHAF7.esm.js";import"../chunks/chunk-G5Z7USXC.esm.js";import"../chunks/chunk-AXUWC2WH.esm.js";import"../chunks/chunk-GZONWSRB.esm.js";export{Ba as A11Y_ATTRIBUTE,$a as ApollionModeScript,Xa as ApollionProvider,I as DARK_BOOST_TAPER_MAX_L,H as DARK_ELEVATION_BOOST,Ca as DARK_SCHEME_QUERY,ta as DEFAULT_DIMENSION,aa as DEPTH_SHADOW,sa as DIMENSION_MULTIPLIERS,n as DISABLED_NEUTRAL_INDICES,N as EDGE_ALPHA,da as GROUND_INK_ROLES,ca as GROUND_VAR_PREFIX,Za as GlobalStyle,Ya as GlobalStyleComponent,_a as Ground,K as HALATION_FLOORS,d as HextoRgb,M as INK_APCA_MIN,L as INK_MIX,G as LADDER_DELTAS,f as MIN_CONTRAST_AA,t as MIN_STATE_CONTRAST,Aa as MODE_ATTRIBUTE,za as MODE_STORAGE_KEY,l as NEUTRAL_TEXT_INDICES,X as OKABE_ITO,r as QUIET_NEUTRAL_INDICES,k as READABLE_TEXT_PALETTES,ea as ROOT_GROUND_TOKEN,u as STATE_DELTA_L_JND,o as STRUCTURAL_NEUTRAL_INDICES,ab as SurfaceProvider,va as TYPE_WEIGHT_LADDERS,O as WASH_ALPHA,Da as a11yStorageKey,_ as accessibilityPalettes,la as animation,b as apcaContrast,a as apcaLuminance,ka as auditGroundVars,na as breakpointsValues,y as clampLightness,Pa as clearDocumentMode,Y as colorblindPalette,g as contrastRatio,Ka as cookieAdapter,pa as createBreakpoints,U as createColors,qa as createComponentTokens,ra as createDeepTheme,ba as createDeth,xa as createFont,ya as createFoundation,m as createReadableTextLayer,Ra as createSemantic,Ta as createSpacing,Ua as createTheme,J as darkElevationBoostFactor,ma as defaultInputBorder,oa as defaultInputBreakpoints,T as defaultInputColors,wa as defaultInputFont,Sa as defaultInputSpacing,i as getColor,j as getContrastColor,Qa as getModeScript,ua as getMultiplierForDimension,e as getOppositeColor,V as grayscalePalette,ha as groundInkPath,fa as groundVar,ga as groundVarRef,ja as groundVars,W as highContrastPalette,Va as invertForSurface,Fa as isA11yMode,w as isDarkSurface,Ea as isModePreference,ia as isOpaqueGround,$ as levelValues,Ia as localStorageAdapter,c as mixOklch,E as mountActionColors,D as mountBaseColors,B as mountGreyscaleColors,F as mountMainColors,C as mountNeutralColors,A as mountSingleColor,v as oklchLightness,Q as oppositePolarity,Ga as prefersDarkScheme,Na as readA11yFromCookie,Ja as readCookieValue,Ma as readModeFromCookie,h as readableColor,p as resolveDisabledNeutral,Ha as resolveMode,S as resolveOppositeLadder,P as resolvePolarity,s as resolveQuietPalette,La as resolveStorage,q as resolveStructuralNeutrals,R as resolveSurfaceLadder,x as shiftLightness,Oa as syncDocumentMode,Z as toDarkColors,z as toRgbaString,Wa as useApollionTheme};
+import"../chunks/chunk-HPMNSONF.esm.js";import"../chunks/chunk-4L2KOZIQ.esm.js";import{a as gb}from"../chunks/chunk-F4JJQGPH.esm.js";import{a as hb}from"../chunks/chunk-4E3BR56X.esm.js";import{a as ib}from"../chunks/chunk-ZYQJYJIC.esm.js";import{b as eb,c as fb}from"../chunks/chunk-MFYH5ECV.esm.js";import{a as ab,e as cb,g as db}from"../chunks/chunk-B6OC4RV2.esm.js";import{a as Ja,b as Ka,c as La,d as Ma,e as Na,f as Oa,g as Pa,h as Qa,i as Ra,j as Sa,k as Ta,l as Ua,m as Va,n as Wa,o as Xa,p as Ya,q as Za,r as _a}from"../chunks/chunk-TLIKQFOT.esm.js";import"../chunks/chunk-IA234JY2.esm.js";import{a as bb}from"../chunks/chunk-76VCAI6X.esm.js";import{b as $a}from"../chunks/chunk-ERQXQRK3.esm.js";import{b as qa}from"../chunks/chunk-SEPVF2TL.esm.js";import{a as ra}from"../chunks/chunk-ITRAQ6Q2.esm.js";import"../chunks/chunk-Z7GJDO5T.esm.js";import{a as va,b as Ea,c as Fa,d as Ga,e as Ha}from"../chunks/chunk-LCCVFIPZ.esm.js";import{a as wa,b as xa}from"../chunks/chunk-TG5BCBO4.esm.js";import{a as ya,b as za,c as Aa,d as Ba,e as Ca,f as Da}from"../chunks/chunk-WB5XXCKL.esm.js";import{a as sa,b as ta,c as ua}from"../chunks/chunk-JOKVE3IX.esm.js";import"../chunks/chunk-CWRWYU7D.esm.js";import{a as Ia}from"../chunks/chunk-PFLBU7HG.esm.js";import{a as la}from"../chunks/chunk-XUZQE326.esm.js";import{a as ma}from"../chunks/chunk-3DUB5C4Z.esm.js";import{a as na,b as oa,c as pa}from"../chunks/chunk-KT6QQ3UJ.esm.js";import"../chunks/chunk-L7A7RA56.esm.js";import"../chunks/chunk-HVFI7FHR.esm.js";import"../chunks/chunk-4SDDAQ6N.esm.js";import"../chunks/chunk-R2QEO3KP.esm.js";import{a as ca,b as da,c as ea,d as fa,e as ga,f as ha,g as ia,h as ja,i as ka}from"../chunks/chunk-3CKHLCIB.esm.js";import"../chunks/chunk-H7FLNZDA.esm.js";import{a as $,b as aa,c as ba}from"../chunks/chunk-UU62HUHC.esm.js";import{a as T,b as U,c as V,d as W,e as X,f as Y,g as Z,h as _}from"../chunks/chunk-XBPV4MKV.esm.js";import{a as G,b as H,c as I,d as J,e as K,f as L,g as M,h as N,i as O,j as P,k as Q,l as R,m as S}from"../chunks/chunk-AZXLTCJK.esm.js";import{A as y,B as z,C as A,D as B,E as C,F as D,G as E,H as F,c as a,d as b,e as c,f as d,g as e,h as f,i as g,j as h,k as i,l as j,m as k,n as l,o as m,p as n,q as o,r as p,s as q,t as r,u as s,v as t,w as u,x as v,y as w,z as x}from"../chunks/chunk-2TQTHAFO.esm.js";import"../chunks/chunk-6G22RNUO.esm.js";import"../chunks/chunk-J6F4PMW4.esm.js";import"../chunks/chunk-G5Z7USXC.esm.js";import"../chunks/chunk-AXUWC2WH.esm.js";import"../chunks/chunk-GZONWSRB.esm.js";export{La as A11Y_ATTRIBUTE,hb as ApollionModeScript,db as ApollionProvider,I as DARK_BOOST_TAPER_MAX_L,H as DARK_ELEVATION_BOOST,Ma as DARK_SCHEME_QUERY,ta as DEFAULT_DIMENSION,Ca as DEFAULT_TEXT_SIZE,aa as DEPTH_SHADOW,sa as DIMENSION_MULTIPLIERS,n as DISABLED_NEUTRAL_INDICES,N as EDGE_ALPHA,Ea as FONT_SIZE_FLOOR_PX,da as GROUND_INK_ROLES,ca as GROUND_VAR_PREFIX,fb as GlobalStyle,eb as GlobalStyleComponent,gb as Ground,K as HALATION_FLOORS,d as HextoRgb,M as INK_APCA_MIN,L as INK_MIX,G as LADDER_DELTAS,f as MIN_CONTRAST_AA,t as MIN_STATE_CONTRAST,Ka as MODE_ATTRIBUTE,Ja as MODE_STORAGE_KEY,l as NEUTRAL_TEXT_INDICES,X as OKABE_ITO,r as QUIET_NEUTRAL_INDICES,k as READABLE_TEXT_PALETTES,ea as ROOT_GROUND_TOKEN,u as STATE_DELTA_L_JND,o as STRUCTURAL_NEUTRAL_INDICES,ib as SurfaceProvider,ya as TEXT_SIZE_ATTRIBUTE,Ba as TEXT_SIZE_MULTIPLIERS,Fa as TYPE_WEIGHT_LADDERS,O as WASH_ALPHA,Na as a11yStorageKey,_ as accessibilityPalettes,la as animation,b as apcaContrast,a as apcaLuminance,ka as auditGroundVars,na as breakpointsValues,y as clampLightness,Za as clearDocumentMode,Aa as clearDocumentTextSize,Y as colorblindPalette,g as contrastRatio,Ua as cookieAdapter,pa as createBreakpoints,U as createColors,qa as createComponentTokens,ra as createDeepTheme,ba as createDeth,Ha as createFont,Ia as createFoundation,m as createReadableTextLayer,$a as createSemantic,xa as createSpacing,ab as createTheme,J as darkElevationBoostFactor,ma as defaultInputBorder,oa as defaultInputBreakpoints,T as defaultInputColors,Ga as defaultInputFont,wa as defaultInputSpacing,i as getColor,j as getContrastColor,_a as getModeScript,ua as getMultiplierForDimension,Da as getMultiplierForTextSize,e as getOppositeColor,V as grayscalePalette,ha as groundInkPath,fa as groundVar,ga as groundVarRef,ja as groundVars,W as highContrastPalette,bb as invertForSurface,Pa as isA11yMode,w as isDarkSurface,Oa as isModePreference,ia as isOpaqueGround,$ as levelValues,Sa as localStorageAdapter,c as mixOklch,E as mountActionColors,D as mountBaseColors,B as mountGreyscaleColors,F as mountMainColors,C as mountNeutralColors,A as mountSingleColor,v as oklchLightness,Q as oppositePolarity,Qa as prefersDarkScheme,Xa as readA11yFromCookie,Ta as readCookieValue,Wa as readModeFromCookie,h as readableColor,p as resolveDisabledNeutral,Ra as resolveMode,S as resolveOppositeLadder,P as resolvePolarity,s as resolveQuietPalette,Va as resolveStorage,q as resolveStructuralNeutrals,R as resolveSurfaceLadder,x as shiftLightness,Ya as syncDocumentMode,za as syncDocumentTextSize,Z as toDarkColors,z as toRgbaString,va as typeSizing,cb as useApollionTheme};

package/lib/utils/capabilities.d.ts

@@ -0,0 +1,185 @@
+import { RuleSet } from '../vendors/StyledComponents';
+/**
+ * ADR-029 §3 — capability tiers. T0 needs no guard (every floor browser
+ * ships it). T1/T2/T3 are enforced by `capability-guardrails.test.ts`:
+ * T1 is graceful-ignore (allowlisted per file, no `supports()` needed —
+ * the browser silently drops the declaration); T2 must be wrapped in
+ * `supports()`; T3 is single-engine and must never appear in core src.
+ */
+export type CapabilityTier = 'T1' | 'T2' | 'T3';
+/**
+ * Lowest engine version that ships the feature, mirroring
+ * `@mdn/browser-compat-data`'s `version_added` shape: `false` when no
+ * released version of that engine supports it. Chrome/Firefox are major
+ * version numbers; Safari/WebKit versions carry a minor (e.g. `'26.4'`)
+ * because that is how Apple ships within a "major" (ADR-029 floor table).
+ */
+export interface CapabilityBcd {
+    readonly chrome: string | false;
+    readonly firefox: string | false;
+    readonly safari: string | false;
+}
+export interface CapabilityEntry {
+    /** The `<supports-condition>` body — `supports()` wraps it in `@supports (…)`. */
+    readonly condition: string;
+    readonly tier: CapabilityTier;
+    /**
+     * What `capability-guardrails.test.ts` looks for in core sources: the
+     * kebab-case CSS property/at-rule/function and its camelCase object-style
+     * key, bounded so an unrelated identifier or theme token does not match.
+     */
+    readonly patterns: readonly RegExp[];
+    readonly bcd: CapabilityBcd;
+}
+/**
+ * The capability registry (ADR-029 §3). Every call site reads
+ * through `CAPS`/`supports()`, never a literal condition, so a future
+ * `APOLLION_VR_FLOOR` knob can swap a condition in one place.
+ *
+ * - T2 (`supports()` required): `view-transitions` (live in
+ *   `Motion.helpers.ts`), and `anchor-positioning`,
+ *   `scroll-driven-animations`, `scope` — seeded before any call site so the
+ *   first one is guarded.
+ * - T1 (graceful-ignore, allowlisted per file): `overlay` (static `Sheet`
+ *   exit transition list), `field-sizing` (`TextArea` `autoResize`),
+ *   `details-content` (`Accordion` open/close transition — engines without
+ *   the pseudo-element drop the rule and panels toggle instantly).
+ * - T3 (forbidden): `interpolate-size`, `calc-size`, `if-function`,
+ *   `corner-shape`, `base-select`.
+ */
+export declare const CAPS: {
+    readonly 'view-transitions': {
+        readonly condition: "view-transition-name: none";
+        readonly tier: "T2";
+        readonly patterns: readonly [...RegExp[], RegExp];
+        readonly bcd: {
+            readonly chrome: "111";
+            readonly firefox: "144";
+            readonly safari: "18";
+        };
+    };
+    readonly overlay: {
+        readonly condition: "overlay: auto";
+        readonly tier: "T1";
+        readonly patterns: readonly [RegExp, RegExp];
+        readonly bcd: {
+            readonly chrome: "117";
+            readonly firefox: false;
+            readonly safari: false;
+        };
+    };
+    readonly 'anchor-positioning': {
+        readonly condition: "anchor-name: --a";
+        readonly tier: "T2";
+        readonly patterns: readonly RegExp[];
+        readonly bcd: {
+            readonly chrome: "125";
+            readonly firefox: "147";
+            readonly safari: "26";
+        };
+    };
+    readonly 'scroll-driven-animations': {
+        readonly condition: "animation-timeline: scroll()";
+        readonly tier: "T2";
+        readonly patterns: readonly RegExp[];
+        readonly bcd: {
+            readonly chrome: "115";
+            readonly firefox: false;
+            readonly safari: "26";
+        };
+    };
+    readonly scope: {
+        readonly condition: "at-rule(@scope)";
+        readonly tier: "T2";
+        readonly patterns: readonly [RegExp];
+        readonly bcd: {
+            readonly chrome: "118";
+            readonly firefox: "146";
+            readonly safari: "26.4";
+        };
+    };
+    readonly 'interpolate-size': {
+        readonly condition: "interpolate-size: allow-keywords";
+        readonly tier: "T3";
+        readonly patterns: RegExp[];
+        readonly bcd: {
+            readonly chrome: "129";
+            readonly firefox: false;
+            readonly safari: false;
+        };
+    };
+    readonly 'calc-size': {
+        readonly condition: "width: calc-size(auto, size)";
+        readonly tier: "T3";
+        readonly patterns: readonly [RegExp];
+        readonly bcd: {
+            readonly chrome: "129";
+            readonly firefox: false;
+            readonly safari: false;
+        };
+    };
+    readonly 'if-function': {
+        readonly condition: "width: if(style(--x): 1px; else: 2px)";
+        readonly tier: "T3";
+        readonly patterns: readonly [RegExp];
+        readonly bcd: {
+            readonly chrome: "137";
+            readonly firefox: false;
+            readonly safari: false;
+        };
+    };
+    readonly 'corner-shape': {
+        readonly condition: "corner-shape: bevel";
+        readonly tier: "T3";
+        readonly patterns: RegExp[];
+        readonly bcd: {
+            readonly chrome: "139";
+            readonly firefox: false;
+            readonly safari: false;
+        };
+    };
+    readonly 'base-select': {
+        readonly condition: "appearance: base-select";
+        readonly tier: "T3";
+        readonly patterns: readonly [RegExp];
+        readonly bcd: {
+            readonly chrome: "135";
+            readonly firefox: false;
+            readonly safari: false;
+        };
+    };
+    readonly 'field-sizing': {
+        readonly condition: "field-sizing: content";
+        readonly tier: "T1";
+        readonly patterns: RegExp[];
+        readonly bcd: {
+            readonly chrome: "123";
+            readonly firefox: "152";
+            readonly safari: "26.2";
+        };
+    };
+    readonly 'details-content': {
+        readonly condition: "selector(::details-content)";
+        readonly tier: "T1";
+        readonly patterns: readonly [RegExp];
+        readonly bcd: {
+            readonly chrome: "131";
+            readonly firefox: "143";
+            readonly safari: "18.4";
+        };
+    };
+};
+export type CapabilityId = keyof typeof CAPS;
+/**
+ * Per-file allowlist for T1 capabilities: no `supports()` needed (the browser
+ * drops the declaration), so each occurrence is a reviewed decision. An entry
+ * whose file no longer uses the capability fails the guardrail.
+ */
+export declare const T1_ALLOWLIST: Readonly<Partial<Record<CapabilityId, readonly string[]>>>;
+/**
+ * Wraps `content` in `@supports (<condition>) { … }` for a T2 capability,
+ * reading the condition from {@link CAPS} — never a literal string at the
+ * call site (ADR-029 §4: SSR-deterministic, the condition is a static
+ * string, no feature detection at render time).
+ */
+export declare function supports(cap: CapabilityId, content: RuleSet<object>): RuleSet<object>;

package/lib/utils/index.esm.js

@@ -1 +1 @@
-import{a,b as e,c as f,d as g,e as h,f as i,g as j,h as k,i as l,j as m,k as n,l as o,m as p,n as q,o as r,p as s,q as t,r as u}from"../chunks/chunk-BV6GHAF7.esm.js";import{a as b,b as c,c as d}from"../chunks/chunk-G5Z7USXC.esm.js";import"../chunks/chunk-GZONWSRB.esm.js";export{d as $documentBody,c as $window,a as LOGGER,b as canuseDom,u as createMask,o as domToReact,p as flatAll,r as getValue,l as isEmptyArray,h as isFunction,m as isInputEvent,i as isObject,j as isObjectEmpty,k as isString,q as mapObjIndexed,t as maskContructor,s as memoize,n as parseHtmlString,g as toArray,f as toPixel,e as useDeprecated};
+import{a as e,b as f,c as g,d as h,e as i,f as j,g as k,h as l,i as m,j as n,k as o,l as p,m as q,n as r,o as s,p as t,q as u}from"../chunks/chunk-6G22RNUO.esm.js";import{a}from"../chunks/chunk-J6F4PMW4.esm.js";import{a as b,b as c,c as d}from"../chunks/chunk-G5Z7USXC.esm.js";import"../chunks/chunk-GZONWSRB.esm.js";export{d as $documentBody,c as $window,a as LOGGER,b as canuseDom,u as createMask,o as domToReact,p as flatAll,r as getValue,l as isEmptyArray,h as isFunction,m as isInputEvent,i as isObject,j as isObjectEmpty,k as isString,q as mapObjIndexed,t as maskContructor,s as memoize,n as parseHtmlString,g as toArray,f as toPixel,e as useDeprecated};

package/lib/vendors/EmotionIsPropValid/component.d.ts

@@ -1,12 +1,3 @@
-/**
- * Typed re-export of the absorbed surface of `@emotion/is-prop-valid`.
- *
- * Absorbed surface: default export — predicate that classifies a prop name
- * as HTML-valid (used by styled-components' `shouldForwardProp`).
- *
- * @see ./README.md
- * @see ADR-004 §3.1
- */
-import isPropValid from '@emotion/is-prop-valid';
+declare const isPropValid: (prop: string) => boolean;
 export { isPropValid };
 export default isPropValid;

package/lib/vendors/FloatingUI/index.d.ts

@@ -1,2 +1,3 @@
 export * from './component';
 export * from './interface';
+export * from './layer';

package/lib/vendors/FloatingUI/interface.d.ts

@@ -10,9 +10,19 @@
  * - `OpenChangeReason` — passed to `onOpenChange` callbacks indicating
  *   what triggered the close (`outside-press`, `escape-key`, etc.).
  *
- * No DS-owned types. The ADR-004 §3.1 convention keeps the file for
- * uniformity across vendors.
+ * DS-owned: `FloatingLayer` (see `getFloatingLayer`).
  *
  * @see ./component.ts
  */
+import type { Strategy } from '@floating-ui/react';
 export type { MiddlewareData, OpenChangeReason, Placement, Strategy } from '@floating-ui/react';
+/**
+ * DS-owned: the portal root + positioning strategy of a floating layer,
+ * resolved by `getFloatingLayer` from its reference element. Maps onto
+ * `FloatingPortal`'s `root`: an element portals there, `undefined` portals to
+ * `document.body`, `null` waits (reference not mounted yet).
+ */
+export interface FloatingLayer {
+    root: HTMLElement | null | undefined;
+    strategy: Strategy;
+}

package/lib/vendors/FloatingUI/layer.d.ts

@@ -0,0 +1,46 @@
+import type { FloatingLayer } from './interface';
+/**
+ * Resolves where a floating layer anchored to `reference` portals, and how it
+ * is positioned.
+ *
+ * Inside a modal host the layer portals into that host, so it paints above the
+ * modal and stays interactive:
+ * - an open `<dialog>` (static `Sheet`) sits in the browser's top layer and
+ *   makes everything outside its subtree inert — a `document.body` portal
+ *   would paint under it and ignore clicks;
+ * - an `aria-modal="true"` panel (`Modal`, controlled `Sheet`) lives in a
+ *   `theme.zIndex.modal` container in `body` — a `body` portal at
+ *   `theme.zIndex.dropdown` would paint under it.
+ *
+ * There the layer is positioned `fixed` (host contract: `transform: none` at
+ * rest, see the vendor README). Anywhere else it keeps the default
+ * `document.body` portal with the `absolute` strategy.
+ *
+ * Until the reference mounts, `root` is `null`: `FloatingPortal` waits
+ * instead of creating its node on `document.body`, where it would stay.
+ *
+ * DOM read only — call it with the already-mounted reference element, never
+ * with `document` on the server.
+ *
+ * @example
+ * ```tsx
+ * const layer = getFloatingLayer(referenceEl);
+ * const { refs, floatingStyles } = useFloating({ strategy: layer.strategy, elements: { reference: referenceEl } });
+ * return <FloatingPortal root={layer.root}>…</FloatingPortal>;
+ * ```
+ */
+export declare function getFloatingLayer(reference: Element | null | undefined): FloatingLayer;
+/**
+ * {@link getFloatingLayer} for a component: same resolution, plus a
+ * development warning when the layer is `open` but its reference never
+ * mounts — the portal waits on `root: null` and would otherwise render
+ * nothing, silently. A reference that arrives on the next render (the
+ * normal mount order) cancels the warning.
+ *
+ * @example
+ * ```tsx
+ * const layer = useFloatingLayer(referenceEl, open);
+ * return <FloatingPortal root={layer.root}>…</FloatingPortal>;
+ * ```
+ */
+export declare function useFloatingLayer(reference: Element | null | undefined, open: boolean): FloatingLayer;