aeon-ui-engine 1.0.2 → 1.0.3

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

@@ -0,0 +1,49 @@
+// src/machines/dialog.ts
+import { assign, setup } from "xstate";
+var dialogMachine = setup({
+  types: {
+    context: {},
+    events: {},
+    input: {}
+  },
+  actions: {
+    markOpen: assign({ open: true }),
+    markClosed: assign({ open: false }),
+    toggleOpen: assign({ open: ({ context }) => !context.open }),
+    setOpen: assign({
+      open: ({ event }) => event.type === "SET_OPEN" ? event.open : false
+    })
+  }
+}).createMachine({
+  id: "dialog",
+  context: ({ input }) => ({
+    open: input.open ?? false
+  }),
+  initial: "closed",
+  states: {
+    closed: {
+      on: {
+        OPEN: { target: "open", actions: "markOpen" },
+        TOGGLE: { target: "open", actions: "markOpen" },
+        SET_OPEN: [
+          { target: "open", actions: "markOpen", guard: ({ event }) => event.open }
+        ]
+      }
+    },
+    open: {
+      on: {
+        CLOSE: { target: "closed", actions: "markClosed" },
+        ESCAPE: { target: "closed", actions: "markClosed" },
+        POINTER_DOWN_OUTSIDE: { target: "closed", actions: "markClosed" },
+        TOGGLE: { target: "closed", actions: "markClosed" },
+        SET_OPEN: [
+          { target: "closed", actions: "markClosed", guard: ({ event }) => !event.open }
+        ]
+      }
+    }
+  }
+});
+
+export {
+  dialogMachine
+};

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

@@ -0,0 +1,56 @@
+// src/machines/button.ts
+import { setup } from "xstate";
+var BUTTON_LIFECYCLE_STATES = [
+  "idle",
+  "pending",
+  "success",
+  "failure",
+  "disabled"
+];
+var buttonLifecycleMachine = setup({
+  types: {
+    events: {}
+  }
+}).createMachine({
+  id: "buttonLifecycle",
+  initial: "idle",
+  states: {
+    idle: {
+      on: {
+        PRESS: "pending",
+        DISABLE: "disabled"
+      }
+    },
+    pending: {
+      on: {
+        SUCCEED: "success",
+        FAIL: "failure",
+        DISABLE: "disabled"
+      }
+    },
+    success: {
+      on: {
+        RESET: "idle",
+        PRESS: "pending",
+        DISABLE: "disabled"
+      }
+    },
+    failure: {
+      on: {
+        RESET: "idle",
+        PRESS: "pending",
+        DISABLE: "disabled"
+      }
+    },
+    disabled: {
+      on: {
+        ENABLE: "idle"
+      }
+    }
+  }
+});
+
+export {
+  BUTTON_LIFECYCLE_STATES,
+  buttonLifecycleMachine
+};

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

@@ -0,0 +1,74 @@
+// src/machines/field.ts
+import { setup } from "xstate";
+var FIELD_INTERACTION_STATES = ["pristine", "dirty"];
+var FIELD_VALIDATION_STATES = ["valid", "invalid"];
+var FIELD_SUBMISSION_STATES = ["idle", "pending"];
+var fieldMachine = setup({
+  types: {
+    events: {}
+  }
+}).createMachine({
+  id: "field",
+  type: "parallel",
+  states: {
+    interaction: {
+      initial: "pristine",
+      states: {
+        pristine: {
+          on: {
+            INPUT: "dirty",
+            BLUR: "dirty"
+          }
+        },
+        dirty: {
+          on: {
+            RESET: "pristine"
+          }
+        }
+      }
+    },
+    validation: {
+      initial: "valid",
+      states: {
+        valid: {
+          on: {
+            VALIDATE: [
+              { target: "invalid", guard: ({ event }) => event.type === "VALIDATE" && !event.valid }
+            ]
+          }
+        },
+        invalid: {
+          on: {
+            VALIDATE: [
+              { target: "valid", guard: ({ event }) => event.type === "VALIDATE" && event.valid }
+            ],
+            RESET: "valid"
+          }
+        }
+      }
+    },
+    submission: {
+      initial: "idle",
+      states: {
+        idle: {
+          on: {
+            SUBMIT: "pending"
+          }
+        },
+        pending: {
+          on: {
+            SUBMIT_DONE: "idle",
+            SUBMIT_FAIL: "idle"
+          }
+        }
+      }
+    }
+  }
+});
+
+export {
+  FIELD_INTERACTION_STATES,
+  FIELD_VALIDATION_STATES,
+  FIELD_SUBMISSION_STATES,
+  fieldMachine
+};

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

