@astryxdesign/core 0.7.6-canary.fdabeba → 0.7.6

package/dist/i18n/generated-locales/zh-CN.generated.js

@@ -152,7 +152,7 @@ const runtimeCatalog = {
   '@astryx.selector.empty': '无选项',
   '@astryx.sideNav.label': '侧边导航',
   '@astryx.sideNav.resizeSidebar': '调整侧边栏尺寸',
-  '@astryx.sideNav.heading.openMenu': '打开菜单',
+  '@astryx.sideNav.heading.openMenu': '{heading}, 打开菜单',
   '@astryx.tabList.label': '标签页',
   '@astryx.table.label': '表格',
   '@astryx.table.noData': '暂无数据',
@@ -169,7 +169,7 @@ const runtimeCatalog = {
   '@astryx.toast.dismiss': '关闭通知',
   '@astryx.toast.viewport': '通知',
   '@astryx.tokenizer.clearAll': '全部清除',
-  '@astryx.topNav.heading.openMenu': '打开菜单',
+  '@astryx.topNav.heading.openMenu': '{hasHeading, select, true {{heading}, } other {}}打开菜单',
   '@astryx.topNav.landmarkLabel': '顶部导航',
   '@astryx.treeList.toggleChildren': '切换子项',
   '@astryx.typeahead.emptySearchResults': '未找到结果',

package/dist/i18n/generated-locales/zh-TW.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zh-TW.generated.d.ts","sourceRoot":"","sources":["../../../src/i18n/generated-locales/zh-TW.generated.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,QAAA,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkZpD,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"zh-TW.generated.d.ts","sourceRoot":"","sources":["../../../src/i18n/generated-locales/zh-TW.generated.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,QAAA,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmZpD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/i18n/generated-locales/zh-TW.generated.js

@@ -152,7 +152,7 @@ const runtimeCatalog = {
   '@astryx.selector.empty': '無選項',
   '@astryx.sideNav.label': '側邊導覽',
   '@astryx.sideNav.resizeSidebar': '調整側邊欄大小',
-  '@astryx.sideNav.heading.openMenu': '開啟功能表',
+  '@astryx.sideNav.heading.openMenu': '{heading}, 開啟功能表',
   '@astryx.tabList.label': '索引標籤',
   '@astryx.table.label': '表格',
   '@astryx.table.noData': '無資料',
@@ -169,7 +169,7 @@ const runtimeCatalog = {
   '@astryx.toast.dismiss': '關閉通知',
   '@astryx.toast.viewport': '通知',
   '@astryx.tokenizer.clearAll': '全部清除',
-  '@astryx.topNav.heading.openMenu': '開啟功能表',
+  '@astryx.topNav.heading.openMenu': '{hasHeading, select, true {{heading}, } other {}}開啟功能表',
   '@astryx.topNav.landmarkLabel': '頂部導覽',
   '@astryx.treeList.toggleChildren': '切換子項目',
   '@astryx.typeahead.emptySearchResults': '找不到結果',

package/dist/i18n/index.d.ts

@@ -14,6 +14,11 @@
  *   - getLocaleDirection          — server-safe locale → direction helper
  *   - Translator                  — interface for consumer-injected runtimes
  *
+ * `useTranslator` and `InternationalizationContext` are the public paths
+ * that resolve any Astryx key, so they register the whole English catalog.
+ * Core modules import the defining modules (useComponentTranslator.ts,
+ * InternationalizationContext.ts) instead of this barrel for those two.
+ *
  * SYNC: When modified, update these files to stay in sync:
  * - /packages/core/src/index.ts
  * - /packages/core/src/i18n/useLocale.ts
@@ -23,7 +28,7 @@
  */
 export { InternationalizationProvider } from './InternationalizationProvider.js';
 export type { InternationalizationProviderProps } from './InternationalizationProvider.js';
-export { InternationalizationContext } from './InternationalizationContext.js';
+export { InternationalizationContext } from './publicContext.js';
 export type { InternationalizationContextValue } from './InternationalizationContext.js';
 export { useTranslator } from './useTranslator.js';
 export type { TranslatorFn } from './useTranslator.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAC5E,YAAY,EAAC,iCAAiC,EAAC,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAC,2BAA2B,EAAC,MAAM,+BAA+B,CAAC;AAC1E,YAAY,EAAC,gCAAgC,EAAC,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,MAAM,EACN,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,GACV,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAC5E,YAAY,EAAC,iCAAiC,EAAC,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAC,2BAA2B,EAAC,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAC,gCAAgC,EAAC,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,MAAM,EACN,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/i18n/index.js

@@ -16,6 +16,11 @@
  *   - getLocaleDirection          — server-safe locale → direction helper
  *   - Translator                  — interface for consumer-injected runtimes
  *
+ * `useTranslator` and `InternationalizationContext` are the public paths
+ * that resolve any Astryx key, so they register the whole English catalog.
+ * Core modules import the defining modules (useComponentTranslator.ts,
+ * InternationalizationContext.ts) instead of this barrel for those two.
+ *
  * SYNC: When modified, update these files to stay in sync:
  * - /packages/core/src/index.ts
  * - /packages/core/src/i18n/useLocale.ts
@@ -25,7 +30,7 @@
  */
 
 export { InternationalizationProvider } from "./InternationalizationProvider.js";
-export { InternationalizationContext } from "./InternationalizationContext.js";
+export { InternationalizationContext } from "./publicContext.js";
 export { useTranslator } from "./useTranslator.js";
 export { useLocale } from "./useLocale.js";
 export { useCollator } from "./useCollator.js";

package/dist/i18n/publicContext.d.ts

@@ -0,0 +1,2 @@
+export declare const InternationalizationContext: import("react").Context<import("./InternationalizationContext.js").InternationalizationContextValue>;
+//# sourceMappingURL=publicContext.d.ts.map

package/dist/i18n/publicContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publicContext.d.ts","sourceRoot":"","sources":["../../src/i18n/publicContext.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,2BAA2B,mGAAkB,CAAC"}

package/dist/i18n/publicContext.js

@@ -0,0 +1,26 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file publicContext.ts
+ * @input InternationalizationContext, fullEnglishFallback
+ * @output The public InternationalizationContext export
+ * @position The package's InternationalizationContext, re-exported by the i18n
+ *   barrel. The same context object Core components read.
+ *
+ * Application code may call `translate` from this context with any Astryx
+ * key, so loading the public export registers the whole English catalog.
+ * Core modules import ./InternationalizationContext directly and register only
+ * the English they name. The export is its own binding rather than a
+ * re-export so bundlers keep this module, and its registration, whenever the
+ * public context is used.
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/i18n/InternationalizationContext.ts
+ * - /packages/core/src/i18n/index.ts
+ */
+import { InternationalizationContext as ProviderContext } from "./InternationalizationContext.js";
+import { registerFullEnglishFallback } from "./fullEnglishFallback.js";
+registerFullEnglishFallback();
+export const InternationalizationContext = ProviderContext;

package/dist/i18n/resolve.d.ts

@@ -1,4 +1,4 @@
-import type { Locale, Overrides, ProviderMessagesByLocale } from './types.js';
+import type { Locale, Overrides, ProviderMessagesByLocale, RuntimeCatalog } from './types.js';
 /**
  * Walk a BCP 47 tag from most-specific to least-specific.
  * Input is canonicalized via `Intl.Locale.baseName` so `pt-br` and `PT-BR`
@@ -13,7 +13,11 @@ import type { Locale, Overrides, ProviderMessagesByLocale } from './types.js';
  * shipped en catalog separately as the final source-of-truth.
  */
 export declare function resolveLocaleChain(locale: Locale): Locale[];
-export declare function getResolve(locale: Locale, messages: ProviderMessagesByLocale, overrides?: Overrides): (key: string, values: Record<string, unknown> | undefined) => string;
+/**
+ * `english` defaults to the shipped English registry; tests pass a fixed map
+ * to compare one module's English with the whole catalog.
+ */
+export declare function getResolve(locale: Locale, messages: ProviderMessagesByLocale, overrides?: Overrides, english?: RuntimeCatalog): (key: string, values: Record<string, unknown> | undefined) => string;
 /**
  * Reset internal caches. Test-only.
  * @internal

package/dist/i18n/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/i18n/resolve.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAC,MAAM,EAAE,SAAS,EAAE,wBAAwB,EAAC,MAAM,SAAS,CAAC;AAsBzE;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAc3D;AAoCD,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,wBAAwB,EAClC,SAAS,CAAC,EAAE,SAAS,IAIb,KAAK,MAAM,EAAE,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,YA0BjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/i18n/resolve.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EACV,MAAM,EACN,SAAS,EACT,wBAAwB,EACxB,cAAc,EACf,MAAM,SAAS,CAAC;AAsBjB;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAc3D;AAoCD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,wBAAwB,EAClC,SAAS,CAAC,EAAE,SAAS,EACrB,OAAO,GAAE,cAAgC,IAIjC,KAAK,MAAM,EAAE,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,YA0BjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}

package/dist/i18n/resolve.js

@@ -11,16 +11,19 @@
  *   2. Per-locale override for a parent locale (pt-BR → pt)
  *   3. Shipped catalog entry for the exact locale
  *   4. Shipped catalog entry for a parent locale (pt-BR → pt)
- *   5. Shipped en catalog (the source of truth, always present)
+ *   5. Shipped English: the English registered by the loaded modules that
+ *      name the key (englishFallback.ts), or the whole catalog on public
+ *      paths that resolve arbitrary keys
  *   6. The key itself (dev-visible fallback, warns once)
  *
  * SYNC: When modified, update these files to stay in sync:
  * - /packages/core/src/i18n/useTranslator.ts
+ * - /packages/core/src/i18n/englishFallback.ts
  * - /packages/core/src/i18n/__tests__/resolve.test.ts
  */
 
 import IntlMessageFormat from 'intl-messageformat';
-import enCatalog from "./generated-locales/en.generated.js";
+import { englishFallback } from "./englishFallback.js";
 import { warnOnce, __resetDevWarnings } from "../utils/devWarning.js";
 
 /**
@@ -95,10 +98,15 @@ function getLookup(locale, messages, overrides) {
   }
   return lookup;
 }
-export function getResolve(locale, messages, overrides) {
+
+/**
+ * `english` defaults to the shipped English registry; tests pass a fixed map
+ * to compare one module's English with the whole catalog.
+ */
+export function getResolve(locale, messages, overrides, english = englishFallback) {
   const lookup = getLookup(locale, messages, overrides);
   return (key, values) => {
-    const result = lookup[key] ?? enCatalog[key];
+    const result = lookup[key] ?? english[key];
     if (result === undefined) {
       // Fires ONLY when a key is missing from every source including the
       // shipped `en` catalog — a real bug (typo, stale catalog, deleted key).

package/dist/i18n/useComponentTranslator.d.ts

@@ -0,0 +1,8 @@
+import type { TranslatorFn } from './useTranslator.js';
+export { registerEnglishFallback } from './englishFallback.js';
+/**
+ * Returns the translator bound to the current provider's locale. Keys resolve
+ * to English only when the module naming them registered its English.
+ */
+export declare function useComponentTranslator(): TranslatorFn;
+//# sourceMappingURL=useComponentTranslator.d.ts.map

package/dist/i18n/useComponentTranslator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComponentTranslator.d.ts","sourceRoot":"","sources":["../../src/i18n/useComponentTranslator.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAC,uBAAuB,EAAC,MAAM,mBAAmB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CAGrD"}

package/dist/i18n/useComponentTranslator.js

@@ -0,0 +1,42 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useComponentTranslator.ts
+ * @input InternationalizationContext (via use())
+ * @output useComponentTranslator, and registerEnglishFallback re-exported for
+ *   the same importers
+ * @position Internal translator for Core components. Not exported from the
+ *   package; application code uses the public `useTranslator`.
+ *
+ * Returns the same provider-bound translator as the public hook. The public
+ * hook also registers the whole English catalog, because application code may
+ * translate any Astryx key; a component instead registers the English for the
+ * keys it names, from its generated map:
+ *
+ *   import {
+ *     registerEnglishFallback,
+ *     useComponentTranslator,
+ *   } from '../i18n/useComponentTranslator';
+ *   import english from '../i18n/generated-english/Button/Button.generated';
+ *
+ *   registerEnglishFallback(english);
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/i18n/useTranslator.ts
+ * - /packages/core/src/i18n/englishFallback.ts
+ * - /scripts/i18n-english-fallback.mjs
+ */
+import { use } from 'react';
+import { InternationalizationContext } from "./InternationalizationContext.js";
+export { registerEnglishFallback } from "./englishFallback.js";
+
+/**
+ * Returns the translator bound to the current provider's locale. Keys resolve
+ * to English only when the module naming them registered its English.
+ */
+export function useComponentTranslator() {
+  const ctx = use(InternationalizationContext);
+  return ctx.translate;
+}

package/dist/i18n/useTranslator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTranslator.d.ts","sourceRoot":"","sources":["../../src/i18n/useTranslator.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,MAAM,CAAC;AAEZ;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAG5C"}
+{"version":3,"file":"useTranslator.d.ts","sourceRoot":"","sources":["../../src/i18n/useTranslator.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,MAAM,CAAC;AAEZ;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,IAAI,YAAY,CAG5C"}

package/dist/i18n/useTranslator.js

@@ -14,12 +14,18 @@
  * to translate inside an event handler or effect, capture a translator during
  * render via useTranslator() and call it later.
  *
+ * This is the public hook: application code may translate any Astryx key, so
+ * loading it registers the whole English catalog. Core components use
+ * useComponentTranslator.ts and register only the English they name.
+ *
  * SYNC: When modified, update these files to stay in sync:
  * - /packages/core/src/i18n/index.ts
- * - /packages/core/src/i18n/t.client.ts
+ * - /packages/core/src/i18n/useComponentTranslator.ts
  */
 import { use } from 'react';
 import { InternationalizationContext } from "./InternationalizationContext.js";
+import { registerFullEnglishFallback } from "./fullEnglishFallback.js";
+registerFullEnglishFallback();
 /**
  * Returns a translator function bound to the current provider's locale.
  * Safe to call from event handlers and effects.

package/dist/motion/animatedLayout.d.ts

@@ -58,13 +58,26 @@ export interface LayoutChange {
  * outside its container, nothing moves.
  */
 export declare function reportLayoutChange(handle: AnimatedLayout | null | undefined, target: Target): LayoutChange;
+/**
+ * The edge an element reveals from or conceals to (`spec:AST-105` FR9): its
+ * block-end edge by default, or its block-start, inline-start or inline-end
+ * edge, such as a panel collapsing beside content. An inline edge follows
+ * the element's direction.
+ */
+export type LayoutEdge = 'block-end' | 'block-start' | 'inline-start' | 'inline-end';
 /**
  * The changed element's own animation, on the same motion as the content
- * after it: content that appears reveals downward from its top edge. Plays
- * only with a handle, inside its area and in the area's visible part.
- * Returns the entrance it started, or null when it played none.
+ * after it (`spec:AST-105` FR4): content that appears reveals from its
+ * block-end edge downward, or from the `edge` it is given (FR9), and its edge
+ * rides the glide of the content on that side once it starts. A reveal that
+ * reverses a running conceal (an adopter opens it again mid-exit, after
+ * `releaseLayoutExit`) starts from what the element shows. Plays only with a
+ * handle, inside its area and in the area's visible part. Returns the
+ * entrance it started, or null when it played none.
  */
-export declare function playLayoutChange(handle: AnimatedLayout | null | undefined, element: Element): Animation | null;
+export declare function playLayoutChange(handle: AnimatedLayout | null | undefined, element: Element, { edge }?: {
+    edge?: LayoutEdge;
+}): Animation | null;
 /**
  * The changed element's exit (`spec:AST-105` FR4): content that disappears
  * keeps its place on screen but gives up its space (a negative end margin
@@ -77,6 +90,11 @@ export declare function playLayoutChange(handle: AnimatedLayout | null | undefin
  * element, after the change's `animate()` reported it measured, in the same
  * task: the glide reads the layout once the element has given up its space.
  *
+ * It conceals to its block-end edge by default, or to the `edge` it is given
+ * (`spec:AST-105` FR9), and its edge rides the glide of the content on that
+ * side once it starts; a conceal that reverses a running reveal (a close
+ * while it opens) starts from what the element shows.
+ *
  * Returns false, holding nothing, when the exit lands at once: no handle, a
  * close no change in the area measured, outside the area or its visible part,
  * Reduce Motion with a fine pointer, or a layout no end margin can free (a
@@ -84,7 +102,9 @@ export declare function playLayoutChange(handle: AnimatedLayout | null | undefin
  * that last case the content after it takes its final place at once too.
  * The component then hides the element itself.
  */
-export declare function holdLayoutExit(handle: AnimatedLayout | null | undefined, element: HTMLElement, done: () => void): boolean;
+export declare function holdLayoutExit(handle: AnimatedLayout | null | undefined, element: HTMLElement, done: () => void, { edge }?: {
+    edge?: LayoutEdge;
+}): boolean;
 /**
  * Puts an element `holdLayoutExit` held back: stops its exit and puts back
  * what the exit replaced (its `inert` and inline values as they were). Called
@@ -167,6 +187,111 @@ export declare function playLayoutSwap(swap: LayoutSwap, how: LayoutSwapMotion):
  * nothing plays. Returns what ends them at once.
  */
 export declare function playLayoutFrames(handle: AnimatedLayout | null | undefined, parts: LayoutSwapMotion['incoming']): () => void;
+/**
+ * An element's old state, held before a change commits for FR9's two-state
+ * edge reveal.
+ */
+export interface LayoutEdgeHold {
+    readonly element: HTMLElement;
+    /** Where it showed, in viewport coordinates. */
+    readonly rect: DOMRect;
+    /**
+     * Its size along the edge's axis as it shows: what a running reveal shows
+     * mid-motion, or its box.
+     */
+    readonly extent: number;
+    /** Its old state as one transient copy, or null when it cannot be held. */
+    readonly swap: LayoutSwap | null;
+}
+/** A playing two-state edge reveal. */
+export interface LayoutEdgeMotion {
+    /** Ends it at once (a new change, an unmount). */
+    end(): void;
+    /**
+     * What it shows now: its extent along the edge's axis and the motion's
+     * progress (0 → 1), or null once it has settled.
+     */
+    shown(): {
+        readonly extent: number;
+        readonly progress: number;
+    } | null;
+}
+/** What the caller adds to a two-state edge reveal: only its own fades. */
+export interface LayoutEdgeParts {
+    /** The old state's copy's opacity over the progress (1 when absent). */
+    readonly copyOpacity?: (p: number) => number;
+    /** Its text's opacity, on its own curve, when that differs from the copy's. */
+    readonly copyText?: (p: number) => number;
+    /** Parts the page renders, playing with the reveal (the new state's text). */
+    readonly incoming?: ReadonlyArray<{
+        readonly element: Element;
+        readonly frames: (p: number) => Keyframe;
+    }>;
+}
+/**
+ * Before a change commits: hold `element`'s old state for FR9's two-state edge
+ * reveal, its box and the extent it shows along `edge`'s axis (`shown`, from a
+ * running reveal, or its box), and its old state as one transient copy (null
+ * when it cannot be copied, or under an immediate change). Returns null
+ * without the element or without Web Animations.
+ */
+export declare function holdLayoutEdge(handle: AnimatedLayout | null | undefined, element: HTMLElement | null, { edge, shown, }?: {
+    edge?: LayoutEdge;
+    shown?: number | null;
+}): LayoutEdgeHold | null;
+/**
+ * After the change commits, before paint: FR9's two-state edge reveal, on
+ * FR4's one motion. The state that is larger along `edge`'s axis is clipped
+ * on that edge, from the extent the element showed to the new one: a conceal
+ * covers the old state, held as the swap's copy, with the element raised
+ * above it; a reveal opens the element, under the old state. With
+ * `rideWith`, an element the glide moves after that edge (a rail's content
+ * column), the edge rides its glide, frame by frame, so the two never part,
+ * also when this reverses a running reveal; without it the edge follows the
+ * motion's curve. `parts` gives the caller's own fades, told whether the edge
+ * conceals and the element as it is now. Under Reduce Motion it follows
+ * `design:reduced-motion`: opacity only under a coarse primary pointer (DR2),
+ * an immediate change otherwise (DR3). `current` is the element after the
+ * commit, when it remounted.
+ */
+export declare function playLayoutEdge(hold: LayoutEdgeHold, current: HTMLElement | null, handle: AnimatedLayout, { edge, rideWith, parts, }?: {
+    edge?: LayoutEdge;
+    rideWith?: Element | null;
+    parts?: (isConceal: boolean, element: HTMLElement) => LayoutEdgeParts;
+}): LayoutEdgeMotion;
+/** A resized element's edge reveal, reported around its change. */
+export interface LayoutEdgeReport {
+    /** Before the change commits: measures the element and what moves. */
+    measureBefore(): void;
+    /**
+     * After the new size is applied, before paint: the element reveals or
+     * conceals by its edge, from the extent it showed to its new one, and the
+     * content beside it glides on the same motion.
+     */
+    animate(): void;
+    /** Ends a running reveal or conceal at once, removing what it holds. */
+    cancel(): void;
+}
+/**
+ * Reports a resized element's edge reveal (`spec:AST-105` FR9) with no copy:
+ * a resize controller's pane collapsing or opening beside the content it
+ * shares a row with (`component:Resizable` FR8, `component:LayoutPanel`
+ * FR7). Measure before the change commits and animate after the
+ * new size is applied, as `reportLayoutChange` does; the content beside the
+ * element glides through that report. A larger extent reveals by `edge` from
+ * the extent the element showed. A smaller one conceals: the element is held
+ * at the extent it was laid out at, the difference freed by the margin on
+ * that edge's side so the content beyond it stays where the new size puts it,
+ * and clipped down to its new extent; the hold goes when the motion ends. The
+ * moving edge rides the glide of the content on that side, frame by frame,
+ * and a change made while it runs starts from the extent it shows. It slides:
+ * nothing fades. Under Reduce Motion with a coarse primary pointer a reveal
+ * fades in and a conceal lands at once (`design:reduced-motion` DR2); with a
+ * fine one every change lands at once (DR3).
+ */
+export declare function reportLayoutEdge(handle: AnimatedLayout | null | undefined, getElement: () => HTMLElement | null, { edge }?: {
+    edge?: LayoutEdge;
+}): LayoutEdgeReport;
 /**
  * A disclosure's indicator (its chevron) turns on the same motion as the
  * glide: its CSS transition takes the spring as a `linear()` easing, and an

package/dist/motion/animatedLayout.d.ts.map

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