@typed/ui 1.0.0-beta.6 → 1.0.0-beta.8

package/dist/Slider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Slider.d.ts","sourceRoot":"","sources":["../src/Slider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAQ,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAK;IACpB;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;EAA0C,CAAC;AAEnE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY;;2EAE9C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EACzC,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAE5B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAc,SAAQ,GAAG,CAAC,WAAW,CAAC,gBAAgB,CAAC;IACtE;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzE;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzD;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzD;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACnE;AAED,iBAAS,aAAa,CAAC,KAAK,CAAC,OAAO,SAAS,aAAa,EAAE,OAAO,EAAE,OAAO,kBACpD,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC;aAEnD,IAAI,EAAE,OAAO;aACb,KAAK;aACL,QAAQ;aACR,GAAG;aACH,GAAG;aACH,IAAI;aACJ,OAAO;aAKP,GAAG;EAER;AACD,KAAK,mBAAmB,CAAC,OAAO,SAAS,aAAa,IAAI,UAAU,CAClE,UAAU,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,CAC1C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,aAAa,EAAE,KAAK,CAAC,IAAI,SAAS,UAAU,GAAG,KAAK,EAC/F,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,0DAW9F"}
+{"version":3,"file":"Slider.d.ts","sourceRoot":"","sources":["../src/Slider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAQ,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;GACG;AACH,MAAM,WAAW,KAAK;IACpB;OACG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;GACG;AACH,MAAM,WAAW,YAAY;IAC3B;OACG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;GACG;AACH,eAAO,MAAM,WAAW;;EAA0C,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY;;2EAE9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EACzC,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAE5B;AAED;GACG;AACH,MAAM,WAAW,aAAc,SAAQ,GAAG,CAAC,WAAW,CAAC,gBAAgB,CAAC;IACtE;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzE;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzD;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzD;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACnE;AAED,iBAAS,aAAa,CAAC,KAAK,CAAC,OAAO,SAAS,aAAa,EAAE,OAAO,EAAE,OAAO,kBACpD,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC;aAEnD,IAAI,EAAE,OAAO;aACb,KAAK;aACL,QAAQ;aACR,GAAG;aACH,GAAG;aACH,IAAI;aACJ,OAAO;aAKP,GAAG;EAER;AACD,KAAK,mBAAmB,CAAC,OAAO,SAAS,aAAa,IAAI,UAAU,CAClE,UAAU,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,CAC1C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,MAAM,CAAC,KAAK,CAAC,OAAO,SAAS,aAAa,EAAE,KAAK,CAAC,IAAI,SAAS,UAAU,GAAG,KAAK,EAC/F,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,0DAW9F"}

package/dist/Slider.js

@@ -1,23 +1,26 @@
+/**
+ * Native range input publishing numeric updates during input.
+ * Keep programmatic values coherent with bounds and control expensive downstream work separately.
+ *
+ * Read the [Slider guide](/explore/ui-slider) for a complete example.
+ *
+ * [APG interaction reference](https://www.w3.org/WAI/ARIA/apg/patterns/slider/).
+ * @since 1.0.0
+ * @category Overview
+ * @packageDocumentation
+ */
 import * as Effect from "effect/Effect";
 import * as Schema from "effect/Schema";
 import { RefSubject } from "@typed/fx";
 import { EventHandler, html } from "@typed/template";
 import * as Dom from "./Dom.js";
-/** Schema for slider hydration state.
- * @remarks
- * ## Why
- * Finite validation prevents invalid serialized range values.
- * ## Ownership and lifetime
- * The immutable schema acquires no resources.
- * @since 1.0.0
- * @category schemas
+/**
  */
 export const StateSchema = Schema.Struct({ value: Schema.Finite });
-/** Creates hydrated slider state.
+/**
+ * Creates hydrated slider state.
  * @remarks
- * ## Why
  * State can be composed and tested independently of the renderer.
- * ## Ownership and lifetime
  * The calling Effect Scope owns the returned RefSubject.
  * @example
  * ```ts
@@ -29,29 +32,20 @@ export const StateSchema = Schema.Struct({ value: Schema.Finite });
  * })
  * ```
  * @since 1.0.0
- * @category constructors
+ * @category State construction
  */
 export function makeState(initial) {
     return RefSubject.hydrate(StateSchema, initial);
 }
-/** Updates the synchronized slider value.
- * @remarks
- * ## Why
- * An explicit Effect transition preserves RefSubject failures and services.
- * ## Ownership and lifetime
- * It uses the existing state lifetime and acquires no resource.
- * @example
- * ```ts
- * import { Effect } from "effect"
- * import * as Slider from "@typed/ui/Slider"
+/**
+ * Assigns a range value without clamping or snapping it.
  *
- * const program = Effect.gen(function* () {
- *   const state = yield* Slider.makeState({ value: 25 })
- *   yield* Slider.setValue(state, 50)
- * })
- * ```
+ * @remarks
+ * min, max, and step belong to the native input options and are not consulted here. Validate or
+ * normalize programmatic values before assignment so the subject and browser-sanitized range
+ * value stay consistent.
  * @since 1.0.0
- * @category state
+ * @category State transitions
  */
 export function setValue(state, value) {
     return RefSubject.update(state, (current) => ({ ...current, value }));
@@ -68,26 +62,37 @@ function internalProps(options) {
         ref: options.state,
     });
 }