@@ -0,0 +1,11 @@
+export { ToggleContext, ToggleEvent, toggleMachine } from './machines/toggle.js';
+export { DialogContext, DialogEvent, dialogMachine } from './machines/dialog.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';
+export { BUTTON_LIFECYCLE_STATES, ButtonLifecycleEvent, ButtonLifecycleState, buttonLifecycleMachine } from './machines/button.js';
+export { FIELD_INTERACTION_STATES, FIELD_SUBMISSION_STATES, FIELD_VALIDATION_STATES, FieldEvent, FieldInteractionState, FieldSubmissionState, FieldValidationState, fieldMachine } from './machines/field.js';
+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';
+import 'xstate';

package/packages/primitives/dist/index.js

@@ -0,0 +1,60 @@
+import {
+  tabsMachine
+} from "./chunk-HONROWUG.js";
+import {
+  toastMachine
+} from "./chunk-5S4DIRL4.js";
+import {
+  toggleMachine
+} from "./chunk-H4KOEPYC.js";
+import {
+  accordionMachine
+} from "./chunk-JBAG5E6W.js";
+import {
+  ASYNC_LIFECYCLE_STATES,
+  asyncMachine,
+  createAsyncMachine,
+  isEmptyAsyncData
+} from "./chunk-J6JHKMVM.js";
+import {
+  BUTTON_LIFECYCLE_STATES,
+  buttonLifecycleMachine
+} from "./chunk-WVICCOQH.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 {
+  ASYNC_LIFECYCLE_STATES,
+  BUTTON_LIFECYCLE_STATES,
+  FIELD_INTERACTION_STATES,
+  FIELD_SUBMISSION_STATES,
+  FIELD_VALIDATION_STATES,
+  accordionMachine,
+  asyncMachine,
+  buttonLifecycleMachine,
+  clamp as clampSliderValue,
+  createAsyncMachine,
+  dialogMachine,
+  fieldMachine,
+  isEmptyAsyncData,
+  popoverMachine,
+  sliderMachine,
+  snap as snapSliderValue,
+  tabsMachine,
+  toastMachine,
+  toggleMachine
+};

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

@@ -0,0 +1,34 @@
+import * as xstate from 'xstate';
+
+interface AccordionContext {
+    value: string[];
+    multiple: boolean;
+    collapsible: boolean;
+}
+type AccordionEvent = {
+    type: 'TOGGLE';
+    item: string;
+} | {
+    type: 'SET_VALUE';
+    value: string[];
+};
+declare const accordionMachine: xstate.StateMachine<AccordionContext, {
+    type: "TOGGLE";
+    item: string;
+} | {
+    type: "SET_VALUE";
+    value: string[];
+}, {}, never, {
+    type: "toggle";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setValue";
+    params: xstate.NonReducibleUnknown;
+}, never, never, "managing", string, AccordionContext, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "accordion";
+    states: {
+        readonly managing: {};
+    };
+}>;
+
+export { type AccordionContext, type AccordionEvent, accordionMachine };

package/packages/primitives/dist/machines/accordion.js

@@ -0,0 +1,6 @@
+import {
+  accordionMachine
+} from "../chunk-JBAG5E6W.js";
+export {
+  accordionMachine
+};

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

