aeon-ui-engine 1.0.3 → 1.2.0

package/packages/primitives/dist/chunk-4NOKRUSG.js

@@ -0,0 +1,81 @@
+// src/machines/app-nav.ts
+import { assign, setup } from "xstate";
+function appNavDepth(ctx) {
+  return ctx.stack.length;
+}
+function appNavChild(ctx) {
+  return ctx.stack.length ? ctx.stack[ctx.stack.length - 1] : null;
+}
+function appNavStateAttr(ctx) {
+  const child = appNavChild(ctx);
+  return child ? `${ctx.section}/${child.type}` : ctx.section;
+}
+var appNavMachine = setup({
+  types: {
+    context: {},
+    events: {},
+    input: {}
+  },
+  actions: {
+    setSection: assign({
+      section: ({ event }) => event.type === "SET_SECTION" ? event.section : "",
+      stack: []
+    }),
+    push: assign({
+      stack: ({ context, event }) => event.type === "PUSH" ? [...context.stack, event.child] : context.stack
+    }),
+    replace: assign({
+      stack: ({ context, event }) => {
+        if (event.type !== "REPLACE") return context.stack;
+        if (!context.stack.length) return [event.child];
+        return [...context.stack.slice(0, -1), event.child];
+      }
+    }),
+    pop: assign({
+      stack: ({ context }) => context.stack.slice(0, -1)
+    }),
+    popTo: assign({
+      stack: ({ context, event }) => {
+        if (event.type !== "POP_TO") return context.stack;
+        const idx = context.stack.findIndex((c) => c.id === event.id);
+        if (idx < 0) return context.stack;
+        return context.stack.slice(0, idx + 1);
+      }
+    }),
+    clear: assign({ stack: [] }),
+    reset: assign({
+      section: ({ event }) => event.type === "RESET" ? event.section : "",
+      stack: []
+    })
+  },
+  guards: {
+    canPop: ({ context }) => context.stack.length > 0
+  }
+}).createMachine({
+  id: "appNav",
+  context: ({ input }) => ({
+    section: input?.section ?? "home",
+    stack: input?.stack ?? []
+  }),
+  initial: "ready",
+  states: {
+    ready: {
+      on: {
+        SET_SECTION: { actions: "setSection" },
+        PUSH: { actions: "push" },
+        REPLACE: { actions: "replace" },
+        POP: { guard: "canPop", actions: "pop" },
+        POP_TO: { actions: "popTo" },
+        CLEAR: { actions: "clear" },
+        RESET: { actions: "reset" }
+      }
+    }
+  }
+});
+
+export {
+  appNavDepth,
+  appNavChild,
+  appNavStateAttr,
+  appNavMachine
+};

package/packages/primitives/dist/chunk-R25CUHNF.js

@@ -0,0 +1,46 @@
+// src/machines/app-shell.ts
+import { assign, setup } from "xstate";
+var APP_SHELL_STATES = ["idle", "overlayOpen"];
+var appShellMachine = setup({
+  types: {
+    context: {},
+    events: {},
+    input: {}
+  },
+  actions: {
+    showDock: assign({ dockVisible: true }),
+    hideDock: assign({ dockVisible: false }),
+    setDock: assign({
+      dockVisible: ({ event }) => event.type === "SET_DOCK" ? event.visible : true
+    })
+  }
+}).createMachine({
+  id: "appShell",
+  context: ({ input }) => ({
+    dockVisible: input?.dockVisible ?? true
+  }),
+  initial: "idle",
+  states: {
+    idle: {
+      on: {
+        OPEN_OVERLAY: "overlayOpen",
+        SHOW_DOCK: { actions: "showDock" },
+        HIDE_DOCK: { actions: "hideDock" },
+        SET_DOCK: { actions: "setDock" }
+      }
+    },
+    overlayOpen: {
+      on: {
+        CLOSE_OVERLAY: "idle",
+        SHOW_DOCK: { actions: "showDock" },
+        HIDE_DOCK: { actions: "hideDock" },
+        SET_DOCK: { actions: "setDock" }
+      }
+    }
+  }
+});
+
+export {
+  APP_SHELL_STATES,
+  appShellMachine
+};

package/packages/primitives/dist/chunk-RO2DMFN5.js

