foldkit-primitives 0.15.3 → 0.16.0

package/dist/interaction/tree-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-navigation.js","names":[],"sources":["../../src/interaction/tree-navigation.ts"],"sourcesContent":["/**\n * Keyboard navigation of a tree (a file explorer, a page's layers, a nested\n * menu), after the WAI-ARIA tree pattern: one tab stop, Up and Down through the\n * rows that are showing, Right to open a row or step into it, Left to close it\n * or step out to its parent, Home and End to the first and last row.\n *\n * The Model slice is the current row's id and which rows are open. Openness is\n * stored as the rows `toggled` away from a default, so a layers panel that\n * starts with everything open and a file tree that starts closed are the same\n * bundle with a different `openByDefault`, and neither stores every row.\n *\n * Which rows exist is the view's to say, each with its parent, in tree order.\n * What a key does is a pure function of those rows and the Model; the Behavior\n * wires it to the slots and writes the tree's ARIA attributes.\n */\nimport { Option, Schema } from 'effect'\nimport type { HtmlBuilder, KeyboardModifiers } from 'foldkit/html'\nimport { defineMessageUnion } from 'foldkit/message'\nimport { Bundle } from 'foldkit-bundle'\nimport type { Declared } from 'foldkit-bundle'\nimport { Behavior, Capability, type SlotItem } from 'foldkit-mixins'\nimport { FollowTabStop } from '../dom/follow-tab-stop.js'\nimport { idSelector } from './roving-tabindex.js'\nimport { perInput } from '../internal.js'\n\nexport const Model = Schema.Struct({\n  /** The current row's id, or `null` before any row has been focused. */\n  current: Schema.NullOr(Schema.String),\n  /** The rows whose open state differs from `openByDefault`. */\n  toggled: Schema.Array(Schema.String),\n})\nexport type Model = typeof Model.Type\n\nexport const Message = defineMessageUnion({\n  /** A row became current: the user focused it, or a key moved there. */\n  Focused: { id: Schema.String },\n  Opened: { id: Schema.String },\n  Closed: { id: Schema.String },\n})\nexport type Message = typeof Message.Type\n\nexport const Args = Schema.Struct({\n  /** Whether a row with children starts open. */\n  openByDefault: Schema.Boolean,\n})\nexport type Args = typeof Args.Type\n\n/** Whether a row is open, given the default and what was toggled. */\nexport const isOpen = (model: Model, args: Args, id: string): boolean =>\n  args.openByDefault !== model.toggled.includes(id)\n\nconst setOpen = (model: Model, args: Args, id: string, open: boolean): Model =>\n  isOpen(model, args, id) === open\n    ? model\n    : {\n        ...model,\n        toggled: model.toggled.includes(id)\n          ? model.toggled.filter(toggled => toggled !== id)\n          : [...model.toggled, id],\n      }\n\nexport const bundle = Bundle.make('TreeNavigation', {\n  Model,\n  Message,\n  args: Args,\n  init: () => ({ model: { current: null, toggled: [] } }),\n  update: (model, message, args) => {\n    switch (message._tag) {\n      // Moving focus by key dispatches `Focused`, and the row's `OnFocus` reports it again.\n      case 'Focused':\n        return model.current === message.id\n          ? { model }\n          : { model: { ...model, current: message.id } }\n      case 'Opened':\n        return { model: setOpen(model, args, message.id, true) }\n      case 'Closed':\n        return { model: setOpen(model, args, message.id, false) }\n    }\n  },\n})\n\n/** One row of the tree, in tree order: a parent comes before its children. */\nexport interface Row {\n  readonly id: string\n  /** The parent's id, or `null` for a top-level row. */\n  readonly parent: string | null\n  /** Whether it has children, so it can be opened and closed. */\n  readonly branch: boolean\n  readonly disabled?: boolean\n}\n\n/** A row as it is showing: where it sits, for its ARIA attributes. */\nexport interface Shown extends Row {\n  /** 1 for a top-level row. */\n  readonly level: number\n  /** Its place among its siblings, from 1, and how many there are. */\n  readonly position: number\n  readonly siblings: number\n}\n\n/**\n * The rows that are showing: every row whose ancestors are all open, with its\n * level and its place among its siblings. A row whose parent is not a row is\n * treated as top-level.\n */\nexport const shown = (rows: ReadonlyArray<Row>, model: Model, args: Args): ReadonlyArray<Shown> => {\n  const byId = new Map(rows.map(row => [row.id, row]))\n  // Each row's place among its siblings, counted once: a page of a thousand rows\n  // under one parent is not a million steps.\n  const siblingsOf = new Map<string | null, number>()\n  const positionOf = new Map<string, number>()\n  for (const row of rows) {\n    const parent = row.parent !== null && byId.has(row.parent) ? row.parent : null\n    const count = (siblingsOf.get(parent) ?? 0) + 1\n    siblingsOf.set(parent, count)\n    positionOf.set(row.id, count)\n  }\n  const levels = new Map<string, number>()\n  const showing = new Map<string, boolean>()\n  const result: Array<Shown> = []\n  for (const row of rows) {\n    const parent = row.parent !== null && byId.has(row.parent) ? row.parent : null\n    const level = parent === null ? 1 : (levels.get(parent) ?? 0) + 1\n    levels.set(row.id, level)\n    const visible = parent === null || (showing.get(parent) === true && isOpen(model, args, parent))\n    showing.set(row.id, visible)\n    if (!visible) continue\n    result.push({\n      ...row,\n      level,\n      position: positionOf.get(row.id) ?? 1,\n      siblings: siblingsOf.get(parent) ?? 1,\n    })\n  }\n  return result\n}\n\n/** What a key does: move to a row, or open or close one. */\nexport type Action =\n  | { readonly _tag: 'Focus'; readonly id: string }\n  | { readonly _tag: 'Open'; readonly id: string }\n  | { readonly _tag: 'Close'; readonly id: string }\n\nconst isPlain = (modifiers: KeyboardModifiers): boolean =>\n  !modifiers.ctrlKey && !modifiers.altKey && !modifiers.metaKey\n\n/**\n * What a key does from the current row, over the rows that are showing, or\n * `undefined` when it is not a key the tree handles. Disabled rows are stepped\n * over. With nothing current, Down and Home land on the first row, Up and End\n * on the last. Right and Left swap under `rtl`.\n */\nexport const move = (\n  rows: ReadonlyArray<Shown>,\n  current: string | null,\n  key: string,\n  modifiers: KeyboardModifiers,\n  model: Model,\n  args: Args,\n  direction: 'ltr' | 'rtl' = 'ltr',\n): Action | undefined => {\n  const enabled = rows.filter(row => row.disabled !== true)\n  if (enabled.length === 0 || !isPlain(modifiers)) return undefined\n  const focus = (row: Row | undefined): Action | undefined =>\n    row === undefined ? undefined : { _tag: 'Focus', id: row.id }\n  const at = enabled.findIndex(row => row.id === current)\n  const inward = direction === 'rtl' ? 'ArrowLeft' : 'ArrowRight'\n  const outward = direction === 'rtl' ? 'ArrowRight' : 'ArrowLeft'\n  if (key === 'Home') return focus(enabled[0])\n  if (key === 'End') return focus(enabled[enabled.length - 1])\n  if (key === 'ArrowDown')\n    return focus(at === -1 ? enabled[0] : enabled[Math.min(at + 1, enabled.length - 1)])\n  if (key === 'ArrowUp')\n    return focus(at === -1 ? enabled[enabled.length - 1] : enabled[Math.max(at - 1, 0)])\n  const row = enabled[at]\n  if (row === undefined) return key === inward || key === outward ? focus(enabled[0]) : undefined\n  if (key === inward) {\n    if (!row.branch) return undefined\n    if (!isOpen(model, args, row.id)) return { _tag: 'Open', id: row.id }\n    return focus(enabled.find(child => child.parent === row.id))\n  }\n  if (key === outward) {\n    if (row.branch && isOpen(model, args, row.id)) return { _tag: 'Close', id: row.id }\n    return focus(enabled.find(parent => parent.id === row.parent))\n  }\n  return undefined\n}\n\n/** The row that holds the tab stop: the current one while it is showing, else the first. */\nexport const tabStop = (rows: ReadonlyArray<Shown>, current: string | null): string | undefined => {\n  const here = rows.find(row => row.id === current && row.disabled !== true)\n  return (here ?? rows.find(row => row.disabled !== true))?.id\n}\n\nexport interface BehaviorOptions<Input, Slots> {\n  /** The slot that receives the keys: the element with `role=\"tree\"`. */\n  readonly container: keyof Slots & string\n  /** The slot rendered once per showing row, with `item.id` or `item.index` into `shown`. */\n  readonly item: keyof Slots & string\n  /** Every row, open or not, in tree order. */\n  readonly rows: (input: Input) => ReadonlyArray<Row>\n  /** The DOM id a row's element carries. Default: the row's own id. */\n  readonly domId?: (id: string) => string\n  readonly direction?: (input: Input) => 'ltr' | 'rtl'\n}\n\n/** The rows showing for one input, with what each row's attributes look up. */\ninterface Prepared {\n  readonly model: Model\n  readonly rows: ReadonlyArray<Shown>\n  readonly byId: ReadonlyMap<string, Shown>\n  readonly stop: string | undefined\n}\n\n/**\n * Wires a placed `TreeNavigation` to the slots. The container's keys move focus\n * to the row they pick, or open or close the current row with focus left where\n * it is. Each showing row gets its id, `role=\"treeitem\"`, `aria-level` (and\n * the same level as `--fk-tree-level`, so one `calc` indents any depth),\n * `aria-posinset`, `aria-setsize`, `aria-expanded` when it has children,\n * `aria-disabled` when disabled, a roving `tabindex`, and `OnFocus` reporting\n * it current. Every handled key is default-prevented.\n */\n\nexport const behavior =\n  <Field extends string>(declared: Declared<typeof bundle, Field>, args: Args) =>\n  <Slots>(slots: Slots) =>\n  <Input extends { readonly [K in Field]: Model }, ParentMessage>(\n    options: BehaviorOptions<Input, Slots>,\n  ): Behavior.NamedBehavior<Slots, Input, ParentMessage> => {\n    const wrap = (message: Message): ParentMessage =>\n      declared.wrapper.make(message) as unknown as ParentMessage\n    const slice = (input: Input): Model => input[declared.field]\n    const domId = options.domId ?? ((id: string) => id)\n    // Every row's attributes read the same rows: work them out once per input,\n    // or a tree of n rows costs n times its whole.\n    const prepare = perInput((input: Input): Prepared => {\n      const model = slice(input)\n      const rows = shown(options.rows(input), model, args)\n      return {\n        model,\n        rows,\n        byId: new Map(rows.map(row => [row.id, row])),\n        stop: tabStop(rows, model.current),\n      }\n    })\n    return Behavior.forSlots(slots)<Input, ParentMessage>(\n      {\n        [options.container]: Behavior.slot({\n          requires: { capability: Capability.Interactive },\n          // Focus in the tree stays on its stop when an edit elsewhere moves or removes it.\n          mount: () => FollowTabStop(),\n          attributes: ({\n            input,\n            h,\n          }: {\n            readonly input: Input\n            readonly h: HtmlBuilder<ParentMessage>\n          }) => {\n            const { model, rows } = prepare(input)\n            const direction = options.direction?.(input) ?? 'ltr'\n            return [\n              h.OnKeyDownFocus((key, modifiers) => {\n                const action = move(rows, model.current, key, modifiers, model, args, direction)\n                if (action === undefined) return Option.none()\n                // Opening or closing keeps focus on the row it acted on.\n                const message =\n                  action._tag === 'Focus'\n                    ? Message.Focused({ id: action.id })\n                    : action._tag === 'Open'\n                      ? Message.Opened({ id: action.id })\n                      : Message.Closed({ id: action.id })\n                return Option.some({\n                  focusSelector: idSelector(domId(action.id)),\n                  message: wrap(message),\n                })\n              }),\n            ]\n          },\n        }),\n        [options.item]: Behavior.slot({\n          requires: { capability: Capability.Focusable },\n          attributes: ({\n            input,\n            h,\n            item,\n          }: {\n            readonly input: Input\n            readonly h: HtmlBuilder<ParentMessage>\n            readonly item?: SlotItem\n          }) => {\n            if (item === undefined) return []\n            const { model, rows, byId, stop } = prepare(input)\n            const row = item.id === undefined ? rows[item.index] : byId.get(item.id)\n            if (row === undefined) return []\n            return [\n              h.Id(domId(row.id)),\n              h.Role('treeitem'),\n              h.AriaLevel(row.level),\n              h.Style({ '--fk-tree-level': String(row.level) }),\n              h.AriaPosinset(row.position),\n              h.AriaSetsize(row.siblings),\n              ...(row.branch ? [h.AriaExpanded(isOpen(model, args, row.id))] : []),\n              ...(row.disabled === true ? [h.AriaDisabled(true)] : []),\n              h.Tabindex(stop === row.id ? 0 : -1),\n              h.OnFocus(wrap(Message.Focused({ id: row.id }))),\n            ]\n          },\n        }),\n        // Keyed by values the caller chose; `forSlots` checks both keys exist.\n      } as unknown as Behavior.BehaviorSpec<Slots, Input, ParentMessage>,\n      { name: 'TreeNavigation' },\n    )\n  }\n"],"mappings":"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"}

package/dist/interaction/typeahead.d.ts

@@ -0,0 +1,73 @@
+import { Schema } from "effect";
+import { Bundle, Declared } from "foldkit-bundle";
+import { Behavior, Behaviors } from "foldkit-mixins";
+import { KeyboardModifiers } from "foldkit/html";
+export declare const Model: Schema.Struct<{
+  readonly query: Schema.String;
+  /** Bumped per keystroke, carried by the clear it schedules, so a superseded
+   *  timer's `Expired` changes nothing. */
+  readonly generation: Schema.Number;
+}>;
+export type Model = typeof Model.Type;
+export declare const Message: import("foldkit/message").MessageUnion<{
+  /** A printable key was pressed with no ctrl, alt or meta. */
+  readonly Typed: {
+    char: Schema.String;
+  };
+  /** The clear timer fired for `generation`. */
+  readonly Expired: {
+    generation: Schema.Number;
+  };
+  /** The query was dropped on purpose (a blur, a selection). */
+  readonly Cleared: {};
+}>;
+export type Message = typeof Message.Type;
+export declare const Args: Schema.Struct<{
+  /** How long the query survives after the last key. */
+  readonly timeoutMs: Schema.Number;
+}>;
+export type Args = typeof Args.Type;
+export declare const bundle: Bundle.Bundle<"Typeahead", {
+  readonly timeoutMs: number;
+}, {
+  readonly query: string;
+  readonly generation: number;
+}, {
+  readonly _tag: "Cleared";
+} | {
+  readonly _tag: "Expired";
+  readonly generation: number;
+} | {
+  readonly _tag: "Typed";
+  readonly char: string;
+}, never, never, never, void, {}, {}>;
+/**
+ * The enabled index whose text starts with `query`, searching forward from
+ * `current` and wrapping, or `undefined`. A query of one character, or one
+ * character repeated (`aaa`), starts *after* the current item so repeated
+ * presses cycle through the items that begin with it; a longer query starts
+ * *at* the current item, since the user is refining a match. Case and leading
+ * whitespace are ignored.
+ */
+export declare const match: (texts: ReadonlyArray<string>, enabled: ReadonlyArray<number>, query: string, current: number) => number | undefined;
+/** A single character with no ctrl, alt or meta: a typeahead key. */
+export declare const isPrintable: (key: string, modifiers: KeyboardModifiers) => boolean;
+export interface BehaviorOptions<Input, Slots> {
+  /** The slot that receives the keys. */
+  readonly host: keyof Slots & string;
+  readonly items: (input: Input) => Behaviors.Collection.Items<unknown>;
+  /** The text an item is matched by. */
+  readonly text: (input: Input, index: number) => string;
+  /** The current item's id, so the search starts from it; a placed
+   *  `RovingTabindex` is the usual source. */
+  readonly current: (input: Input) => string | null;
+}
+/**
+ * Wires a placed `Typeahead` to the host slot: a printable key extends the
+ * query, focuses the matching item by its id (which then reports itself
+ * current, through `RovingTabindex`'s `OnFocus`), and dispatches `Typed`.
+ * With no match the key still extends the query, so the next one can match;
+ * a space with an empty query is left to the host (it activates).
+ */
+export declare const behavior: <Field extends string>(declared: Declared<typeof bundle, Field>) => <Slots>(slots: Slots) => <Input extends { readonly [K in Field]: Model; }, ParentMessage>(options: BehaviorOptions<Input, Slots>) => Behavior.NamedBehavior<Slots, Input, ParentMessage>;
+//# sourceMappingURL=typeahead.d.ts.map

package/dist/interaction/typeahead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeahead.d.ts","names":[],"sources":["../../src/interaction/typeahead.ts"],"mappings":";;;;qBAea,OAAK,OAAA;;;;;;YAMN,eAAe,MAAM;qBAEpB,mCAAO;;;IAET,MAAI,OAAA;;;;IAEF,YAAU,OAAA;;;;;YAIX,iBAAiB,QAAQ;qBAExB,MAAI,OAAA;;;;YAOL,cAAc,KAAK;qBAElB,QAAM,OAAA;;;;;;;;;;;;;;;;;;;;;;qBAuCN,QAAK,OACT,uBAAqB,SACnB,uBAAqB,eACjB;;qBAgBF,cAAW,aAAe,WAAa;iBAGnC,gBAAgB,OAAO;;WAE7B,YAAY;WACZ,QAAQ,OAAO,UAAU,UAAU,WAAW;;WAE9C,OAAO,OAAO,OAAO;;;WAGrB,UAAU,OAAO;;;;;;;;;qBAUf,WACV,sBAAoB,UAAY,gBAAgB,QAAQ,YACxD,OAAK,OAAS,WACd,0BAA0B,KAAK,QAAQ,UAAS,eAAa,SACnD,gBAAgB,OAAO,WAC/B,SAAS,cAAc,OAAO,OAAO"}

package/dist/interaction/typeahead.js

@@ -0,0 +1,113 @@
+import { Effect, Option, Schema } from "effect";
+import { defineMessageUnion } from "foldkit/message";
+import { Bundle } from "foldkit-bundle";
+import { clearQuery } from "../internal.js";
+import { Behavior, Capability } from "foldkit-mixins";
+import { idSelector } from "./roving-tabindex.js";
+// src/interaction/typeahead.ts
+/**
+* Typeahead over a set of items: printable keys build a query that a timer
+* clears, and the query picks the item to move to. The query lives in the
+* Model so a replay sees the same picks; the timer runs on Effect's clock so
+* TestClock drives it. Which item matches is a pure function.
+*/
+const Model = Schema.Struct({
+	query: Schema.String,
+	/** Bumped per keystroke, carried by the clear it schedules, so a superseded
+	*  timer's `Expired` changes nothing. */
+	generation: Schema.Number
+});
+const Message = defineMessageUnion({
+	/** A printable key was pressed with no ctrl, alt or meta. */
+	Typed: { char: Schema.String },
+	/** The clear timer fired for `generation`. */
+	Expired: { generation: Schema.Number },
+	/** The query was dropped on purpose (a blur, a selection). */
+	Cleared: {}
+});
+const Args = Schema.Struct({ 
+/** How long the query survives after the last key. */
+timeoutMs: Schema.Number.pipe(Schema.check(Schema.isGreaterThan(0)), Schema.check(Schema.isFinite())) });
+const bundle = Bundle.make("Typeahead", {
+	Model,
+	Message,
+	args: Args,
+	init: () => ({ model: {
+		query: "",
+		generation: 0
+	} }),
+	update: (model, message, args) => Message.match(message, {
+		Typed: ({ char }) => {
+			const generation = model.generation + 1;
+			return {
+				model: {
+					query: model.query + char,
+					generation
+				},
+				commands: [{
+					name: "Typeahead.expire",
+					args: { generation },
+					effect: Effect.as(Effect.sleep(args.timeoutMs), Message.Expired({ generation }))
+				}]
+			};
+		},
+		Expired: ({ generation }) => generation === model.generation ? clearQuery(model) : { model },
+		Cleared: () => clearQuery(model)
+	})
+});
+const normalize = (text) => text.trimStart().toLocaleLowerCase();
+const isRepeated = (query) => query.length > 1 && [...query].every((char) => char === query[0]);
+/**
+* The enabled index whose text starts with `query`, searching forward from
+* `current` and wrapping, or `undefined`. A query of one character, or one
+* character repeated (`aaa`), starts *after* the current item so repeated
+* presses cycle through the items that begin with it; a longer query starts
+* *at* the current item, since the user is refining a match. Case and leading
+* whitespace are ignored.
+*/
+const match = (texts, enabled, query, current) => {
+	if (query === "" || enabled.length === 0) return void 0;
+	const needle = normalize(isRepeated(query) ? query[0] : query);
+	const position = enabled.indexOf(current);
+	const startAfter = needle.length === 1 || isRepeated(query);
+	const start = position === -1 ? 0 : startAfter ? position + 1 : position;
+	for (let offset = 0; offset < enabled.length; offset += 1) {
+		const index = enabled[(start + offset) % enabled.length];
+		if (normalize(texts[index] ?? "").startsWith(needle)) return index;
+	}
+};
+/** A single character with no ctrl, alt or meta: a typeahead key. */
+const isPrintable = (key, modifiers) => key.length === 1 && !modifiers.ctrlKey && !modifiers.altKey && !modifiers.metaKey;
+/**
+* Wires a placed `Typeahead` to the host slot: a printable key extends the
+* query, focuses the matching item by its id (which then reports itself
+* current, through `RovingTabindex`'s `OnFocus`), and dispatches `Typed`.
+* With no match the key still extends the query, so the next one can match;
+* a space with an empty query is left to the host (it activates).
+*/
+const behavior = (declared) => (slots) => (options) => {
+	const wrap = (char) => declared.wrapper.make(Message.Typed({ char }));
+	return Behavior.forSlots(slots)({ [options.host]: Behavior.slot({
+		requires: { capability: Capability.Interactive },
+		attributes: ({ input, h }) => {
+			const items = options.items(input);
+			const query = input[declared.field].query;
+			const currentId = options.current(input);
+			const current = currentId === null ? -1 : items.indexOf(currentId);
+			return [h.OnKeyDownFocus((key, modifiers) => {
+				if (!isPrintable(key, modifiers)) return Option.none();
+				if (key === " " && query === "") return Option.none();
+				const texts = items.ids.map((_, index) => options.text(input, index));
+				const found = match(texts, items.enabled, query + key, current);
+				const target = found === void 0 ? currentId : items.ids[found];
+				return Option.some({
+					focusSelector: target === null || target === void 0 ? ":not(*)" : idSelector(target),
+					message: wrap(key)
+				});
+			})];
+		}
+	}) }, { name: "Typeahead" });
+};
+export { Args, Message, Model, behavior, bundle, isPrintable, match };
+
+//# sourceMappingURL=typeahead.js.map

package/dist/interaction/typeahead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeahead.js","names":[],"sources":["../../src/interaction/typeahead.ts"],"sourcesContent":["/**\n * Typeahead over a set of items: printable keys build a query that a timer\n * clears, and the query picks the item to move to. The query lives in the\n * Model so a replay sees the same picks; the timer runs on Effect's clock so\n * TestClock drives it. Which item matches is a pure function.\n */\nimport { Effect, Option, Schema } from 'effect'\nimport type { HtmlBuilder, KeyboardModifiers } from 'foldkit/html'\nimport { defineMessageUnion } from 'foldkit/message'\nimport type * as Update from 'foldkit/update'\nimport { Bundle, type Declared } from 'foldkit-bundle'\nimport { Behavior, Behaviors, Capability } from 'foldkit-mixins'\nimport { idSelector } from './roving-tabindex.js'\nimport { clearQuery } from '../internal.js'\n\nexport const Model = Schema.Struct({\n  query: Schema.String,\n  /** Bumped per keystroke, carried by the clear it schedules, so a superseded\n   *  timer's `Expired` changes nothing. */\n  generation: Schema.Number,\n})\nexport type Model = typeof Model.Type\n\nexport const Message = defineMessageUnion({\n  /** A printable key was pressed with no ctrl, alt or meta. */\n  Typed: { char: Schema.String },\n  /** The clear timer fired for `generation`. */\n  Expired: { generation: Schema.Number },\n  /** The query was dropped on purpose (a blur, a selection). */\n  Cleared: {},\n})\nexport type Message = typeof Message.Type\n\nexport const Args = Schema.Struct({\n  /** How long the query survives after the last key. */\n  timeoutMs: Schema.Number.pipe(\n    Schema.check(Schema.isGreaterThan(0)),\n    Schema.check(Schema.isFinite()),\n  ),\n})\nexport type Args = typeof Args.Type\n\nexport const bundle = Bundle.make('Typeahead', {\n  Model,\n  Message,\n  args: Args,\n  init: () => ({ model: { query: '', generation: 0 } }),\n  update: (model, message, args) =>\n    Message.match<Update.Return<Model, Message>>(message, {\n      Typed: ({ char }) => {\n        const generation = model.generation + 1\n        return {\n          model: { query: model.query + char, generation },\n          commands: [\n            {\n              name: 'Typeahead.expire',\n              args: { generation },\n              effect: Effect.as(Effect.sleep(args.timeoutMs), Message.Expired({ generation })),\n            },\n          ],\n        }\n      },\n      Expired: ({ generation }) =>\n        generation === model.generation ? clearQuery(model) : { model },\n      Cleared: () => clearQuery(model),\n    }),\n})\n\nconst normalize = (text: string): string => text.trimStart().toLocaleLowerCase()\n\nconst isRepeated = (query: string): boolean =>\n  query.length > 1 && [...query].every(char => char === query[0])\n\n/**\n * The enabled index whose text starts with `query`, searching forward from\n * `current` and wrapping, or `undefined`. A query of one character, or one\n * character repeated (`aaa`), starts *after* the current item so repeated\n * presses cycle through the items that begin with it; a longer query starts\n * *at* the current item, since the user is refining a match. Case and leading\n * whitespace are ignored.\n */\nexport const match = (\n  texts: ReadonlyArray<string>,\n  enabled: ReadonlyArray<number>,\n  query: string,\n  current: number,\n): number | undefined => {\n  if (query === '' || enabled.length === 0) return undefined\n  const needle = normalize(isRepeated(query) ? query[0]! : query)\n  const position = enabled.indexOf(current)\n  const startAfter = needle.length === 1 || isRepeated(query)\n  const start = position === -1 ? 0 : startAfter ? position + 1 : position\n  for (let offset = 0; offset < enabled.length; offset += 1) {\n    const index = enabled[(start + offset) % enabled.length]!\n    if (normalize(texts[index] ?? '').startsWith(needle)) return index\n  }\n  return undefined\n}\n\n/** A single character with no ctrl, alt or meta: a typeahead key. */\nexport const isPrintable = (key: string, modifiers: KeyboardModifiers): boolean =>\n  key.length === 1 && !modifiers.ctrlKey && !modifiers.altKey && !modifiers.metaKey\n\nexport interface BehaviorOptions<Input, Slots> {\n  /** The slot that receives the keys. */\n  readonly host: keyof Slots & string\n  readonly items: (input: Input) => Behaviors.Collection.Items<unknown>\n  /** The text an item is matched by. */\n  readonly text: (input: Input, index: number) => string\n  /** The current item's id, so the search starts from it; a placed\n   *  `RovingTabindex` is the usual source. */\n  readonly current: (input: Input) => string | null\n}\n\n/**\n * Wires a placed `Typeahead` to the host slot: a printable key extends the\n * query, focuses the matching item by its id (which then reports itself\n * current, through `RovingTabindex`'s `OnFocus`), and dispatches `Typed`.\n * With no match the key still extends the query, so the next one can match;\n * a space with an empty query is left to the host (it activates).\n */\nexport const behavior =\n  <Field extends string>(declared: Declared<typeof bundle, Field>) =>\n  <Slots>(slots: Slots) =>\n  <Input extends { readonly [K in Field]: Model }, ParentMessage>(\n    options: BehaviorOptions<Input, Slots>,\n  ): Behavior.NamedBehavior<Slots, Input, ParentMessage> => {\n    const wrap = (char: string): ParentMessage =>\n      declared.wrapper.make(Message.Typed({ char })) as unknown as ParentMessage\n    return Behavior.forSlots(slots)<Input, ParentMessage>(\n      {\n        [options.host]: Behavior.slot({\n          requires: { capability: Capability.Interactive },\n          attributes: ({\n            input,\n            h,\n          }: {\n            readonly input: Input\n            readonly h: HtmlBuilder<ParentMessage>\n          }) => {\n            const items = options.items(input)\n            const query = input[declared.field].query\n            const currentId = options.current(input)\n            const current = currentId === null ? -1 : items.indexOf(currentId)\n            return [\n              h.OnKeyDownFocus((key, modifiers) => {\n                if (!isPrintable(key, modifiers)) return Option.none()\n                if (key === ' ' && query === '') return Option.none()\n                // Read on a key, not on every render.\n                const texts = items.ids.map((_, index) => options.text(input, index))\n                const found = match(texts, items.enabled, query + key, current)\n                const target = found === undefined ? currentId : items.ids[found]\n                return Option.some({\n                  // `:not(*)` matches nothing: no match and nothing current\n                  // moves no focus, but the key is still recorded.\n                  focusSelector:\n                    target === null || target === undefined ? ':not(*)' : idSelector(target),\n                  message: wrap(key),\n                })\n              }),\n            ]\n          },\n        }),\n        // Keyed by a value the caller chose; `forSlots` checks the key exists.\n      } as unknown as Behavior.BehaviorSpec<Slots, Input, ParentMessage>,\n      { name: 'Typeahead' },\n    )\n  }\n"],"mappings":"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"}

package/dist/internal.d.ts

@@ -0,0 +1,16 @@
+/** Whether two id lists hold the same ids in the same order. */
+export declare const sameIds: (a: ReadonlyArray<string>, b: ReadonlyArray<string>) => boolean;
+/**
+ * Memoizes `derive` by the identity of its input. Every slot a Behavior writes
+ * in one render reads the same input, so a derivation each item needs runs
+ * once per render rather than once per item.
+ */
+export declare const perInput: <Input extends object, Value>(derive: (input: Input) => Value) => ((input: Input) => Value);
+/** Clears a typeahead query; blur and selection usually find it empty already. */
+export declare const clearQuery: <Model extends {
+  readonly query: string;
+}>(model: Model) => {
+  readonly model: Model;
+};
+export declare const unlessSame: <Model extends object>(model: Model, next: NoInfer<Model>) => Model;
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","names":[],"sources":["../src/internal.ts"],"mappings":";qBAGa,UAAO,GAAO,uBAAqB,GAAK;;;;;;qBAQxC,WAAY,sBAAsB,OAAK,SACzC,OAAO,UAAU,YACvB,OAAO,UAAU;;qBAWT,aAAc;WAAyB;GAAe,OAC1D;WACK,OAAO;;qBAaR,aAAc,sBAAoB,OAAS,OAAK,MAAQ,QAAQ,WAAS"}

package/dist/{internal-DP-xLKbT.mjs → internal.js}

@@ -1,4 +1,5 @@
-//#region src/internal.ts
+import { Equal, Option } from "effect";
+// src/internal.ts
 /** Whether two id lists hold the same ids in the same order. */
 const sameIds = (a, b) => a.length === b.length && a.every((id, index) => id === b[index]);
 /**
@@ -22,16 +23,16 @@ const clearQuery = (model) => model.query === "" ? { model } : { model: {
 } };
 /**
 * `next`, or `model` itself when both hold the same fields with the same
-* values. Foldkit renders only when the root Model changes identity, so an
-* equal copy renders the whole page for nothing.
+* values, an `Option` by what it holds. Foldkit renders only when the root
+* Model changes identity, so an equal copy renders the whole page for nothing.
 */
+const same = (left, right) => Object.is(left, right) || Option.isOption(left) && Option.isOption(right) && Equal.equals(left, right);
 const unlessSame = (model, next) => {
 	const keys = Object.keys(next);
 	if (keys.length !== Object.keys(model).length) return next;
-	for (const key of keys) if (!Object.hasOwn(model, key) || !Object.is(next[key], model[key])) return next;
+	for (const key of keys) if (!Object.hasOwn(model, key) || !same(next[key], model[key])) return next;
 	return model;
 };
-//#endregion
-export { unlessSame as i, perInput as n, sameIds as r, clearQuery as t };
+export { clearQuery, perInput, sameIds, unlessSame };
 
-//# sourceMappingURL=internal-DP-xLKbT.mjs.map
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","names":[],"sources":["../src/internal.ts"],"sourcesContent":["import { Equal, Option } from 'effect'\n\n/** Whether two id lists hold the same ids in the same order. */\nexport const sameIds = (a: ReadonlyArray<string>, b: ReadonlyArray<string>): boolean =>\n  a.length === b.length && a.every((id, index) => id === b[index])\n\n/**\n * Memoizes `derive` by the identity of its input. Every slot a Behavior writes\n * in one render reads the same input, so a derivation each item needs runs\n * once per render rather than once per item.\n */\nexport const perInput = <Input extends object, Value>(\n  derive: (input: Input) => Value,\n): ((input: Input) => Value) => {\n  const cache = new WeakMap<Input, Value>()\n  return input => {\n    if (cache.has(input)) return cache.get(input)!\n    const value = derive(input)\n    cache.set(input, value)\n    return value\n  }\n}\n\n/** Clears a typeahead query; blur and selection usually find it empty already. */\nexport const clearQuery = <Model extends { readonly query: string }>(\n  model: Model,\n): { readonly model: Model } =>\n  model.query === '' ? { model } : { model: { ...model, query: '' } }\n\n/**\n * `next`, or `model` itself when both hold the same fields with the same\n * values, an `Option` by what it holds. Foldkit renders only when the root\n * Model changes identity, so an equal copy renders the whole page for nothing.\n */\n// A fresh `Option.some(x)` is a new object each time, though it holds the same `x`.\nconst same = (left: unknown, right: unknown): boolean =>\n  Object.is(left, right) ||\n  (Option.isOption(left) && Option.isOption(right) && Equal.equals(left, right))\n\nexport const unlessSame = <Model extends object>(model: Model, next: NoInfer<Model>): Model => {\n  const keys = Object.keys(next) as Array<keyof Model>\n  if (keys.length !== Object.keys(model).length) return next\n  for (const key of keys) {\n    if (!Object.hasOwn(model, key) || !same(next[key], model[key])) return next\n  }\n  return model\n}\n"],"mappings":";;;AAGA,MAAa,WAAW,GAA0B,MAChD,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,IAAI,UAAU,OAAO,EAAE,MAAM;;;;;;AAOjE,MAAa,YACX,WAC8B;CAC9B,MAAM,wBAAQ,IAAI,QAAsB;CACxC,QAAO,UAAS;EACd,IAAI,MAAM,IAAI,KAAK,GAAG,OAAO,MAAM,IAAI,KAAK;EAC5C,MAAM,QAAQ,OAAO,KAAK;EAC1B,MAAM,IAAI,OAAO,KAAK;EACtB,OAAO;CACT;AACF;;AAGA,MAAa,cACX,UAEA,MAAM,UAAU,KAAK,EAAE,MAAM,IAAI,EAAE,OAAO;CAAE,GAAG;CAAO,OAAO;AAAG,EAAE;;;;;;AAQpE,MAAM,QAAQ,MAAe,UAC3B,OAAO,GAAG,MAAM,KAAK,KACpB,OAAO,SAAS,IAAI,KAAK,OAAO,SAAS,KAAK,KAAK,MAAM,OAAO,MAAM,KAAK;AAE9E,MAAa,cAAoC,OAAc,SAAgC;CAC7F,MAAM,OAAO,OAAO,KAAK,IAAI;CAC7B,IAAI,KAAK,WAAW,OAAO,KAAK,KAAK,CAAC,CAAC,QAAQ,OAAO;CACtD,KAAK,MAAM,OAAO,MAChB,IAAI,CAAC,OAAO,OAAO,OAAO,GAAG,KAAK,CAAC,KAAK,KAAK,MAAM,MAAM,IAAI,GAAG,OAAO;CAEzE,OAAO;AACT"}

package/dist/media/breakpoints.d.ts

@@ -0,0 +1,37 @@
+import { Schema } from "effect";
+import { Bundle } from "foldkit-bundle";
+export declare const BreakpointsModel: Schema.Struct<{
+  readonly width: Schema.Number;
+  readonly breakpoint: Schema.NullOr<Schema.String>;
+}>;
+export type BreakpointsModel = typeof BreakpointsModel.Type;
+export declare const BreakpointsMessage: import("foldkit/message").MessageUnion<{
+  readonly Changed: {
+    width: Schema.Number;
+  };
+}>;
+export type BreakpointsMessage = typeof BreakpointsMessage.Type;
+/**
+ * The breakpoint a width falls in: the name with the largest threshold at or
+ * below it, or `null` below every threshold. `Breakpoints` uses it; a view that
+ * has a width of its own can too.
+ */
+export declare const breakpointFor: (width: number, breakpoints: Readonly<Record<string, number>>) => string | null;
+/**
+ * Named breakpoints over the viewport width: one `resize` listener, derived
+ * names in `update`. Thresholds are mobile-first min-widths: the breakpoint
+ * is the largest name whose threshold is <= width. Ties break
+ * alphabetically so duplicates stay deterministic.
+ */
+export declare const Breakpoints: Bundle.Bundle<"Breakpoints", {
+  readonly breakpoints: {
+    readonly [x: string]: number;
+  };
+}, {
+  readonly width: number;
+  readonly breakpoint: string | null;
+}, {
+  readonly _tag: "Changed";
+  readonly width: number;
+}, never, never, never, void, {}, {}>;
+//# sourceMappingURL=breakpoints.d.ts.map

package/dist/media/breakpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakpoints.d.ts","names":[],"sources":["../../src/media/breakpoints.ts"],"mappings":";;qBAKa,kBAAgB,OAAA;;;;YAIjB,0BAA0B,iBAAiB;qBAE1C,8CAAkB;;IAAmC,OAAK,OAAA;;;YAC3D,4BAA4B,mBAAmB;;;;;;qBAO9C,gBAAa,eACX,aACA,SAAS;;;;;;;qBA+CX,aAAW,OAAA"}

package/dist/media/breakpoints.js

@@ -0,0 +1,64 @@
+import { Effect, Queue, Schema, Stream } from "effect";
+import { defineMessageUnion } from "foldkit/message";
+import * as Subscription from "foldkit/subscription";
+import { Bundle } from "foldkit-bundle";
+// src/media/breakpoints.ts
+const BreakpointsModel = Schema.Struct({
+	width: Schema.Number,
+	breakpoint: Schema.NullOr(Schema.String)
+});
+const BreakpointsMessage = defineMessageUnion({ Changed: { width: Schema.Number } });
+/**
+* The breakpoint a width falls in: the name with the largest threshold at or
+* below it, or `null` below every threshold. `Breakpoints` uses it; a view that
+* has a width of its own can too.
+*/
+const breakpointFor = (width, breakpoints) => {
+	let best = null;
+	let bestThreshold = -Infinity;
+	for (const name of Object.keys(breakpoints)) {
+		const threshold = breakpoints[name];
+		if (threshold <= width && (threshold > bestThreshold || threshold === bestThreshold && (best === null || name > best))) {
+			best = name;
+			bestThreshold = threshold;
+		}
+	}
+	return best;
+};
+const widthStream = () => {
+	if (typeof window === "undefined" || typeof window.addEventListener !== "function") return Stream.empty;
+	return Stream.unwrap(Effect.gen(function* () {
+		const queue = yield* Queue.unbounded();
+		const onResize = () => {
+			Effect.runFork(Queue.offer(queue, BreakpointsMessage.Changed({ width: window.innerWidth })));
+		};
+		window.addEventListener("resize", onResize);
+		yield* Effect.addFinalizer(() => Effect.sync(() => {
+			window.removeEventListener("resize", onResize);
+		}));
+		return Stream.concat(Stream.make(BreakpointsMessage.Changed({ width: window.innerWidth })), Stream.fromQueue(queue));
+	}));
+};
+/**
+* Named breakpoints over the viewport width: one `resize` listener, derived
+* names in `update`. Thresholds are mobile-first min-widths: the breakpoint
+* is the largest name whose threshold is <= width. Ties break
+* alphabetically so duplicates stay deterministic.
+*/
+const Breakpoints = Bundle.make("Breakpoints", {
+	Model: BreakpointsModel,
+	Message: BreakpointsMessage,
+	args: Schema.Struct({ breakpoints: Schema.Record(Schema.String, Schema.Number.pipe(Schema.check(Schema.isFinite()))) }),
+	init: (args) => ({ model: {
+		width: 0,
+		breakpoint: breakpointFor(0, args.breakpoints)
+	} }),
+	update: (model, message, args) => BreakpointsMessage.match(message, { Changed: ({ width }) => width === model.width ? { model } : { model: {
+		width,
+		breakpoint: breakpointFor(width, args.breakpoints)
+	} } }),
+	subscriptions: () => Subscription.make()(() => ({ changes: Subscription.persistentEntry(widthStream()) }))
+});
+export { Breakpoints, BreakpointsMessage, BreakpointsModel, breakpointFor };
+
+//# sourceMappingURL=breakpoints.js.map

package/dist/media/breakpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breakpoints.js","names":[],"sources":["../../src/media/breakpoints.ts"],"sourcesContent":["import { Effect, Queue, Schema, Stream } from 'effect'\nimport { defineMessageUnion } from 'foldkit/message'\nimport * as Subscription from 'foldkit/subscription'\nimport { Bundle } from 'foldkit-bundle'\n\nexport const BreakpointsModel = Schema.Struct({\n  width: Schema.Number,\n  breakpoint: Schema.NullOr(Schema.String),\n})\nexport type BreakpointsModel = typeof BreakpointsModel.Type\n\nexport const BreakpointsMessage = defineMessageUnion({ Changed: { width: Schema.Number } })\nexport type BreakpointsMessage = typeof BreakpointsMessage.Type\n\n/**\n * The breakpoint a width falls in: the name with the largest threshold at or\n * below it, or `null` below every threshold. `Breakpoints` uses it; a view that\n * has a width of its own can too.\n */\nexport const breakpointFor = (\n  width: number,\n  breakpoints: Readonly<Record<string, number>>,\n): string | null => {\n  let best: string | null = null\n  let bestThreshold = -Infinity\n  for (const name of Object.keys(breakpoints)) {\n    const threshold = breakpoints[name]!\n    if (\n      threshold <= width &&\n      (threshold > bestThreshold || (threshold === bestThreshold && (best === null || name > best)))\n    ) {\n      best = name\n      bestThreshold = threshold\n    }\n  }\n  return best\n}\n\nconst widthStream = (): Stream.Stream<BreakpointsMessage> => {\n  if (typeof window === 'undefined' || typeof window.addEventListener !== 'function') {\n    return Stream.empty\n  }\n  return Stream.unwrap(\n    Effect.gen(function* () {\n      const queue = yield* Queue.unbounded<BreakpointsMessage>()\n      const onResize = () => {\n        Effect.runFork(Queue.offer(queue, BreakpointsMessage.Changed({ width: window.innerWidth })))\n      }\n      window.addEventListener('resize', onResize)\n      yield* Effect.addFinalizer(() =>\n        Effect.sync(() => {\n          window.removeEventListener('resize', onResize)\n        }),\n      )\n      return Stream.concat(\n        Stream.make(BreakpointsMessage.Changed({ width: window.innerWidth })),\n        Stream.fromQueue(queue),\n      )\n    }),\n  )\n}\n\n/**\n * Named breakpoints over the viewport width: one `resize` listener, derived\n * names in `update`. Thresholds are mobile-first min-widths: the breakpoint\n * is the largest name whose threshold is <= width. Ties break\n * alphabetically so duplicates stay deterministic.\n */\nexport const Breakpoints = Bundle.make('Breakpoints', {\n  Model: BreakpointsModel,\n  Message: BreakpointsMessage,\n  args: Schema.Struct({\n    breakpoints: Schema.Record(Schema.String, Schema.Number.pipe(Schema.check(Schema.isFinite()))),\n  }),\n  init: args => ({\n    model: { width: 0, breakpoint: breakpointFor(0, args.breakpoints) },\n  }),\n  update: (model, message, args) =>\n    BreakpointsMessage.match(message, {\n      // A height-only resize reports the same width.\n      Changed: ({ width }) =>\n        width === model.width\n          ? { model }\n          : { model: { width, breakpoint: breakpointFor(width, args.breakpoints) } },\n    }),\n  subscriptions: (): Subscription.Subscriptions<BreakpointsModel, BreakpointsMessage> =>\n    Subscription.make<BreakpointsModel, BreakpointsMessage>()(() => ({\n      changes: Subscription.persistentEntry(widthStream()),\n    })),\n})\n"],"mappings":";;;;;AAKA,MAAa,mBAAmB,OAAO,OAAO;CAC5C,OAAO,OAAO;CACd,YAAY,OAAO,OAAO,OAAO,MAAM;AACzC,CAAC;AAGD,MAAa,qBAAqB,mBAAmB,EAAE,SAAS,EAAE,OAAO,OAAO,OAAO,EAAE,CAAC;;;;;;AAQ1F,MAAa,iBACX,OACA,gBACkB;CAClB,IAAI,OAAsB;CAC1B,IAAI,gBAAgB;CACpB,KAAK,MAAM,QAAQ,OAAO,KAAK,WAAW,GAAG;EAC3C,MAAM,YAAY,YAAY;EAC9B,IACE,aAAa,UACZ,YAAY,iBAAkB,cAAc,kBAAkB,SAAS,QAAQ,OAAO,QACvF;GACA,OAAO;GACP,gBAAgB;EAClB;CACF;CACA,OAAO;AACT;AAEA,MAAM,oBAAuD;CAC3D,IAAI,OAAO,WAAW,eAAe,OAAO,OAAO,qBAAqB,YACtE,OAAO,OAAO;CAEhB,OAAO,OAAO,OACZ,OAAO,IAAI,aAAa;EACtB,MAAM,QAAQ,OAAO,MAAM,UAA8B;EACzD,MAAM,iBAAiB;GACrB,OAAO,QAAQ,MAAM,MAAM,OAAO,mBAAmB,QAAQ,EAAE,OAAO,OAAO,WAAW,CAAC,CAAC,CAAC;EAC7F;EACA,OAAO,iBAAiB,UAAU,QAAQ;EAC1C,OAAO,OAAO,mBACZ,OAAO,WAAW;GAChB,OAAO,oBAAoB,UAAU,QAAQ;EAC/C,CAAC,CACH;EACA,OAAO,OAAO,OACZ,OAAO,KAAK,mBAAmB,QAAQ,EAAE,OAAO,OAAO,WAAW,CAAC,CAAC,GACpE,OAAO,UAAU,KAAK,CACxB;CACF,CAAC,CACH;AACF;;;;;;;AAQA,MAAa,cAAc,OAAO,KAAK,eAAe;CACpD,OAAO;CACP,SAAS;CACT,MAAM,OAAO,OAAO,EAClB,aAAa,OAAO,OAAO,OAAO,QAAQ,OAAO,OAAO,KAAK,OAAO,MAAM,OAAO,SAAS,CAAC,CAAC,CAAC,EAC/F,CAAC;CACD,OAAM,UAAS,EACb,OAAO;EAAE,OAAO;EAAG,YAAY,cAAc,GAAG,KAAK,WAAW;CAAE,EACpE;CACA,SAAS,OAAO,SAAS,SACvB,mBAAmB,MAAM,SAAS,EAEhC,UAAU,EAAE,YACV,UAAU,MAAM,QACZ,EAAE,MAAM,IACR,EAAE,OAAO;EAAE;EAAO,YAAY,cAAc,OAAO,KAAK,WAAW;CAAE,EAAE,EAC/E,CAAC;CACH,qBACE,aAAa,KAA2C,CAAC,QAAQ,EAC/D,SAAS,aAAa,gBAAgB,YAAY,CAAC,EACrD,EAAE;AACN,CAAC"}

package/dist/media/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./breakpoints.js";
+export * from "./mediaquery.js";
+export * from "./platform.js";

package/dist/media/index.js

@@ -0,0 +1,4 @@
+export * from "./breakpoints.js";
+export * from "./mediaquery.js";
+export * from "./platform.js";
+export {};

package/dist/media/mediaquery.d.ts

@@ -0,0 +1,40 @@
+import { Schema } from "effect";
+import { Bundle } from "foldkit-bundle";
+export declare const MediaQueryModel: Schema.Struct<{
+  readonly matches: Schema.Boolean;
+}>;
+export type MediaQueryModel = typeof MediaQueryModel.Type;
+export declare const MediaQueryMessage: import("foldkit/message").MessageUnion<{
+  readonly Changed: {
+    matches: Schema.Boolean;
+  };
+}>;
+export type MediaQueryMessage = typeof MediaQueryMessage.Type;
+/**
+ * A media query as a bundle: `matches` in the Model, kept current by a
+ * `matchMedia` change stream. State stays in the parent Model, so it replays
+ * and time-travels like any other state; the browser only reports facts.
+ */
+export declare const MediaQuery: Bundle.Bundle<"MediaQuery", {
+  readonly query: string;
+}, {
+  readonly matches: boolean;
+}, {
+  readonly _tag: "Changed";
+  readonly matches: boolean;
+}, never, never, never, void, {}, {}>;
+/** `(prefers-color-scheme: dark)`, bound so placements give no args. */
+export declare const PrefersDark: Bundle.Bundle<"MediaQuery", void, {
+  readonly matches: boolean;
+}, {
+  readonly _tag: "Changed";
+  readonly matches: boolean;
+}, never, never, never, void, {}, {}>;
+/** `(prefers-reduced-motion: reduce)`, bound so placements give no args. */
+export declare const PrefersReducedMotion: Bundle.Bundle<"MediaQuery", void, {
+  readonly matches: boolean;
+}, {
+  readonly _tag: "Changed";
+  readonly matches: boolean;
+}, never, never, never, void, {}, {}>;
+//# sourceMappingURL=mediaquery.d.ts.map

package/dist/media/mediaquery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaquery.d.ts","names":[],"sources":["../../src/media/mediaquery.ts"],"mappings":";;qBAKa,iBAAe,OAAA;;;YAChB,yBAAyB,gBAAgB;qBAExC,6CAAiB;;IAAmC,SAAO,OAAA;;;YAC5D,2BAA2B,kBAAkB;;;;;;qBAiC5C,YAAU,OAAA;;;;;;;;;qBAcV,aAAW,OAAA;;;;;;;qBAGX,sBAAoB,OAAA"}

package/dist/media/mediaquery.js

@@ -0,0 +1,42 @@
+import { Effect, Queue, Schema, Stream } from "effect";
+import { defineMessageUnion } from "foldkit/message";
+import * as Subscription from "foldkit/subscription";
+import { Bundle } from "foldkit-bundle";
+// src/media/mediaquery.ts
+const MediaQueryModel = Schema.Struct({ matches: Schema.Boolean });
+const MediaQueryMessage = defineMessageUnion({ Changed: { matches: Schema.Boolean } });
+const matchMediaStream = (query) => {
+	if (typeof window === "undefined" || typeof window.matchMedia !== "function") return Stream.empty;
+	return Stream.unwrap(Effect.gen(function* () {
+		const queue = yield* Queue.unbounded();
+		const list = window.matchMedia(query);
+		const onChange = (event) => {
+			Effect.runFork(Queue.offer(queue, MediaQueryMessage.Changed({ matches: event.matches })));
+		};
+		list.addEventListener("change", onChange);
+		yield* Effect.addFinalizer(() => Effect.sync(() => {
+			list.removeEventListener("change", onChange);
+		}));
+		return Stream.concat(Stream.make(MediaQueryMessage.Changed({ matches: list.matches })), Stream.fromQueue(queue));
+	}));
+};
+/**
+* A media query as a bundle: `matches` in the Model, kept current by a
+* `matchMedia` change stream. State stays in the parent Model, so it replays
+* and time-travels like any other state; the browser only reports facts.
+*/
+const MediaQuery = Bundle.make("MediaQuery", {
+	Model: MediaQueryModel,
+	Message: MediaQueryMessage,
+	args: Schema.Struct({ query: Schema.String }),
+	init: () => ({ model: { matches: false } }),
+	update: (model, message) => message.matches === model.matches ? { model } : { model: { matches: message.matches } },
+	subscriptions: ({ query }) => Subscription.make()(() => ({ changes: Subscription.persistentEntry(matchMediaStream(query)) }))
+});
+/** `(prefers-color-scheme: dark)`, bound so placements give no args. */
+const PrefersDark = MediaQuery.with({ query: "(prefers-color-scheme: dark)" });
+/** `(prefers-reduced-motion: reduce)`, bound so placements give no args. */
+const PrefersReducedMotion = MediaQuery.with({ query: "(prefers-reduced-motion: reduce)" });
+export { MediaQuery, MediaQueryMessage, MediaQueryModel, PrefersDark, PrefersReducedMotion };
+
+//# sourceMappingURL=mediaquery.js.map

package/dist/media/mediaquery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaquery.js","names":[],"sources":["../../src/media/mediaquery.ts"],"sourcesContent":["import { Effect, Queue, Schema, Stream } from 'effect'\nimport { defineMessageUnion } from 'foldkit/message'\nimport * as Subscription from 'foldkit/subscription'\nimport { Bundle } from 'foldkit-bundle'\n\nexport const MediaQueryModel = Schema.Struct({ matches: Schema.Boolean })\nexport type MediaQueryModel = typeof MediaQueryModel.Type\n\nexport const MediaQueryMessage = defineMessageUnion({ Changed: { matches: Schema.Boolean } })\nexport type MediaQueryMessage = typeof MediaQueryMessage.Type\n\nconst matchMediaStream = (query: string): Stream.Stream<MediaQueryMessage> => {\n  // No window (SSR) or no matchMedia (old browser, minimal DOM): nothing to\n  // listen to, so the slice keeps its initial value instead of throwing.\n  if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') return Stream.empty\n  return Stream.unwrap(\n    Effect.gen(function* () {\n      const queue = yield* Queue.unbounded<MediaQueryMessage>()\n      const list = window.matchMedia(query)\n      const onChange = (event: MediaQueryListEvent) => {\n        Effect.runFork(Queue.offer(queue, MediaQueryMessage.Changed({ matches: event.matches })))\n      }\n      list.addEventListener('change', onChange)\n      yield* Effect.addFinalizer(() =>\n        Effect.sync(() => {\n          list.removeEventListener('change', onChange)\n        }),\n      )\n      // The current value first, so the Model is right before the first change.\n      return Stream.concat(\n        Stream.make(MediaQueryMessage.Changed({ matches: list.matches })),\n        Stream.fromQueue(queue),\n      )\n    }),\n  )\n}\n\n/**\n * A media query as a bundle: `matches` in the Model, kept current by a\n * `matchMedia` change stream. State stays in the parent Model, so it replays\n * and time-travels like any other state; the browser only reports facts.\n */\nexport const MediaQuery = Bundle.make('MediaQuery', {\n  Model: MediaQueryModel,\n  Message: MediaQueryMessage,\n  args: Schema.Struct({ query: Schema.String }),\n  init: () => ({ model: { matches: false } }),\n  update: (model, message) =>\n    message.matches === model.matches ? { model } : { model: { matches: message.matches } },\n  subscriptions: ({ query }): Subscription.Subscriptions<MediaQueryModel, MediaQueryMessage> =>\n    Subscription.make<MediaQueryModel, MediaQueryMessage>()(() => ({\n      changes: Subscription.persistentEntry(matchMediaStream(query)),\n    })),\n})\n\n/** `(prefers-color-scheme: dark)`, bound so placements give no args. */\nexport const PrefersDark = MediaQuery.with({ query: '(prefers-color-scheme: dark)' })\n\n/** `(prefers-reduced-motion: reduce)`, bound so placements give no args. */\nexport const PrefersReducedMotion = MediaQuery.with({ query: '(prefers-reduced-motion: reduce)' })\n"],"mappings":";;;;;AAKA,MAAa,kBAAkB,OAAO,OAAO,EAAE,SAAS,OAAO,QAAQ,CAAC;AAGxE,MAAa,oBAAoB,mBAAmB,EAAE,SAAS,EAAE,SAAS,OAAO,QAAQ,EAAE,CAAC;AAG5F,MAAM,oBAAoB,UAAoD;CAG5E,IAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,YAAY,OAAO,OAAO;CAC5F,OAAO,OAAO,OACZ,OAAO,IAAI,aAAa;EACtB,MAAM,QAAQ,OAAO,MAAM,UAA6B;EACxD,MAAM,OAAO,OAAO,WAAW,KAAK;EACpC,MAAM,YAAY,UAA+B;GAC/C,OAAO,QAAQ,MAAM,MAAM,OAAO,kBAAkB,QAAQ,EAAE,SAAS,MAAM,QAAQ,CAAC,CAAC,CAAC;EAC1F;EACA,KAAK,iBAAiB,UAAU,QAAQ;EACxC,OAAO,OAAO,mBACZ,OAAO,WAAW;GAChB,KAAK,oBAAoB,UAAU,QAAQ;EAC7C,CAAC,CACH;EAEA,OAAO,OAAO,OACZ,OAAO,KAAK,kBAAkB,QAAQ,EAAE,SAAS,KAAK,QAAQ,CAAC,CAAC,GAChE,OAAO,UAAU,KAAK,CACxB;CACF,CAAC,CACH;AACF;;;;;;AAOA,MAAa,aAAa,OAAO,KAAK,cAAc;CAClD,OAAO;CACP,SAAS;CACT,MAAM,OAAO,OAAO,EAAE,OAAO,OAAO,OAAO,CAAC;CAC5C,aAAa,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE;CACzC,SAAS,OAAO,YACd,QAAQ,YAAY,MAAM,UAAU,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,SAAS,QAAQ,QAAQ,EAAE;CACxF,gBAAgB,EAAE,YAChB,aAAa,KAAyC,CAAC,QAAQ,EAC7D,SAAS,aAAa,gBAAgB,iBAAiB,KAAK,CAAC,EAC/D,EAAE;AACN,CAAC;;AAGD,MAAa,cAAc,WAAW,KAAK,EAAE,OAAO,+BAA+B,CAAC;;AAGpF,MAAa,uBAAuB,WAAW,KAAK,EAAE,OAAO,mCAAmC,CAAC"}

package/dist/media/platform.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Platform detection as pure functions. `platformFromUA` reads a user-agent
+ * string (passed in, so tests pin it without stubbing globals); order
+ * matters — Android contains "Linux", iPhones mention "Mac" — so mobile
+ * checks come first. `isBrowser`/`isServer` split SSR from client for init
+ * defaults.
+ */
+export declare const Platform: readonly ['mac', 'windows', 'linux', 'android', 'ios', 'unknown'];
+export type Platform = (typeof Platform)[number];
+/**
+ * Client Hints (`navigator.userAgentData`) plus touch points
+ * (`navigator.maxTouchPoints`), passed in so detection stays pure and
+ * pinned. Only `platform` and `touchPoints` can change the answer — the
+ * `mobile` flag never disambiguates on its own, so it is not accepted.
+ */
+export interface PlatformHints {
+  readonly platform?: string | undefined;
+  readonly touchPoints?: number | undefined;
+}
+/**
+ * The platform a user-agent string names, preferring Client Hints when given
+ * (`navigator.userAgentData.platform`), with touch points telling a desktop-mode
+ * iPad from a Mac. `unknown` when nothing matches.
+ */
+export declare const platformFromUA: (userAgent: string, hints?: PlatformHints) => Platform;
+/** Whether a window exists: the client side of an SSR split. */
+export declare const isBrowser: () => boolean;
+/** Whether no window exists: the server side of an SSR split. */
+export declare const isServer: () => boolean;
+//# sourceMappingURL=platform.d.ts.map

package/dist/media/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","names":[],"sources":["../../src/media/platform.ts"],"mappings":";;;;;;;qBAOa;YACD,mBAAmB;;;;;;;iBAQd;WACN;WACA;;;;;;;qBAyBE,iBAAc,mBAAqB,QAAS,kBAAqB;;qBAkBjE;;qBAGA"}

package/dist/media/platform.js

@@ -0,0 +1,50 @@
+// src/media/platform.ts
+/**
+* Platform detection as pure functions. `platformFromUA` reads a user-agent
+* string (passed in, so tests pin it without stubbing globals); order
+* matters — Android contains "Linux", iPhones mention "Mac" — so mobile
+* checks come first. `isBrowser`/`isServer` split SSR from client for init
+* defaults.
+*/
+const Platform = [
+	"mac",
+	"windows",
+	"linux",
+	"android",
+	"ios",
+	"unknown"
+];
+const hintedPlatform = (platform) => {
+	switch (platform.toLowerCase()) {
+		case "macos": return "mac";
+		case "windows": return "windows";
+		case "linux": return "linux";
+		case "android": return "android";
+		case "ios": return "ios";
+		default: return null;
+	}
+};
+/**
+* The platform a user-agent string names, preferring Client Hints when given
+* (`navigator.userAgentData.platform`), with touch points telling a desktop-mode
+* iPad from a Mac. `unknown` when nothing matches.
+*/
+const platformFromUA = (userAgent, hints = {}) => {
+	const hinted = hints.platform === void 0 ? null : hintedPlatform(hints.platform);
+	const ua = userAgent.toLowerCase();
+	let sniffed = "unknown";
+	if (ua.includes("android")) sniffed = "android";
+	else if (ua.includes("iphone") || ua.includes("ipad") || ua.includes("ipod")) sniffed = "ios";
+	else if (ua.includes("windows") || ua.includes("win32") || ua.includes("win64")) sniffed = "windows";
+	else if (ua.includes("macintosh") || ua.includes("mac os")) sniffed = "mac";
+	else if (ua.includes("linux")) sniffed = "linux";
+	const candidate = hinted ?? sniffed;
+	return candidate === "mac" && (hints.touchPoints ?? 0) > 1 ? "ios" : candidate;
+};
+/** Whether a window exists: the client side of an SSR split. */
+const isBrowser = () => typeof window !== "undefined";
+/** Whether no window exists: the server side of an SSR split. */
+const isServer = () => !isBrowser();
+export { Platform, isBrowser, isServer, platformFromUA };
+
+//# sourceMappingURL=platform.js.map