@@ -0,0 +1,111 @@
+import * as xstate from 'xstate';
+
+/** Stable lifecycle states for async data regions (see STATES.md). */
+declare const ASYNC_LIFECYCLE_STATES: readonly ["idle", "loading", "success", "failure", "empty"];
+type AsyncLifecycleState = (typeof ASYNC_LIFECYCLE_STATES)[number];
+declare function isEmptyAsyncData(data: unknown): boolean;
+/**
+ * Thesis §2.1: fetch lifecycle as sequential, well-defined states.
+ * This machine models fetch lifecycle as mutually exclusive states.
+ */
+interface AsyncContext<T = unknown> {
+    data: T | null;
+    error: string | null;
+    /** Success with background refresh — style readout as `success stale` (see STATES.md). */
+    stale?: boolean;
+}
+type AsyncEvent<T = unknown> = {
+    type: 'FETCH';
+} | {
+    type: 'RESOLVE';
+    data: T;
+} | {
+    type: 'REJECT';
+    error: string;
+} | {
+    type: 'RESET';
+} | {
+    type: 'STALE';
+} | {
+    type: 'REFRESH';
+};
+declare function createAsyncMachine<T = unknown>(): xstate.StateMachine<AsyncContext<T>, {
+    type: "FETCH";
+} | {
+    type: "REJECT";
+    error: string;
+} | {
+    type: "RESET";
+} | {
+    type: "STALE";
+} | {
+    type: "REFRESH";
+} | {
+    type: "RESOLVE";
+    data: T;
+}, {}, never, {
+    type: "clear";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "resolve";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "markStale";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "clearStale";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "reject";
+    params: xstate.NonReducibleUnknown;
+}, never, never, "idle" | "loading" | "success" | "failure" | "empty", string, xstate.NonReducibleUnknown, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "async";
+    states: {
+        readonly idle: {};
+        readonly loading: {};
+        readonly empty: {};
+        readonly success: {};
+        readonly failure: {};
+    };
+}>;
+declare const asyncMachine: xstate.StateMachine<AsyncContext<unknown>, {
+    type: "FETCH";
+} | {
+    type: "REJECT";
+    error: string;
+} | {
+    type: "RESET";
+} | {
+    type: "STALE";
+} | {
+    type: "REFRESH";
+} | {
+    type: "RESOLVE";
+    data: unknown;
+}, {}, never, {
+    type: "clear";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "resolve";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "markStale";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "clearStale";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "reject";
+    params: xstate.NonReducibleUnknown;
+}, never, never, "idle" | "loading" | "success" | "failure" | "empty", string, xstate.NonReducibleUnknown, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "async";
+    states: {
+        readonly idle: {};
+        readonly loading: {};
+        readonly empty: {};
+        readonly success: {};
+        readonly failure: {};
+    };
+}>;
+
+export { ASYNC_LIFECYCLE_STATES, type AsyncContext, type AsyncEvent, type AsyncLifecycleState, asyncMachine, createAsyncMachine, isEmptyAsyncData };

package/packages/primitives/dist/machines/async.js

@@ -0,0 +1,12 @@
+import {
+  ASYNC_LIFECYCLE_STATES,
+  asyncMachine,
+  createAsyncMachine,
+  isEmptyAsyncData
+} from "../chunk-J6JHKMVM.js";
+export {
+  ASYNC_LIFECYCLE_STATES,
+  asyncMachine,
+  createAsyncMachine,
+  isEmptyAsyncData
+};

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