@@ -0,0 +1,89 @@
+// src/machines/content-region.ts
+import { assign, setup } from "xstate";
+var CONTENT_REGION_STATES = [
+  "idle",
+  "pending",
+  "empty",
+  "error",
+  "ready",
+  "loadingMore",
+  "success"
+];
+var contentRegionMachine = setup({
+  types: {
+    context: {},
+    events: {},
+    input: {}
+  },
+  actions: {
+    clearError: assign({ error: null }),
+    setError: assign({
+      error: ({ event }) => event.type === "REJECT" ? event.error : null
+    })
+  }
+}).createMachine({
+  id: "contentRegion",
+  context: ({ input }) => ({
+    error: input?.error ?? null
+  }),
+  initial: "idle",
+  states: {
+    idle: {
+      on: {
+        LOAD: { target: "pending", actions: "clearError" },
+        RESET: { actions: "clearError" }
+      }
+    },
+    pending: {
+      on: {
+        RESOLVE: [
+          { target: "empty", guard: ({ event }) => Boolean(event.empty) },
+          { target: "ready" }
+        ],
+        REJECT: { target: "error", actions: "setError" }
+      }
+    },
+    empty: {
+      on: {
+        LOAD: { target: "pending", actions: "clearError" },
+        RETRY: { target: "pending", actions: "clearError" },
+        RESET: { target: "idle", actions: "clearError" }
+      }
+    },
+    error: {
+      on: {
+        RETRY: { target: "pending", actions: "clearError" },
+        LOAD: { target: "pending", actions: "clearError" },
+        RESET: { target: "idle", actions: "clearError" }
+      }
+    },
+    ready: {
+      on: {
+        LOAD: { target: "pending", actions: "clearError" },
+        LOAD_MORE: "loadingMore",
+        SUCCEED: "success",
+        RESET: { target: "idle", actions: "clearError" }
+      }
+    },
+    loadingMore: {
+      on: {
+        MORE_DONE: [
+          { target: "ready", guard: ({ event }) => !event.empty },
+          { target: "ready" }
+        ],
+        REJECT: { target: "error", actions: "setError" }
+      }
+    },
+    success: {
+      on: {
+        LOAD: { target: "pending", actions: "clearError" },
+        RESET: { target: "idle", actions: "clearError" }
+      }
+    }
+  }
+});
+
+export {
+  CONTENT_REGION_STATES,
+  contentRegionMachine
+};

package/packages/primitives/dist/chunk-V5D7LS4J.js

@@ -0,0 +1,61 @@
+// src/machines/panel.ts
+import { assign, setup } from "xstate";
+var panelMachine = setup({
+  types: {
+    context: {},
+    events: {},
+    input: {}
+  },
+  actions: {
+    markExpanded: assign({ expanded: true }),
+    markCollapsed: assign({ expanded: false }),
+    toggleExpanded: assign({ expanded: ({ context }) => !context.expanded }),
+    setExpanded: assign({
+      expanded: ({ event }) => event.type === "SET_EXPANDED" ? event.expanded : true
+    })
+  }
+}).createMachine({
+  id: "panel",
+  context: ({ input }) => ({
+    expanded: input.expanded ?? true
+  }),
+  initial: "resolve",
+  states: {
+    resolve: {
+      always: [
+        { target: "collapsed", guard: ({ context }) => !context.expanded },
+        { target: "expanded" }
+      ]
+    },
+    expanded: {
+      on: {
+        COLLAPSE: { target: "collapsed", actions: "markCollapsed" },
+        TOGGLE: { target: "collapsed", actions: "markCollapsed" },
+        SET_EXPANDED: [
+          {
+            target: "collapsed",
+            actions: "markCollapsed",
+            guard: ({ event }) => !event.expanded
+          }
+        ]
+      }
+    },
+    collapsed: {
+      on: {
+        EXPAND: { target: "expanded", actions: "markExpanded" },
+        TOGGLE: { target: "expanded", actions: "markExpanded" },
+        SET_EXPANDED: [
+          {
+            target: "expanded",
+            actions: "markExpanded",
+            guard: ({ event }) => event.expanded
+          }
+        ]
+      }
+    }
+  }
+});
+
+export {
+  panelMachine
+};

package/packages/primitives/dist/chunk-YBPNI2LI.js

