@cascivo/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 urbanisierung
+
+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,19 @@
+<!-- generated by scripts/readme/generate.ts — edit readme.body.md, not this file -->
+
+# @cascivo/core
+
+> Micro-FSM and Preact Signals primitives powering every cascade component
+
+[cascivo.com](https://cascivo.com) · [Docs](https://docs.cascivo.com) · [Storybook](https://storybook.cascivo.com) · [GitHub](https://github.com/urbanisierung/cascivo)
+
+Core runtime for cascade — micro-FSM engine, Preact Signals integration (`useSignal`, `useComputed`, `useSignalEffect`, `useSignals`), and base utilities shared across all components.
+
+## Install
+
+```sh
+pnpm add @cascivo/core
+```
+
+---
+
+[cascivo.com](https://cascivo.com) · [Docs](https://docs.cascivo.com) · [Storybook](https://storybook.cascivo.com) · [GitHub](https://github.com/urbanisierung/cascivo) · AI agents: use [`@cascivo/mcp`](https://github.com/urbanisierung/cascivo/tree/main/packages/mcp) and [`registry.json`](https://github.com/urbanisierung/cascivo/blob/main/registry.json) · MIT

package/dist/index.d.mts

@@ -0,0 +1,372 @@
+import { ReadonlySignal, Signal, batch, computed, effect, signal, useComputed, useSignal, useSignalEffect } from "@preact/signals-react";
+import { useSignals } from "@preact/signals-react/runtime";
+import { CSSProperties, Component, ErrorInfo, HTMLAttributes, ReactElement, ReactNode, Ref, RefCallback, RefObject } from "react";
+
+//#region src/types.d.ts
+interface StateConfig {
+  on?: Record<string, string>;
+}
+interface MachineConfig<S extends string = string, I extends S = S> {
+  initial: I;
+  states: Record<S, StateConfig>;
+}
+interface Machine<S extends string = string> {
+  initial: S;
+  states: Record<S, StateConfig>;
+}
+interface PropMeta {
+  name: string;
+  type: string;
+  required: boolean;
+  default?: string;
+  description?: string;
+}
+/**
+ * WCAG conformance level with explicit version.
+ * 'AA' / 'AAA' are deprecated aliases for '2.1-AA' / '2.1-AAA' — migrate to versioned form.
+ */
+type WcagLevel = '2.1-AA' | '2.2-AA' | '2.2-AAA' | 'AA' | 'AAA';
+interface AccessibilityMeta {
+  role: string;
+  /** WCAG conformance level. Use versioned form: '2.1-AA' | '2.2-AA'. */
+  wcag: WcagLevel;
+  keyboard: string[];
+  /**
+   * ARIA Authoring Practices Guide pattern this component conforms to.
+   * E.g. 'tabs', 'dialog-modal', 'combobox', 'accordion', 'slider'.
+   * Omit for components that don't map to an APG pattern (charts, composites).
+   */
+  apgPattern?: string;
+  /**
+   * True if the component explicitly handles forced-colors (Windows High Contrast)
+   * via @media (forced-colors: active) CSS rules.
+   */
+  forcedColors?: boolean;
+  /**
+   * True if the component explicitly respects prefers-reduced-motion.
+   * Omit/false for components with no animation.
+   */
+  reducedMotion?: boolean;
+}
+interface ExampleMeta {
+  title: string;
+  code: string;
+  description?: string;
+}
+interface ComponentMeta {
+  name: string;
+  description: string;
+  category: 'inputs' | 'display' | 'overlay' | 'navigation' | 'feedback' | 'layout' | 'block' | 'chart';
+  states: string[];
+  variants: string[];
+  sizes: string[];
+  props: PropMeta[];
+  tokens: string[];
+  accessibility: AccessibilityMeta;
+  examples: ExampleMeta[];
+  dependencies: string[];
+  tags: string[];
+  intent?: ComponentIntent;
+}
+interface IntentAntiPattern {
+  bad: string;
+  good?: string;
+  why: string;
+}
+type IntentRelationship = 'alternative' | 'pairs-with' | 'contains' | 'contained-by';
+interface IntentRelated {
+  name: string;
+  relationship: IntentRelationship;
+  reason: string;
+}
+interface IntentFlexibility {
+  area: string;
+  level: 'strict' | 'flexible';
+  note: string;
+}
+interface IntentContent {
+  tone: string;
+  notes?: string;
+}
+interface ComponentIntent {
+  whenToUse: string[];
+  whenNotToUse: string[];
+  antiPatterns: IntentAntiPattern[];
+  related: IntentRelated[];
+  a11yRationale: string;
+  content?: IntentContent;
+  flexibility: IntentFlexibility[];
+}
+//#endregion
+//#region src/machine.d.ts
+declare function createMachine<S extends string, I extends S = S>(config: MachineConfig<S, I>): Machine<S>;
+declare function useMachine<S extends string>(machine: Machine<S>): readonly [import("@preact/signals-core").Signal<S>, (event: string) => void];
+//#endregion
+//#region src/utils.d.ts
+declare function cn(...classes: (string | undefined | null | false | 0)[]): string;
+declare function composeRefs<T>(...refs: (Ref<T> | undefined)[]): RefCallback<T>;
+declare function mergeProps<T extends Record<string, unknown>>(...propsList: Partial<T>[]): T;
+//#endregion
+//#region src/error-boundary.d.ts
+interface ErrorBoundaryProps {
+  children: ReactNode;
+  fallback: ReactNode | ((error: Error, reset: () => void) => ReactNode);
+  onError?: (error: Error, info: ErrorInfo) => void;
+}
+interface State {
+  error: Error | null;
+}
+declare class ErrorBoundary extends Component<ErrorBoundaryProps, State> {
+  state: State;
+  static getDerivedStateFromError(error: Error): State;
+  componentDidCatch(error: Error, info: ErrorInfo): void;
+  reset: () => void;
+  render(): ReactNode;
+}
+//#endregion
+//#region src/suspense-boundary.d.ts
+interface SuspenseBoundaryProps {
+  children: ReactNode;
+  fallback?: ReactNode;
+}
+declare function SuspenseBoundary({
+  children,
+  fallback
+}: SuspenseBoundaryProps): import("react").JSX.Element;
+//#endregion
+//#region src/portal.d.ts
+interface PortalProps {
+  children: ReactNode;
+  container?: Element | DocumentFragment;
+}
+declare function Portal({
+  children,
+  container
+}: PortalProps): import("react").ReactPortal | null;
+//#endregion
+//#region src/visually-hidden.d.ts
+interface VisuallyHiddenProps extends HTMLAttributes<HTMLSpanElement> {
+  children: ReactNode;
+  showOnFocus?: boolean;
+}
+declare function VisuallyHidden({
+  children,
+  showOnFocus,
+  className,
+  ...props
+}: VisuallyHiddenProps): import("react").JSX.Element;
+//#endregion
+//#region src/focus-scope.d.ts
+interface FocusScopeProps {
+  children: ReactNode;
+  trapped?: boolean;
+  restoreFocus?: boolean;
+  autoFocus?: boolean;
+}
+declare function FocusScope({
+  children,
+  trapped,
+  restoreFocus,
+  autoFocus
+}: FocusScopeProps): import("react").JSX.Element;
+//#endregion
+//#region src/slot.d.ts
+interface SlotProps {
+  children?: ReactNode;
+  className?: string;
+  style?: CSSProperties;
+  [key: string]: unknown;
+}
+/**
+ * Slot renders its single child element while merging the Slot's own props and ref onto it —
+ * the Radix-style `asChild` composition primitive, built on cascivo's existing
+ * `mergeProps`/`composeRefs`/`cn`.
+ *
+ * - Non-handler props: child wins (so the consumer's element controls its own identity).
+ * - `on*` handlers: chained (Slot's runs, then the child's) via `mergeProps`.
+ * - `className`: unioned via `cn`. `style`: shallow-merged (child wins on conflicts).
+ * - `ref`: composed so both the Slot consumer's ref and the child's own ref receive the node.
+ *
+ * Fails fast if `children` is not exactly one valid React element.
+ */
+declare const Slot: import("react").ForwardRefExoticComponent<Omit<SlotProps, "ref"> & import("react").RefAttributes<unknown>>;
+//#endregion
+//#region src/controllable.d.ts
+interface UseControllableSignalOptions<T> {
+  /** Controlled value. When provided, the component is controlled for its whole life. */
+  value?: T | undefined;
+  /** Initial value for uncontrolled use. */
+  defaultValue?: T | undefined;
+  /** Called on every write, in both controlled and uncontrolled modes. */
+  onChange?: ((value: T) => void) | undefined;
+}
+/**
+ * Codifies the controlled/uncontrolled pattern documented by hand in CLAUDE.md
+ * (`const x = useSignal(open); x.value = open`).
+ *
+ * Returns a `[signal, setValue]` pair:
+ * - **Controlled** (`value` provided): the signal mirrors `value` on every render; `setValue`
+ *   does not mutate the signal locally — it only routes the request through `onChange` so the
+ *   parent owns the state (React semantics).
+ * - **Uncontrolled** (`value` undefined): the signal owns the state seeded from `defaultValue`;
+ *   `setValue` updates it locally and also calls `onChange`.
+ *
+ * Whether a component is controlled is fixed for its life, exactly like React.
+ */
+declare function useControllableSignal<T>(options: UseControllableSignalOptions<T>): [Signal<T>, (next: T) => void];
+//#endregion
+//#region src/media-query.d.ts
+/**
+ * `useMediaQuery(query)` → a `ReadonlySignal<boolean>` that tracks whether the media query matches.
+ * SSR-safe (defaults to `false` when `window`/`matchMedia` is unavailable). Subscribes to changes
+ * inside `useSignalEffect`; the listener is cleaned up on teardown.
+ */
+declare function useMediaQuery(query: string): ReadonlySignal<boolean>;
+//#endregion
+//#region src/scroll-lock.d.ts
+/**
+ * Locks `document.body` scroll while `locked` is true, compensating for the scrollbar width to
+ * avoid a layout shift. Accepts a plain boolean or a `Signal<boolean>` (reactive). The previous
+ * inline styles are restored on unlock/teardown. DOM work runs inside `useSignalEffect`.
+ */
+declare function useScrollLock(locked: Signal<boolean> | boolean): void;
+//#endregion
+//#region src/use-id.d.ts
+/**
+ * SSR-safe stable id for aria wiring (Label/Field). Wraps React's `useId` and strips the
+ * non-selector-safe colons React emits, prefixing for readability (default `cascivo`).
+ */
+declare function useId(prefix?: string): string;
+//#endregion
+//#region src/clipboard.d.ts
+interface UseClipboardOptions {
+  /** How long `copied` stays true after a successful copy, in ms. */
+  timeout?: number;
+}
+interface UseClipboardReturn {
+  copied: ReadonlySignal<boolean>;
+  copy: (text: string) => Promise<void>;
+}
+/**
+ * Copy-to-clipboard helper that de-dupes the inline logic in `copy-button`.
+ * `copy(text)` writes via `navigator.clipboard.writeText`; `copied` flips true then resets after
+ * `timeout`. The reset timer is cleared on unmount via `useSignalEffect` (no `useEffect`).
+ */
+declare function useClipboard(options?: UseClipboardOptions): UseClipboardReturn;
+//#endregion
+//#region src/dismissable-layer.d.ts
+interface DismissableLayerProps {
+  children: ReactNode;
+  /** Called when an outside pointer lands or Escape is pressed (when this is the top-most layer). */
+  onDismiss?: () => void;
+  /** Disable the outside-pointer dismissal (Escape still works unless escapeDismisses is false). */
+  disableOutsidePointer?: boolean;
+  /** Whether Escape dismisses the top-most layer. Default true. */
+  escapeDismisses?: boolean;
+}
+/**
+ * Wraps its children and dismisses on an outside pointer press or Escape. One tested implementation
+ * of the dismissal logic every overlay reinvents. Nested layers form a stack — only the top-most
+ * responds to Escape and outside pointers. All listeners run inside `useSignalEffect`.
+ */
+declare function DismissableLayer({
+  children,
+  onDismiss,
+  disableOutsidePointer,
+  escapeDismisses
+}: DismissableLayerProps): import("react").JSX.Element;
+//#endregion
+//#region src/roving-focus.d.ts
+type RovingOrientation = 'horizontal' | 'vertical' | 'both';
+interface UseRovingFocusOptions {
+  orientation?: RovingOrientation;
+  /** Wrap focus from last→first and first→last. Default false. */
+  loop?: boolean;
+  /** Initial active index. Default 0. */
+  defaultIndex?: number;
+}
+interface RovingItemProps {
+  tabIndex: number;
+  onKeyDown: (event: React.KeyboardEvent<HTMLElement>) => void;
+  onFocus: () => void;
+  ref: (el: HTMLElement | null) => void;
+}
+interface UseRovingFocusReturn {
+  activeIndex: ReadonlySignal<number>;
+  getItemProps: (index: number) => RovingItemProps;
+  setActiveIndex: (index: number) => void;
+}
+/**
+ * Roving tabindex without context. The parent calls `useRovingFocus(...)` and spreads
+ * `getItemProps(i)` onto each item. Only the active item is tabbable (`tabIndex={0}`); arrow keys
+ * move focus (Home/End jump; `loop` wraps). State lives in a signal — the consuming component reads
+ * it during render, so React apps must call `useSignals()` (per the project rule).
+ */
+declare function useRovingFocus(options?: UseRovingFocusOptions): UseRovingFocusReturn;
+//#endregion
+//#region src/presence.d.ts
+interface PresenceProps {
+  /** Whether the content should be present. Accepts a boolean or a Signal. */
+  present: boolean | Signal<boolean>;
+  /** A single element child; receives `data-state="open|closed"` and a composed ref. */
+  children: ReactElement;
+}
+/**
+ * Defers unmount until an exit animation/transition finishes. While `present` is true the child is
+ * mounted with `data-state="open"`; when it flips to false the child gets `data-state="closed"` and
+ * stays mounted until its `animationend`/`transitionend` fires (or unmounts immediately if there is
+ * no animation). CSS drives the visuals via `data-state`; this only manages mount timing. No
+ * `useEffect` — the present prop is mirrored into a signal and watched with `useSignalEffect`.
+ */
+declare function Presence({
+  present,
+  children
+}: PresenceProps): ReactElement<Record<string, unknown>, string | import("react").JSXElementConstructor<any>> | null;
+//#endregion
+//#region src/anchor.d.ts
+type AnchorSide = 'top' | 'bottom' | 'left' | 'right';
+type AnchorAlign = 'start' | 'center' | 'end';
+type AnchorPlacement = AnchorSide | `${AnchorSide}-${'start' | 'end'}`;
+interface UseAnchorPositionOptions {
+  anchorRef: RefObject<HTMLElement | null>;
+  floatingRef: RefObject<HTMLElement | null>;
+  placement?: AnchorPlacement;
+  /** Gate positioning (e.g. only while open). Default true. */
+  enabled?: boolean | Signal<boolean>;
+}
+interface UseAnchorPositionReturn {
+  /** Spread onto the anchor element (CSS-anchor path sets `anchor-name`). */
+  anchorStyle: CSSProperties;
+  /** Spread onto the floating element. */
+  floatingStyle: CSSProperties;
+  /** Whether the CSS anchor-positioning primary path is active. */
+  cssAnchorSupported: boolean;
+}
+/** JS fallback math — position `floating` relative to `anchor` for the given placement. */
+declare function computePosition(anchor: {
+  top: number;
+  left: number;
+  right: number;
+  bottom: number;
+  width: number;
+  height: number;
+}, floating: {
+  width: number;
+  height: number;
+}, placement: AnchorPlacement): {
+  top: number;
+  left: number;
+};
+/**
+ * Positions a floating element relative to an anchor. Primary path: CSS anchor positioning
+ * (Chrome-leading) — emits `anchor-name`/`position-anchor` + `anchor()` insets. Fallback (behind
+ * `CSS.supports`): JS `getBoundingClientRect` placement recomputed on scroll/resize inside
+ * `useSignalEffect`. Small by design — not a collision/flip engine (deferred).
+ */
+declare function useAnchorPosition(options: UseAnchorPositionOptions): UseAnchorPositionReturn;
+//#endregion
+//#region src/index.d.ts
+declare const VERSION = "0.0.0";
+//#endregion
+export { type AccessibilityMeta, type AnchorAlign, type AnchorPlacement, type AnchorSide, type ComponentIntent, type ComponentMeta, DismissableLayer, type DismissableLayerProps, ErrorBoundary, type ErrorBoundaryProps, type ExampleMeta, FocusScope, type FocusScopeProps, type IntentAntiPattern, type IntentContent, type IntentFlexibility, type IntentRelated, type IntentRelationship, type Machine, type MachineConfig, Portal, type PortalProps, Presence, type PresenceProps, type PropMeta, type ReadonlySignal, type RovingItemProps, type RovingOrientation, type Signal, Slot, type SlotProps, type StateConfig, SuspenseBoundary, type SuspenseBoundaryProps, type UseAnchorPositionOptions, type UseAnchorPositionReturn, type UseClipboardOptions, type UseClipboardReturn, type UseControllableSignalOptions, type UseRovingFocusOptions, type UseRovingFocusReturn, VERSION, VisuallyHidden, type VisuallyHiddenProps, type WcagLevel, batch, cn, composeRefs, computePosition, computed, createMachine, effect, mergeProps, signal, useAnchorPosition, useClipboard, useComputed, useControllableSignal, useId, useMachine, useMediaQuery, useRovingFocus, useScrollLock, useSignal, useSignalEffect, useSignals };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/machine.ts","../src/utils.ts","../src/error-boundary.tsx","../src/suspense-boundary.tsx","../src/portal.tsx","../src/visually-hidden.tsx","../src/focus-scope.tsx","../src/slot.tsx","../src/controllable.ts","../src/media-query.ts","../src/scroll-lock.ts","../src/use-id.ts","../src/clipboard.ts","../src/dismissable-layer.tsx","../src/roving-focus.ts","../src/presence.tsx","../src/anchor.tsx","../src/index.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,561 @@
+import { batch, computed, effect, signal, useComputed, useSignal, useSignal as useSignal$1, useSignalEffect } from "@preact/signals-react";
+import { useSignals } from "@preact/signals-react/runtime";
+import { Children, Component, Suspense, cloneElement, forwardRef, isValidElement, useId as useId$1, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+import { createPortal } from "react-dom";
+//#region src/machine.ts
+function createMachine(config) {
+	return config;
+}
+function useMachine(machine) {
+	const state = useSignal$1(machine.initial);
+	const send = (event) => {
+		const next = machine.states[state.value]?.on?.[event];
+		if (next !== void 0) state.value = next;
+	};
+	return [state, send];
+}
+//#endregion
+//#region src/utils.ts
+function cn(...classes) {
+	return classes.filter(Boolean).join(" ");
+}
+function composeRefs(...refs) {
+	return (value) => {
+		refs.forEach((ref) => {
+			if (!ref) return;
+			if (typeof ref === "function") ref(value);
+			else ref.current = value;
+		});
+	};
+}
+function mergeProps(...propsList) {
+	const result = {};
+	for (const props of propsList) for (const [key, val] of Object.entries(props)) if (key.startsWith("on") && typeof val === "function" && typeof result[key] === "function") {
+		const existing = result[key];
+		result[key] = (...args) => {
+			existing(...args);
+			val(...args);
+		};
+	} else result[key] = val;
+	return result;
+}
+//#endregion
+//#region src/error-boundary.tsx
+var ErrorBoundary = class extends Component {
+	state = { error: null };
+	static getDerivedStateFromError(error) {
+		return { error };
+	}
+	componentDidCatch(error, info) {
+		this.props.onError?.(error, info);
+	}
+	reset = () => {
+		this.setState({ error: null });
+	};
+	render() {
+		const { error } = this.state;
+		if (error !== null) {
+			const { fallback } = this.props;
+			return typeof fallback === "function" ? fallback(error, this.reset) : fallback;
+		}
+		return this.props.children;
+	}
+};
+//#endregion
+//#region src/suspense-boundary.tsx
+function SuspenseBoundary({ children, fallback }) {
+	return /* @__PURE__ */ jsx(Suspense, {
+		fallback: fallback ?? /* @__PURE__ */ jsx("span", {
+			"aria-busy": "true",
+			"aria-label": "Loading"
+		}),
+		children
+	});
+}
+//#endregion
+//#region src/portal.tsx
+function Portal({ children, container }) {
+	useSignals();
+	const mounted = useSignal(false);
+	const containerRef = useRef(null);
+	useSignalEffect(() => {
+		if (typeof document === "undefined") return;
+		containerRef.current = container ?? document.body;
+		mounted.value = true;
+		return () => {
+			mounted.value = false;
+		};
+	});
+	if (!mounted.value || containerRef.current === null) return null;
+	return createPortal(children, containerRef.current);
+}
+//#endregion
+//#region src/visually-hidden.module.css
+var visually_hidden_module_default = {
+	"focusable": "rYIFkW_focusable",
+	"root": "rYIFkW_root"
+};
+//#endregion
+//#region src/visually-hidden.tsx
+function VisuallyHidden({ children, showOnFocus, className, ...props }) {
+	return /* @__PURE__ */ jsx("span", {
+		className: [
+			visually_hidden_module_default.root,
+			showOnFocus && visually_hidden_module_default.focusable,
+			className
+		].filter(Boolean).join(" "),
+		...props,
+		children
+	});
+}
+//#endregion
+//#region src/focus-scope.tsx
+const FOCUSABLE = "a[href],area[href],input:not([disabled]),select:not([disabled]),textarea:not([disabled]),button:not([disabled]),[tabindex]:not([tabindex=\"-1\"])";
+function FocusScope({ children, trapped, restoreFocus, autoFocus }) {
+	useSignals();
+	const containerRef = useRef(null);
+	const previousFocusRef = useRef(null);
+	useSignalEffect(() => {
+		const container = containerRef.current;
+		if (!container) return;
+		if (restoreFocus) previousFocusRef.current = document.activeElement;
+		if (autoFocus) container.querySelector(FOCUSABLE)?.focus();
+		if (!trapped) return;
+		function handleKeyDown(e) {
+			if (e.key !== "Tab") return;
+			const focusable = Array.from(container.querySelectorAll(FOCUSABLE));
+			if (focusable.length === 0) return;
+			const first = focusable[0];
+			const last = focusable[focusable.length - 1];
+			if (e.shiftKey) {
+				if (document.activeElement === first) {
+					e.preventDefault();
+					last.focus();
+				}
+			} else if (document.activeElement === last) {
+				e.preventDefault();
+				first.focus();
+			}
+		}
+		document.addEventListener("keydown", handleKeyDown);
+		return () => {
+			document.removeEventListener("keydown", handleKeyDown);
+			if (restoreFocus && previousFocusRef.current instanceof HTMLElement) previousFocusRef.current.focus();
+		};
+	});
+	return /* @__PURE__ */ jsx("div", {
+		ref: containerRef,
+		children
+	});
+}
+//#endregion
+//#region src/slot.tsx
+/**
+* Slot renders its single child element while merging the Slot's own props and ref onto it —
+* the Radix-style `asChild` composition primitive, built on cascivo's existing
+* `mergeProps`/`composeRefs`/`cn`.
+*
+* - Non-handler props: child wins (so the consumer's element controls its own identity).
+* - `on*` handlers: chained (Slot's runs, then the child's) via `mergeProps`.
+* - `className`: unioned via `cn`. `style`: shallow-merged (child wins on conflicts).
+* - `ref`: composed so both the Slot consumer's ref and the child's own ref receive the node.
+*
+* Fails fast if `children` is not exactly one valid React element.
+*/
+const Slot = forwardRef(function Slot(props, forwardedRef) {
+	const { children, className: slotClassName, style: slotStyle, ...slotProps } = props;
+	if (!isValidElement(children) || Children.count(children) !== 1) throw new Error("Slot expects exactly one valid React element child (asChild requires a single element).");
+	const child = children;
+	const childProps = child.props;
+	const merged = mergeProps(slotProps, childProps);
+	merged["className"] = cn(slotClassName, childProps["className"]);
+	merged["style"] = {
+		...slotStyle ?? {},
+		...childProps["style"] ?? {}
+	};
+	merged["ref"] = composeRefs(forwardedRef, childProps["ref"] ?? child.ref);
+	return cloneElement(child, merged);
+});
+//#endregion
+//#region src/controllable.ts
+/**
+* Codifies the controlled/uncontrolled pattern documented by hand in CLAUDE.md
+* (`const x = useSignal(open); x.value = open`).
+*
+* Returns a `[signal, setValue]` pair:
+* - **Controlled** (`value` provided): the signal mirrors `value` on every render; `setValue`
+*   does not mutate the signal locally — it only routes the request through `onChange` so the
+*   parent owns the state (React semantics).
+* - **Uncontrolled** (`value` undefined): the signal owns the state seeded from `defaultValue`;
+*   `setValue` updates it locally and also calls `onChange`.
+*
+* Whether a component is controlled is fixed for its life, exactly like React.
+*/
+function useControllableSignal(options) {
+	const { value, defaultValue, onChange } = options;
+	const isControlled = value !== void 0;
+	const sig = useSignal(isControlled ? value : defaultValue);
+	const onChangeRef = useRef(onChange);
+	onChangeRef.current = onChange;
+	if (isControlled) sig.value = value;
+	const setValue = (next) => {
+		if (!isControlled) sig.value = next;
+		onChangeRef.current?.(next);
+	};
+	return [sig, setValue];
+}
+//#endregion
+//#region src/media-query.ts
+function initialMatch(query) {
+	if (typeof window === "undefined" || typeof window.matchMedia !== "function") return false;
+	return window.matchMedia(query).matches;
+}
+/**
+* `useMediaQuery(query)` → a `ReadonlySignal<boolean>` that tracks whether the media query matches.
+* SSR-safe (defaults to `false` when `window`/`matchMedia` is unavailable). Subscribes to changes
+* inside `useSignalEffect`; the listener is cleaned up on teardown.
+*/
+function useMediaQuery(query) {
+	const matches = useSignal(initialMatch(query));
+	useSignalEffect(() => {
+		if (typeof window === "undefined" || typeof window.matchMedia !== "function") return;
+		const mql = window.matchMedia(query);
+		matches.value = mql.matches;
+		const handler = (event) => {
+			matches.value = event.matches;
+		};
+		mql.addEventListener("change", handler);
+		return () => mql.removeEventListener("change", handler);
+	});
+	return matches;
+}
+//#endregion
+//#region src/scroll-lock.ts
+/**
+* Locks `document.body` scroll while `locked` is true, compensating for the scrollbar width to
+* avoid a layout shift. Accepts a plain boolean or a `Signal<boolean>` (reactive). The previous
+* inline styles are restored on unlock/teardown. DOM work runs inside `useSignalEffect`.
+*/
+function useScrollLock(locked) {
+	useSignalEffect(() => {
+		if (!(typeof locked === "boolean" ? locked : locked.value) || typeof document === "undefined") return;
+		const body = document.body;
+		const prevOverflow = body.style.overflow;
+		const prevPaddingInlineEnd = body.style.paddingInlineEnd;
+		const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth;
+		body.style.overflow = "hidden";
+		if (scrollbarWidth > 0) {
+			const current = Number.parseInt(window.getComputedStyle(body).paddingInlineEnd, 10) || 0;
+			body.style.paddingInlineEnd = `${current + scrollbarWidth}px`;
+		}
+		return () => {
+			body.style.overflow = prevOverflow;
+			body.style.paddingInlineEnd = prevPaddingInlineEnd;
+		};
+	});
+}
+//#endregion
+//#region src/use-id.ts
+/**
+* SSR-safe stable id for aria wiring (Label/Field). Wraps React's `useId` and strips the
+* non-selector-safe colons React emits, prefixing for readability (default `cascivo`).
+*/
+function useId(prefix = "cascivo") {
+	return `${prefix}-${useId$1().replace(/:/g, "")}`;
+}
+//#endregion
+//#region src/clipboard.ts
+/**
+* Copy-to-clipboard helper that de-dupes the inline logic in `copy-button`.
+* `copy(text)` writes via `navigator.clipboard.writeText`; `copied` flips true then resets after
+* `timeout`. The reset timer is cleared on unmount via `useSignalEffect` (no `useEffect`).
+*/
+function useClipboard(options = {}) {
+	const { timeout = 2e3 } = options;
+	const copied = useSignal(false);
+	const timerRef = useRef(null);
+	useSignalEffect(() => {
+		return () => {
+			if (timerRef.current) clearTimeout(timerRef.current);
+		};
+	});
+	const copy = async (text) => {
+		if (typeof navigator === "undefined" || !navigator.clipboard) return;
+		await navigator.clipboard.writeText(text);
+		copied.value = true;
+		if (timerRef.current) clearTimeout(timerRef.current);
+		timerRef.current = setTimeout(() => {
+			copied.value = false;
+		}, timeout);
+	};
+	return {
+		copied,
+		copy
+	};
+}
+//#endregion
+//#region src/dismissable-layer.tsx
+const layers = [];
+/**
+* Wraps its children and dismisses on an outside pointer press or Escape. One tested implementation
+* of the dismissal logic every overlay reinvents. Nested layers form a stack — only the top-most
+* responds to Escape and outside pointers. All listeners run inside `useSignalEffect`.
+*/
+function DismissableLayer({ children, onDismiss, disableOutsidePointer, escapeDismisses = true }) {
+	useSignals();
+	const rootRef = useRef(null);
+	const onDismissRef = useRef(onDismiss);
+	onDismissRef.current = onDismiss;
+	useSignalEffect(() => {
+		if (typeof document === "undefined") return;
+		const entry = { getRoot: () => rootRef.current };
+		layers.push(entry);
+		const isTop = () => {
+			const root = rootRef.current;
+			if (!root) return false;
+			for (const other of layers) {
+				if (other === entry) continue;
+				const otherRoot = other.getRoot();
+				if (otherRoot && root.contains(otherRoot)) return false;
+			}
+			return true;
+		};
+		const handlePointer = (event) => {
+			if (disableOutsidePointer || !isTop()) return;
+			const root = rootRef.current;
+			if (!root) return;
+			if (event.target instanceof Node && !root.contains(event.target)) onDismissRef.current?.();
+		};
+		const handleKey = (event) => {
+			if (!escapeDismisses || event.key !== "Escape" || !isTop()) return;
+			onDismissRef.current?.();
+		};
+		document.addEventListener("pointerdown", handlePointer, true);
+		document.addEventListener("keydown", handleKey);
+		return () => {
+			document.removeEventListener("pointerdown", handlePointer, true);
+			document.removeEventListener("keydown", handleKey);
+			const idx = layers.indexOf(entry);
+			if (idx !== -1) layers.splice(idx, 1);
+		};
+	});
+	return /* @__PURE__ */ jsx("div", {
+		ref: rootRef,
+		children
+	});
+}
+//#endregion
+//#region src/roving-focus.ts
+/**
+* Roving tabindex without context. The parent calls `useRovingFocus(...)` and spreads
+* `getItemProps(i)` onto each item. Only the active item is tabbable (`tabIndex={0}`); arrow keys
+* move focus (Home/End jump; `loop` wraps). State lives in a signal — the consuming component reads
+* it during render, so React apps must call `useSignals()` (per the project rule).
+*/
+function useRovingFocus(options = {}) {
+	const { orientation = "horizontal", loop = false, defaultIndex = 0 } = options;
+	const activeIndex = useSignal(defaultIndex);
+	const itemsRef = useRef([]);
+	const focusIndex = (index) => {
+		activeIndex.value = index;
+		itemsRef.current[index]?.focus();
+	};
+	const handleKeyDown = (event, index) => {
+		const count = itemsRef.current.length;
+		if (count === 0) return;
+		const horizontal = orientation !== "vertical";
+		const vertical = orientation !== "horizontal";
+		let next = index;
+		if (horizontal && event.key === "ArrowRight" || vertical && event.key === "ArrowDown") next = index + 1;
+		else if (horizontal && event.key === "ArrowLeft" || vertical && event.key === "ArrowUp") next = index - 1;
+		else if (event.key === "Home") next = 0;
+		else if (event.key === "End") next = count - 1;
+		else return;
+		event.preventDefault();
+		if (next < 0) next = loop ? count - 1 : 0;
+		if (next >= count) next = loop ? 0 : count - 1;
+		focusIndex(next);
+	};
+	const getItemProps = (index) => ({
+		tabIndex: activeIndex.value === index ? 0 : -1,
+		onKeyDown: (event) => handleKeyDown(event, index),
+		onFocus: () => {
+			activeIndex.value = index;
+		},
+		ref: (el) => {
+			itemsRef.current[index] = el;
+		}
+	});
+	return {
+		activeIndex,
+		getItemProps,
+		setActiveIndex: (index) => {
+			activeIndex.value = index;
+		}
+	};
+}
+//#endregion
+//#region src/presence.tsx
+/**
+* Defers unmount until an exit animation/transition finishes. While `present` is true the child is
+* mounted with `data-state="open"`; when it flips to false the child gets `data-state="closed"` and
+* stays mounted until its `animationend`/`transitionend` fires (or unmounts immediately if there is
+* no animation). CSS drives the visuals via `data-state`; this only manages mount timing. No
+* `useEffect` — the present prop is mirrored into a signal and watched with `useSignalEffect`.
+*/
+function Presence({ present, children }) {
+	useSignals();
+	const presentVal = typeof present === "boolean" ? present : present.value;
+	const presentSig = useSignal(presentVal);
+	presentSig.value = presentVal;
+	const isMounted = useSignal(presentVal);
+	const state = useSignal(presentVal ? "open" : "closed");
+	const nodeRef = useRef(null);
+	useSignalEffect(() => {
+		if (presentSig.value) {
+			isMounted.value = true;
+			state.value = "open";
+			return;
+		}
+		state.value = "closed";
+		const node = nodeRef.current;
+		if (!node || typeof getComputedStyle === "undefined") {
+			isMounted.value = false;
+			return;
+		}
+		const styles = getComputedStyle(node);
+		if (!(styles.animationName !== "none" && styles.animationName !== "" && styles.animationDuration !== "0s" || styles.transitionDuration !== "0s" && styles.transitionDuration !== "")) {
+			isMounted.value = false;
+			return;
+		}
+		const handleEnd = (event) => {
+			if (event.target === node) isMounted.value = false;
+		};
+		node.addEventListener("animationend", handleEnd);
+		node.addEventListener("transitionend", handleEnd);
+		return () => {
+			node.removeEventListener("animationend", handleEnd);
+			node.removeEventListener("transitionend", handleEnd);
+		};
+	});
+	if (!isMounted.value) return null;
+	if (!isValidElement(children)) throw new Error("Presence expects a single valid React element child");
+	const child = children;
+	const childRef = child.props["ref"] ?? child.ref;
+	return cloneElement(child, {
+		"data-state": state.value,
+		ref: composeRefs(childRef, (el) => {
+			nodeRef.current = el;
+		})
+	});
+}
+//#endregion
+//#region src/anchor.tsx
+function supportsCssAnchor() {
+	return typeof CSS !== "undefined" && typeof CSS.supports === "function" && CSS.supports("anchor-name: --x");
+}
+function parsePlacement(placement) {
+	const [side, end] = placement.split("-");
+	return {
+		side,
+		align: end ?? "center"
+	};
+}
+/** JS fallback math — position `floating` relative to `anchor` for the given placement. */
+function computePosition(anchor, floating, placement) {
+	const { side, align } = parsePlacement(placement);
+	let top = 0;
+	let left = 0;
+	if (side === "top" || side === "bottom") {
+		top = side === "bottom" ? anchor.bottom : anchor.top - floating.height;
+		left = align === "start" ? anchor.left : align === "end" ? anchor.right - floating.width : anchor.left + (anchor.width - floating.width) / 2;
+	} else {
+		left = side === "right" ? anchor.right : anchor.left - floating.width;
+		top = align === "start" ? anchor.top : align === "end" ? anchor.bottom - floating.height : anchor.top + (anchor.height - floating.height) / 2;
+	}
+	return {
+		top,
+		left
+	};
+}
+function cssAnchorInsets(side, align) {
+	const style = {
+		position: "fixed",
+		insetBlockStart: "auto",
+		insetInlineStart: "auto"
+	};
+	if (side === "bottom") style.top = "anchor(bottom)";
+	if (side === "top") style.bottom = "anchor(top)";
+	if (side === "right") style.left = "anchor(right)";
+	if (side === "left") style.right = "anchor(left)";
+	if (side === "top" || side === "bottom") {
+		style.left = align === "end" ? void 0 : align === "start" ? "anchor(left)" : "anchor(center)";
+		if (align === "end") style.right = "anchor(right)";
+	} else {
+		style.top = align === "end" ? void 0 : align === "start" ? "anchor(top)" : "anchor(center)";
+		if (align === "end") style.bottom = "anchor(bottom)";
+	}
+	return style;
+}
+/**
+* Positions a floating element relative to an anchor. Primary path: CSS anchor positioning
+* (Chrome-leading) — emits `anchor-name`/`position-anchor` + `anchor()` insets. Fallback (behind
+* `CSS.supports`): JS `getBoundingClientRect` placement recomputed on scroll/resize inside
+* `useSignalEffect`. Small by design — not a collision/flip engine (deferred).
+*/
+function useAnchorPosition(options) {
+	const { anchorRef, floatingRef, placement = "bottom", enabled = true } = options;
+	useSignals();
+	const supported = supportsCssAnchor();
+	const name = useId("anchor");
+	const pos = useSignal(null);
+	useSignalEffect(() => {
+		const isEnabled = typeof enabled === "boolean" ? enabled : enabled.value;
+		if (supported || !isEnabled || typeof window === "undefined") return;
+		const update = () => {
+			const a = anchorRef.current;
+			const f = floatingRef.current;
+			if (!a || !f) return;
+			pos.value = computePosition(a.getBoundingClientRect(), f.getBoundingClientRect(), placement);
+		};
+		update();
+		window.addEventListener("scroll", update, true);
+		window.addEventListener("resize", update);
+		return () => {
+			window.removeEventListener("scroll", update, true);
+			window.removeEventListener("resize", update);
+		};
+	});
+	if (supported) {
+		const { side, align } = parsePlacement(placement);
+		return {
+			anchorStyle: { anchorName: `--${name}` },
+			floatingStyle: {
+				positionAnchor: `--${name}`,
+				...cssAnchorInsets(side, align)
+			},
+			cssAnchorSupported: true
+		};
+	}
+	const p = pos.value;
+	return {
+		anchorStyle: {},
+		floatingStyle: p ? {
+			position: "fixed",
+			top: p.top,
+			left: p.left
+		} : {
+			position: "fixed",
+			visibility: "hidden"
+		},
+		cssAnchorSupported: false
+	};
+}
+//#endregion
+//#region src/index.ts
+const VERSION = "0.0.0";
+//#endregion
+export { DismissableLayer, ErrorBoundary, FocusScope, Portal, Presence, Slot, SuspenseBoundary, VERSION, VisuallyHidden, batch, cn, composeRefs, computePosition, computed, createMachine, effect, mergeProps, signal, useAnchorPosition, useClipboard, useComputed, useControllableSignal, useId, useMachine, useMediaQuery, useRovingFocus, useScrollLock, useSignal, useSignalEffect, useSignals };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["useSignal","styles","useReactId"],"sources":["../src/machine.ts","../src/utils.ts","../src/error-boundary.tsx","../src/suspense-boundary.tsx","../src/portal.tsx","../src/visually-hidden.module.css","../src/visually-hidden.tsx","../src/focus-scope.tsx","../src/slot.tsx","../src/controllable.ts","../src/media-query.ts","../src/scroll-lock.ts","../src/use-id.ts","../src/clipboard.ts","../src/dismissable-layer.tsx","../src/roving-focus.ts","../src/presence.tsx","../src/anchor.tsx","../src/index.ts"],"sourcesContent":["import { useSignal } from '@preact/signals-react'\nimport type { Machine, MachineConfig } from './types.ts'\n\nexport function createMachine<S extends string, I extends S = S>(\n  config: MachineConfig<S, I>,\n): Machine<S> {\n  return config as Machine<S>\n}\n\nexport function useMachine<S extends string>(machine: Machine<S>) {\n  const state = useSignal<S>(machine.initial)\n  const send = (event: string) => {\n    const next = machine.states[state.value]?.on?.[event] as S | undefined\n    if (next !== undefined) state.value = next\n  }\n  return [state, send] as const\n}\n","import type { Ref, RefCallback, MutableRefObject } from 'react'\n\nexport function cn(...classes: (string | undefined | null | false | 0)[]): string {\n  return classes.filter(Boolean).join(' ')\n}\n\nexport function composeRefs<T>(...refs: (Ref<T> | undefined)[]): RefCallback<T> {\n  return (value) => {\n    refs.forEach((ref) => {\n      if (!ref) return\n      if (typeof ref === 'function') {\n        ref(value)\n      } else {\n        ;(ref as MutableRefObject<T | null>).current = value\n      }\n    })\n  }\n}\n\ntype EventHandler = (...args: unknown[]) => unknown\n\nexport function mergeProps<T extends Record<string, unknown>>(...propsList: Partial<T>[]): T {\n  const result: Record<string, unknown> = {}\n  for (const props of propsList) {\n    for (const [key, val] of Object.entries(props)) {\n      if (key.startsWith('on') && typeof val === 'function' && typeof result[key] === 'function') {\n        const existing = result[key] as EventHandler\n        result[key] = (...args: unknown[]) => {\n          existing(...args)\n          ;(val as EventHandler)(...args)\n        }\n      } else {\n        result[key] = val\n      }\n    }\n  }\n  return result as T\n}\n","import { Component, type ErrorInfo, type ReactNode } from 'react'\n\nexport interface ErrorBoundaryProps {\n  children: ReactNode\n  fallback: ReactNode | ((error: Error, reset: () => void) => ReactNode)\n  onError?: (error: Error, info: ErrorInfo) => void\n}\n\ninterface State {\n  error: Error | null\n}\n\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, State> {\n  state: State = { error: null }\n\n  static getDerivedStateFromError(error: Error): State {\n    return { error }\n  }\n\n  componentDidCatch(error: Error, info: ErrorInfo) {\n    this.props.onError?.(error, info)\n  }\n\n  reset = () => {\n    this.setState({ error: null })\n  }\n\n  render() {\n    const { error } = this.state\n    if (error !== null) {\n      const { fallback } = this.props\n      return typeof fallback === 'function' ? fallback(error, this.reset) : fallback\n    }\n    return this.props.children\n  }\n}\n","import { Suspense, type ReactNode } from 'react'\n\nexport interface SuspenseBoundaryProps {\n  children: ReactNode\n  fallback?: ReactNode\n}\n\nexport function SuspenseBoundary({ children, fallback }: SuspenseBoundaryProps) {\n  return (\n    <Suspense fallback={fallback ?? <span aria-busy=\"true\" aria-label=\"Loading\" />}>\n      {children}\n    </Suspense>\n  )\n}\n","'use client'\nimport { useRef, type ReactNode } from 'react'\nimport { createPortal } from 'react-dom'\nimport { useSignal, useSignalEffect, useSignals } from './signals.ts'\n\nexport interface PortalProps {\n  children: ReactNode\n  container?: Element | DocumentFragment\n}\n\nexport function Portal({ children, container }: PortalProps) {\n  useSignals()\n  const mounted = useSignal(false)\n  const containerRef = useRef<Element | DocumentFragment | null>(null)\n\n  useSignalEffect(() => {\n    if (typeof document === 'undefined') return\n    containerRef.current = container ?? document.body\n    mounted.value = true\n    return () => {\n      mounted.value = false\n    }\n  })\n\n  if (!mounted.value || containerRef.current === null) return null\n  return createPortal(children, containerRef.current)\n}\n","@layer cascade.component {\n  .root {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    padding: 0;\n    margin: -1px;\n    overflow: hidden;\n    clip: rect(0, 0, 0, 0);\n    white-space: nowrap;\n    border: 0;\n  }\n  .focusable:focus,\n  .focusable:focus-within {\n    position: static;\n    width: auto;\n    height: auto;\n    padding: var(--cascivo-space-2) var(--cascivo-space-3);\n    margin: 0;\n    overflow: visible;\n    clip: auto;\n    white-space: normal;\n  }\n}\n","import type { ReactNode, HTMLAttributes } from 'react'\nimport styles from './visually-hidden.module.css'\n\nexport interface VisuallyHiddenProps extends HTMLAttributes<HTMLSpanElement> {\n  children: ReactNode\n  showOnFocus?: boolean\n}\n\nexport function VisuallyHidden({\n  children,\n  showOnFocus,\n  className,\n  ...props\n}: VisuallyHiddenProps) {\n  const classes = [styles.root, showOnFocus && styles.focusable, className]\n    .filter(Boolean)\n    .join(' ')\n  return (\n    <span className={classes} {...props}>\n      {children}\n    </span>\n  )\n}\n","'use client'\nimport { useRef, type ReactNode } from 'react'\nimport { useSignalEffect, useSignals } from './signals.ts'\n\nconst FOCUSABLE =\n  'a[href],area[href],input:not([disabled]),select:not([disabled]),textarea:not([disabled]),button:not([disabled]),[tabindex]:not([tabindex=\"-1\"])'\n\nexport interface FocusScopeProps {\n  children: ReactNode\n  trapped?: boolean\n  restoreFocus?: boolean\n  autoFocus?: boolean\n}\n\nexport function FocusScope({ children, trapped, restoreFocus, autoFocus }: FocusScopeProps) {\n  useSignals()\n  const containerRef = useRef<HTMLDivElement>(null)\n  const previousFocusRef = useRef<Element | null>(null)\n\n  useSignalEffect(() => {\n    const container = containerRef.current\n    if (!container) return\n    if (restoreFocus) previousFocusRef.current = document.activeElement\n    if (autoFocus) {\n      const first = container.querySelector<HTMLElement>(FOCUSABLE)\n      first?.focus()\n    }\n    if (!trapped) return\n    function handleKeyDown(e: KeyboardEvent) {\n      if (e.key !== 'Tab') return\n      const focusable = Array.from(container!.querySelectorAll<HTMLElement>(FOCUSABLE))\n      if (focusable.length === 0) return\n      const first = focusable[0]!\n      const last = focusable[focusable.length - 1]!\n      if (e.shiftKey) {\n        if (document.activeElement === first) {\n          e.preventDefault()\n          last.focus()\n        }\n      } else {\n        if (document.activeElement === last) {\n          e.preventDefault()\n          first.focus()\n        }\n      }\n    }\n    document.addEventListener('keydown', handleKeyDown)\n    return () => {\n      document.removeEventListener('keydown', handleKeyDown)\n      if (restoreFocus && previousFocusRef.current instanceof HTMLElement) {\n        previousFocusRef.current.focus()\n      }\n    }\n  })\n\n  return <div ref={containerRef}>{children}</div>\n}\n","'use client'\nimport {\n  Children,\n  cloneElement,\n  forwardRef,\n  isValidElement,\n  type CSSProperties,\n  type ReactElement,\n  type ReactNode,\n  type Ref,\n} from 'react'\nimport { cn, composeRefs, mergeProps } from './utils.ts'\n\nexport interface SlotProps {\n  children?: ReactNode\n  className?: string\n  style?: CSSProperties\n  [key: string]: unknown\n}\n\ntype ElementWithRef = ReactElement<Record<string, unknown>> & { ref?: Ref<unknown> }\n\n/**\n * Slot renders its single child element while merging the Slot's own props and ref onto it —\n * the Radix-style `asChild` composition primitive, built on cascivo's existing\n * `mergeProps`/`composeRefs`/`cn`.\n *\n * - Non-handler props: child wins (so the consumer's element controls its own identity).\n * - `on*` handlers: chained (Slot's runs, then the child's) via `mergeProps`.\n * - `className`: unioned via `cn`. `style`: shallow-merged (child wins on conflicts).\n * - `ref`: composed so both the Slot consumer's ref and the child's own ref receive the node.\n *\n * Fails fast if `children` is not exactly one valid React element.\n */\nexport const Slot = forwardRef<unknown, SlotProps>(function Slot(props, forwardedRef) {\n  const { children, className: slotClassName, style: slotStyle, ...slotProps } = props\n\n  if (!isValidElement(children) || Children.count(children) !== 1) {\n    throw new Error(\n      'Slot expects exactly one valid React element child (asChild requires a single element).',\n    )\n  }\n\n  const child = children as ElementWithRef\n  const childProps = child.props\n  const merged = mergeProps<Record<string, unknown>>(slotProps, childProps)\n\n  merged['className'] = cn(\n    slotClassName as string | undefined,\n    childProps['className'] as string | undefined,\n  )\n  merged['style'] = {\n    ...((slotStyle as CSSProperties | undefined) ?? {}),\n    ...((childProps['style'] as CSSProperties | undefined) ?? {}),\n  }\n  // React 19 exposes ref as a regular prop; React 18 keeps it on the element. Prefer props.ref to\n  // avoid touching the deprecated `element.ref` getter when it isn't needed.\n  const childRef = (childProps['ref'] as Ref<unknown> | undefined) ?? child.ref\n  merged['ref'] = composeRefs(forwardedRef, childRef)\n\n  return cloneElement(child, merged)\n})\n","'use client'\nimport { useRef } from 'react'\nimport { useSignal, type Signal } from './signals.ts'\n\nexport interface UseControllableSignalOptions<T> {\n  /** Controlled value. When provided, the component is controlled for its whole life. */\n  value?: T | undefined\n  /** Initial value for uncontrolled use. */\n  defaultValue?: T | undefined\n  /** Called on every write, in both controlled and uncontrolled modes. */\n  onChange?: ((value: T) => void) | undefined\n}\n\n/**\n * Codifies the controlled/uncontrolled pattern documented by hand in CLAUDE.md\n * (`const x = useSignal(open); x.value = open`).\n *\n * Returns a `[signal, setValue]` pair:\n * - **Controlled** (`value` provided): the signal mirrors `value` on every render; `setValue`\n *   does not mutate the signal locally — it only routes the request through `onChange` so the\n *   parent owns the state (React semantics).\n * - **Uncontrolled** (`value` undefined): the signal owns the state seeded from `defaultValue`;\n *   `setValue` updates it locally and also calls `onChange`.\n *\n * Whether a component is controlled is fixed for its life, exactly like React.\n */\nexport function useControllableSignal<T>(\n  options: UseControllableSignalOptions<T>,\n): [Signal<T>, (next: T) => void] {\n  const { value, defaultValue, onChange } = options\n  const isControlled = value !== undefined\n\n  const sig = useSignal<T>((isControlled ? value : defaultValue) as T)\n\n  // Keep onChange current without an effect (the onCloseRef idiom from CLAUDE.md).\n  const onChangeRef = useRef(onChange)\n  onChangeRef.current = onChange\n\n  // Controlled: mirror the prop into the signal each render (no-op if unchanged).\n  if (isControlled) sig.value = value as T\n\n  const setValue = (next: T): void => {\n    if (!isControlled) sig.value = next\n    onChangeRef.current?.(next)\n  }\n\n  return [sig, setValue]\n}\n","'use client'\nimport { useSignal, useSignalEffect, type ReadonlySignal } from './signals.ts'\n\nfunction initialMatch(query: string): boolean {\n  if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return false\n  return window.matchMedia(query).matches\n}\n\n/**\n * `useMediaQuery(query)` → a `ReadonlySignal<boolean>` that tracks whether the media query matches.\n * SSR-safe (defaults to `false` when `window`/`matchMedia` is unavailable). Subscribes to changes\n * inside `useSignalEffect`; the listener is cleaned up on teardown.\n */\nexport function useMediaQuery(query: string): ReadonlySignal<boolean> {\n  const matches = useSignal(initialMatch(query))\n\n  useSignalEffect(() => {\n    if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return\n    const mql = window.matchMedia(query)\n    matches.value = mql.matches\n    const handler = (event: MediaQueryListEvent): void => {\n      matches.value = event.matches\n    }\n    mql.addEventListener('change', handler)\n    return () => mql.removeEventListener('change', handler)\n  })\n\n  return matches\n}\n","'use client'\nimport { useSignalEffect, type Signal } from './signals.ts'\n\n/**\n * Locks `document.body` scroll while `locked` is true, compensating for the scrollbar width to\n * avoid a layout shift. Accepts a plain boolean or a `Signal<boolean>` (reactive). The previous\n * inline styles are restored on unlock/teardown. DOM work runs inside `useSignalEffect`.\n */\nexport function useScrollLock(locked: Signal<boolean> | boolean): void {\n  useSignalEffect(() => {\n    const isLocked = typeof locked === 'boolean' ? locked : locked.value\n    if (!isLocked || typeof document === 'undefined') return\n\n    const body = document.body\n    const prevOverflow = body.style.overflow\n    const prevPaddingInlineEnd = body.style.paddingInlineEnd\n\n    const scrollbarWidth = window.innerWidth - document.documentElement.clientWidth\n    body.style.overflow = 'hidden'\n    if (scrollbarWidth > 0) {\n      const current = Number.parseInt(window.getComputedStyle(body).paddingInlineEnd, 10) || 0\n      body.style.paddingInlineEnd = `${current + scrollbarWidth}px`\n    }\n\n    return () => {\n      body.style.overflow = prevOverflow\n      body.style.paddingInlineEnd = prevPaddingInlineEnd\n    }\n  })\n}\n","'use client'\nimport { useId as useReactId } from 'react'\n\n/**\n * SSR-safe stable id for aria wiring (Label/Field). Wraps React's `useId` and strips the\n * non-selector-safe colons React emits, prefixing for readability (default `cascivo`).\n */\nexport function useId(prefix = 'cascivo'): string {\n  const id = useReactId()\n  return `${prefix}-${id.replace(/:/g, '')}`\n}\n","'use client'\nimport { useRef } from 'react'\nimport { useSignal, useSignalEffect, type ReadonlySignal } from './signals.ts'\n\nexport interface UseClipboardOptions {\n  /** How long `copied` stays true after a successful copy, in ms. */\n  timeout?: number\n}\n\nexport interface UseClipboardReturn {\n  copied: ReadonlySignal<boolean>\n  copy: (text: string) => Promise<void>\n}\n\n/**\n * Copy-to-clipboard helper that de-dupes the inline logic in `copy-button`.\n * `copy(text)` writes via `navigator.clipboard.writeText`; `copied` flips true then resets after\n * `timeout`. The reset timer is cleared on unmount via `useSignalEffect` (no `useEffect`).\n */\nexport function useClipboard(options: UseClipboardOptions = {}): UseClipboardReturn {\n  const { timeout = 2000 } = options\n  const copied = useSignal(false)\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null)\n\n  useSignalEffect(() => {\n    return () => {\n      if (timerRef.current) clearTimeout(timerRef.current)\n    }\n  })\n\n  const copy = async (text: string): Promise<void> => {\n    if (typeof navigator === 'undefined' || !navigator.clipboard) return\n    await navigator.clipboard.writeText(text)\n    copied.value = true\n    if (timerRef.current) clearTimeout(timerRef.current)\n    timerRef.current = setTimeout(() => {\n      copied.value = false\n    }, timeout)\n  }\n\n  return { copied, copy }\n}\n","'use client'\nimport { useRef, type ReactNode } from 'react'\nimport { useSignalEffect, useSignals } from './signals.ts'\n\n// Module-level registry so nested layers (a dropdown inside a modal) dismiss top-first. Effects\n// mount child-first, so a stack would invert nesting; instead we resolve the top-most layer by DOM\n// depth — a layer responds only when no other mounted layer's root is nested inside its own root.\ninterface LayerEntry {\n  getRoot: () => HTMLElement | null\n}\nconst layers: LayerEntry[] = []\n\nexport interface DismissableLayerProps {\n  children: ReactNode\n  /** Called when an outside pointer lands or Escape is pressed (when this is the top-most layer). */\n  onDismiss?: () => void\n  /** Disable the outside-pointer dismissal (Escape still works unless escapeDismisses is false). */\n  disableOutsidePointer?: boolean\n  /** Whether Escape dismisses the top-most layer. Default true. */\n  escapeDismisses?: boolean\n}\n\n/**\n * Wraps its children and dismisses on an outside pointer press or Escape. One tested implementation\n * of the dismissal logic every overlay reinvents. Nested layers form a stack — only the top-most\n * responds to Escape and outside pointers. All listeners run inside `useSignalEffect`.\n */\nexport function DismissableLayer({\n  children,\n  onDismiss,\n  disableOutsidePointer,\n  escapeDismisses = true,\n}: DismissableLayerProps) {\n  useSignals()\n  const rootRef = useRef<HTMLDivElement>(null)\n  const onDismissRef = useRef(onDismiss)\n  onDismissRef.current = onDismiss\n\n  useSignalEffect(() => {\n    if (typeof document === 'undefined') return\n    const entry: LayerEntry = { getRoot: () => rootRef.current }\n    layers.push(entry)\n\n    // Top-most = deepest in the DOM: no other mounted layer's root sits inside this one's root.\n    const isTop = (): boolean => {\n      const root = rootRef.current\n      if (!root) return false\n      for (const other of layers) {\n        if (other === entry) continue\n        const otherRoot = other.getRoot()\n        if (otherRoot && root.contains(otherRoot)) return false\n      }\n      return true\n    }\n\n    const handlePointer = (event: PointerEvent): void => {\n      if (disableOutsidePointer || !isTop()) return\n      const root = rootRef.current\n      if (!root) return\n      if (event.target instanceof Node && !root.contains(event.target)) {\n        onDismissRef.current?.()\n      }\n    }\n    const handleKey = (event: KeyboardEvent): void => {\n      if (!escapeDismisses || event.key !== 'Escape' || !isTop()) return\n      onDismissRef.current?.()\n    }\n\n    document.addEventListener('pointerdown', handlePointer, true)\n    document.addEventListener('keydown', handleKey)\n    return () => {\n      document.removeEventListener('pointerdown', handlePointer, true)\n      document.removeEventListener('keydown', handleKey)\n      const idx = layers.indexOf(entry)\n      if (idx !== -1) layers.splice(idx, 1)\n    }\n  })\n\n  return <div ref={rootRef}>{children}</div>\n}\n","'use client'\nimport { useRef } from 'react'\nimport { useSignal, type ReadonlySignal } from './signals.ts'\n\nexport type RovingOrientation = 'horizontal' | 'vertical' | 'both'\n\nexport interface UseRovingFocusOptions {\n  orientation?: RovingOrientation\n  /** Wrap focus from last→first and first→last. Default false. */\n  loop?: boolean\n  /** Initial active index. Default 0. */\n  defaultIndex?: number\n}\n\nexport interface RovingItemProps {\n  tabIndex: number\n  onKeyDown: (event: React.KeyboardEvent<HTMLElement>) => void\n  onFocus: () => void\n  ref: (el: HTMLElement | null) => void\n}\n\nexport interface UseRovingFocusReturn {\n  activeIndex: ReadonlySignal<number>\n  getItemProps: (index: number) => RovingItemProps\n  setActiveIndex: (index: number) => void\n}\n\n/**\n * Roving tabindex without context. The parent calls `useRovingFocus(...)` and spreads\n * `getItemProps(i)` onto each item. Only the active item is tabbable (`tabIndex={0}`); arrow keys\n * move focus (Home/End jump; `loop` wraps). State lives in a signal — the consuming component reads\n * it during render, so React apps must call `useSignals()` (per the project rule).\n */\nexport function useRovingFocus(options: UseRovingFocusOptions = {}): UseRovingFocusReturn {\n  const { orientation = 'horizontal', loop = false, defaultIndex = 0 } = options\n  const activeIndex = useSignal(defaultIndex)\n  const itemsRef = useRef<(HTMLElement | null)[]>([])\n\n  const focusIndex = (index: number): void => {\n    activeIndex.value = index\n    itemsRef.current[index]?.focus()\n  }\n\n  const handleKeyDown = (event: React.KeyboardEvent<HTMLElement>, index: number): void => {\n    const count = itemsRef.current.length\n    if (count === 0) return\n    const horizontal = orientation !== 'vertical'\n    const vertical = orientation !== 'horizontal'\n    let next = index\n    if ((horizontal && event.key === 'ArrowRight') || (vertical && event.key === 'ArrowDown')) {\n      next = index + 1\n    } else if ((horizontal && event.key === 'ArrowLeft') || (vertical && event.key === 'ArrowUp')) {\n      next = index - 1\n    } else if (event.key === 'Home') {\n      next = 0\n    } else if (event.key === 'End') {\n      next = count - 1\n    } else {\n      return\n    }\n    event.preventDefault()\n    if (next < 0) next = loop ? count - 1 : 0\n    if (next >= count) next = loop ? 0 : count - 1\n    focusIndex(next)\n  }\n\n  const getItemProps = (index: number): RovingItemProps => ({\n    tabIndex: activeIndex.value === index ? 0 : -1,\n    onKeyDown: (event) => handleKeyDown(event, index),\n    onFocus: () => {\n      activeIndex.value = index\n    },\n    ref: (el) => {\n      itemsRef.current[index] = el\n    },\n  })\n\n  return {\n    activeIndex,\n    getItemProps,\n    setActiveIndex: (index: number) => {\n      activeIndex.value = index\n    },\n  }\n}\n","'use client'\nimport { cloneElement, isValidElement, useRef, type ReactElement, type Ref } from 'react'\nimport { useSignal, useSignalEffect, useSignals, type Signal } from './signals.ts'\nimport { composeRefs } from './utils.ts'\n\nexport interface PresenceProps {\n  /** Whether the content should be present. Accepts a boolean or a Signal. */\n  present: boolean | Signal<boolean>\n  /** A single element child; receives `data-state=\"open|closed\"` and a composed ref. */\n  children: ReactElement\n}\n\ntype ElementWithRef = ReactElement<Record<string, unknown>> & { ref?: Ref<unknown> }\n\n/**\n * Defers unmount until an exit animation/transition finishes. While `present` is true the child is\n * mounted with `data-state=\"open\"`; when it flips to false the child gets `data-state=\"closed\"` and\n * stays mounted until its `animationend`/`transitionend` fires (or unmounts immediately if there is\n * no animation). CSS drives the visuals via `data-state`; this only manages mount timing. No\n * `useEffect` — the present prop is mirrored into a signal and watched with `useSignalEffect`.\n */\nexport function Presence({ present, children }: PresenceProps) {\n  useSignals()\n  const presentVal = typeof present === 'boolean' ? present : present.value\n\n  // Mirror the (boolean or signal) present value into a local signal so the effect reacts to both\n  // prop changes (re-render) and signal changes.\n  const presentSig = useSignal(presentVal)\n  presentSig.value = presentVal\n\n  const isMounted = useSignal(presentVal)\n  const state = useSignal<'open' | 'closed'>(presentVal ? 'open' : 'closed')\n  const nodeRef = useRef<HTMLElement | null>(null)\n\n  useSignalEffect(() => {\n    if (presentSig.value) {\n      isMounted.value = true\n      state.value = 'open'\n      return\n    }\n    state.value = 'closed'\n    const node = nodeRef.current\n    if (!node || typeof getComputedStyle === 'undefined') {\n      isMounted.value = false\n      return\n    }\n    const styles = getComputedStyle(node)\n    const animates =\n      (styles.animationName !== 'none' &&\n        styles.animationName !== '' &&\n        styles.animationDuration !== '0s') ||\n      (styles.transitionDuration !== '0s' && styles.transitionDuration !== '')\n    if (!animates) {\n      isMounted.value = false\n      return\n    }\n    const handleEnd = (event: Event): void => {\n      if (event.target === node) isMounted.value = false\n    }\n    node.addEventListener('animationend', handleEnd)\n    node.addEventListener('transitionend', handleEnd)\n    return () => {\n      node.removeEventListener('animationend', handleEnd)\n      node.removeEventListener('transitionend', handleEnd)\n    }\n  })\n\n  if (!isMounted.value) return null\n  if (!isValidElement(children)) {\n    throw new Error('Presence expects a single valid React element child')\n  }\n  const child = children as ElementWithRef\n  const childRef = (child.props['ref'] as Ref<unknown> | undefined) ?? child.ref\n  return cloneElement(child, {\n    'data-state': state.value,\n    ref: composeRefs(childRef, (el: HTMLElement | null) => {\n      nodeRef.current = el\n    }),\n  } as Record<string, unknown>)\n}\n","'use client'\nimport { type CSSProperties, type RefObject } from 'react'\nimport { useSignal, useSignalEffect, useSignals, type Signal } from './signals.ts'\nimport { useId } from './use-id.ts'\n\nexport type AnchorSide = 'top' | 'bottom' | 'left' | 'right'\nexport type AnchorAlign = 'start' | 'center' | 'end'\nexport type AnchorPlacement = AnchorSide | `${AnchorSide}-${'start' | 'end'}`\n\nexport interface UseAnchorPositionOptions {\n  anchorRef: RefObject<HTMLElement | null>\n  floatingRef: RefObject<HTMLElement | null>\n  placement?: AnchorPlacement\n  /** Gate positioning (e.g. only while open). Default true. */\n  enabled?: boolean | Signal<boolean>\n}\n\nexport interface UseAnchorPositionReturn {\n  /** Spread onto the anchor element (CSS-anchor path sets `anchor-name`). */\n  anchorStyle: CSSProperties\n  /** Spread onto the floating element. */\n  floatingStyle: CSSProperties\n  /** Whether the CSS anchor-positioning primary path is active. */\n  cssAnchorSupported: boolean\n}\n\nfunction supportsCssAnchor(): boolean {\n  return (\n    typeof CSS !== 'undefined' &&\n    typeof CSS.supports === 'function' &&\n    CSS.supports('anchor-name: --x')\n  )\n}\n\nfunction parsePlacement(placement: AnchorPlacement): { side: AnchorSide; align: AnchorAlign } {\n  const [side, end] = placement.split('-') as [AnchorSide, 'start' | 'end' | undefined]\n  return { side, align: end ?? 'center' }\n}\n\n/** JS fallback math — position `floating` relative to `anchor` for the given placement. */\nexport function computePosition(\n  anchor: {\n    top: number\n    left: number\n    right: number\n    bottom: number\n    width: number\n    height: number\n  },\n  floating: { width: number; height: number },\n  placement: AnchorPlacement,\n): { top: number; left: number } {\n  const { side, align } = parsePlacement(placement)\n  let top = 0\n  let left = 0\n  if (side === 'top' || side === 'bottom') {\n    top = side === 'bottom' ? anchor.bottom : anchor.top - floating.height\n    left =\n      align === 'start'\n        ? anchor.left\n        : align === 'end'\n          ? anchor.right - floating.width\n          : anchor.left + (anchor.width - floating.width) / 2\n  } else {\n    left = side === 'right' ? anchor.right : anchor.left - floating.width\n    top =\n      align === 'start'\n        ? anchor.top\n        : align === 'end'\n          ? anchor.bottom - floating.height\n          : anchor.top + (anchor.height - floating.height) / 2\n  }\n  return { top, left }\n}\n\nfunction cssAnchorInsets(side: AnchorSide, align: AnchorAlign): CSSProperties {\n  const style: CSSProperties = {\n    position: 'fixed',\n    insetBlockStart: 'auto',\n    insetInlineStart: 'auto',\n  }\n  if (side === 'bottom') style.top = 'anchor(bottom)'\n  if (side === 'top') style.bottom = 'anchor(top)'\n  if (side === 'right') style.left = 'anchor(right)'\n  if (side === 'left') style.right = 'anchor(left)'\n  if (side === 'top' || side === 'bottom') {\n    style.left = align === 'end' ? undefined : align === 'start' ? 'anchor(left)' : 'anchor(center)'\n    if (align === 'end') style.right = 'anchor(right)'\n  } else {\n    style.top = align === 'end' ? undefined : align === 'start' ? 'anchor(top)' : 'anchor(center)'\n    if (align === 'end') style.bottom = 'anchor(bottom)'\n  }\n  return style\n}\n\n/**\n * Positions a floating element relative to an anchor. Primary path: CSS anchor positioning\n * (Chrome-leading) — emits `anchor-name`/`position-anchor` + `anchor()` insets. Fallback (behind\n * `CSS.supports`): JS `getBoundingClientRect` placement recomputed on scroll/resize inside\n * `useSignalEffect`. Small by design — not a collision/flip engine (deferred).\n */\nexport function useAnchorPosition(options: UseAnchorPositionOptions): UseAnchorPositionReturn {\n  const { anchorRef, floatingRef, placement = 'bottom', enabled = true } = options\n  useSignals()\n  const supported = supportsCssAnchor()\n  const name = useId('anchor')\n  const pos = useSignal<{ top: number; left: number } | null>(null)\n\n  useSignalEffect(() => {\n    const isEnabled = typeof enabled === 'boolean' ? enabled : enabled.value\n    if (supported || !isEnabled || typeof window === 'undefined') return\n\n    const update = (): void => {\n      const a = anchorRef.current\n      const f = floatingRef.current\n      if (!a || !f) return\n      pos.value = computePosition(a.getBoundingClientRect(), f.getBoundingClientRect(), placement)\n    }\n    update()\n    window.addEventListener('scroll', update, true)\n    window.addEventListener('resize', update)\n    return () => {\n      window.removeEventListener('scroll', update, true)\n      window.removeEventListener('resize', update)\n    }\n  })\n\n  if (supported) {\n    const { side, align } = parsePlacement(placement)\n    return {\n      anchorStyle: { anchorName: `--${name}` } as CSSProperties,\n      floatingStyle: {\n        positionAnchor: `--${name}`,\n        ...cssAnchorInsets(side, align),\n      } as CSSProperties,\n      cssAnchorSupported: true,\n    }\n  }\n\n  const p = pos.value\n  return {\n    anchorStyle: {},\n    floatingStyle: p\n      ? { position: 'fixed', top: p.top, left: p.left }\n      : { position: 'fixed', visibility: 'hidden' },\n    cssAnchorSupported: false,\n  }\n}\n","export { createMachine, useMachine } from './machine.ts'\nexport {\n  signal,\n  computed,\n  effect,\n  batch,\n  useSignal,\n  useComputed,\n  useSignalEffect,\n  useSignals,\n} from './signals.ts'\nexport type { Signal, ReadonlySignal } from './signals.ts'\nexport { cn, composeRefs, mergeProps } from './utils.ts'\nexport type {\n  Machine,\n  MachineConfig,\n  StateConfig,\n  ComponentMeta,\n  PropMeta,\n  AccessibilityMeta,\n  WcagLevel,\n  ExampleMeta,\n  ComponentIntent,\n  IntentAntiPattern,\n  IntentRelated,\n  IntentFlexibility,\n  IntentContent,\n  IntentRelationship,\n} from './types.ts'\nexport const VERSION = '0.0.0'\nexport { ErrorBoundary } from './error-boundary.tsx'\nexport type { ErrorBoundaryProps } from './error-boundary.tsx'\nexport { SuspenseBoundary } from './suspense-boundary.tsx'\nexport type { SuspenseBoundaryProps } from './suspense-boundary.tsx'\nexport { Portal } from './portal.tsx'\nexport type { PortalProps } from './portal.tsx'\nexport { VisuallyHidden } from './visually-hidden.tsx'\nexport type { VisuallyHiddenProps } from './visually-hidden.tsx'\nexport { FocusScope } from './focus-scope.tsx'\nexport type { FocusScopeProps } from './focus-scope.tsx'\nexport { Slot } from './slot.tsx'\nexport type { SlotProps } from './slot.tsx'\nexport { useControllableSignal } from './controllable.ts'\nexport type { UseControllableSignalOptions } from './controllable.ts'\nexport { useMediaQuery } from './media-query.ts'\nexport { useScrollLock } from './scroll-lock.ts'\nexport { useId } from './use-id.ts'\nexport { useClipboard } from './clipboard.ts'\nexport type { UseClipboardOptions, UseClipboardReturn } from './clipboard.ts'\nexport { DismissableLayer } from './dismissable-layer.tsx'\nexport type { DismissableLayerProps } from './dismissable-layer.tsx'\nexport { useRovingFocus } from './roving-focus.ts'\nexport type {\n  UseRovingFocusOptions,\n  UseRovingFocusReturn,\n  RovingItemProps,\n  RovingOrientation,\n} from './roving-focus.ts'\nexport { Presence } from './presence.tsx'\nexport type { PresenceProps } from './presence.tsx'\nexport { useAnchorPosition, computePosition } from './anchor.tsx'\nexport type {\n  UseAnchorPositionOptions,\n  UseAnchorPositionReturn,\n  AnchorPlacement,\n  AnchorSide,\n  AnchorAlign,\n} from './anchor.tsx'\n"],"mappings":";;;;;;AAGA,SAAgB,cACd,QACY;CACZ,OAAO;AACT;AAEA,SAAgB,WAA6B,SAAqB;CAChE,MAAM,QAAQA,YAAa,QAAQ,OAAO;CAC1C,MAAM,QAAQ,UAAkB;EAC9B,MAAM,OAAO,QAAQ,OAAO,MAAM,QAAQ,KAAK;EAC/C,IAAI,SAAS,KAAA,GAAW,MAAM,QAAQ;CACxC;CACA,OAAO,CAAC,OAAO,IAAI;AACrB;;;ACdA,SAAgB,GAAG,GAAG,SAA4D;CAChF,OAAO,QAAQ,OAAO,OAAO,EAAE,KAAK,GAAG;AACzC;AAEA,SAAgB,YAAe,GAAG,MAA8C;CAC9E,QAAQ,UAAU;EAChB,KAAK,SAAS,QAAQ;GACpB,IAAI,CAAC,KAAK;GACV,IAAI,OAAO,QAAQ,YACjB,IAAI,KAAK;QAER,IAAoC,UAAU;EAEnD,CAAC;CACH;AACF;AAIA,SAAgB,WAA8C,GAAG,WAA4B;CAC3F,MAAM,SAAkC,CAAC;CACzC,KAAK,MAAM,SAAS,WAClB,KAAK,MAAM,CAAC,KAAK,QAAQ,OAAO,QAAQ,KAAK,GAC3C,IAAI,IAAI,WAAW,IAAI,KAAK,OAAO,QAAQ,cAAc,OAAO,OAAO,SAAS,YAAY;EAC1F,MAAM,WAAW,OAAO;EACxB,OAAO,QAAQ,GAAG,SAAoB;GACpC,SAAS,GAAG,IAAI;GACf,IAAsB,GAAG,IAAI;EAChC;CACF,OACE,OAAO,OAAO;CAIpB,OAAO;AACT;;;ACzBA,IAAa,gBAAb,cAAmC,UAAqC;CACtE,QAAe,EAAE,OAAO,KAAK;CAE7B,OAAO,yBAAyB,OAAqB;EACnD,OAAO,EAAE,MAAM;CACjB;CAEA,kBAAkB,OAAc,MAAiB;EAC/C,KAAK,MAAM,UAAU,OAAO,IAAI;CAClC;CAEA,cAAc;EACZ,KAAK,SAAS,EAAE,OAAO,KAAK,CAAC;CAC/B;CAEA,SAAS;EACP,MAAM,EAAE,UAAU,KAAK;EACvB,IAAI,UAAU,MAAM;GAClB,MAAM,EAAE,aAAa,KAAK;GAC1B,OAAO,OAAO,aAAa,aAAa,SAAS,OAAO,KAAK,KAAK,IAAI;EACxE;EACA,OAAO,KAAK,MAAM;CACpB;AACF;;;AC5BA,SAAgB,iBAAiB,EAAE,UAAU,YAAmC;CAC9E,OACE,oBAAC,UAAD;EAAU,UAAU,YAAY,oBAAC,QAAD;GAAM,aAAU;GAAO,cAAW;EAAW,CAAA;EAC1E;CACO,CAAA;AAEd;;;ACHA,SAAgB,OAAO,EAAE,UAAU,aAA0B;CAC3D,WAAW;CACX,MAAM,UAAU,UAAU,KAAK;CAC/B,MAAM,eAAe,OAA0C,IAAI;CAEnE,sBAAsB;EACpB,IAAI,OAAO,aAAa,aAAa;EACrC,aAAa,UAAU,aAAa,SAAS;EAC7C,QAAQ,QAAQ;EAChB,aAAa;GACX,QAAQ,QAAQ;EAClB;CACF,CAAC;CAED,IAAI,CAAC,QAAQ,SAAS,aAAa,YAAY,MAAM,OAAO;CAC5D,OAAO,aAAa,UAAU,aAAa,OAAO;AACpD;;;ACtBA,IAAA,iCAAY;CAAA,aAAA;CAAA,QAAA;AAAA;;;ACIZ,SAAgB,eAAe,EAC7B,UACA,aACA,WACA,GAAG,SACmB;CAItB,OACE,oBAAC,QAAD;EAAM,WAJQ;GAACC,+BAAO;GAAM,eAAeA,+BAAO;GAAW;EAAS,EACrE,OAAO,OAAO,EACd,KAAK,GAEiB;EAAG,GAAI;EAC3B;CACG,CAAA;AAEV;;;AClBA,MAAM,YACJ;AASF,SAAgB,WAAW,EAAE,UAAU,SAAS,cAAc,aAA8B;CAC1F,WAAW;CACX,MAAM,eAAe,OAAuB,IAAI;CAChD,MAAM,mBAAmB,OAAuB,IAAI;CAEpD,sBAAsB;EACpB,MAAM,YAAY,aAAa;EAC/B,IAAI,CAAC,WAAW;EAChB,IAAI,cAAc,iBAAiB,UAAU,SAAS;EACtD,IAAI,WAEF,UADwB,cAA2B,SAC/C,GAAG,MAAM;EAEf,IAAI,CAAC,SAAS;EACd,SAAS,cAAc,GAAkB;GACvC,IAAI,EAAE,QAAQ,OAAO;GACrB,MAAM,YAAY,MAAM,KAAK,UAAW,iBAA8B,SAAS,CAAC;GAChF,IAAI,UAAU,WAAW,GAAG;GAC5B,MAAM,QAAQ,UAAU;GACxB,MAAM,OAAO,UAAU,UAAU,SAAS;GAC1C,IAAI,EAAE;QACA,SAAS,kBAAkB,OAAO;KACpC,EAAE,eAAe;KACjB,KAAK,MAAM;IACb;UAEA,IAAI,SAAS,kBAAkB,MAAM;IACnC,EAAE,eAAe;IACjB,MAAM,MAAM;GACd;EAEJ;EACA,SAAS,iBAAiB,WAAW,aAAa;EAClD,aAAa;GACX,SAAS,oBAAoB,WAAW,aAAa;GACrD,IAAI,gBAAgB,iBAAiB,mBAAmB,aACtD,iBAAiB,QAAQ,MAAM;EAEnC;CACF,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,KAAK;EAAe;CAAc,CAAA;AAChD;;;;;;;;;;;;;;;ACtBA,MAAa,OAAO,WAA+B,SAAS,KAAK,OAAO,cAAc;CACpF,MAAM,EAAE,UAAU,WAAW,eAAe,OAAO,WAAW,GAAG,cAAc;CAE/E,IAAI,CAAC,eAAe,QAAQ,KAAK,SAAS,MAAM,QAAQ,MAAM,GAC5D,MAAM,IAAI,MACR,yFACF;CAGF,MAAM,QAAQ;CACd,MAAM,aAAa,MAAM;CACzB,MAAM,SAAS,WAAoC,WAAW,UAAU;CAExE,OAAO,eAAe,GACpB,eACA,WAAW,YACb;CACA,OAAO,WAAW;EAChB,GAAK,aAA2C,CAAC;EACjD,GAAK,WAAW,YAA0C,CAAC;CAC7D;CAIA,OAAO,SAAS,YAAY,cADV,WAAW,UAAuC,MAAM,GACxB;CAElD,OAAO,aAAa,OAAO,MAAM;AACnC,CAAC;;;;;;;;;;;;;;;;ACnCD,SAAgB,sBACd,SACgC;CAChC,MAAM,EAAE,OAAO,cAAc,aAAa;CAC1C,MAAM,eAAe,UAAU,KAAA;CAE/B,MAAM,MAAM,UAAc,eAAe,QAAQ,YAAkB;CAGnE,MAAM,cAAc,OAAO,QAAQ;CACnC,YAAY,UAAU;CAGtB,IAAI,cAAc,IAAI,QAAQ;CAE9B,MAAM,YAAY,SAAkB;EAClC,IAAI,CAAC,cAAc,IAAI,QAAQ;EAC/B,YAAY,UAAU,IAAI;CAC5B;CAEA,OAAO,CAAC,KAAK,QAAQ;AACvB;;;AC5CA,SAAS,aAAa,OAAwB;CAC5C,IAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,YAAY,OAAO;CACrF,OAAO,OAAO,WAAW,KAAK,EAAE;AAClC;;;;;;AAOA,SAAgB,cAAc,OAAwC;CACpE,MAAM,UAAU,UAAU,aAAa,KAAK,CAAC;CAE7C,sBAAsB;EACpB,IAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,YAAY;EAC9E,MAAM,MAAM,OAAO,WAAW,KAAK;EACnC,QAAQ,QAAQ,IAAI;EACpB,MAAM,WAAW,UAAqC;GACpD,QAAQ,QAAQ,MAAM;EACxB;EACA,IAAI,iBAAiB,UAAU,OAAO;EACtC,aAAa,IAAI,oBAAoB,UAAU,OAAO;CACxD,CAAC;CAED,OAAO;AACT;;;;;;;;ACpBA,SAAgB,cAAc,QAAyC;CACrE,sBAAsB;EAEpB,IAAI,EADa,OAAO,WAAW,YAAY,SAAS,OAAO,UAC9C,OAAO,aAAa,aAAa;EAElD,MAAM,OAAO,SAAS;EACtB,MAAM,eAAe,KAAK,MAAM;EAChC,MAAM,uBAAuB,KAAK,MAAM;EAExC,MAAM,iBAAiB,OAAO,aAAa,SAAS,gBAAgB;EACpE,KAAK,MAAM,WAAW;EACtB,IAAI,iBAAiB,GAAG;GACtB,MAAM,UAAU,OAAO,SAAS,OAAO,iBAAiB,IAAI,EAAE,kBAAkB,EAAE,KAAK;GACvF,KAAK,MAAM,mBAAmB,GAAG,UAAU,eAAe;EAC5D;EAEA,aAAa;GACX,KAAK,MAAM,WAAW;GACtB,KAAK,MAAM,mBAAmB;EAChC;CACF,CAAC;AACH;;;;;;;ACtBA,SAAgB,MAAM,SAAS,WAAmB;CAEhD,OAAO,GAAG,OAAO,GADNC,QACU,EAAE,QAAQ,MAAM,EAAE;AACzC;;;;;;;;ACSA,SAAgB,aAAa,UAA+B,CAAC,GAAuB;CAClF,MAAM,EAAE,UAAU,QAAS;CAC3B,MAAM,SAAS,UAAU,KAAK;CAC9B,MAAM,WAAW,OAA6C,IAAI;CAElE,sBAAsB;EACpB,aAAa;GACX,IAAI,SAAS,SAAS,aAAa,SAAS,OAAO;EACrD;CACF,CAAC;CAED,MAAM,OAAO,OAAO,SAAgC;EAClD,IAAI,OAAO,cAAc,eAAe,CAAC,UAAU,WAAW;EAC9D,MAAM,UAAU,UAAU,UAAU,IAAI;EACxC,OAAO,QAAQ;EACf,IAAI,SAAS,SAAS,aAAa,SAAS,OAAO;EACnD,SAAS,UAAU,iBAAiB;GAClC,OAAO,QAAQ;EACjB,GAAG,OAAO;CACZ;CAEA,OAAO;EAAE;EAAQ;CAAK;AACxB;;;AC/BA,MAAM,SAAuB,CAAC;;;;;;AAiB9B,SAAgB,iBAAiB,EAC/B,UACA,WACA,uBACA,kBAAkB,QACM;CACxB,WAAW;CACX,MAAM,UAAU,OAAuB,IAAI;CAC3C,MAAM,eAAe,OAAO,SAAS;CACrC,aAAa,UAAU;CAEvB,sBAAsB;EACpB,IAAI,OAAO,aAAa,aAAa;EACrC,MAAM,QAAoB,EAAE,eAAe,QAAQ,QAAQ;EAC3D,OAAO,KAAK,KAAK;EAGjB,MAAM,cAAuB;GAC3B,MAAM,OAAO,QAAQ;GACrB,IAAI,CAAC,MAAM,OAAO;GAClB,KAAK,MAAM,SAAS,QAAQ;IAC1B,IAAI,UAAU,OAAO;IACrB,MAAM,YAAY,MAAM,QAAQ;IAChC,IAAI,aAAa,KAAK,SAAS,SAAS,GAAG,OAAO;GACpD;GACA,OAAO;EACT;EAEA,MAAM,iBAAiB,UAA8B;GACnD,IAAI,yBAAyB,CAAC,MAAM,GAAG;GACvC,MAAM,OAAO,QAAQ;GACrB,IAAI,CAAC,MAAM;GACX,IAAI,MAAM,kBAAkB,QAAQ,CAAC,KAAK,SAAS,MAAM,MAAM,GAC7D,aAAa,UAAU;EAE3B;EACA,MAAM,aAAa,UAA+B;GAChD,IAAI,CAAC,mBAAmB,MAAM,QAAQ,YAAY,CAAC,MAAM,GAAG;GAC5D,aAAa,UAAU;EACzB;EAEA,SAAS,iBAAiB,eAAe,eAAe,IAAI;EAC5D,SAAS,iBAAiB,WAAW,SAAS;EAC9C,aAAa;GACX,SAAS,oBAAoB,eAAe,eAAe,IAAI;GAC/D,SAAS,oBAAoB,WAAW,SAAS;GACjD,MAAM,MAAM,OAAO,QAAQ,KAAK;GAChC,IAAI,QAAQ,IAAI,OAAO,OAAO,KAAK,CAAC;EACtC;CACF,CAAC;CAED,OAAO,oBAAC,OAAD;EAAK,KAAK;EAAU;CAAc,CAAA;AAC3C;;;;;;;;;AC9CA,SAAgB,eAAe,UAAiC,CAAC,GAAyB;CACxF,MAAM,EAAE,cAAc,cAAc,OAAO,OAAO,eAAe,MAAM;CACvE,MAAM,cAAc,UAAU,YAAY;CAC1C,MAAM,WAAW,OAA+B,CAAC,CAAC;CAElD,MAAM,cAAc,UAAwB;EAC1C,YAAY,QAAQ;EACpB,SAAS,QAAQ,QAAQ,MAAM;CACjC;CAEA,MAAM,iBAAiB,OAAyC,UAAwB;EACtF,MAAM,QAAQ,SAAS,QAAQ;EAC/B,IAAI,UAAU,GAAG;EACjB,MAAM,aAAa,gBAAgB;EACnC,MAAM,WAAW,gBAAgB;EACjC,IAAI,OAAO;EACX,IAAK,cAAc,MAAM,QAAQ,gBAAkB,YAAY,MAAM,QAAQ,aAC3E,OAAO,QAAQ;OACV,IAAK,cAAc,MAAM,QAAQ,eAAiB,YAAY,MAAM,QAAQ,WACjF,OAAO,QAAQ;OACV,IAAI,MAAM,QAAQ,QACvB,OAAO;OACF,IAAI,MAAM,QAAQ,OACvB,OAAO,QAAQ;OAEf;EAEF,MAAM,eAAe;EACrB,IAAI,OAAO,GAAG,OAAO,OAAO,QAAQ,IAAI;EACxC,IAAI,QAAQ,OAAO,OAAO,OAAO,IAAI,QAAQ;EAC7C,WAAW,IAAI;CACjB;CAEA,MAAM,gBAAgB,WAAoC;EACxD,UAAU,YAAY,UAAU,QAAQ,IAAI;EAC5C,YAAY,UAAU,cAAc,OAAO,KAAK;EAChD,eAAe;GACb,YAAY,QAAQ;EACtB;EACA,MAAM,OAAO;GACX,SAAS,QAAQ,SAAS;EAC5B;CACF;CAEA,OAAO;EACL;EACA;EACA,iBAAiB,UAAkB;GACjC,YAAY,QAAQ;EACtB;CACF;AACF;;;;;;;;;;AC/DA,SAAgB,SAAS,EAAE,SAAS,YAA2B;CAC7D,WAAW;CACX,MAAM,aAAa,OAAO,YAAY,YAAY,UAAU,QAAQ;CAIpE,MAAM,aAAa,UAAU,UAAU;CACvC,WAAW,QAAQ;CAEnB,MAAM,YAAY,UAAU,UAAU;CACtC,MAAM,QAAQ,UAA6B,aAAa,SAAS,QAAQ;CACzE,MAAM,UAAU,OAA2B,IAAI;CAE/C,sBAAsB;EACpB,IAAI,WAAW,OAAO;GACpB,UAAU,QAAQ;GAClB,MAAM,QAAQ;GACd;EACF;EACA,MAAM,QAAQ;EACd,MAAM,OAAO,QAAQ;EACrB,IAAI,CAAC,QAAQ,OAAO,qBAAqB,aAAa;GACpD,UAAU,QAAQ;GAClB;EACF;EACA,MAAM,SAAS,iBAAiB,IAAI;EAMpC,IAAI,EAJD,OAAO,kBAAkB,UACxB,OAAO,kBAAkB,MACzB,OAAO,sBAAsB,QAC9B,OAAO,uBAAuB,QAAQ,OAAO,uBAAuB,KACxD;GACb,UAAU,QAAQ;GAClB;EACF;EACA,MAAM,aAAa,UAAuB;GACxC,IAAI,MAAM,WAAW,MAAM,UAAU,QAAQ;EAC/C;EACA,KAAK,iBAAiB,gBAAgB,SAAS;EAC/C,KAAK,iBAAiB,iBAAiB,SAAS;EAChD,aAAa;GACX,KAAK,oBAAoB,gBAAgB,SAAS;GAClD,KAAK,oBAAoB,iBAAiB,SAAS;EACrD;CACF,CAAC;CAED,IAAI,CAAC,UAAU,OAAO,OAAO;CAC7B,IAAI,CAAC,eAAe,QAAQ,GAC1B,MAAM,IAAI,MAAM,qDAAqD;CAEvE,MAAM,QAAQ;CACd,MAAM,WAAY,MAAM,MAAM,UAAuC,MAAM;CAC3E,OAAO,aAAa,OAAO;EACzB,cAAc,MAAM;EACpB,KAAK,YAAY,WAAW,OAA2B;GACrD,QAAQ,UAAU;EACpB,CAAC;CACH,CAA4B;AAC9B;;;ACrDA,SAAS,oBAA6B;CACpC,OACE,OAAO,QAAQ,eACf,OAAO,IAAI,aAAa,cACxB,IAAI,SAAS,kBAAkB;AAEnC;AAEA,SAAS,eAAe,WAAsE;CAC5F,MAAM,CAAC,MAAM,OAAO,UAAU,MAAM,GAAG;CACvC,OAAO;EAAE;EAAM,OAAO,OAAO;CAAS;AACxC;;AAGA,SAAgB,gBACd,QAQA,UACA,WAC+B;CAC/B,MAAM,EAAE,MAAM,UAAU,eAAe,SAAS;CAChD,IAAI,MAAM;CACV,IAAI,OAAO;CACX,IAAI,SAAS,SAAS,SAAS,UAAU;EACvC,MAAM,SAAS,WAAW,OAAO,SAAS,OAAO,MAAM,SAAS;EAChE,OACE,UAAU,UACN,OAAO,OACP,UAAU,QACR,OAAO,QAAQ,SAAS,QACxB,OAAO,QAAQ,OAAO,QAAQ,SAAS,SAAS;CAC1D,OAAO;EACL,OAAO,SAAS,UAAU,OAAO,QAAQ,OAAO,OAAO,SAAS;EAChE,MACE,UAAU,UACN,OAAO,MACP,UAAU,QACR,OAAO,SAAS,SAAS,SACzB,OAAO,OAAO,OAAO,SAAS,SAAS,UAAU;CAC3D;CACA,OAAO;EAAE;EAAK;CAAK;AACrB;AAEA,SAAS,gBAAgB,MAAkB,OAAmC;CAC5E,MAAM,QAAuB;EAC3B,UAAU;EACV,iBAAiB;EACjB,kBAAkB;CACpB;CACA,IAAI,SAAS,UAAU,MAAM,MAAM;CACnC,IAAI,SAAS,OAAO,MAAM,SAAS;CACnC,IAAI,SAAS,SAAS,MAAM,OAAO;CACnC,IAAI,SAAS,QAAQ,MAAM,QAAQ;CACnC,IAAI,SAAS,SAAS,SAAS,UAAU;EACvC,MAAM,OAAO,UAAU,QAAQ,KAAA,IAAY,UAAU,UAAU,iBAAiB;EAChF,IAAI,UAAU,OAAO,MAAM,QAAQ;CACrC,OAAO;EACL,MAAM,MAAM,UAAU,QAAQ,KAAA,IAAY,UAAU,UAAU,gBAAgB;EAC9E,IAAI,UAAU,OAAO,MAAM,SAAS;CACtC;CACA,OAAO;AACT;;;;;;;AAQA,SAAgB,kBAAkB,SAA4D;CAC5F,MAAM,EAAE,WAAW,aAAa,YAAY,UAAU,UAAU,SAAS;CACzE,WAAW;CACX,MAAM,YAAY,kBAAkB;CACpC,MAAM,OAAO,MAAM,QAAQ;CAC3B,MAAM,MAAM,UAAgD,IAAI;CAEhE,sBAAsB;EACpB,MAAM,YAAY,OAAO,YAAY,YAAY,UAAU,QAAQ;EACnE,IAAI,aAAa,CAAC,aAAa,OAAO,WAAW,aAAa;EAE9D,MAAM,eAAqB;GACzB,MAAM,IAAI,UAAU;GACpB,MAAM,IAAI,YAAY;GACtB,IAAI,CAAC,KAAK,CAAC,GAAG;GACd,IAAI,QAAQ,gBAAgB,EAAE,sBAAsB,GAAG,EAAE,sBAAsB,GAAG,SAAS;EAC7F;EACA,OAAO;EACP,OAAO,iBAAiB,UAAU,QAAQ,IAAI;EAC9C,OAAO,iBAAiB,UAAU,MAAM;EACxC,aAAa;GACX,OAAO,oBAAoB,UAAU,QAAQ,IAAI;GACjD,OAAO,oBAAoB,UAAU,MAAM;EAC7C;CACF,CAAC;CAED,IAAI,WAAW;EACb,MAAM,EAAE,MAAM,UAAU,eAAe,SAAS;EAChD,OAAO;GACL,aAAa,EAAE,YAAY,KAAK,OAAO;GACvC,eAAe;IACb,gBAAgB,KAAK;IACrB,GAAG,gBAAgB,MAAM,KAAK;GAChC;GACA,oBAAoB;EACtB;CACF;CAEA,MAAM,IAAI,IAAI;CACd,OAAO;EACL,aAAa,CAAC;EACd,eAAe,IACX;GAAE,UAAU;GAAS,KAAK,EAAE;GAAK,MAAM,EAAE;EAAK,IAC9C;GAAE,UAAU;GAAS,YAAY;EAAS;EAC9C,oBAAoB;CACtB;AACF;;;ACtHA,MAAa,UAAU"}

package/dist/style.css

@@ -0,0 +1,24 @@
+@layer cascade.component {
+  .rYIFkW_root {
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+    width: 1px;
+    height: 1px;
+    margin: -1px;
+    padding: 0;
+    position: absolute;
+    overflow: hidden;
+  }
+
+  .rYIFkW_focusable:focus, .rYIFkW_focusable:focus-within {
+    width: auto;
+    height: auto;
+    padding: var(--cascivo-space-2) var(--cascivo-space-3);
+    clip: auto;
+    white-space: normal;
+    margin: 0;
+    position: static;
+    overflow: visible;
+  }
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@cascivo/core",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Micro-FSM and Preact Signals primitives powering every cascade component",
+  "keywords": [
+    "cascivo",
+    "css",
+    "design-system",
+    "fsm",
+    "preact-signals",
+    "react",
+    "signals"
+  ],
+  "homepage": "https://github.com/urbanisierung/cascivo/tree/main/packages/core#readme",
+  "bugs": "https://github.com/urbanisierung/cascivo/issues",
+  "license": "MIT",
+  "author": "urbanisierung",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/urbanisierung/cascivo.git",
+    "directory": "packages/core"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@preact/signals-react": "^3",
+    "@testing-library/react": "^16.3.2",
+    "@tsdown/css": "^0.22.2",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "jsdom": "^29",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "^5",
+    "vite-plus": "^0.1.24"
+  },
+  "peerDependencies": {
+    "@preact/signals-react": ">=2.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "check": "tsc --noEmit",
+    "test": "vp test",
+    "dev": "vp pack --watch"
+  }
+}

package/readme.body.md

@@ -0,0 +1 @@
+Core runtime for cascade — micro-FSM engine, Preact Signals integration (`useSignal`, `useComputed`, `useSignalEffect`, `useSignals`), and base utilities shared across all components.