@@ -0,0 +1,45 @@
+import * as xstate from 'xstate';
+
+declare const BUTTON_LIFECYCLE_STATES: readonly ["idle", "pending", "success", "failure", "disabled"];
+type ButtonLifecycleState = (typeof BUTTON_LIFECYCLE_STATES)[number];
+type ButtonLifecycleEvent = {
+    type: 'PRESS';
+} | {
+    type: 'SUCCEED';
+} | {
+    type: 'FAIL';
+} | {
+    type: 'RESET';
+} | {
+    type: 'DISABLE';
+} | {
+    type: 'ENABLE';
+};
+/**
+ * Submit / action button lifecycle — idle → pending → success | failure.
+ * Use for controls that represent an in-flight operation, not mere `disabled`.
+ */
+declare const buttonLifecycleMachine: xstate.StateMachine<xstate.MachineContext, {
+    type: "PRESS";
+} | {
+    type: "SUCCEED";
+} | {
+    type: "FAIL";
+} | {
+    type: "RESET";
+} | {
+    type: "DISABLE";
+} | {
+    type: "ENABLE";
+}, {}, never, never, never, never, "disabled" | "idle" | "success" | "failure" | "pending", string, xstate.NonReducibleUnknown, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "buttonLifecycle";
+    states: {
+        readonly idle: {};
+        readonly pending: {};
+        readonly success: {};
+        readonly failure: {};
+        readonly disabled: {};
+    };
+}>;
+
+export { BUTTON_LIFECYCLE_STATES, type ButtonLifecycleEvent, type ButtonLifecycleState, buttonLifecycleMachine };

package/packages/primitives/dist/machines/button.js

@@ -0,0 +1,8 @@
+import {
+  BUTTON_LIFECYCLE_STATES,
+  buttonLifecycleMachine
+} from "../chunk-WVICCOQH.js";
+export {
+  BUTTON_LIFECYCLE_STATES,
+  buttonLifecycleMachine
+};

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

@@ -0,0 +1,57 @@
+import * as xstate from 'xstate';
+
+interface DialogContext {
+    open: boolean;
+}
+type DialogEvent = {
+    type: 'OPEN';
+} | {
+    type: 'CLOSE';
+} | {
+    type: 'TOGGLE';
+} | {
+    type: 'SET_OPEN';
+    open: boolean;
+} | {
+    type: 'ESCAPE';
+} | {
+    type: 'POINTER_DOWN_OUTSIDE';
+};
+/**
+ * Dialog visibility is a single orthogonal region: closed | open.
+ * Open and closed are distinct, stable states.
+ */
+declare const dialogMachine: xstate.StateMachine<DialogContext, {
+    type: "OPEN";
+} | {
+    type: "CLOSE";
+} | {
+    type: "TOGGLE";
+} | {
+    type: "SET_OPEN";
+    open: boolean;
+} | {
+    type: "ESCAPE";
+} | {
+    type: "POINTER_DOWN_OUTSIDE";
+}, {}, never, {
+    type: "markOpen";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "markClosed";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "toggleOpen";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setOpen";
+    params: xstate.NonReducibleUnknown;
+}, never, never, "open" | "closed", string, DialogContext, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "dialog";
+    states: {
+        readonly closed: {};
+        readonly open: {};
+    };
+}>;
+
+export { type DialogContext, type DialogEvent, dialogMachine };

package/packages/primitives/dist/machines/dialog.js

@@ -0,0 +1,6 @@
+import {
+  dialogMachine
+} from "../chunk-SZV6KGXN.js";
+export {
+  dialogMachine
+};

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