@@ -0,0 +1,70 @@
+// src/machines/sticky-bar.ts
+import { assign, setup } from "xstate";
+var STICKY_BAR_STATES = ["floating", "docked", "collapsed", "hidden"];
+var stickyBarMachine = setup({
+  types: {
+    context: {},
+    events: {},
+    input: {}
+  },
+  actions: {
+    setOffset: assign({
+      offsetPx: ({ event }) => event.type === "SET_OFFSET" ? event.offsetPx : 0
+    })
+  }
+}).createMachine({
+  id: "stickyBar",
+  context: ({ input }) => ({
+    offsetPx: input?.offsetPx ?? 0,
+    initial: input?.initial ?? "floating"
+  }),
+  initial: "resolve",
+  states: {
+    resolve: {
+      always: [
+        { target: "docked", guard: ({ context }) => context.initial === "docked" },
+        { target: "collapsed", guard: ({ context }) => context.initial === "collapsed" },
+        { target: "hidden", guard: ({ context }) => context.initial === "hidden" },
+        { target: "floating" }
+      ]
+    },
+    floating: {
+      on: {
+        DOCK: "docked",
+        COLLAPSE: "collapsed",
+        HIDE: "hidden",
+        SET_OFFSET: { actions: "setOffset" }
+      }
+    },
+    docked: {
+      on: {
+        FLOAT: "floating",
+        COLLAPSE: "collapsed",
+        HIDE: "hidden",
+        SET_OFFSET: { actions: "setOffset" }
+      }
+    },
+    collapsed: {
+      on: {
+        EXPAND: "floating",
+        DOCK: "docked",
+        FLOAT: "floating",
+        HIDE: "hidden",
+        SET_OFFSET: { actions: "setOffset" }
+      }
+    },
+    hidden: {
+      on: {
+        SHOW: "floating",
+        DOCK: "docked",
+        FLOAT: "floating",
+        SET_OFFSET: { actions: "setOffset" }
+      }
+    }
+  }
+});
+
+export {
+  STICKY_BAR_STATES,
+  stickyBarMachine
+};

package/packages/primitives/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { ToggleContext, ToggleEvent, toggleMachine } from './machines/toggle.js';
 export { DialogContext, DialogEvent, dialogMachine } from './machines/dialog.js';
+export { PanelContext, PanelEvent, panelMachine } from './machines/panel.js';
 export { TabsContext, TabsEvent, tabsMachine } from './machines/tabs.js';
 export { AccordionContext, AccordionEvent, accordionMachine } from './machines/accordion.js';
 export { ASYNC_LIFECYCLE_STATES, AsyncContext, AsyncEvent, AsyncLifecycleState, asyncMachine, createAsyncMachine, isEmptyAsyncData } from './machines/async.js';
