@almadar/ui 6.51.2 → 6.53.0

package/dist/{EntityBindingContext-BbxrwSb9.d.ts → AwaitingSkeletonContext-Bh399p1x.d.ts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-import { ResolvedEntity, OrbitalSchema, EventPayload, ResolvedTrait, ResolvedTraitBinding, EntityRow, TraitConfig } from '@almadar/core';
+import { ResolvedEntity, OrbitalSchema, EventPayload, ResolvedTrait, ResolvedTraitBinding, EntityRow, TraitConfig, SkeletonNode } from '@almadar/core';
 import { EventTransport, AccessTokenProvider } from '@almadar/runtime';
 
 /**
@@ -213,4 +213,19 @@ declare function useEntityBindingSnapshot(traitName: string | undefined): {
     state: string;
 };
 
-export { type EntityBindingSource as E, type ServerBridgeTransport as S, TraitContext as T, type EntitySchemaContextValue as a, EntitySchemaProvider as b, type EntitySchemaProviderProps as c, type ServerBridgeContextValue as d, ServerBridgeProvider as e, type TraitContextValue as f, type TraitInstance as g, TraitProvider as h, type TraitProviderProps as i, useEntitySchemaOptional as j, useServerBridge as k, useTrait as l, useTraitContext as m, EntityBindingContext as n, type ServerBridgeProviderProps as o, useEntityBindingSnapshot as p, useEntitySchema as u };
+interface AwaitingSkeletonSource {
+    /** The predicted skeleton for a top-level slot, from a non-embedded awaiting render. */
+    forSlot: (slot: string) => SkeletonNode | undefined;
+    /** The predicted skeleton for an embedded trait's frame. */
+    forTrait: (traitName: string) => SkeletonNode | undefined;
+    subscribe: (callback: () => void) => () => void;
+    getVersion: () => number;
+}
+declare const AwaitingSkeletonContext: React.Context<AwaitingSkeletonSource | null>;
+declare function useAwaitingSkeleton(target: {
+    slot: string;
+} | {
+    trait: string;
+}): SkeletonNode | undefined;
+
+export { type AwaitingSkeletonSource as A, type EntityBindingSource as E, type ServerBridgeTransport as S, TraitContext as T, type EntitySchemaContextValue as a, EntitySchemaProvider as b, type EntitySchemaProviderProps as c, type ServerBridgeContextValue as d, ServerBridgeProvider as e, type TraitContextValue as f, type TraitInstance as g, TraitProvider as h, type TraitProviderProps as i, useEntitySchemaOptional as j, useServerBridge as k, useTrait as l, useTraitContext as m, AwaitingSkeletonContext as n, EntityBindingContext as o, type ServerBridgeProviderProps as p, useAwaitingSkeleton as q, useEntityBindingSnapshot as r, useEntitySchema as u };

package/dist/{Canvas3DHost-CLC_jXh_.d.ts → Canvas3DHost-B-y2TNij.d.ts}

@@ -1,7 +1,7 @@
 import { AnimationName, Asset, ScenePos, EventEmit, EventKey } from '@almadar/core';
 import React__default from 'react';
 import * as THREE from 'three';
-import { D as DrawableNode } from './paintDispatch-CMgOyVjS.js';
+import { D as DrawableNode } from './paintDispatch-_6EhJCiL.js';
 
 /**
  * Sprite Sheet Animation Types

package/dist/{FileTree-RKQqRhIM.d.ts → FileTree-DUi7e7Z8.d.ts}

@@ -1,5 +1,5 @@
 import React__default from 'react';
-import { EventEmit, JsonObject, EntityPersistence, OrbitalSchema } from '@almadar/core';
+import { A11yProps, EventEmit, JsonObject, EntityPersistence, OrbitalSchema } from '@almadar/core';
 import { T as TraitLevelData, F as FieldInfo, O as OrbitalTraitInfo, a as OrbitalPageInfo, E as ExternalLink } from './avl-schema-parser-C0wnAp5x.js';
 import { Node, Edge } from '@xyflow/react';
 
@@ -9,7 +9,7 @@ import { Node, Edge } from '@xyflow/react';
  * optional execution position (active state, fired transition, visited path).
  */
 