@@ -0,0 +1,72 @@
+import * as xstate from 'xstate';
+
+declare const FIELD_INTERACTION_STATES: readonly ["pristine", "dirty"];
+declare const FIELD_VALIDATION_STATES: readonly ["valid", "invalid"];
+declare const FIELD_SUBMISSION_STATES: readonly ["idle", "pending"];
+type FieldInteractionState = (typeof FIELD_INTERACTION_STATES)[number];
+type FieldValidationState = (typeof FIELD_VALIDATION_STATES)[number];
+type FieldSubmissionState = (typeof FIELD_SUBMISSION_STATES)[number];
+type FieldEvent = {
+    type: 'INPUT';
+} | {
+    type: 'BLUR';
+} | {
+    type: 'VALIDATE';
+    valid: boolean;
+} | {
+    type: 'SUBMIT';
+} | {
+    type: 'SUBMIT_DONE';
+} | {
+    type: 'SUBMIT_FAIL';
+} | {
+    type: 'RESET';
+};
+/**
+ * Orthogonal field regions — interaction, validation, and submission evolve independently.
+ * Snapshot value is nested; flatten with `stateToAttr` for `data-aeon-state`.
+ */
+declare const fieldMachine: xstate.StateMachine<xstate.MachineContext, {
+    type: "INPUT";
+} | {
+    type: "BLUR";
+} | {
+    type: "VALIDATE";
+    valid: boolean;
+} | {
+    type: "SUBMIT";
+} | {
+    type: "SUBMIT_DONE";
+} | {
+    type: "SUBMIT_FAIL";
+} | {
+    type: "RESET";
+}, {}, never, never, never, never, {
+    interaction: "pristine" | "dirty";
+    validation: "valid" | "invalid";
+    submission: "idle" | "pending";
+}, string, xstate.NonReducibleUnknown, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "field";
+    states: {
+        readonly interaction: {
+            states: {
+                readonly pristine: {};
+                readonly dirty: {};
+            };
+        };
+        readonly validation: {
+            states: {
+                readonly valid: {};
+                readonly invalid: {};
+            };
+        };
+        readonly submission: {
+            states: {
+                readonly idle: {};
+                readonly pending: {};
+            };
+        };
+    };
+}>;
+
+export { FIELD_INTERACTION_STATES, FIELD_SUBMISSION_STATES, FIELD_VALIDATION_STATES, type FieldEvent, type FieldInteractionState, type FieldSubmissionState, type FieldValidationState, fieldMachine };

package/packages/primitives/dist/machines/field.js

@@ -0,0 +1,12 @@
+import {
+  FIELD_INTERACTION_STATES,
+  FIELD_SUBMISSION_STATES,
+  FIELD_VALIDATION_STATES,
+  fieldMachine
+} from "../chunk-ZMGRX64G.js";
+export {
+  FIELD_INTERACTION_STATES,
+  FIELD_SUBMISSION_STATES,
+  FIELD_VALIDATION_STATES,
+  fieldMachine
+};

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

@@ -0,0 +1,54 @@
+import * as xstate from 'xstate';
+
+interface PopoverContext {
+    open: boolean;
+}
+type PopoverEvent = {
+    type: 'OPEN';
+} | {
+    type: 'CLOSE';
+} | {
+    type: 'TOGGLE';
+} | {
+    type: 'SET_OPEN';
+    open: boolean;
+} | {
+    type: 'ESCAPE';
+} | {
+    type: 'POINTER_DOWN_OUTSIDE';
+};
+/** Floating surface: menu, popover, select listbox — closed | open. */
+declare const popoverMachine: xstate.StateMachine<PopoverContext, {
+    type: "OPEN";
+} | {
+    type: "CLOSE";
+} | {
+    type: "TOGGLE";
+} | {
+    type: "SET_OPEN";
+    open: boolean;
+} | {
+    type: "ESCAPE";
+} | {
+    type: "POINTER_DOWN_OUTSIDE";
+}, {}, never, {
+    type: "markOpen";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "markClosed";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "toggleOpen";
+    params: xstate.NonReducibleUnknown;
+} | {
+    type: "setOpen";
+    params: xstate.NonReducibleUnknown;
+}, never, never, "open" | "closed", string, PopoverContext, xstate.NonReducibleUnknown, xstate.EventObject, xstate.MetaObject, {
+    id: "popover";
+    states: {
+        readonly closed: {};
+        readonly open: {};
+    };
+}>;
+
+export { type PopoverContext, type PopoverEvent, popoverMachine };

package/packages/primitives/dist/machines/popover.js

@@ -0,0 +1,6 @@
+import {
+  popoverMachine
+} from "../chunk-LVNCD5F2.js";
+export {
+  popoverMachine
+};