@@ -8,4 +9,8 @@ export { FIELD_INTERACTION_STATES, FIELD_SUBMISSION_STATES, FIELD_VALIDATION_STA
 export { PopoverContext, PopoverEvent, popoverMachine } from './machines/popover.js';
 export { ToastContext, ToastEvent, toastMachine } from './machines/toast.js';
 export { SliderContext, SliderEvent, clampSliderValue, sliderMachine, snapSliderValue } from './machines/slider.js';
+export { APP_SHELL_STATES, AppShellContext, AppShellEvent, AppShellState, appShellMachine } from './machines/app-shell.js';
+export { AppNavChild, AppNavContext, AppNavEvent, appNavChild, appNavDepth, appNavMachine, appNavStateAttr } from './machines/app-nav.js';
+export { STICKY_BAR_STATES, StickyBarContext, StickyBarEvent, StickyBarState, stickyBarMachine } from './machines/sticky-bar.js';
+export { CONTENT_REGION_STATES, ContentRegionContext, ContentRegionEvent, ContentRegionState, contentRegionMachine } from './machines/content-region.js';
 import 'xstate';

package/packages/primitives/dist/index.js

@@ -1,3 +1,24 @@
+import {
+  FIELD_INTERACTION_STATES,
+  FIELD_SUBMISSION_STATES,
+  FIELD_VALIDATION_STATES,
+  fieldMachine
+} from "./chunk-ZMGRX64G.js";
+import {
+  panelMachine
+} from "./chunk-V5D7LS4J.js";
+import {
+  popoverMachine
+} from "./chunk-LVNCD5F2.js";
+import {
+  clamp,
+  sliderMachine,
+  snap
+} from "./chunk-PB3LFHXU.js";
+import {
+  STICKY_BAR_STATES,
+  stickyBarMachine
+} from "./chunk-YBPNI2LI.js";
 import {
   tabsMachine
 } from "./chunk-HONROWUG.js";
@@ -10,6 +31,16 @@ import {
 import {
   accordionMachine
 } from "./chunk-JBAG5E6W.js";
+import {
+  appNavChild,
+  appNavDepth,
+  appNavMachine,
+  appNavStateAttr
+} from "./chunk-4NOKRUSG.js";
+import {
+  APP_SHELL_STATES,
+  appShellMachine
+} from "./chunk-R25CUHNF.js";
 import {
   ASYNC_LIFECYCLE_STATES,
   asyncMachine,
@@ -20,40 +51,41 @@ import {
   BUTTON_LIFECYCLE_STATES,
   buttonLifecycleMachine
 } from "./chunk-WVICCOQH.js";
+import {
+  CONTENT_REGION_STATES,
+  contentRegionMachine
+} from "./chunk-RO2DMFN5.js";
 import {
   dialogMachine
 } from "./chunk-SZV6KGXN.js";
-import {
-  FIELD_INTERACTION_STATES,
-  FIELD_SUBMISSION_STATES,
-  FIELD_VALIDATION_STATES,
-  fieldMachine
-} from "./chunk-ZMGRX64G.js";
-import {
-  popoverMachine
-} from "./chunk-LVNCD5F2.js";
-import {
-  clamp,
-  sliderMachine,
-  snap
-} from "./chunk-PB3LFHXU.js";
 export {
+  APP_SHELL_STATES,
   ASYNC_LIFECYCLE_STATES,
   BUTTON_LIFECYCLE_STATES,
+  CONTENT_REGION_STATES,
   FIELD_INTERACTION_STATES,
   FIELD_SUBMISSION_STATES,
   FIELD_VALIDATION_STATES,
+  STICKY_BAR_STATES,
   accordionMachine,
+  appNavChild,
+  appNavDepth,
+  appNavMachine,
+  appNavStateAttr,
+  appShellMachine,
   asyncMachine,
   buttonLifecycleMachine,
   clamp as clampSliderValue,
+  contentRegionMachine,
   createAsyncMachine,
   dialogMachine,
   fieldMachine,
   isEmptyAsyncData,
+  panelMachine,
   popoverMachine,
   sliderMachine,
   snap as snapSliderValue,
+  stickyBarMachine,
   tabsMachine,
   toastMachine,
   toggleMachine

package/packages/primitives/dist/machines/app-nav.d.ts

@@ -0,0 +1,96 @@
+import * as xstate from 'xstate';
+
+/**
+ * Section + detail stack navigation — the pattern every multi-panel product
+ * reinvented (wallet sections, settings drill-in, list→detail).
+ *
+ * Not product-specific: `section` is a string id; `stack` is opaque child records.
+ */
+type AppNavChild = {
+    id: string;
+    /** Free-form type tag (e.g. "detail", "compose", "settings"). */
+    type: string;
+    /** Optional payload for the view layer. */
+    data?: unknown;
+};
+interface AppNavContext {
+    section: string;
+    stack: AppNavChild[];
+}
+type AppNavEvent = {
+    type: 'SET_SECTION';
+    section: string;
+} | {
+    type: 'PUSH';
+    child: AppNavChild;
+} | {
+    type: 'REPLACE';
+    child: AppNavChild;
+} | {
+    type: 'POP';
+} | {
+    type: 'POP_TO';
+    id: string;
+} | {
+    type: 'CLEAR';
+} | {
+    type: 'RESET';
+    section: string;
+};
+declare function appNavDepth(ctx: AppNavContext): number;
+declare function appNavChild(ctx: AppNavContext): AppNavChild | null;
+/** Projected state for data-aeon-state: `section` or `section/childType`. */
+declare function appNavStateAttr(ctx: AppNavContext): string;
+declare const appNavMachine: xstate.StateMachine<AppNavContext, {
+    type: "SET_SECTION";
+    section: string;
+} | {
+    type: "PUSH";
+    child: AppNavChild;
+} | {
+    type: "REPLACE";
+    child: AppNavChild;
+} | {
+    type: "POP";
+} | {
+    type: "POP_TO";
+    id: string;
+} | {
+    type: "CLEAR";
+} | {
+    type: "RESET";
+    section: string;
+}, {}, never, {
+    type: "replace";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "pop";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "push";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "clear";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setSection";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "popTo";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "reset";
+    params: xstate.NonReducibleUnknown;
+}, {
+    type: "canPop";
+    params: unknown;
+}, never, "ready", string, Partial<AppNavContext> & {
+    section?: string;
+}, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "appNav";
+    states: {
+        readonly ready: {};
+    };
+}>;
+
+export { type AppNavChild, type AppNavContext, type AppNavEvent, appNavChild, appNavDepth, appNavMachine, appNavStateAttr };

package/packages/primitives/dist/machines/app-nav.js

@@ -0,0 +1,12 @@
+import {
+  appNavChild,
+  appNavDepth,
+  appNavMachine,
+  appNavStateAttr
+} from "../chunk-4NOKRUSG.js";
+export {
+  appNavChild,
+  appNavDepth,
+  appNavMachine,
+  appNavStateAttr
+};

package/packages/primitives/dist/machines/app-shell.d.ts

@@ -0,0 +1,57 @@
+import * as xstate from 'xstate';
+
+declare const APP_SHELL_STATES: readonly ["idle", "overlayOpen"];
+type AppShellState = (typeof APP_SHELL_STATES)[number];
+interface AppShellContext {
+    /** Bottom (or edge) dock chrome — tab bar, action dock. */
+    dockVisible: boolean;
+}
+type AppShellEvent = {
+    type: 'OPEN_OVERLAY';
+} | {
+    type: 'CLOSE_OVERLAY';
+} | {
+    type: 'SHOW_DOCK';
+} | {
+    type: 'HIDE_DOCK';
+} | {
+    type: 'SET_DOCK';
+    visible: boolean;
+};
+/**
+ * Application chrome frame — layered top / content / dock / overlays.
+ * Reference: HandCash items-market MainLayout (content dims when overlay open).
+ *
+ * Parallel concerns:
+ * - region `chrome`: idle | overlayOpen (content inert + scrim)
+ * - context `dockVisible`: whether the edge dock is shown
+ */
+declare const appShellMachine: xstate.StateMachine<AppShellContext, {
+    type: "OPEN_OVERLAY";
+} | {
+    type: "CLOSE_OVERLAY";
+} | {
+    type: "SHOW_DOCK";
+} | {
+    type: "HIDE_DOCK";
+} | {
+    type: "SET_DOCK";
+    visible: boolean;
+}, {}, never, {
+    type: "showDock";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "hideDock";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setDock";
+    params: xstate.NonReducibleUnknown;
+}, never, never, "idle" | "overlayOpen", string, Partial<AppShellContext>, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "appShell";
+    states: {
+        readonly idle: {};
+        readonly overlayOpen: {};
+    };
+}>;
+
+export { APP_SHELL_STATES, type AppShellContext, type AppShellEvent, type AppShellState, appShellMachine };

package/packages/primitives/dist/machines/app-shell.js

@@ -0,0 +1,8 @@
+import {
+  APP_SHELL_STATES,
+  appShellMachine
+} from "../chunk-R25CUHNF.js";
+export {
+  APP_SHELL_STATES,
+  appShellMachine
+};

package/packages/primitives/dist/machines/async.d.ts

@@ -44,10 +44,10 @@ declare function createAsyncMachine<T = unknown>(): xstate.StateMachine<AsyncCon
     type: "RESOLVE";
     data: T;
 }, {}, never, {
-    type: "clear";
+    type: "resolve";
     params: xstate.NonReducibleUnknown;
 } | {
-    type: "resolve";
+    type: "clear";
     params: xstate.NonReducibleUnknown;
 } | {
     type: "markStale";
@@ -83,10 +83,10 @@ declare const asyncMachine: xstate.StateMachine<AsyncContext<unknown>, {
     type: "RESOLVE";
     data: unknown;
 }, {}, never, {
-    type: "clear";
+    type: "resolve";
     params: xstate.NonReducibleUnknown;
 } | {
-    type: "resolve";
+    type: "clear";
     params: xstate.NonReducibleUnknown;
 } | {
     type: "markStale";