-interface AvlStateMachineProps {
+interface AvlStateMachineProps extends A11yProps {
     /** The trait to draw (see `parseTraitLevel`).
      * @example {"name":"OrderFlow","linkedEntity":"Order","states":[{"name":"browsing","isInitial":true,"isTerminal":false},{"name":"editing","isInitial":false,"isTerminal":false},{"name":"saving","isInitial":false,"isTerminal":false},{"name":"confirmed","isInitial":false,"isTerminal":true},{"name":"failed","isInitial":false,"isTerminal":false}],"transitions":[{"from":"browsing","to":"editing","event":"EDIT","effects":[{"type":"render-ui","args":[]}],"index":0},{"from":"editing","to":"saving","event":"SAVE","effects":[{"type":"persist","args":[]},{"type":"notify","args":[]}],"index":1},{"from":"saving","to":"confirmed","event":"SAVED","effects":[{"type":"emit","args":[]},{"type":"render-ui","args":[]}],"index":2},{"from":"saving","to":"failed","event":"SAVE_FAILED","effects":[{"type":"notify","args":[]}],"index":3},{"from":"failed","to":"editing","event":"RETRY","effects":[],"index":4},{"from":"editing","to":"browsing","event":"CANCEL","effects":[{"type":"render-ui","args":[]}],"index":5},{"from":"confirmed","to":"browsing","event":"DONE","effects":[{"type":"navigate","args":[]}],"index":6}],"emittedEvents":["ORDER_SAVED"],"listenedEvents":["PAYMENT_OK"]}
      */
@@ -105,7 +105,7 @@ declare function schemaToFlowGraph(schema: OrbitalSchema): {
  *
  * @capabilities orbital module summary card, entity and trait overview card, app architecture node card
  */
-interface ModuleCardProps {
+interface ModuleCardProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
     /** The orbital to summarize.
      * @example {"orbitalName":"OrderOrbital","entityName":"Order","persistence":"persistent","fields":[{"name":"customer","type":"string","required":true,"hasDefault":false},{"name":"qty","type":"number","required":true,"hasDefault":true},{"name":"status","type":"string","required":false,"hasDefault":true}],"traits":[{"name":"OrderFlow","stateCount":5,"eventCount":7,"transitionCount":7,"emits":["ORDER_SAVED"],"listens":["PAYMENT_OK"]}],"pages":[{"name":"Orders","route":"/orders"}],"traitDetails":{"OrderFlow":{"name":"OrderFlow","linkedEntity":"Order","states":[{"name":"browsing","isInitial":true,"isTerminal":false},{"name":"editing","isInitial":false,"isTerminal":false},{"name":"saving","isInitial":false,"isTerminal":false},{"name":"confirmed","isInitial":false,"isTerminal":true},{"name":"failed","isInitial":false,"isTerminal":false}],"transitions":[{"from":"browsing","to":"editing","event":"EDIT","effects":[{"type":"render-ui","args":[]}],"index":0},{"from":"editing","to":"saving","event":"SAVE","effects":[{"type":"persist","args":[]},{"type":"notify","args":[]}],"index":1},{"from":"saving","to":"confirmed","event":"SAVED","effects":[{"type":"emit","args":[]},{"type":"render-ui","args":[]}],"index":2},{"from":"saving","to":"failed","event":"SAVE_FAILED","effects":[{"type":"notify","args":[]}],"index":3},{"from":"failed","to":"editing","event":"RETRY","effects":[],"index":4},{"from":"editing","to":"browsing","event":"CANCEL","effects":[{"type":"render-ui","args":[]}],"index":5},{"from":"confirmed","to":"browsing","event":"DONE","effects":[{"type":"navigate","args":[]}],"index":6}],"emittedEvents":["ORDER_SAVED"],"listenedEvents":["PAYMENT_OK"]}},"externalLinks":[{"targetOrbital":"PaymentOrbital","eventName":"PAYMENT_OK","direction":"in","traitName":"OrderFlow"}]}
      */
@@ -125,7 +125,7 @@ declare const ModuleCard: React__default.FC<ModuleCardProps>;
  * BehaviorView — an orbital's behavior: one themed state machine per trait.
  */
 
-interface BehaviorViewProps {
+interface BehaviorViewProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
     /** The orbital to summarize.
      * @example {"orbitalName":"OrderOrbital","entityName":"Order","persistence":"persistent","fields":[{"name":"customer","type":"string","required":true,"hasDefault":false},{"name":"qty","type":"number","required":true,"hasDefault":true},{"name":"status","type":"string","required":false,"hasDefault":true}],"traits":[{"name":"OrderFlow","stateCount":5,"eventCount":7,"transitionCount":7,"emits":["ORDER_SAVED"],"listens":["PAYMENT_OK"]}],"pages":[{"name":"Orders","route":"/orders"}],"traitDetails":{"OrderFlow":{"name":"OrderFlow","linkedEntity":"Order","states":[{"name":"browsing","isInitial":true,"isTerminal":false},{"name":"editing","isInitial":false,"isTerminal":false},{"name":"saving","isInitial":false,"isTerminal":false},{"name":"confirmed","isInitial":false,"isTerminal":true},{"name":"failed","isInitial":false,"isTerminal":false}],"transitions":[{"from":"browsing","to":"editing","event":"EDIT","effects":[{"type":"render-ui","args":[]}],"index":0},{"from":"editing","to":"saving","event":"SAVE","effects":[{"type":"persist","args":[]},{"type":"notify","args":[]}],"index":1},{"from":"saving","to":"confirmed","event":"SAVED","effects":[{"type":"emit","args":[]},{"type":"render-ui","args":[]}],"index":2},{"from":"saving","to":"failed","event":"SAVE_FAILED","effects":[{"type":"notify","args":[]}],"index":3},{"from":"failed","to":"editing","event":"RETRY","effects":[],"index":4},{"from":"editing","to":"browsing","event":"CANCEL","effects":[{"type":"render-ui","args":[]}],"index":5},{"from":"confirmed","to":"browsing","event":"DONE","effects":[{"type":"navigate","args":[]}],"index":6}],"emittedEvents":["ORDER_SAVED"],"listenedEvents":["PAYMENT_OK"]}},"externalLinks":[{"targetOrbital":"PaymentOrbital","eventName":"PAYMENT_OK","direction":"in","traitName":"OrderFlow"}]}
      */
@@ -172,7 +172,7 @@ interface FileTreeItem {
     /** Icon name override (falls back to folder/file by presence of children) */
     icon?: string;
 }
-interface FileTreeProps {
+interface FileTreeProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
     /** The tree data (pre-nested). Ignored when `items` is provided. */
     tree?: FileTreeNode[];
     /** Flat node list, nested by `parentId` at render time — takes precedence

package/dist/{GameAudioProvider-BgWLggIy.d.ts → GameAudioProvider-DyBvYP2c.d.ts}

@@ -1,6 +1,6 @@
 import React__default from 'react';
 import { AudioManifest } from '@almadar/core';
-import { U as UiError } from './paintDispatch-CMgOyVjS.js';
+import { U as UiError } from './paintDispatch-_6EhJCiL.js';
 
 /** Core owns the sound-manifest shape (`@almadar/core` `types/asset.ts`) so the
  *  pattern extractor and the generated `.lolo` factories resolve the same

package/dist/{NavStackContext-B-XLULCO.d.ts → NavStackContext-04NLdXsY.d.ts}

@@ -93,6 +93,12 @@ interface NavPageDecl {
     /** Declared nav label (`@label`); absent = the page name as written. */
     label?: string;
 }
+/** A declared navigation item (the app shell's `navItems`), children included. */
+interface NavItemDecl {
+    href: string;
+    label: string;
+    children?: readonly NavItemDecl[];
+}
 
 /**
  * NavStackProvider — the orbital-scoped client-session navigation stack.
@@ -123,6 +129,8 @@ interface NavStackApi {
      *  (idempotent; no-op when the label already matches). DetailPanel calls
      *  this from the routed main slot so cold-loaded crumbs read like pushes. */
     setCurrentLabel: (label: string) => void;
+    /** The app shell's declared navItems: a page reached by one shows that item's label in the trail. */
+    registerNavItems: (items: readonly NavItemDecl[]) => void;
 }
 /** True when no NavStackProvider is mounted above (plain React / SSR hosts). */
 declare function isInertNavStack(api: NavStackApi): boolean;

package/dist/Typography-JGSDH4JP.js

@@ -0,0 +1,5 @@
+export { Typography } from './chunk-GMDMOYXD.js';
+import './chunk-64WACXM7.js';
+import './chunk-4OZDHCZV.js';
+import './chunk-UGHAADU5.js';
+import './chunk-QPXIAUJD.js';

package/dist/{UISlotContext-DNM8iXna.d.ts → UISlotContext-CS487Uoc.d.ts}

@@ -1,5 +1,5 @@
 import React__default from 'react';
-import { U as UISlotManager, b as SlotContent } from './useUISlots-CwUWM1ra.js';
+import { U as UISlotManager, a as SlotContent } from './useUISlots-1dk2TR4j.js';
 import { UISlot } from '@almadar/core';
 
 /**

package/dist/{UISlotRenderer-7UYHFW4S.js → UISlotRenderer-JT34I3O7.js}

@@ -1,14 +1,14 @@
-export { SlotContainedContext, SlotContentRenderer, SuspenseConfigProvider, UISlotComponent, UISlotRenderer, renderPatternValue } from './chunk-GIPZSCND.js';
-import './chunk-BUEIZY54.js';
-import './chunk-MWPX2O4M.js';
-import './chunk-NTO555KF.js';
+export { SlotContainedContext, SlotContentRenderer, SuspenseConfigProvider, UISlotComponent, UISlotRenderer, renderPatternValue } from './chunk-3EF5SDIJ.js';
+import './chunk-7LM6I3NA.js';
+import './chunk-GMDMOYXD.js';
+import './chunk-JRW33U35.js';
 import './chunk-XJTHMW4G.js';
 import './chunk-6EV3OEBQ.js';
-import './chunk-OLZ3EEML.js';
+import './chunk-KQXXO42S.js';
 import './chunk-O7OLVVBR.js';
-import './chunk-HQDKHLFG.js';
-import './chunk-GHXWGQTX.js';
-import './chunk-L55SAFKL.js';
+import './chunk-64WACXM7.js';
+import './chunk-4OZDHCZV.js';
+import './chunk-UGHAADU5.js';
 import './chunk-PQKU62LK.js';
-import './chunk-YHY5K2Y7.js';
+import './chunk-PEST66PN.js';
 import './chunk-QPXIAUJD.js';