@tokis/core 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tokis Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,41 @@
+# /core
+
+Framework-agnostic headless primitives for the Tokis design system — state machines, accessibility helpers, and focus management. Zero dependencies.
+
+## Installation
+
+```bash
+npm install /core
+```
+
+> Or install everything at once: `npm install tokis`
+
+## Usage
+
+```ts
+import {
+  createFocusTrap,
+  rovingTabIndex,
+  generateId,
+  createMachine,
+} from '/core';
+```
+
+## What's Included
+
+- **Focus Management** — `createFocusTrap`, `rovingTabIndex`, `useFocusVisible`
+- **Accessibility** — ARIA attribute helpers, unique ID generation
+- **State Machines** — Lightweight `createMachine` for component behavior
+- **Controllable State** — Unified controlled/uncontrolled state pattern
+
+## Why Use This?
+
+`/core` contains no React, no DOM assumptions, and no CSS. Use it to build your own component library on top of Tokis's battle-tested accessibility and state management layer — in React, Vue, Svelte, or vanilla JS.
+
+## Documentation
+
+Visit [tokis.dev](https://tokis.dev) for the full documentation.
+
+## License
+
+MIT

package/dist/a11y/aria-helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ARIA attribute helpers.
+ * Imperative setters for use in non-framework environments.
+ * Framework adapters should use the corresponding prop-object helpers instead.
+ */
+export declare function setAriaLabelledBy(element: HTMLElement, id: string): void;
+export declare function setAriaDescribedBy(element: HTMLElement, id: string): void;
+export declare function setAriaExpanded(element: HTMLElement, expanded: boolean): void;
+export declare function setAriaHidden(element: HTMLElement, hidden: boolean): void;
+export declare function setAriaControls(element: HTMLElement, id: string): void;
+export declare function ariaLabelledByProps(id: string): Record<string, string>;
+export declare function ariaDescribedByProps(id: string): Record<string, string>;
+export declare function ariaExpandedProps(expanded: boolean): Record<string, string>;
+export declare function ariaHiddenProps(hidden: boolean): Record<string, string>;
+/** @deprecated Use setAriaLabelledBy instead */
+export declare const ariaLabelledBy: typeof setAriaLabelledBy;
+/** @deprecated Use setAriaDescribedBy instead */
+export declare const ariaDescribedBy: typeof setAriaDescribedBy;
+//# sourceMappingURL=aria-helpers.d.ts.map

package/dist/a11y/aria-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-helpers.d.ts","sourceRoot":"","sources":["../../src/a11y/aria-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAExE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAE7E;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAEzE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtE;AAID,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtE;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvE;AAGD,gDAAgD;AAChD,eAAO,MAAM,cAAc,0BAAoB,CAAC;AAChD,iDAAiD;AACjD,eAAO,MAAM,eAAe,2BAAqB,CAAC"}

package/dist/a11y/aria-helpers.js

@@ -0,0 +1,40 @@
+/**
+ * ARIA attribute helpers.
+ * Imperative setters for use in non-framework environments.
+ * Framework adapters should use the corresponding prop-object helpers instead.
+ */
+// --- Imperative setters ---
+export function setAriaLabelledBy(element, id) {
+    element.setAttribute('aria-labelledby', id);
+}
+export function setAriaDescribedBy(element, id) {
+    element.setAttribute('aria-describedby', id);
+}
+export function setAriaExpanded(element, expanded) {
+    element.setAttribute('aria-expanded', String(expanded));
+}
+export function setAriaHidden(element, hidden) {
+    element.setAttribute('aria-hidden', String(hidden));
+}
+export function setAriaControls(element, id) {
+    element.setAttribute('aria-controls', id);
+}
+// --- Prop-object helpers (framework-agnostic, usable in React/Vue/etc.) ---
+export function ariaLabelledByProps(id) {
+    return { 'aria-labelledby': id };
+}
+export function ariaDescribedByProps(id) {
+    return { 'aria-describedby': id };
+}
+export function ariaExpandedProps(expanded) {
+    return { 'aria-expanded': String(expanded) };
+}
+export function ariaHiddenProps(hidden) {
+    return { 'aria-hidden': String(hidden) };
+}
+// Keep legacy exports for backward compatibility
+/** @deprecated Use setAriaLabelledBy instead */
+export const ariaLabelledBy = setAriaLabelledBy;
+/** @deprecated Use setAriaDescribedBy instead */
+export const ariaDescribedBy = setAriaDescribedBy;
+//# sourceMappingURL=aria-helpers.js.map

package/dist/a11y/aria-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aria-helpers.js","sourceRoot":"","sources":["../../src/a11y/aria-helpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6BAA6B;AAE7B,MAAM,UAAU,iBAAiB,CAAC,OAAoB,EAAE,EAAU;IAChE,OAAO,CAAC,YAAY,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAoB,EAAE,EAAU;IACjE,OAAO,CAAC,YAAY,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAoB,EAAE,QAAiB;IACrE,OAAO,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,MAAe;IACjE,OAAO,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAoB,EAAE,EAAU;IAC9D,OAAO,CAAC,YAAY,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,6EAA6E;AAE7E,MAAM,UAAU,mBAAmB,CAAC,EAAU;IAC5C,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAiB;IACjD,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,iDAAiD;AACjD,gDAAgD;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAChD,iDAAiD;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC"}

package/dist/a11y/id-generator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generates a globally unique, incrementing ID with an optional prefix.
+ * SSR Note: IDs generated server-side and client-side may differ.
+ * Prefer `createIdScope` for component-level ID generation.
+ */
+export declare function generateId(prefix?: string): string;
+/**
+ * Creates a scoped ID generator for a component instance.
+ * All IDs within a scope share the same numeric suffix,
+ * making them predictably related (e.g., label-1 / input-1).
+ *
+ * @example
+ * const scope = createIdScope('field');
+ * scope('label');  // → 'field-label-1'
+ * scope('input');  // → 'field-input-1'
+ */
+export declare function createIdScope(componentName: string): (part: string) => string;
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/a11y/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../src/a11y/id-generator.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAU,GAAG,MAAM,CAGnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAG7E"}

package/dist/a11y/id-generator.js

@@ -0,0 +1,25 @@
+let globalCounter = 0;
+/**
+ * Generates a globally unique, incrementing ID with an optional prefix.
+ * SSR Note: IDs generated server-side and client-side may differ.
+ * Prefer `createIdScope` for component-level ID generation.
+ */
+export function generateId(prefix = 'tokis') {
+    globalCounter += 1;
+    return `${prefix}-${globalCounter}`;
+}
+/**
+ * Creates a scoped ID generator for a component instance.
+ * All IDs within a scope share the same numeric suffix,
+ * making them predictably related (e.g., label-1 / input-1).
+ *
+ * @example
+ * const scope = createIdScope('field');
+ * scope('label');  // → 'field-label-1'
+ * scope('input');  // → 'field-input-1'
+ */
+export function createIdScope(componentName) {
+    const id = generateId(componentName);
+    return (part) => `${id}-${part}`;
+}
+//# sourceMappingURL=id-generator.js.map

package/dist/a11y/id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.js","sourceRoot":"","sources":["../../src/a11y/id-generator.ts"],"names":[],"mappings":"AAAA,IAAI,aAAa,GAAG,CAAC,CAAC;AAEtB;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAM,GAAG,OAAO;IACzC,aAAa,IAAI,CAAC,CAAC;IACnB,OAAO,GAAG,MAAM,IAAI,aAAa,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,aAAqB;IACjD,MAAM,EAAE,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACrC,OAAO,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;AAC3C,CAAC"}

package/dist/cjs/a11y/aria-helpers.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * ARIA attribute helpers.
+ * Imperative setters for use in non-framework environments.
+ * Framework adapters should use the corresponding prop-object helpers instead.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ariaDescribedBy = exports.ariaLabelledBy = void 0;
+exports.setAriaLabelledBy = setAriaLabelledBy;
+exports.setAriaDescribedBy = setAriaDescribedBy;
+exports.setAriaExpanded = setAriaExpanded;
+exports.setAriaHidden = setAriaHidden;
+exports.setAriaControls = setAriaControls;
+exports.ariaLabelledByProps = ariaLabelledByProps;
+exports.ariaDescribedByProps = ariaDescribedByProps;
+exports.ariaExpandedProps = ariaExpandedProps;
+exports.ariaHiddenProps = ariaHiddenProps;
+// --- Imperative setters ---
+function setAriaLabelledBy(element, id) {
+    element.setAttribute('aria-labelledby', id);
+}
+function setAriaDescribedBy(element, id) {
+    element.setAttribute('aria-describedby', id);
+}
+function setAriaExpanded(element, expanded) {
+    element.setAttribute('aria-expanded', String(expanded));
+}
+function setAriaHidden(element, hidden) {
+    element.setAttribute('aria-hidden', String(hidden));
+}
+function setAriaControls(element, id) {
+    element.setAttribute('aria-controls', id);
+}
+// --- Prop-object helpers (framework-agnostic, usable in React/Vue/etc.) ---
+function ariaLabelledByProps(id) {
+    return { 'aria-labelledby': id };
+}
+function ariaDescribedByProps(id) {
+    return { 'aria-describedby': id };
+}
+function ariaExpandedProps(expanded) {
+    return { 'aria-expanded': String(expanded) };
+}
+function ariaHiddenProps(hidden) {
+    return { 'aria-hidden': String(hidden) };
+}
+// Keep legacy exports for backward compatibility
+/** @deprecated Use setAriaLabelledBy instead */
+exports.ariaLabelledBy = setAriaLabelledBy;
+/** @deprecated Use setAriaDescribedBy instead */
+exports.ariaDescribedBy = setAriaDescribedBy;

package/dist/cjs/a11y/id-generator.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateId = generateId;
+exports.createIdScope = createIdScope;
+let globalCounter = 0;
+/**
+ * Generates a globally unique, incrementing ID with an optional prefix.
+ * SSR Note: IDs generated server-side and client-side may differ.
+ * Prefer `createIdScope` for component-level ID generation.
+ */
+function generateId(prefix = 'tokis') {
+    globalCounter += 1;
+    return `${prefix}-${globalCounter}`;
+}
+/**
+ * Creates a scoped ID generator for a component instance.
+ * All IDs within a scope share the same numeric suffix,
+ * making them predictably related (e.g., label-1 / input-1).
+ *
+ * @example
+ * const scope = createIdScope('field');
+ * scope('label');  // → 'field-label-1'
+ * scope('input');  // → 'field-input-1'
+ */
+function createIdScope(componentName) {
+    const id = generateId(componentName);
+    return (part) => `${id}-${part}`;
+}

package/dist/cjs/focus/focus-trap.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trapFocus = trapFocus;
+function trapFocus(element) {
+    const focusableSelectors = 'a[href], button, textarea, input, select, [tabindex]:not([tabindex="-1"])';
+    const focusable = Array.from(element.querySelectorAll(focusableSelectors));
+    if (!focusable.length)
+        return;
+    const first = focusable[0];
+    const last = focusable[focusable.length - 1];
+    const handleKeyDown = (e) => {
+        if (e.key !== 'Tab')
+            return;
+        if (e.shiftKey) {
+            if (document.activeElement === first) {
+                e.preventDefault();
+                last.focus();
+            }
+        }
+        else {
+            if (document.activeElement === last) {
+                e.preventDefault();
+                first.focus();
+            }
+        }
+    };
+    element.addEventListener('keydown', handleKeyDown);
+    // Return cleanup function
+    return () => element.removeEventListener('keydown', handleKeyDown);
+}

package/dist/cjs/focus/roving-tabindex.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rovingTabIndex = rovingTabIndex;
+function rovingTabIndex(container, options) {
+    const focusable = Array.from(container.querySelectorAll('button:not([disabled]), [role="button"], a[href], input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])'));
+    let activeIndex = options?.activeIndex ?? 0;
+    const setActive = (index) => {
+        activeIndex = index;
+        focusable.forEach((el, i) => {
+            el.setAttribute('tabindex', i === index ? '0' : '-1');
+        });
+        focusable[index]?.focus();
+    };
+    if (focusable.length > 0) {
+        setActive(activeIndex);
+    }
+    const handleKeyDown = (e) => {
+        if (!['ArrowRight', 'ArrowLeft', 'ArrowDown', 'ArrowUp', 'Home', 'End'].includes(e.key))
+            return;
+        e.preventDefault();
+        if (e.key === 'ArrowRight' || e.key === 'ArrowDown') {
+            setActive((activeIndex + 1) % focusable.length);
+        }
+        else if (e.key === 'ArrowLeft' || e.key === 'ArrowUp') {
+            setActive((activeIndex - 1 + focusable.length) % focusable.length);
+        }
+        else if (e.key === 'Home') {
+            setActive(0);
+        }
+        else if (e.key === 'End') {
+            setActive(focusable.length - 1);
+        }
+    };
+    container.addEventListener('keydown', handleKeyDown);
+    return () => container.removeEventListener('keydown', handleKeyDown);
+}

package/dist/cjs/focus/use-focus-visible.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFocusVisible = useFocusVisible;
+/**
+ * Tracks whether focus was triggered via keyboard input and applies
+ * the `focus-visible` class accordingly — matching the CSS :focus-visible spec.
+ * Returns a cleanup function to remove all listeners.
+ */
+function useFocusVisible(element) {
+    let hadKeyboardEvent = false;
+    const onPointerDown = () => {
+        hadKeyboardEvent = false;
+    };
+    const onKeyDown = (e) => {
+        // Ignore modifier-only keypresses
+        if (!['Tab', 'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'Enter', ' '].includes(e.key))
+            return;
+        hadKeyboardEvent = true;
+    };
+    const onFocus = (e) => {
+        const target = e.target;
+        if (target && hadKeyboardEvent) {
+            target.classList.add('focus-visible');
+        }
+    };
+    const onBlur = (e) => {
+        const target = e.target;
+        if (target) {
+            target.classList.remove('focus-visible');
+        }
+    };
+    element.addEventListener('pointerdown', onPointerDown, true);
+    element.addEventListener('keydown', onKeyDown, true);
+    element.addEventListener('focus', onFocus, true);
+    element.addEventListener('blur', onBlur, true);
+    return () => {
+        element.removeEventListener('pointerdown', onPointerDown, true);
+        element.removeEventListener('keydown', onKeyDown, true);
+        element.removeEventListener('focus', onFocus, true);
+        element.removeEventListener('blur', onBlur, true);
+    };
+}

package/dist/cjs/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./primitives/button/index"), exports);
+__exportStar(require("./focus/focus-trap"), exports);
+__exportStar(require("./focus/roving-tabindex"), exports);
+__exportStar(require("./focus/use-focus-visible"), exports);
+__exportStar(require("./a11y/aria-helpers"), exports);
+__exportStar(require("./a11y/id-generator"), exports);
+__exportStar(require("./state/controllable-state"), exports);
+__exportStar(require("./state/create-machine"), exports);

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/primitives/button/button.machine.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buttonMachine = void 0;
+const create_machine_js_1 = require("../../state/create-machine");
+exports.buttonMachine = (0, create_machine_js_1.createMachine)({
+    id: 'button',
+    initial: 'idle',
+    context: { disabled: false },
+    states: {
+        idle: { PRESS: 'pressed' },
+        pressed: { RELEASE: 'idle' },
+    },
+});

package/dist/cjs/primitives/button/button.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/primitives/button/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./button.machine"), exports);
+__exportStar(require("./button.types"), exports);

package/dist/cjs/state/controllable-state.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isControlled = isControlled;
+exports.resolveInitialState = resolveInitialState;
+/**
+ * Determines whether a value is controlled (externally managed) or uncontrolled.
+ * Returns the resolved value and a no-op setter indicator for framework adapters.
+ *
+ * Framework adapters (e.g. react/) are responsible for implementing
+ * useControllableState using this utility as a type helper.
+ */
+function isControlled(value) {
+    return typeof value !== 'undefined';
+}
+/**
+ * Resolves the initial state for an uncontrolled component.
+ * If `controlled` is defined, returns it directly.
+ * Otherwise returns `defaultValue`.
+ */
+function resolveInitialState(controlled, defaultValue) {
+    return isControlled(controlled) ? controlled : defaultValue;
+}

package/dist/cjs/state/create-machine.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Lightweight state machine factory — no external dependencies.
+ * A minimal alternative to XState for simple state transitions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMachine = createMachine;
+exports.assign = assign;
+exports.setup = setup;
+function createMachine(config) {
+    return {
+        id: config.id,
+        initialState: config.initial,
+        initialContext: config.context,
+        transition(state, event) {
+            return config.states[state]?.[event] ?? state;
+        },
+    };
+}
+/** No-op assign helper for API compatibility */
+function assign(updater) {
+    return updater;
+}
+/** No-op setup helper for API compatibility */
+function setup(_config) {
+    return { createMachine };
+}

package/dist/focus/focus-trap.d.ts

@@ -0,0 +1,2 @@
+export declare function trapFocus(element: HTMLElement): (() => void) | undefined;
+//# sourceMappingURL=focus-trap.d.ts.map

package/dist/focus/focus-trap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-trap.d.ts","sourceRoot":"","sources":["../../src/focus/focus-trap.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,4BAyB7C"}

package/dist/focus/focus-trap.js

@@ -0,0 +1,28 @@
+export function trapFocus(element) {
+    const focusableSelectors = 'a[href], button, textarea, input, select, [tabindex]:not([tabindex="-1"])';
+    const focusable = Array.from(element.querySelectorAll(focusableSelectors));
+    if (!focusable.length)
+        return;
+    const first = focusable[0];
+    const last = focusable[focusable.length - 1];
+    const handleKeyDown = (e) => {
+        if (e.key !== 'Tab')
+            return;
+        if (e.shiftKey) {
+            if (document.activeElement === first) {
+                e.preventDefault();
+                last.focus();
+            }
+        }
+        else {
+            if (document.activeElement === last) {
+                e.preventDefault();
+                first.focus();
+            }
+        }
+    };
+    element.addEventListener('keydown', handleKeyDown);
+    // Return cleanup function
+    return () => element.removeEventListener('keydown', handleKeyDown);
+}
+//# sourceMappingURL=focus-trap.js.map

package/dist/focus/focus-trap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-trap.js","sourceRoot":"","sources":["../../src/focus/focus-trap.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,OAAoB;IAC5C,MAAM,kBAAkB,GAAG,2EAAoF,CAAC;IAChH,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAkB,CAAC;IAC5F,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO;IAC9B,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE7C,MAAM,aAAa,GAAG,CAAC,CAAgB,EAAE,EAAE;QACzC,IAAI,CAAC,CAAC,GAAG,KAAK,KAAK;YAAE,OAAO;QAC5B,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACf,IAAI,QAAQ,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;gBACrC,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,QAAQ,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;gBACpC,CAAC,CAAC,cAAc,EAAE,CAAC;gBACnB,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACnD,0BAA0B;IAC1B,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACrE,CAAC"}

package/dist/focus/roving-tabindex.d.ts

@@ -0,0 +1,4 @@
+export declare function rovingTabIndex(container: HTMLElement, options?: {
+    activeIndex?: number;
+}): () => void;
+//# sourceMappingURL=roving-tabindex.d.ts.map

package/dist/focus/roving-tabindex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roving-tabindex.d.ts","sourceRoot":"","sources":["../../src/focus/roving-tabindex.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,cAqCxF"}

package/dist/focus/roving-tabindex.js

@@ -0,0 +1,34 @@
+export function rovingTabIndex(container, options) {
+    const focusable = Array.from(container.querySelectorAll('button:not([disabled]), [role="button"], a[href], input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])'));
+    let activeIndex = options?.activeIndex ?? 0;
+    const setActive = (index) => {
+        activeIndex = index;
+        focusable.forEach((el, i) => {
+            el.setAttribute('tabindex', i === index ? '0' : '-1');
+        });
+        focusable[index]?.focus();
+    };
+    if (focusable.length > 0) {
+        setActive(activeIndex);
+    }
+    const handleKeyDown = (e) => {
+        if (!['ArrowRight', 'ArrowLeft', 'ArrowDown', 'ArrowUp', 'Home', 'End'].includes(e.key))
+            return;
+        e.preventDefault();
+        if (e.key === 'ArrowRight' || e.key === 'ArrowDown') {
+            setActive((activeIndex + 1) % focusable.length);
+        }
+        else if (e.key === 'ArrowLeft' || e.key === 'ArrowUp') {
+            setActive((activeIndex - 1 + focusable.length) % focusable.length);
+        }
+        else if (e.key === 'Home') {
+            setActive(0);
+        }
+        else if (e.key === 'End') {
+            setActive(focusable.length - 1);
+        }
+    };
+    container.addEventListener('keydown', handleKeyDown);
+    return () => container.removeEventListener('keydown', handleKeyDown);
+}
+//# sourceMappingURL=roving-tabindex.js.map

package/dist/focus/roving-tabindex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roving-tabindex.js","sourceRoot":"","sources":["../../src/focus/roving-tabindex.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,SAAsB,EAAE,OAAkC;IACvF,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAC1B,SAAS,CAAC,gBAAgB,CACxB,4JAA4J,CAC7J,CACF,CAAC;IACF,IAAI,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,CAAC,CAAC;IAE5C,MAAM,SAAS,GAAG,CAAC,KAAa,EAAE,EAAE;QAClC,WAAW,GAAG,KAAK,CAAC;QACpB,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;YAC1B,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QACH,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,WAAW,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,CAAgB,EAAE,EAAE;QACzC,IAAI,CAAC,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;YAAE,OAAO;QAChG,CAAC,CAAC,cAAc,EAAE,CAAC;QAEnB,IAAI,CAAC,CAAC,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;YACpD,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YACxD,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM,EAAE,CAAC;YAC5B,SAAS,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;aAAM,IAAI,CAAC,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;YAC3B,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC;IAEF,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACrD,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACvE,CAAC"}

package/dist/focus/use-focus-visible.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tracks whether focus was triggered via keyboard input and applies
+ * the `focus-visible` class accordingly — matching the CSS :focus-visible spec.
+ * Returns a cleanup function to remove all listeners.
+ */
+export declare function useFocusVisible(element: HTMLElement): () => void;
+//# sourceMappingURL=use-focus-visible.d.ts.map

package/dist/focus/use-focus-visible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-focus-visible.d.ts","sourceRoot":"","sources":["../../src/focus/use-focus-visible.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,IAAI,CAsChE"}

package/dist/focus/use-focus-visible.js

@@ -0,0 +1,40 @@
+/**
+ * Tracks whether focus was triggered via keyboard input and applies
+ * the `focus-visible` class accordingly — matching the CSS :focus-visible spec.
+ * Returns a cleanup function to remove all listeners.
+ */
+export function useFocusVisible(element) {
+    let hadKeyboardEvent = false;
+    const onPointerDown = () => {
+        hadKeyboardEvent = false;
+    };
+    const onKeyDown = (e) => {
+        // Ignore modifier-only keypresses
+        if (!['Tab', 'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'Enter', ' '].includes(e.key))
+            return;
+        hadKeyboardEvent = true;
+    };
+    const onFocus = (e) => {
+        const target = e.target;
+        if (target && hadKeyboardEvent) {
+            target.classList.add('focus-visible');
+        }
+    };
+    const onBlur = (e) => {
+        const target = e.target;
+        if (target) {
+            target.classList.remove('focus-visible');
+        }
+    };
+    element.addEventListener('pointerdown', onPointerDown, true);
+    element.addEventListener('keydown', onKeyDown, true);
+    element.addEventListener('focus', onFocus, true);
+    element.addEventListener('blur', onBlur, true);
+    return () => {
+        element.removeEventListener('pointerdown', onPointerDown, true);
+        element.removeEventListener('keydown', onKeyDown, true);
+        element.removeEventListener('focus', onFocus, true);
+        element.removeEventListener('blur', onBlur, true);
+    };
+}
+//# sourceMappingURL=use-focus-visible.js.map

package/dist/focus/use-focus-visible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-focus-visible.js","sourceRoot":"","sources":["../../src/focus/use-focus-visible.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB;IAClD,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAE7B,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,gBAAgB,GAAG,KAAK,CAAC;IAC3B,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,CAAgB,EAAE,EAAE;QACrC,kCAAkC;QAClC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;YAAE,OAAO;QACtG,gBAAgB,GAAG,IAAI,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE;QAChC,MAAM,MAAM,GAAG,CAAC,CAAC,MAA4B,CAAC;QAC9C,IAAI,MAAM,IAAI,gBAAgB,EAAE,CAAC;YAC/B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,CAAa,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,CAAC,CAAC,MAA4B,CAAC;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAE/C,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,mBAAmB,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QAChE,OAAO,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACxD,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './primitives/button/index.js';
+export * from './focus/focus-trap.js';
+export * from './focus/roving-tabindex.js';
+export * from './focus/use-focus-visible.js';
+export * from './a11y/aria-helpers.js';
+export * from './a11y/id-generator.js';
+export * from './state/controllable-state.js';
+export * from './state/create-machine.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './primitives/button/index.js';
+export * from './focus/focus-trap.js';
+export * from './focus/roving-tabindex.js';
+export * from './focus/use-focus-visible.js';
+export * from './a11y/aria-helpers.js';
+export * from './a11y/id-generator.js';
+export * from './state/controllable-state.js';
+export * from './state/create-machine.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC"}

package/dist/primitives/button/button.machine.d.ts

@@ -0,0 +1,5 @@
+import type { ButtonContext } from './button.types.js';
+type ButtonState = 'idle' | 'pressed';
+export declare const buttonMachine: import("../../state/create-machine.js").MachineInstance<ButtonState, "PRESS" | "RELEASE", ButtonContext>;
+export {};
+//# sourceMappingURL=button.machine.d.ts.map

package/dist/primitives/button/button.machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.machine.d.ts","sourceRoot":"","sources":["../../../src/primitives/button/button.machine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,mBAAmB,CAAC;AAEpE,KAAK,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAGtC,eAAO,MAAM,aAAa,0GAQxB,CAAC"}

package/dist/primitives/button/button.machine.js

@@ -0,0 +1,11 @@
+import { createMachine } from '../../state/create-machine.js';
+export const buttonMachine = createMachine({
+    id: 'button',
+    initial: 'idle',
+    context: { disabled: false },
+    states: {
+        idle: { PRESS: 'pressed' },
+        pressed: { RELEASE: 'idle' },
+    },
+});
+//# sourceMappingURL=button.machine.js.map

package/dist/primitives/button/button.machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.machine.js","sourceRoot":"","sources":["../../../src/primitives/button/button.machine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAM9D,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAA8C;IACtF,EAAE,EAAE,QAAQ;IACZ,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC5B,MAAM,EAAE;QACN,IAAI,EAAK,EAAE,KAAK,EAAE,SAAS,EAAE;QAC7B,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;KAC7B;CACF,CAAC,CAAC"}

package/dist/primitives/button/button.types.d.ts

@@ -0,0 +1,9 @@
+export interface ButtonContext {
+    disabled: boolean;
+}
+export type ButtonEvent = {
+    type: 'PRESS';
+} | {
+    type: 'RELEASE';
+};
+//# sourceMappingURL=button.types.d.ts.map

package/dist/primitives/button/button.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.types.d.ts","sourceRoot":"","sources":["../../../src/primitives/button/button.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC"}

package/dist/primitives/button/button.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=button.types.js.map

package/dist/primitives/button/button.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.types.js","sourceRoot":"","sources":["../../../src/primitives/button/button.types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,3 @@
+export * from './button.machine.js';
+export * from './button.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/primitives/button/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/primitives/button/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/primitives/button/index.js

@@ -0,0 +1,3 @@
+export * from './button.machine.js';
+export * from './button.types.js';
+//# sourceMappingURL=index.js.map

package/dist/primitives/button/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/primitives/button/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/state/controllable-state.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Determines whether a value is controlled (externally managed) or uncontrolled.
+ * Returns the resolved value and a no-op setter indicator for framework adapters.
+ *
+ * Framework adapters (e.g. react/) are responsible for implementing
+ * useControllableState using this utility as a type helper.
+ */
+export declare function isControlled<T>(value: T | undefined): value is T;
+/**
+ * Resolves the initial state for an uncontrolled component.
+ * If `controlled` is defined, returns it directly.
+ * Otherwise returns `defaultValue`.
+ */
+export declare function resolveInitialState<T>(controlled: T | undefined, defaultValue: T): T;
+//# sourceMappingURL=controllable-state.d.ts.map

package/dist/state/controllable-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllable-state.d.ts","sourceRoot":"","sources":["../../src/state/controllable-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,KAAK,IAAI,CAAC,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,SAAS,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAEpF"}

package/dist/state/controllable-state.js

@@ -0,0 +1,19 @@
+/**
+ * Determines whether a value is controlled (externally managed) or uncontrolled.
+ * Returns the resolved value and a no-op setter indicator for framework adapters.
+ *
+ * Framework adapters (e.g. react/) are responsible for implementing
+ * useControllableState using this utility as a type helper.
+ */
+export function isControlled(value) {
+    return typeof value !== 'undefined';
+}
+/**
+ * Resolves the initial state for an uncontrolled component.
+ * If `controlled` is defined, returns it directly.
+ * Otherwise returns `defaultValue`.
+ */
+export function resolveInitialState(controlled, defaultValue) {
+    return isControlled(controlled) ? controlled : defaultValue;
+}
+//# sourceMappingURL=controllable-state.js.map

package/dist/state/controllable-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllable-state.js","sourceRoot":"","sources":["../../src/state/controllable-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAI,KAAoB;IAClD,OAAO,OAAO,KAAK,KAAK,WAAW,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAI,UAAyB,EAAE,YAAe;IAC/E,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;AAC9D,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Lightweight state machine factory — no external dependencies.
+ * A minimal alternative to XState for simple state transitions.
+ */
+export type Transition<S extends string, E extends string> = {
+    [state in S]?: {
+        [event in E]?: S;
+    };
+};
+export interface MachineConfig<S extends string, E extends string, C> {
+    id: string;
+    initial: S;
+    context: C;
+    states: Transition<S, E>;
+}
+export interface MachineInstance<S extends string, E extends string, C> {
+    id: string;
+    initialState: S;
+    initialContext: C;
+    transition: (state: S, event: E) => S;
+}
+export declare function createMachine<S extends string, E extends string, C>(config: MachineConfig<S, E, C>): MachineInstance<S, E, C>;
+/** No-op assign helper for API compatibility */
+export declare function assign<C>(updater: Partial<C> | ((ctx: C) => Partial<C>)): typeof updater;
+/** No-op setup helper for API compatibility */
+export declare function setup<_T>(_config: _T): {
+    createMachine: typeof createMachine;
+};
+//# sourceMappingURL=create-machine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-machine.d.ts","sourceRoot":"","sources":["../../src/state/create-machine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI;KAC1D,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE;SAAG,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;KAAE;CACpC,CAAC;AAEF,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,CAAC,CAAC;IAChB,cAAc,EAAE,CAAC,CAAC;IAClB,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CACvC;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,EACjE,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAC7B,eAAe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAS1B;AAED,gDAAgD;AAChD,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,OAAO,CAExF;AAED,+CAA+C;AAC/C,wBAAgB,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,GAAG;IAAE,aAAa,EAAE,OAAO,aAAa,CAAA;CAAE,CAE9E"}

package/dist/state/create-machine.js

@@ -0,0 +1,23 @@
+/**
+ * Lightweight state machine factory — no external dependencies.
+ * A minimal alternative to XState for simple state transitions.
+ */
+export function createMachine(config) {
+    return {
+        id: config.id,
+        initialState: config.initial,
+        initialContext: config.context,
+        transition(state, event) {
+            return config.states[state]?.[event] ?? state;
+        },
+    };
+}
+/** No-op assign helper for API compatibility */
+export function assign(updater) {
+    return updater;
+}
+/** No-op setup helper for API compatibility */
+export function setup(_config) {
+    return { createMachine };
+}
+//# sourceMappingURL=create-machine.js.map

package/dist/state/create-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-machine.js","sourceRoot":"","sources":["../../src/state/create-machine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoBH,MAAM,UAAU,aAAa,CAC3B,MAA8B;IAE9B,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,YAAY,EAAE,MAAM,CAAC,OAAO;QAC5B,cAAc,EAAE,MAAM,CAAC,OAAO;QAC9B,UAAU,CAAC,KAAQ,EAAE,KAAQ;YAC3B,OAAQ,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAmB,IAAI,KAAK,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,MAAM,CAAI,OAA8C;IACtE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,KAAK,CAAK,OAAW;IACnC,OAAO,EAAE,aAAa,EAAE,CAAC;AAC3B,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@tokis/core",
+  "version": "1.0.0",
+  "description": "Framework-agnostic headless primitives for Tokis — state machines, accessibility helpers, and focus management. Zero dependencies.",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/cjs/index.js",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc && tsc -p tsconfig.cjs.json && node ../../scripts/stamp-cjs.js",
+    "typecheck": "tsc --noEmit",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "tokis",
+    "design-system",
+    "headless",
+    "headless-ui",
+    "accessibility",
+    "a11y",
+    "aria",
+    "wcag",
+    "state-machine",
+    "focus-management",
+    "focus-trap",
+    "roving-tabindex",
+    "framework-agnostic",
+    "typescript",
+    "zero-dependencies"
+  ],
+  "author": "Tokis Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tokis-design/tokis.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://tokis.dev",
+  "bugs": {
+    "url": "https://github.com/tokis-design/tokis/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}