-/** Renders a native range input synchronized with hydrated state.
+/**
+ * Renders a native range input whose input events update numeric state.
+ *
  * @remarks
- * ## Why
- * Browser pointer, keyboard, constraints, and accessibility remain intact;
- * input events update the same RefSubject consumed elsewhere.
- * ## Ownership and lifetime
- * Running the Fx owns native listeners and subscriptions in its Scope. A
- * custom host must preserve type, value, range props, and the hydration ref.
+ * Dragging publishes through input, so expensive downstream work should control its own update
+ * rate. Native min/max/step, keyboard interaction, and pointer behavior stay with the browser.
+ * Supply a label and a unit-bearing readout; a custom non-input host must implement the
+ * interaction itself.
+ *
  * @example
  * ```ts
- * import { Effect } from "effect"
- * import * as Slider from "@typed/ui/Slider"
+ * import { RefSubject } from "@typed/fx";
+ * import { html } from "@typed/template";
+ * import { component } from "@typed/ui/Component";
+ * import * as Slider from "@typed/ui/Slider";
  *
- * const program = Effect.gen(function* () {
- *   const state = yield* Slider.makeState({ value: 50 })
- *   return Slider.Slider({ state, min: 0, max: 100 })
- * })
+ * export const ZoomControl = component(function* () {
+ *   const state = yield* Slider.makeState({ value: 100 });
+ *   const percentage = RefSubject.map(state, ({ value }) => `${value}%`);
+ *   return html`<div class="zoom-control">
+ *     <label for="preview-zoom">Preview zoom</label>
+ *     ${Slider.Slider({
+ *       state, min: 50, max: 200, step: 10,
+ *       props: { id: "preview-zoom", name: "zoom", "aria-valuetext": percentage },
+ *     })}
+ *     <output for="preview-zoom">${percentage}</output>
+ *   </div>`;
+ * });
  * ```
  * @since 1.0.0
- * @category components
+ * @category Native controls
  */
 export function Slider(options, host) {
     return Dom.renderHost()(options, host, internalProps(options), "", (props) => {

package/dist/SpinButton.d.ts

@@ -1,68 +1,43 @@
+/**
+ * Native number entry publishing valueAsNumber at the change boundary.
+ * This thin primitive does not maintain draft strings or filter invalid numeric writes.
+ *
+ * Read the [SpinButton guide](/explore/ui-spin-button) for a complete example.
+ *
+ * [APG interaction reference](https://www.w3.org/WAI/ARIA/apg/patterns/spinbutton/).
+ * @since 1.0.0
+ * @category Overview
+ * @packageDocumentation
+ */
 import * as Effect from "effect/Effect";
 import * as Schema from "effect/Schema";
 import { RefSubject } from "@typed/fx";
 import { EventHandler, type Renderable } from "@typed/template";
 import * as Dom from "./Dom.js";
 import type { HostResult } from "./Dom/Types.js";
-/** Current renderer-independent spin-button value.
- * @remarks
- * ## Why
- * Numeric state can be transformed and tested without an input element.
- * ## Ownership and lifetime
- * Plain state is resource-free; RefSubject ownership is Scope-based.
- * @since 1.0.0
- * @category state
+/**
  */
 export interface State {
-    /** Finite value reflected by the native number input.
-     * @remarks
-     * ## Why
-     * One source keeps form control and application state aligned.
-     * ## Ownership and lifetime
-     * Plain data acquires no resources.
-     * @since 1.0.0
-     * @category state
+    /**
      */
     readonly value: number;
 }
-/** Initial spin-button value.
- * @remarks
- * ## Why
- * Explicit state gives SSR and hydration the same numeric snapshot.
- * ## Ownership and lifetime
- * Configuration is inert.
- * @since 1.0.0
- * @category state
+/**
  */
 export interface InitialState {
-    /** Finite initial value.
-     * @remarks
-     * ## Why
-     * It seeds synchronized state before the element mounts.
-     * ## Ownership and lifetime
-     * Plain data retains no resources.
-     * @since 1.0.0
-     * @category state
+    /**
      */
     readonly value: number;
 }
-/** Schema for spin-button hydration state.
- * @remarks
- * ## Why
- * Finite validation prevents invalid serialized number values.
- * ## Ownership and lifetime
- * The immutable schema acquires no resources.
- * @since 1.0.0
- * @category schemas
+/**
  */
 export declare const StateSchema: Schema.Struct<{
     readonly value: Schema.Finite;
 }>;
-/** Creates hydrated spin-button state.
+/**
+ * Creates hydrated spin-button state.
  * @remarks
- * ## Why
  * State remains renderer-independent and directly testable.
- * ## Ownership and lifetime
  * The calling Effect Scope owns the returned RefSubject.
  * @example
  * ```ts
@@ -74,80 +49,47 @@ export declare const StateSchema: Schema.Struct<{
  * })
  * ```
  * @since 1.0.0
- * @category constructors
+ * @category State construction
  */
 export declare function makeState(initial: InitialState): Effect.Effect<RefSubject.HydratedRefSubject<{
     readonly value: number;
 }, Schema.SchemaError, never, never>, never, import("effect/Scope").Scope>;
-/** Updates the synchronized numeric value.
- * @remarks
- * ## Why
- * An explicit Effect transition preserves RefSubject errors and services.
- * ## Ownership and lifetime
- * It uses the existing state lifetime and acquires no resource.
- * @example
- * ```ts
- * import { Effect } from "effect"
- * import * as SpinButton from "@typed/ui/SpinButton"
+/**
+ * Assigns a numeric value without bounds checks or draft filtering.
  *
- * const program = Effect.gen(function* () {
- *   const state = yield* SpinButton.makeState({ value: 1 })
- *   yield* SpinButton.setValue(state, 2)
- * })
- * ```
+ * @remarks
+ * The helper does not consult min/max/step or reject NaN. The hydration schema describes finite
+ * snapshots, but this update is not a decoder. Choose Form.NumberInput or an explicit draft
+ * model when invalid text needs structured feedback.
  * @since 1.0.0
- * @category state
+ * @category State transitions
  */
 export declare function setValue<E, R>(state: RefSubject.RefSubject<State, E, R>, value: number): Effect.Effect<State, E, R>;
-/** Options for a native number input.
- * @remarks
- * ## Why
- * Native spin-button behavior supplies editing, stepping, forms, and
- * accessibility while Typed synchronizes state.
- * ## Ownership and lifetime
- * Options are inert; the mounted component owns subscriptions by Scope.
- * @since 1.0.0
- * @category models
+/**
  */
 export interface SpinButtonOptions extends Dom.HostOptions<HTMLInputElement> {
-    /** Hydrated value state.
-     * @remarks
-     * ## Why
-     * One source serves SSR, UI, and renderer-free state logic.
-     * ## Ownership and lifetime
-     * The component borrows state and subscribes only while mounted.
+    /**
+     * Hydrated value state.
      * @since 1.0.0
-     * @category state
+     * @category State connection
      */
     readonly state: RefSubject.HydratedRefSubject<State, Schema.SchemaError>;
-    /** Native minimum value.
-     * @remarks
-     * ## Why
-     * The platform applies this bound to stepping and validation.
-     * ## Ownership and lifetime
-     * Dynamic attributes follow the component Scope.
+    /**
+     * Native minimum value.
      * @since 1.0.0
-     * @category attributes
+     * @category Numeric bounds
      */
     readonly min?: Renderable.Any<number | null | undefined>;
-    /** Native maximum value.
-     * @remarks
-     * ## Why
-     * The platform applies this bound to stepping and validation.
-     * ## Ownership and lifetime
-     * Dynamic attributes follow the component Scope.
+    /**
+     * Native maximum value.
      * @since 1.0.0
-     * @category attributes
+     * @category Numeric bounds
      */
     readonly max?: Renderable.Any<number | null | undefined>;
-    /** Native step value or `"any"`.
-     * @remarks
-     * ## Why
-     * Increment semantics remain delegated to the number input.
-     * ## Ownership and lifetime
-     * Dynamic attributes follow the component Scope.
+    /**
+     * Native step value or `"any"`.
      * @since 1.0.0
-     * @category attributes
+     * @category Numeric bounds
      */
     readonly step?: Renderable.Any<number | "any" | null | undefined>;
 }
@@ -162,26 +104,37 @@ declare function internalProps<const Options extends SpinButtonOptions>(options:
     readonly ref: RefSubject.HydratedRefSubject<State, Schema.SchemaError, never, never>;
 };
 type SpinButtonInternalProps<Options extends SpinButtonOptions> = ReturnType<ReturnType<typeof internalProps<Options>>>;
-/** Renders a native number input synchronized with hydrated state.
+/**
+ * Renders a native number input that writes valueAsNumber on change.
+ *
  * @remarks
- * ## Why
- * Browser editing, stepping, validation, and form behavior remain intact while
- * change events update renderer-independent state.
- * ## Ownership and lifetime
- * Running the Fx owns listener/state subscriptions in its Scope. A custom host
- * must preserve type, value, constraints, and the single hydration ref owner.
+ * State updates occur at the change boundary rather than every input event. Empty or invalid
+ * native text can yield NaN; the handler does not filter it before assignment. This thin
+ * primitive does not preserve a separate draft string, create field errors, or clamp
+ * programmatic writes.
+ *
  * @example
  * ```ts
- * import { Effect } from "effect"
- * import * as SpinButton from "@typed/ui/SpinButton"
+ * import { RefSubject } from "@typed/fx";
+ * import { html } from "@typed/template";
+ * import { component } from "@typed/ui/Component";
+ * import * as SpinButton from "@typed/ui/SpinButton";
  *
- * const program = Effect.gen(function* () {
- *   const state = yield* SpinButton.makeState({ value: 1 })
- *   return SpinButton.SpinButton({ state, min: 0 })
- * })
+ * export const CopyCount = component(function* () {
+ *   const state = yield* SpinButton.makeState({ value: 1 });
+ *   const summary = RefSubject.map(state, ({ value }) => `Copies requested: ${value}`);
+ *   return html`<div class="copy-count">
+ *     <label for="print-copies">Number of copies</label>
+ *     ${SpinButton.SpinButton({
+ *       state, min: 1, max: 100, step: 1,
+ *       props: { id: "print-copies", name: "copies", required: true },
+ *     })}
+ *     <p>${summary}</p>
+ *   </div>`;
+ * });
  * ```
  * @since 1.0.0
- * @category components
+ * @category Native controls
  */
 export declare function SpinButton<const Options extends SpinButtonOptions, const Host extends HostResult = never>(options: Options, host?: Dom.HostOverride<Dom.RenderHostProps<Options, SpinButtonInternalProps<Options>>, "", Host>): import("./Dom/Types.js").HostComponent<Host | Options>;
 export {};

package/dist/SpinButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SpinButton.d.ts","sourceRoot":"","sources":["../src/SpinButton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAQ,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,WAAW,KAAK;IACpB;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;EAA0C,CAAC;AAEnE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY;;2EAE9C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EACzC,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAE5B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC1E;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzE;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzD;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzD;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACnE;AAED,iBAAS,aAAa,CAAC,KAAK,CAAC,OAAO,SAAS,iBAAiB,EAAE,OAAO,EAAE,OAAO,kBACxD,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC;aAEnD,IAAI,EAAE,QAAQ;aACd,KAAK;aACL,QAAQ;aACR,GAAG;aACH,GAAG;aACH,IAAI;aACJ,QAAQ;aAKR,GAAG;EAER;AACD,KAAK,uBAAuB,CAAC,OAAO,SAAS,iBAAiB,IAAI,UAAU,CAC1E,UAAU,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,CAC1C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CACxB,KAAK,CAAC,OAAO,SAAS,iBAAiB,EACvC,KAAK,CAAC,IAAI,SAAS,UAAU,GAAG,KAAK,EAErC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,0DAWlG"}
+{"version":3,"file":"SpinButton.d.ts","sourceRoot":"","sources":["../src/SpinButton.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAQ,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;GACG;AACH,MAAM,WAAW,KAAK;IACpB;OACG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;GACG;AACH,MAAM,WAAW,YAAY;IAC3B;OACG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;GACG;AACH,eAAO,MAAM,WAAW;;EAA0C,CAAC;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY;;2EAE9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAC3B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EACzC,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAE5B;AAED;GACG;AACH,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC1E;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IACzE;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzD;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACzD;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACnE;AAED,iBAAS,aAAa,CAAC,KAAK,CAAC,OAAO,SAAS,iBAAiB,EAAE,OAAO,EAAE,OAAO,kBACxD,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC;aAEnD,IAAI,EAAE,QAAQ;aACd,KAAK;aACL,QAAQ;aACR,GAAG;aACH,GAAG;aACH,IAAI;aACJ,QAAQ;aAKR,GAAG;EAER;AACD,KAAK,uBAAuB,CAAC,OAAO,SAAS,iBAAiB,IAAI,UAAU,CAC1E,UAAU,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,CAC1C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CACxB,KAAK,CAAC,OAAO,SAAS,iBAAiB,EACvC,KAAK,CAAC,IAAI,SAAS,UAAU,GAAG,KAAK,EAErC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,0DAWlG"}

package/dist/SpinButton.js

@@ -1,23 +1,26 @@
+/**
+ * Native number entry publishing valueAsNumber at the change boundary.
+ * This thin primitive does not maintain draft strings or filter invalid numeric writes.
+ *
+ * Read the [SpinButton guide](/explore/ui-spin-button) for a complete example.
+ *
+ * [APG interaction reference](https://www.w3.org/WAI/ARIA/apg/patterns/spinbutton/).
+ * @since 1.0.0
+ * @category Overview
+ * @packageDocumentation
+ */
 import * as Effect from "effect/Effect";
 import * as Schema from "effect/Schema";
 import { RefSubject } from "@typed/fx";
 import { EventHandler, html } from "@typed/template";
 import * as Dom from "./Dom.js";
-/** Schema for spin-button hydration state.
- * @remarks
- * ## Why
- * Finite validation prevents invalid serialized number values.
- * ## Ownership and lifetime
- * The immutable schema acquires no resources.
- * @since 1.0.0
- * @category schemas
+/**
  */
 export const StateSchema = Schema.Struct({ value: Schema.Finite });
-/** Creates hydrated spin-button state.
+/**
+ * Creates hydrated spin-button state.
  * @remarks
- * ## Why
  * State remains renderer-independent and directly testable.
- * ## Ownership and lifetime
  * The calling Effect Scope owns the returned RefSubject.
  * @example
  * ```ts
@@ -29,29 +32,20 @@ export const StateSchema = Schema.Struct({ value: Schema.Finite });
  * })
  * ```
  * @since 1.0.0
- * @category constructors
+ * @category State construction
  */
 export function makeState(initial) {
     return RefSubject.hydrate(StateSchema, initial);
 }
-/** Updates the synchronized numeric value.
- * @remarks
- * ## Why
- * An explicit Effect transition preserves RefSubject errors and services.
- * ## Ownership and lifetime
- * It uses the existing state lifetime and acquires no resource.
- * @example
- * ```ts
- * import { Effect } from "effect"
- * import * as SpinButton from "@typed/ui/SpinButton"
+/**
+ * Assigns a numeric value without bounds checks or draft filtering.
  *
- * const program = Effect.gen(function* () {
- *   const state = yield* SpinButton.makeState({ value: 1 })
- *   yield* SpinButton.setValue(state, 2)
- * })
- * ```
+ * @remarks
+ * The helper does not consult min/max/step or reject NaN. The hydration schema describes finite
+ * snapshots, but this update is not a decoder. Choose Form.NumberInput or an explicit draft
+ * model when invalid text needs structured feedback.
  * @since 1.0.0
- * @category state
+ * @category State transitions
  */
 export function setValue(state, value) {
     return RefSubject.update(state, (current) => ({ ...current, value }));
@@ -68,26 +62,37 @@ function internalProps(options) {
         ref: options.state,
     });
 }
-/** Renders a native number input synchronized with hydrated state.
+/**
+ * Renders a native number input that writes valueAsNumber on change.
+ *
  * @remarks
- * ## Why
- * Browser editing, stepping, validation, and form behavior remain intact while
- * change events update renderer-independent state.
- * ## Ownership and lifetime
- * Running the Fx owns listener/state subscriptions in its Scope. A custom host
- * must preserve type, value, constraints, and the single hydration ref owner.
+ * State updates occur at the change boundary rather than every input event. Empty or invalid
+ * native text can yield NaN; the handler does not filter it before assignment. This thin
+ * primitive does not preserve a separate draft string, create field errors, or clamp
+ * programmatic writes.
+ *
  * @example
  * ```ts
- * import { Effect } from "effect"
- * import * as SpinButton from "@typed/ui/SpinButton"
+ * import { RefSubject } from "@typed/fx";
+ * import { html } from "@typed/template";
+ * import { component } from "@typed/ui/Component";
+ * import * as SpinButton from "@typed/ui/SpinButton";
  *
- * const program = Effect.gen(function* () {
- *   const state = yield* SpinButton.makeState({ value: 1 })
- *   return SpinButton.SpinButton({ state, min: 0 })
- * })
+ * export const CopyCount = component(function* () {
+ *   const state = yield* SpinButton.makeState({ value: 1 });
+ *   const summary = RefSubject.map(state, ({ value }) => `Copies requested: ${value}`);
+ *   return html`<div class="copy-count">
+ *     <label for="print-copies">Number of copies</label>
+ *     ${SpinButton.SpinButton({
+ *       state, min: 1, max: 100, step: 1,
+ *       props: { id: "print-copies", name: "copies", required: true },
+ *     })}
+ *     <p>${summary}</p>
+ *   </div>`;
+ * });
  * ```
  * @since 1.0.0
- * @category components
+ * @category Native controls
  */
 export function SpinButton(options, host) {
     return Dom.renderHost()(options, host, internalProps(options), "", (props) => {

package/dist/Storybook.d.ts

@@ -16,7 +16,7 @@ import { type RenderEvent, type RenderTemplate } from "@typed/template";
  * removal observer; removing the canvas is the observer's cleanup boundary.
  *
  * @since 1.0.0
- * @category testing
+ * @category Story lifetime
  */
 export interface MountedStory {
     /** Detached div containing the story's real rendered DOM. */
@@ -70,7 +70,7 @@ export interface MountedStory {
  * ```
  *
  * @since 1.0.0
- * @category testing
+ * @category Story mounting
  */
 export declare function mount<E>(content: Fx.Fx<RenderEvent, E, Scope.Scope | RenderTemplate>, document?: Document): Promise<MountedStory>;
 //# sourceMappingURL=Storybook.d.ts.map

package/dist/Storybook.js

@@ -51,7 +51,7 @@ import { DomRenderTemplate, render as renderDom, } from "@typed/template";
  * ```
  *
  * @since 1.0.0
- * @category testing
+ * @category Story mounting
  */
 export async function mount(content, document = globalThis.document) {
     const canvas = document.createElement("div");