@ngxsmk/cdk 3.2.0 → 3.3.0

package/fesm2022/ngxsmk-cdk-state-machine.mjs

@@ -0,0 +1,113 @@
+import { signal, computed } from '@angular/core';
+
+/**
+ * Signal-backed finite state machine for mutually exclusive UI lifecycles.
+ * Prefer over parallel booleans. For animated overlays, use {@link createPresence}.
+ *
+ * ```ts
+ * const m = createMachine({
+ *   initial: 'idle',
+ *   states: {
+ *     idle: { START: 'loading' },
+ *     loading: { SUCCESS: 'success', FAIL: 'error' },
+ *     success: { RESET: 'idle' },
+ *     error: { RESET: 'idle' },
+ *   },
+ * });
+ * m.send('START');
+ * ```
+ */
+function createMachine(config) {
+    const current = signal(config.initial);
+    const send = (event) => {
+        const from = current();
+        const next = config.states[from]?.[event];
+        if (next === undefined) {
+            return false;
+        }
+        current.set(next);
+        return true;
+    };
+    return {
+        state: current.asReadonly(),
+        send,
+        matches: (...states) => states.includes(current()),
+        can: (event) => config.states[current()]?.[event] !== undefined,
+        snapshot: () => current(),
+    };
+}
+
+/**
+ * Animated presence: `closed → open → closing → closed`.
+ * Re-open during exit cancels the pending settle (no phantom close).
+ *
+ * ```ts
+ * const presence = createPresence();
+ * presence.open();
+ * await presence.close(() => playExit(el, motion));
+ * ```
+ */
+function createPresence() {
+    const machine = createMachine({
+        initial: 'closed',
+        states: {
+            closed: { OPEN: 'open' },
+            open: { CLOSE: 'closing', OPEN: 'open' },
+            closing: { OPEN: 'open', CLOSE: 'closing', CLOSED: 'closed' },
+        },
+    });
+    let generation = 0;
+    const open = () => {
+        generation += 1;
+        machine.send('OPEN');
+    };
+    const close = async (playExit) => {
+        if (machine.matches('closed')) {
+            return true;
+        }
+        if (machine.matches('closing')) {
+            return false;
+        }
+        if (!machine.send('CLOSE')) {
+            return false;
+        }
+        const gen = (generation += 1);
+        try {
+            await playExit();
+        }
+        catch {
+            /* animation abort */
+        }
+        if (gen !== generation) {
+            return false;
+        }
+        machine.send('CLOSED');
+        return machine.matches('closed');
+    };
+    const forceClose = () => {
+        generation += 1;
+        if (machine.matches('closed')) {
+            return;
+        }
+        if (machine.matches('open')) {
+            machine.send('CLOSE');
+        }
+        machine.send('CLOSED');
+    };
+    return {
+        state: machine.state,
+        mounted: computed(() => machine.matches('open', 'closing')),
+        isClosing: computed(() => machine.matches('closing')),
+        isOpen: computed(() => machine.matches('open')),
+        open,
+        close,
+        forceClose,
+    };
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { createMachine, createPresence };
+//# sourceMappingURL=ngxsmk-cdk-state-machine.mjs.map

package/fesm2022/ngxsmk-cdk-state-machine.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngxsmk-cdk-state-machine.mjs","sources":["../../../../packages/cdk/state-machine/create-machine.ts","../../../../packages/cdk/state-machine/create-presence.ts","../../../../packages/cdk/state-machine/ngxsmk-cdk-state-machine.ts"],"sourcesContent":["import { signal, type Signal } from '@angular/core';\n\n/** Transition table: from each state, which events lead where. */\nexport type MachineTransitions<S extends string, E extends string> = Partial<\n  Record<S, Partial<Record<E, S>>>\n>;\n\nexport interface CreateMachineConfig<S extends string, E extends string> {\n  readonly initial: S;\n  readonly states: MachineTransitions<S, E>;\n}\n\nexport interface Machine<S extends string, E extends string> {\n  readonly state: Signal<S>;\n  send(event: E): boolean;\n  matches(...states: S[]): boolean;\n  can(event: E): boolean;\n  snapshot(): S;\n}\n\n/**\n * Signal-backed finite state machine for mutually exclusive UI lifecycles.\n * Prefer over parallel booleans. For animated overlays, use {@link createPresence}.\n *\n * ```ts\n * const m = createMachine({\n *   initial: 'idle',\n *   states: {\n *     idle: { START: 'loading' },\n *     loading: { SUCCESS: 'success', FAIL: 'error' },\n *     success: { RESET: 'idle' },\n *     error: { RESET: 'idle' },\n *   },\n * });\n * m.send('START');\n * ```\n */\nexport function createMachine<S extends string, E extends string>(\n  config: CreateMachineConfig<S, E>,\n): Machine<S, E> {\n  const current = signal(config.initial);\n\n  const send = (event: E): boolean => {\n    const from = current();\n    const next = config.states[from]?.[event];\n    if (next === undefined) {\n      return false;\n    }\n    current.set(next);\n    return true;\n  };\n\n  return {\n    state: current.asReadonly(),\n    send,\n    matches: (...states: S[]) => states.includes(current()),\n    can: (event: E) => config.states[current()]?.[event] !== undefined,\n    snapshot: () => current(),\n  };\n}\n\n/** Shared async UI status — prefer over parallel isLoading/isError flags. */\nexport type AsyncStatus = 'idle' | 'loading' | 'success' | 'error';\n\n/** Shared AI / tool-run status. */\nexport type AiRunStatus = 'pending' | 'running' | 'completed' | 'error' | 'cancelled';\n","import { computed, type Signal } from '@angular/core';\nimport { createMachine } from './create-machine';\n\nexport type PresenceState = 'closed' | 'open' | 'closing';\n\nexport type PresenceEvent = 'OPEN' | 'CLOSE' | 'CLOSED';\n\nexport interface PresenceController {\n  readonly state: Signal<PresenceState>;\n  readonly mounted: Signal<boolean>;\n  readonly isClosing: Signal<boolean>;\n  readonly isOpen: Signal<boolean>;\n  /** Opens and cancels any in-flight exit. */\n  open(): void;\n  /**\n   * Plays exit, then settles to `closed` only if this close was not superseded.\n   * @returns `true` when this generation settled to closed\n   */\n  close(playExit: () => Promise<void>): Promise<boolean>;\n  forceClose(): void;\n}\n\n/**\n * Animated presence: `closed → open → closing → closed`.\n * Re-open during exit cancels the pending settle (no phantom close).\n *\n * ```ts\n * const presence = createPresence();\n * presence.open();\n * await presence.close(() => playExit(el, motion));\n * ```\n */\nexport function createPresence(): PresenceController {\n  const machine = createMachine<PresenceState, PresenceEvent>({\n    initial: 'closed',\n    states: {\n      closed: { OPEN: 'open' },\n      open: { CLOSE: 'closing', OPEN: 'open' },\n      closing: { OPEN: 'open', CLOSE: 'closing', CLOSED: 'closed' },\n    },\n  });\n\n  let generation = 0;\n\n  const open = (): void => {\n    generation += 1;\n    machine.send('OPEN');\n  };\n\n  const close = async (playExit: () => Promise<void>): Promise<boolean> => {\n    if (machine.matches('closed')) {\n      return true;\n    }\n    if (machine.matches('closing')) {\n      return false;\n    }\n    if (!machine.send('CLOSE')) {\n      return false;\n    }\n    const gen = (generation += 1);\n    try {\n      await playExit();\n    } catch {\n      /* animation abort */\n    }\n    if (gen !== generation) {\n      return false;\n    }\n    machine.send('CLOSED');\n    return machine.matches('closed');\n  };\n\n  const forceClose = (): void => {\n    generation += 1;\n    if (machine.matches('closed')) {\n      return;\n    }\n    if (machine.matches('open')) {\n      machine.send('CLOSE');\n    }\n    machine.send('CLOSED');\n  };\n\n  return {\n    state: machine.state,\n    mounted: computed(() => machine.matches('open', 'closing')),\n    isClosing: computed(() => machine.matches('closing')),\n    isOpen: computed(() => machine.matches('open')),\n    open,\n    close,\n    forceClose,\n  };\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/ngxsmk-cdk-testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngxsmk-cdk-testing.mjs","sources":["../../../../packages/cdk/testing/a11y.ts","../../../../packages/cdk/testing/ngxsmk-cdk-testing.ts"],"sourcesContent":["import * as axe from 'axe-core';\n\n/**\n * Runs axe-core analysis on the provided HTML element and throws an error if any accessibility\n * violations are detected.\n *\n * Pass axe `options` to tune the run — e.g. in jsdom-based tests disable the\n * `color-contrast` rule, which requires a real rendering engine.\n */\nexport async function expectNoA11yViolations(\n  element: HTMLElement,\n  options: axe.RunOptions = {},\n): Promise<void> {\n  const results = await axe.run(element, options);\n  if (results.violations.length > 0) {\n    const formatted = results.violations\n      .map(\n        (v) =>\n          `[${v.id}] ${v.help}\\n  - Help URL: ${v.helpUrl}\\n  - Nodes affected:\\n${v.nodes\n            .map((n) => `    * ${n.html}`)\n            .join('\\n')}`,\n      )\n      .join('\\n\\n');\n    throw new Error(`Accessibility violations detected:\\n\\n${formatted}`);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;AAEA;;;;;;AAMG;AACI,eAAe,sBAAsB,CAC1C,OAAoB,EACpB,UAA0B,EAAE,EAAA;IAE5B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;IAC/C,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE;AACjC,QAAA,MAAM,SAAS,GAAG,OAAO,CAAC;aACvB,GAAG,CACF,CAAC,CAAC,KACA,CAAA,CAAA,EAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAA,gBAAA,EAAmB,CAAC,CAAC,OAAO,CAAA,uBAAA,EAA0B,CAAC,CAAC;aACxE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAA,MAAA,EAAS,CAAC,CAAC,IAAI,CAAA,CAAE;AAC5B,aAAA,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;aAElB,IAAI,CAAC,MAAM,CAAC;AACf,QAAA,MAAM,IAAI,KAAK,CAAC,yCAAyC,SAAS,CAAA,CAAE,CAAC;IACvE;AACF;;ACzBA;;AAEG;;;;"}
+{"version":3,"file":"ngxsmk-cdk-testing.mjs","sources":["../../../../packages/cdk/testing/a11y.ts","../../../../packages/cdk/testing/ngxsmk-cdk-testing.ts"],"sourcesContent":["import * as axe from 'axe-core';\n\n/**\n * Runs axe-core analysis on the provided HTML element and throws an error if any accessibility\n * violations are detected.\n *\n * Pass axe `options` to tune the run — e.g. in jsdom-based tests disable the\n * `color-contrast` rule, which requires a real rendering engine.\n */\nexport async function expectNoA11yViolations(\n  element: HTMLElement,\n  options: axe.RunOptions = {},\n): Promise<void> {\n  const results = await axe.run(element, options);\n  if (results.violations.length > 0) {\n    const formatted = results.violations\n      .map(\n        (v) =>\n          `[${v.id}] ${v.help}\\n  - Help URL: ${v.helpUrl}\\n  - Nodes affected:\\n${v.nodes\n            .map((n) => `    * ${n.html}`)\n            .join('\\n')}`,\n      )\n      .join('\\n\\n');\n    throw new Error(`Accessibility violations detected:\\n\\n${formatted}`);\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;AAEA;;;;;;AAMG;AACI,eAAe,sBAAsB,CAC1C,OAAoB,EACpB,UAA0B,EAAE,EAAA;IAE5B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;IAC/C,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE;AACjC,QAAA,MAAM,SAAS,GAAG,OAAO,CAAC;aACvB,GAAG,CACF,CAAC,CAAC,KACA,CAAA,CAAA,EAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAA,gBAAA,EAAmB,CAAC,CAAC,OAAO,CAAA,uBAAA,EAA0B,CAAC,CAAC;aACxE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAA,MAAA,EAAS,CAAC,CAAC,IAAI,CAAA,CAAE;AAC5B,aAAA,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;aAElB,IAAI,CAAC,MAAM,CAAC;AACf,QAAA,MAAM,IAAI,KAAK,CAAC,yCAAyC,SAAS,CAAA,CAAE,CAAC;IACvE;AACF;;ACzBA;;AAEG;;"}

package/fesm2022/ngxsmk-cdk-visually-hidden.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngxsmk-cdk-visually-hidden.mjs","sources":["../../../../packages/cdk/visually-hidden/visually-hidden.ts","../../../../packages/cdk/visually-hidden/ngxsmk-cdk-visually-hidden.ts"],"sourcesContent":["import { Directive } from '@angular/core';\n\n/**\n * Hides the host visually while keeping it available to screen readers.\n *\n * ```html\n * <span ngxsmkVisuallyHidden>Opens in a new window</span>\n * ```\n */\n@Directive({\n  standalone: true,\n  selector: '[ngxsmkVisuallyHidden]',\n  host: {\n    style: `\n      position: absolute;\n      width: 1px;\n      height: 1px;\n      margin: -1px;\n      padding: 0;\n      border: 0;\n      overflow: hidden;\n      clip-path: inset(100%);\n      white-space: nowrap;\n    `,\n  },\n})\nexport class NgxsmkVisuallyHidden {}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAEA;;;;;;AAMG;MAkBU,oBAAoB,CAAA;8GAApB,oBAAoB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA,CAAA;kGAApB,oBAAoB,EAAA,YAAA,EAAA,IAAA,EAAA,QAAA,EAAA,wBAAA,EAAA,IAAA,EAAA,EAAA,cAAA,EAAA,wNAAA,EAAA,EAAA,QAAA,EAAA,EAAA,EAAA,CAAA,CAAA;;2FAApB,oBAAoB,EAAA,UAAA,EAAA,CAAA;kBAjBhC,SAAS;AAAC,YAAA,IAAA,EAAA,CAAA;AACT,oBAAA,UAAU,EAAE,IAAI;AAChB,oBAAA,QAAQ,EAAE,wBAAwB;AAClC,oBAAA,IAAI,EAAE;AACJ,wBAAA,KAAK,EAAE;;;;;;;;;;AAUN,IAAA,CAAA;AACF,qBAAA;AACF,iBAAA;;;ACzBD;;AAEG;;;;"}
+{"version":3,"file":"ngxsmk-cdk-visually-hidden.mjs","sources":["../../../../packages/cdk/visually-hidden/visually-hidden.ts","../../../../packages/cdk/visually-hidden/ngxsmk-cdk-visually-hidden.ts"],"sourcesContent":["import { Directive } from '@angular/core';\n\n/**\n * Hides the host visually while keeping it available to screen readers.\n *\n * ```html\n * <span ngxsmkVisuallyHidden>Opens in a new window</span>\n * ```\n */\n@Directive({\n  standalone: true,\n  selector: '[ngxsmkVisuallyHidden]',\n  host: {\n    style: `\n      position: absolute;\n      width: 1px;\n      height: 1px;\n      margin: -1px;\n      padding: 0;\n      border: 0;\n      overflow: hidden;\n      clip-path: inset(100%);\n      white-space: nowrap;\n    `,\n  },\n})\nexport class NgxsmkVisuallyHidden {}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAEA;;;;;;AAMG;MAkBU,oBAAoB,CAAA;8GAApB,oBAAoB,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA,CAAA;kGAApB,oBAAoB,EAAA,YAAA,EAAA,IAAA,EAAA,QAAA,EAAA,wBAAA,EAAA,IAAA,EAAA,EAAA,cAAA,EAAA,wNAAA,EAAA,EAAA,QAAA,EAAA,EAAA,EAAA,CAAA,CAAA;;2FAApB,oBAAoB,EAAA,UAAA,EAAA,CAAA;kBAjBhC,SAAS;AAAC,YAAA,IAAA,EAAA,CAAA;AACT,oBAAA,UAAU,EAAE,IAAI;AAChB,oBAAA,QAAQ,EAAE,wBAAwB;AAClC,oBAAA,IAAI,EAAE;AACJ,wBAAA,KAAK,EAAE;;;;;;;;;;AAUN,IAAA,CAAA;AACF,qBAAA;AACF,iBAAA;;;ACzBD;;AAEG;;"}

package/fesm2022/ngxsmk-cdk.mjs

@@ -10,6 +10,7 @@ export * from '@ngxsmk/cdk/resize-observer';
 export * from '@ngxsmk/cdk/autofocus';
 export * from '@ngxsmk/cdk/cva-base';
 export * from '@ngxsmk/cdk/listbox-keyboard';
+export * from '@ngxsmk/cdk/state-machine';
 export * from '@ngxsmk/cdk/scheduler';
 export { ClipboardPlugin, FilterPlugin, FormulaPlugin, SortPlugin, SpreadsheetEngine, PluginHost as SpreadsheetPluginHost, SelectionPlugin as SpreadsheetSelectionPlugin, UndoPlugin, ValidationPlugin, cellRef, cellsInRange, cloneRow, colIndexToLetter, colLetterToIndex, createEmptyRow, formatCellValue, generateRowId, isCellInRange, normalizeRange, parseCellRef, pinnedWidth } from '@ngxsmk/cdk/spreadsheet';
 export * from '@ngxsmk/cdk/input-group';

package/fesm2022/ngxsmk-cdk.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngxsmk-cdk.mjs","sources":["../../../../packages/cdk/public-api.ts","../../../../packages/cdk/ngxsmk-cdk.ts"],"sourcesContent":["/*\n * Public API Surface of @ngxsmk/cdk\n */\n\nexport * from '@ngxsmk/cdk/click-outside';\nexport * from '@ngxsmk/cdk/focusable';\nexport * from '@ngxsmk/cdk/focus-trap';\nexport * from '@ngxsmk/cdk/live-announcer';\nexport * from '@ngxsmk/cdk/media-query';\nexport * from '@ngxsmk/cdk/scroll-lock';\nexport * from '@ngxsmk/cdk/visually-hidden';\nexport * from '@ngxsmk/cdk/intersection-observer';\nexport * from '@ngxsmk/cdk/resize-observer';\nexport * from '@ngxsmk/cdk/autofocus';\nexport * from '@ngxsmk/cdk/cva-base';\nexport * from '@ngxsmk/cdk/listbox-keyboard';\nexport * from '@ngxsmk/cdk/scheduler';\n\n// Spreadsheet — selective re-exports to avoid name collisions with scheduler\nexport {\n  SpreadsheetEngine,\n  type SpreadsheetConfig,\n  type SpreadsheetDensity,\n  type SpreadsheetLifecycleHooks,\n} from '@ngxsmk/cdk/spreadsheet';\nexport type {\n  Cell,\n  CellValue,\n  CellType,\n  CellMeta,\n  CellEditState,\n  CellAddress,\n  CellRange,\n  ColumnDef,\n  ColumnState,\n  SortDirection,\n  ColumnWidthPreset,\n  RowDef,\n  RowData,\n  SummaryRow,\n  SelectionState as SpreadsheetSelectionState,\n  SelectionMode,\n  SortCriterion,\n  SortState,\n  FilterCriterion,\n  FilterOperator,\n  FilterState,\n  FormulaNode,\n  FormulaResult,\n  FormulaDependency,\n  FormulaFunction,\n} from '@ngxsmk/cdk/spreadsheet';\nexport {\n  PluginHost as SpreadsheetPluginHost,\n  SortPlugin,\n  FilterPlugin,\n  SelectionPlugin as SpreadsheetSelectionPlugin,\n  FormulaPlugin,\n  ClipboardPlugin,\n  UndoPlugin,\n  ValidationPlugin,\n  type SpreadsheetPlugin,\n} from '@ngxsmk/cdk/spreadsheet';\nexport {\n  colIndexToLetter,\n  colLetterToIndex,\n  cellRef,\n  parseCellRef,\n  normalizeRange,\n  isCellInRange,\n  cellsInRange,\n  formatCellValue,\n  createEmptyRow,\n  generateRowId,\n  cloneRow,\n  pinnedWidth,\n} from '@ngxsmk/cdk/spreadsheet';\n\n// Input Group — no naming collisions, re-export everything\nexport * from '@ngxsmk/cdk/input-group';\n\n// NOTE: '@ngxsmk/cdk/testing' is intentionally NOT re-exported here. It pulls in\n// axe-core (a CommonJS dependency) which would otherwise leak into every runtime\n// bundle that imports the main '@ngxsmk/cdk' barrel. Import test helpers directly\n// from the dedicated entry point instead: `import { ... } from '@ngxsmk/cdk/testing'`.\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;AAEG;AA+EH;AACA;AACA;AACA;;ACpFA;;AAEG"}
+{"version":3,"file":"ngxsmk-cdk.mjs","sources":["../../../../packages/cdk/public-api.ts","../../../../packages/cdk/ngxsmk-cdk.ts"],"sourcesContent":["/*\n * Public API Surface of @ngxsmk/cdk\n */\n\nexport * from '@ngxsmk/cdk/click-outside';\nexport * from '@ngxsmk/cdk/focusable';\nexport * from '@ngxsmk/cdk/focus-trap';\nexport * from '@ngxsmk/cdk/live-announcer';\nexport * from '@ngxsmk/cdk/media-query';\nexport * from '@ngxsmk/cdk/scroll-lock';\nexport * from '@ngxsmk/cdk/visually-hidden';\nexport * from '@ngxsmk/cdk/intersection-observer';\nexport * from '@ngxsmk/cdk/resize-observer';\nexport * from '@ngxsmk/cdk/autofocus';\nexport * from '@ngxsmk/cdk/cva-base';\nexport * from '@ngxsmk/cdk/listbox-keyboard';\nexport * from '@ngxsmk/cdk/state-machine';\nexport * from '@ngxsmk/cdk/scheduler';\n\n// Spreadsheet — selective re-exports to avoid name collisions with scheduler\nexport {\n  SpreadsheetEngine,\n  type SpreadsheetConfig,\n  type SpreadsheetDensity,\n  type SpreadsheetLifecycleHooks,\n} from '@ngxsmk/cdk/spreadsheet';\nexport type {\n  Cell,\n  CellValue,\n  CellType,\n  CellMeta,\n  CellEditState,\n  CellAddress,\n  CellRange,\n  ColumnDef,\n  ColumnState,\n  SortDirection,\n  ColumnWidthPreset,\n  RowDef,\n  RowData,\n  SummaryRow,\n  SelectionState as SpreadsheetSelectionState,\n  SelectionMode,\n  SortCriterion,\n  SortState,\n  FilterCriterion,\n  FilterOperator,\n  FilterState,\n  FormulaNode,\n  FormulaResult,\n  FormulaDependency,\n  FormulaFunction,\n} from '@ngxsmk/cdk/spreadsheet';\nexport {\n  PluginHost as SpreadsheetPluginHost,\n  SortPlugin,\n  FilterPlugin,\n  SelectionPlugin as SpreadsheetSelectionPlugin,\n  FormulaPlugin,\n  ClipboardPlugin,\n  UndoPlugin,\n  ValidationPlugin,\n  type SpreadsheetPlugin,\n} from '@ngxsmk/cdk/spreadsheet';\nexport {\n  colIndexToLetter,\n  colLetterToIndex,\n  cellRef,\n  parseCellRef,\n  normalizeRange,\n  isCellInRange,\n  cellsInRange,\n  formatCellValue,\n  createEmptyRow,\n  generateRowId,\n  cloneRow,\n  pinnedWidth,\n} from '@ngxsmk/cdk/spreadsheet';\n\n// Input Group — no naming collisions, re-export everything\nexport * from '@ngxsmk/cdk/input-group';\n\n// NOTE: '@ngxsmk/cdk/testing' is intentionally NOT re-exported here. It pulls in\n// axe-core (a CommonJS dependency) which would otherwise leak into every runtime\n// bundle that imports the main '@ngxsmk/cdk' barrel. Import test helpers directly\n// from the dedicated entry point instead: `import { ... } from '@ngxsmk/cdk/testing'`.\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA;;AAEG;AAgFH;AACA;AACA;AACA;;ACrFA;;AAEG"}

package/input-group/input-group-engine.d.ts

@@ -68,6 +68,7 @@ export declare class InputGroupEngine {
     readonly onValidationChange: WritableSignal<(status: ValidationStatus, message: string) => void>;
     private _config;
     private _asyncTimer;
+    private _validationGeneration;
     constructor(config?: InputGroupEngineConfig);
     setValue(value: string): void;
     clear(): void;
@@ -80,8 +81,10 @@ export declare class InputGroupEngine {
     addAddon(addon: InputGroupAddon): void;
     removeAddon(id: string): void;
     setStatus(status: ValidationStatus, message?: string): void;
+    private _clearAsyncTimer;
     private _runValidation;
     reset(): void;
+    destroy(): void;
     enable(): void;
     disable(): void;
 }

package/input-group/input-group-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-group-engine.d.ts","sourceRoot":"","sources":["../../../../packages/cdk/input-group/input-group-engine.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"input-group-engine.d.ts","sourceRoot":"","sources":["../../../../packages/cdk/input-group/input-group-engine.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngxsmk/cdk",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Low-level Angular directives and utilities (click-outside, focus-trap, media-query, scroll-lock) for @ngxsmk.",
   "keywords": [
     "angular",
@@ -22,8 +22,14 @@
     "url": "https://github.com/NGXSMK/ngxsmk-ui-kit/issues"
   },
   "peerDependencies": {
-    "@angular/common": ">=17.3.0",
-    "@angular/core": ">=17.3.0"
+    "@angular/common": ">=17.3.0 <23.0.0",
+    "@angular/core": ">=17.3.0 <23.0.0",
+    "@angular/forms": ">=17.3.0 <23.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@angular/forms": {
+      "optional": true
+    }
   },
   "dependencies": {
     "tslib": "^2.3.0"
@@ -56,23 +62,17 @@
       "esm": "./esm2022/click-outside/ngxsmk-cdk-click-outside.mjs",
       "default": "./fesm2022/ngxsmk-cdk-click-outside.mjs"
     },
-    "./cva-base": {
-      "types": "./cva-base/index.d.ts",
-      "esm2022": "./esm2022/cva-base/ngxsmk-cdk-cva-base.mjs",
-      "esm": "./esm2022/cva-base/ngxsmk-cdk-cva-base.mjs",
-      "default": "./fesm2022/ngxsmk-cdk-cva-base.mjs"
-    },
     "./input-group": {
       "types": "./input-group/index.d.ts",
       "esm2022": "./esm2022/input-group/ngxsmk-cdk-input-group.mjs",
       "esm": "./esm2022/input-group/ngxsmk-cdk-input-group.mjs",
       "default": "./fesm2022/ngxsmk-cdk-input-group.mjs"
     },
-    "./focusable": {
-      "types": "./focusable/index.d.ts",
-      "esm2022": "./esm2022/focusable/ngxsmk-cdk-focusable.mjs",
-      "esm": "./esm2022/focusable/ngxsmk-cdk-focusable.mjs",
-      "default": "./fesm2022/ngxsmk-cdk-focusable.mjs"
+    "./cva-base": {
+      "types": "./cva-base/index.d.ts",
+      "esm2022": "./esm2022/cva-base/ngxsmk-cdk-cva-base.mjs",
+      "esm": "./esm2022/cva-base/ngxsmk-cdk-cva-base.mjs",
+      "default": "./fesm2022/ngxsmk-cdk-cva-base.mjs"
     },
     "./focus-trap": {
       "types": "./focus-trap/index.d.ts",
@@ -80,11 +80,11 @@
       "esm": "./esm2022/focus-trap/ngxsmk-cdk-focus-trap.mjs",
       "default": "./fesm2022/ngxsmk-cdk-focus-trap.mjs"
     },
-    "./listbox-keyboard": {
-      "types": "./listbox-keyboard/index.d.ts",
-      "esm2022": "./esm2022/listbox-keyboard/ngxsmk-cdk-listbox-keyboard.mjs",
-      "esm": "./esm2022/listbox-keyboard/ngxsmk-cdk-listbox-keyboard.mjs",
-      "default": "./fesm2022/ngxsmk-cdk-listbox-keyboard.mjs"
+    "./focusable": {
+      "types": "./focusable/index.d.ts",
+      "esm2022": "./esm2022/focusable/ngxsmk-cdk-focusable.mjs",
+      "esm": "./esm2022/focusable/ngxsmk-cdk-focusable.mjs",
+      "default": "./fesm2022/ngxsmk-cdk-focusable.mjs"
     },
     "./intersection-observer": {
       "types": "./intersection-observer/index.d.ts",
@@ -92,6 +92,12 @@
       "esm": "./esm2022/intersection-observer/ngxsmk-cdk-intersection-observer.mjs",
       "default": "./fesm2022/ngxsmk-cdk-intersection-observer.mjs"
     },
+    "./listbox-keyboard": {
+      "types": "./listbox-keyboard/index.d.ts",
+      "esm2022": "./esm2022/listbox-keyboard/ngxsmk-cdk-listbox-keyboard.mjs",
+      "esm": "./esm2022/listbox-keyboard/ngxsmk-cdk-listbox-keyboard.mjs",
+      "default": "./fesm2022/ngxsmk-cdk-listbox-keyboard.mjs"
+    },
     "./live-announcer": {
       "types": "./live-announcer/index.d.ts",
       "esm2022": "./esm2022/live-announcer/ngxsmk-cdk-live-announcer.mjs",
@@ -110,11 +116,11 @@
       "esm": "./esm2022/resize-observer/ngxsmk-cdk-resize-observer.mjs",
       "default": "./fesm2022/ngxsmk-cdk-resize-observer.mjs"
     },
-    "./scheduler": {
-      "types": "./scheduler/index.d.ts",
-      "esm2022": "./esm2022/scheduler/ngxsmk-cdk-scheduler.mjs",
-      "esm": "./esm2022/scheduler/ngxsmk-cdk-scheduler.mjs",
-      "default": "./fesm2022/ngxsmk-cdk-scheduler.mjs"
+    "./roving-focus": {
+      "types": "./roving-focus/index.d.ts",
+      "esm2022": "./esm2022/roving-focus/ngxsmk-cdk-roving-focus.mjs",
+      "esm": "./esm2022/roving-focus/ngxsmk-cdk-roving-focus.mjs",
+      "default": "./fesm2022/ngxsmk-cdk-roving-focus.mjs"
     },
     "./skip-link": {
       "types": "./skip-link/index.d.ts",
@@ -122,11 +128,11 @@
       "esm": "./esm2022/skip-link/ngxsmk-cdk-skip-link.mjs",
       "default": "./fesm2022/ngxsmk-cdk-skip-link.mjs"
     },
-    "./roving-focus": {
-      "types": "./roving-focus/index.d.ts",
-      "esm2022": "./esm2022/roving-focus/ngxsmk-cdk-roving-focus.mjs",
-      "esm": "./esm2022/roving-focus/ngxsmk-cdk-roving-focus.mjs",
-      "default": "./fesm2022/ngxsmk-cdk-roving-focus.mjs"
+    "./scheduler": {
+      "types": "./scheduler/index.d.ts",
+      "esm2022": "./esm2022/scheduler/ngxsmk-cdk-scheduler.mjs",
+      "esm": "./esm2022/scheduler/ngxsmk-cdk-scheduler.mjs",
+      "default": "./fesm2022/ngxsmk-cdk-scheduler.mjs"
     },
     "./scroll-lock": {
       "types": "./scroll-lock/index.d.ts",
@@ -140,6 +146,12 @@
       "esm": "./esm2022/spreadsheet/ngxsmk-cdk-spreadsheet.mjs",
       "default": "./fesm2022/ngxsmk-cdk-spreadsheet.mjs"
     },
+    "./state-machine": {
+      "types": "./state-machine/index.d.ts",
+      "esm2022": "./esm2022/state-machine/ngxsmk-cdk-state-machine.mjs",
+      "esm": "./esm2022/state-machine/ngxsmk-cdk-state-machine.mjs",
+      "default": "./fesm2022/ngxsmk-cdk-state-machine.mjs"
+    },
     "./testing": {
       "types": "./testing/index.d.ts",
       "esm2022": "./esm2022/testing/ngxsmk-cdk-testing.mjs",

package/public-api.d.ts

@@ -10,6 +10,7 @@ export * from '@ngxsmk/cdk/resize-observer';
 export * from '@ngxsmk/cdk/autofocus';
 export * from '@ngxsmk/cdk/cva-base';
 export * from '@ngxsmk/cdk/listbox-keyboard';
+export * from '@ngxsmk/cdk/state-machine';
 export * from '@ngxsmk/cdk/scheduler';
 export { SpreadsheetEngine, type SpreadsheetConfig, type SpreadsheetDensity, type SpreadsheetLifecycleHooks, } from '@ngxsmk/cdk/spreadsheet';
 export type { Cell, CellValue, CellType, CellMeta, CellEditState, CellAddress, CellRange, ColumnDef, ColumnState, SortDirection, ColumnWidthPreset, RowDef, RowData, SummaryRow, SelectionState as SpreadsheetSelectionState, SelectionMode, SortCriterion, SortState, FilterCriterion, FilterOperator, FilterState, FormulaNode, FormulaResult, FormulaDependency, FormulaFunction, } from '@ngxsmk/cdk/spreadsheet';

package/public-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../../../packages/cdk/public-api.ts"],"names":[],"mappings":"AAIA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,WAAW,EACX,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,MAAM,EACN,OAAO,EACP,UAAU,EACV,cAAc,IAAI,yBAAyB,EAC3C,aAAa,EACb,aAAa,EACb,SAAS,EACT,eAAe,EACf,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,UAAU,IAAI,qBAAqB,EACnC,UAAU,EACV,YAAY,EACZ,eAAe,IAAI,0BAA0B,EAC7C,aAAa,EACb,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,QAAQ,EACR,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAGjC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../../../packages/cdk/public-api.ts"],"names":[],"mappings":"AAIA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mCAAmC,CAAC;AAClD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,WAAW,EACX,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,MAAM,EACN,OAAO,EACP,UAAU,EACV,cAAc,IAAI,yBAAyB,EAC3C,aAAa,EACb,aAAa,EACb,SAAS,EACT,eAAe,EACf,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,UAAU,IAAI,qBAAqB,EACnC,UAAU,EACV,YAAY,EACZ,eAAe,IAAI,0BAA0B,EAC7C,aAAa,EACb,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,QAAQ,EACR,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAGjC,cAAc,yBAAyB,CAAC"}

package/state-machine/create-machine.d.ts

@@ -0,0 +1,37 @@
+import { type Signal } from '@angular/core';
+/** Transition table: from each state, which events lead where. */
+export type MachineTransitions<S extends string, E extends string> = Partial<Record<S, Partial<Record<E, S>>>>;
+export interface CreateMachineConfig<S extends string, E extends string> {
+    readonly initial: S;
+    readonly states: MachineTransitions<S, E>;
+}
+export interface Machine<S extends string, E extends string> {
+    readonly state: Signal<S>;
+    send(event: E): boolean;
+    matches(...states: S[]): boolean;
+    can(event: E): boolean;
+    snapshot(): S;
+}
+/**
+ * Signal-backed finite state machine for mutually exclusive UI lifecycles.
+ * Prefer over parallel booleans. For animated overlays, use {@link createPresence}.
+ *
+ * ```ts
+ * const m = createMachine({
+ *   initial: 'idle',
+ *   states: {
+ *     idle: { START: 'loading' },
+ *     loading: { SUCCESS: 'success', FAIL: 'error' },
+ *     success: { RESET: 'idle' },
+ *     error: { RESET: 'idle' },
+ *   },
+ * });
+ * m.send('START');
+ * ```
+ */
+export declare function createMachine<S extends string, E extends string>(config: CreateMachineConfig<S, E>): Machine<S, E>;
+/** Shared async UI status — prefer over parallel isLoading/isError flags. */
+export type AsyncStatus = 'idle' | 'loading' | 'success' | 'error';
+/** Shared AI / tool-run status. */
+export type AiRunStatus = 'pending' | 'running' | 'completed' | 'error' | 'cancelled';
+//# sourceMappingURL=create-machine.d.ts.map

package/state-machine/create-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-machine.d.ts","sourceRoot":"","sources":["../../../../packages/cdk/state-machine/create-machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAEpD,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,OAAO,CAC1E,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CACjC,CAAC;AAEF,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM;IACrE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IACxB,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC;IACjC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IACvB,QAAQ,IAAI,CAAC,CAAC;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAC9D,MAAM,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAoBf;AAED,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnE,mCAAmC;AACnC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC"}

package/state-machine/create-presence.d.ts

@@ -0,0 +1,29 @@
+import { type Signal } from '@angular/core';
+export type PresenceState = 'closed' | 'open' | 'closing';
+export type PresenceEvent = 'OPEN' | 'CLOSE' | 'CLOSED';
+export interface PresenceController {
+    readonly state: Signal<PresenceState>;
+    readonly mounted: Signal<boolean>;
+    readonly isClosing: Signal<boolean>;
+    readonly isOpen: Signal<boolean>;
+    /** Opens and cancels any in-flight exit. */
+    open(): void;
+    /**
+     * Plays exit, then settles to `closed` only if this close was not superseded.
+     * @returns `true` when this generation settled to closed
+     */
+    close(playExit: () => Promise<void>): Promise<boolean>;
+    forceClose(): void;
+}
+/**
+ * Animated presence: `closed → open → closing → closed`.
+ * Re-open during exit cancels the pending settle (no phantom close).
+ *
+ * ```ts
+ * const presence = createPresence();
+ * presence.open();
+ * await presence.close(() => playExit(el, motion));
+ * ```
+ */
+export declare function createPresence(): PresenceController;
+//# sourceMappingURL=create-presence.d.ts.map

package/state-machine/create-presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-presence.d.ts","sourceRoot":"","sources":["../../../../packages/cdk/state-machine/create-presence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAGtD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,4CAA4C;IAC5C,IAAI,IAAI,IAAI,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,UAAU,IAAI,IAAI,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,kBAAkB,CA4DnD"}

package/state-machine/index.d.ts

@@ -0,0 +1,3 @@
+export { createMachine, type AiRunStatus, type AsyncStatus, type CreateMachineConfig, type Machine, type MachineTransitions, } from './create-machine';
+export { createPresence, type PresenceController, type PresenceEvent, type PresenceState, } from './create-presence';
+//# sourceMappingURL=index.d.ts.map

package/state-machine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/cdk/state-machine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,OAAO,EACZ,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC"}

package/state-machine/ngxsmk-cdk-state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ngxsmk-cdk-state-machine.d.ts","sourceRoot":"","sources":["../../../../packages/cdk/state-machine/ngxsmk-cdk-state-machine.ts"],"names":[],"mappings":"AAAA;;GAEG;;AAEH,cAAc,SAAS,CAAC"}