@almadar/ui 6.55.0 → 6.57.0

package/dist/{ArbitraryClassCompiler-DvzdeHxc.d.ts → ArbitraryClassCompiler-tChQ3nVq.d.ts}

@@ -67,6 +67,20 @@ interface ThemeScope {
 }
 declare const ThemeScopeContext: React__default.Context<ThemeScope>;
 declare function useThemeScope(): ThemeScope;
+/**
+ * The mode a registry `data-theme` key was built with: `<name>-light` /
+ * `<name>-dark` of a declared theme that has that mode (the same construction
+ * as `appliedTheme`). Undefined for any key no declared theme builds.
+ */
+declare function registryKeyMode(key: string, themes: readonly UIThemeDefinition[]): ResolvedMode | undefined;
+/** The declared theme and mode a registry key was built from, or undefined. */
+declare function registryKeyTheme(key: string, themes: readonly UIThemeDefinition[]): {
+    theme: UIThemeDefinition;
+    mode: ResolvedMode;
+} | undefined;
+declare function themeHasMode(theme: UIThemeDefinition, mode: ResolvedMode): boolean;
+/** The color mode in effect at this point of the tree: a pinned orbital theme's, else the document's. */
+declare function useScopedMode(): ResolvedMode;
 interface ThemeProviderProps {
     children: React__default.ReactNode;
     /** Available themes (will be merged with built-in themes) */
@@ -213,4 +227,4 @@ declare function ArbitraryClassCompilerProvider({ compile, children }: Arbitrary
 declare function resetArbitraryClassStyles(): void;
 declare function useArbitraryClassStyles(schema: OrbitalSchema | null | undefined): void;
 
-export { ARBITRARY_CLASS_STYLE_ID as A, type ColorMode as C, type DesignTheme as D, OrbitalThemeProvider as O, type ResolvedMode as R, ThemeContext as T, type UIThemeDefinition as U, type ArbitraryClassCompiler as a, ArbitraryClassCompilerProvider as b, type ArbitraryClassCompilerProviderProps as c, CurrentPagePathContext as d, CurrentPagePathProvider as e, type CurrentPagePathProviderProps as f, DesignThemeProvider as g, type OrbitalThemeProviderProps as h, ThemeProvider as i, type ThemeProviderProps as j, type ThemeScope as k, ThemeScopeContext as l, useCurrentPagePath as m, useDesignTheme as n, useTheme as o, useThemeScope as p, resetArbitraryClassStyles as r, useArbitraryClassStyles as u };
+export { ARBITRARY_CLASS_STYLE_ID as A, type ColorMode as C, type DesignTheme as D, OrbitalThemeProvider as O, type ResolvedMode as R, ThemeContext as T, type UIThemeDefinition as U, type ArbitraryClassCompiler as a, ArbitraryClassCompilerProvider as b, type ArbitraryClassCompilerProviderProps as c, CurrentPagePathContext as d, CurrentPagePathProvider as e, type CurrentPagePathProviderProps as f, DesignThemeProvider as g, type OrbitalThemeProviderProps as h, ThemeProvider as i, type ThemeProviderProps as j, type ThemeScope as k, ThemeScopeContext as l, registryKeyTheme as m, useCurrentPagePath as n, useDesignTheme as o, useScopedMode as p, useTheme as q, registryKeyMode as r, useThemeScope as s, themeHasMode as t, useArbitraryClassStyles as u, resetArbitraryClassStyles as v };

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

@@ -1,8 +1,27 @@
 import React__default from 'react';
 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 { T as TraitLevelData, F as FieldInfo, O as OrbitalTraitInfo, a as OrbitalPageInfo, E as ExternalLink } from './avl-schema-parser-CH1QoZw1.js';
 import { Node, Edge } from '@xyflow/react';
 
+/**
+ * Author-supplied explanations for AVL diagrams: a note per state, per
+ * transition event and per effect type, shown in a popover on hover/focus.
+ */
+interface AvlNote {
+    /** Short heading. */
+    title?: string;
+    /** The explanation. */
+    body: string;
+}
+interface AvlAnnotations {
+    /** Keyed by state name. */
+    states?: Record<string, AvlNote>;
+    /** Keyed by transition event. */
+    transitions?: Record<string, AvlNote>;
+    /** Keyed by effect type (e.g. `persist`). */
+    effects?: Record<string, AvlNote>;
+}
+
 /**
  * AvlStateMachine — the one state-machine renderer: a trait's states and
  * transitions laid out left→right (ELK), themed entirely through tokens, with
@@ -50,6 +69,10 @@ interface AvlStateMachineProps extends A11yProps {
     direction?: 'ltr' | 'rtl';
     /** Show the trait header (name, entity, listens/emits). @default true */
     showHeader?: boolean;
+    /** Author explanations shown in a popover on hover: a note per state name, per transition event and per effect type.
+     * @example {"states":{"pending":{"title":"Unpaid","body":"Every order starts here."}},"transitions":{"PAY":{"body":"Only fires when the amount is positive."}},"effects":{"persist":{"body":"Saves the order."}}}
+     */
+    annotations?: AvlAnnotations;
     className?: string;
 }
 declare const AvlStateMachine: React__default.FC<AvlStateMachineProps>;
@@ -110,6 +133,10 @@ interface ModuleCardProps extends Omit<React__default.AriaAttributes, keyof A11y
      * @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"}]}
      */
     data: AvlNodeData;
+    /** Author explanations per trait name (states, transition events, effect types), shown in a popover on hover.
+     * @example {"OrderFlow":{"states":{"saving":{"body":"Waiting for the server to confirm."}},"effects":{"persist":{"body":"Saves the order."}}}}
+     */
+    annotations?: Record<string, AvlAnnotations>;
 }
 /**
  * Self-contained ModuleCard. The connection `<Handle>`s need the ReactFlow store,
@@ -221,4 +248,4 @@ interface FileTreeProps extends Omit<React__default.AriaAttributes, keyof A11yPr
 }
 declare const FileTree: React__default.FC<FileTreeProps>;
 
-export { type AvlNodeData as A, BehaviorView as B, type FileTreeItem as F, ModuleCard as M, type AvlEdgeData as a, AvlStateMachine as b, type AvlStateMachineProps as c, type BehaviorViewProps as d, FileTree as e, type FileTreeNode as f, type FileTreeProps as g, type ModuleCardProps as h, schemaToFlowGraph as s };
+export { type AvlAnnotations as A, BehaviorView as B, type FileTreeItem as F, ModuleCard as M, type AvlNodeData as a, type AvlNote as b, type AvlEdgeData as c, AvlStateMachine as d, type AvlStateMachineProps as e, type BehaviorViewProps as f, FileTree as g, type FileTreeNode as h, type FileTreeProps as i, type ModuleCardProps as j, schemaToFlowGraph as s };

package/dist/Typography-LZTP72Y4.js

@@ -0,0 +1,5 @@
+export { Typography } from './chunk-4ZGXIW3B.js';
+import './chunk-64WACXM7.js';
+import './chunk-723MJUU3.js';
+import './chunk-LZRW6GXG.js';
+import './chunk-QPXIAUJD.js';

package/dist/{UISlotRenderer-QTHFT6Z4.js → UISlotRenderer-NCGDIXN4.js}

@@ -1,14 +1,14 @@
-export { SlotContainedContext, SlotContentRenderer, SuspenseConfigProvider, UISlotComponent, UISlotRenderer, renderPatternValue } from './chunk-XZKGRSIO.js';
-import './chunk-Y53Q55H5.js';
-import './chunk-HCSJHRC4.js';
-import './chunk-JRW33U35.js';
+export { SlotContainedContext, SlotContentRenderer, SuspenseConfigProvider, UISlotComponent, UISlotRenderer, renderPatternValue } from './chunk-PYJ2UQWM.js';
+import './chunk-HA7CJWQX.js';
+import './chunk-4ZGXIW3B.js';
+import './chunk-I5QOYW2Z.js';
 import './chunk-XJTHMW4G.js';
-import './chunk-6EV3OEBQ.js';
-import './chunk-KQXXO42S.js';
+import './chunk-CHNC4UYE.js';
+import './chunk-KJGVLXEN.js';
 import './chunk-Q47ZN2DW.js';
 import './chunk-64WACXM7.js';
-import './chunk-RNY5LJXJ.js';
-import './chunk-HRCR53OW.js';
+import './chunk-723MJUU3.js';
+import './chunk-LZRW6GXG.js';
 import './chunk-PQKU62LK.js';
 import './chunk-PEST66PN.js';
 import './chunk-QPXIAUJD.js';