foldkit-primitives 0.1.0

package/dist/dom/index.mjs

@@ -0,0 +1,218 @@
+import { Effect, Queue, Schema, Stream } from "effect";
+import * as Mount from "foldkit/mount";
+import { defineMessageUnion } from "foldkit/message";
+//#region src/dom/autofocus.ts
+/**
+* Autofocus as a Mount: focuses the element on insert, then emits `Focused`.
+* The message means focus was requested — a non-focusable element or a
+* hidden tab may decline, and the browser does not report that. Plain
+* `focus()`, no scroll options: scroll behavior stays the application's
+* choice.
+*/
+const Focused = Schema.TaggedStruct("Focused", {});
+const Autofocus = Mount.define("Autofocus", {
+	messages: [Focused],
+	execute: ({ element }) => Effect.sync(() => {
+		const focusable = element;
+		if (typeof focusable.focus === "function") focusable.focus.call(element);
+		return Focused.make({});
+	})
+});
+//#endregion
+//#region src/dom/clipboard.ts
+/**
+* Clipboard copy as a Command: runs in `update` beside any bundle, yields
+* `Copied` on success and `CopyFailed` otherwise. No Model involved: the
+* clipboard is not application state.
+*/
+const ClipboardMessage = defineMessageUnion({
+	Copied: {},
+	CopyFailed: { message: Schema.String }
+});
+const failMessage$2 = (error) => error instanceof Error ? error.message : String(error);
+/**
+* Copies text to the clipboard. Without a clipboard API (SSR, insecure
+* context, denied permission) the command yields `CopyFailed` instead of
+* throwing, so `update` handles both outcomes as Messages.
+*/
+const copyText = (text) => ({
+	name: "Clipboard.copy",
+	args: { text },
+	effect: typeof navigator !== "undefined" && typeof navigator.clipboard?.writeText === "function" ? Effect.matchEffect(Effect.tryPromise({
+		try: () => navigator.clipboard.writeText(text),
+		catch: failMessage$2
+	}), {
+		onFailure: (message) => Effect.succeed(ClipboardMessage.CopyFailed({ message })),
+		onSuccess: () => Effect.succeed(ClipboardMessage.Copied())
+	}) : Effect.succeed(ClipboardMessage.CopyFailed({ message: "clipboard is unavailable" }))
+});
+//#endregion
+//#region src/dom/input-mask.ts
+/**
+* An input mask as a Mount plus a pure mask function. The pattern language
+* is three placeholders — `#` digit, `A` letter, `*` either, all ASCII —
+* with every other character literal. Literals appear only once a later placeholder
+* consumes input, so partial values never dangle a separator. The Mount
+* rewrites the field, restores the caret approximately, and emits `Input`
+* with both the masked and raw values; the parent owns the state, like any
+* controlled input.
+*/
+const Input = Schema.TaggedStruct("Input", {
+	value: Schema.String,
+	raw: Schema.String
+});
+const isDigit = (char) => char >= "0" && char <= "9";
+const isLetter = (char) => char >= "a" && char <= "z" || char >= "A" && char <= "Z";
+const matches = (placeholder, char) => placeholder === "#" ? isDigit(char) : placeholder === "A" ? isLetter(char) : isDigit(char) || isLetter(char);
+const isPlaceholder = (char) => char === "#" || char === "A" || char === "*";
+/** Whether any placeholder at or after `from` consumes any input at or after `at`. */
+const fillable = (pattern, from, value, at) => {
+	for (let i = from; i < pattern.length; i++) {
+		const placeholder = pattern[i];
+		if (!isPlaceholder(placeholder)) continue;
+		for (let j = at; j < value.length; j++) if (matches(placeholder, value[j])) return true;
+	}
+	return false;
+};
+const applyMask = (value, pattern) => {
+	let masked = "";
+	let raw = "";
+	let at = 0;
+	for (let i = 0; i < pattern.length; i++) {
+		const slot = pattern[i];
+		if (isPlaceholder(slot)) {
+			while (at < value.length && !matches(slot, value[at])) at++;
+			if (at >= value.length) break;
+			masked += value[at];
+			raw += value[at];
+			at++;
+		} else if (fillable(pattern, i + 1, value, at)) masked += slot;
+		else break;
+	}
+	return {
+		masked,
+		raw
+	};
+};
+const asField = (element) => {
+	const field = element;
+	return typeof field.value === "string" && typeof field.addEventListener === "function" ? field : null;
+};
+const InputMask = Mount.defineStream("InputMask", {
+	messages: [Input],
+	args: { pattern: Schema.String },
+	execute: ({ element, pattern }) => Stream.callback((queue) => Effect.gen(function* () {
+		const field = asField(element);
+		if (field === null) return;
+		const onInput = () => {
+			const { masked, raw } = applyMask(field.value, pattern);
+			if (masked !== field.value) {
+				const caret = field.selectionStart ?? masked.length;
+				field.value = masked;
+				const at = Math.min(caret, masked.length);
+				try {
+					field.setSelectionRange?.(at, at);
+				} catch {}
+			}
+			Queue.offerUnsafe(queue, Input.make({
+				value: masked,
+				raw
+			}));
+		};
+		yield* Effect.acquireRelease(Effect.sync(() => {
+			field.addEventListener("input", onInput);
+			return field;
+		}), (current) => Effect.sync(() => current.removeEventListener("input", onInput)));
+	}))
+});
+//#endregion
+//#region src/dom/script-loader.ts
+/**
+* Script loading as a Command: appends a `src` script to the head unless one
+* is already there. Idempotent by URL — concurrent placements collapse onto
+* the first tag instead of fetching twice. Yields `Loaded` on success and
+* `LoadFailed` otherwise (network error, no document), so `update` handles
+* both outcomes as Messages.
+*/
+const ScriptMessage = defineMessageUnion({
+	Loaded: {},
+	LoadFailed: { message: Schema.String }
+});
+const failMessage$1 = (error) => error instanceof Error ? error.message : String(error);
+const inflight = /* @__PURE__ */ new Map();
+/** Loads a script by URL, once per URL. */
+const loadScript = (src) => ({
+	name: "Script.load",
+	args: { src },
+	effect: Effect.matchEffect(Effect.tryPromise({
+		try: () => {
+			if (typeof document === "undefined") return Promise.reject(/* @__PURE__ */ new Error("script loading is unavailable"));
+			const running = inflight.get(src);
+			if (running !== void 0) return running;
+			if (Array.from(document.getElementsByTagName("script")).some((element) => element.getAttribute("src") === src)) return Promise.resolve();
+			const tracked = new Promise((resolve, reject) => {
+				const element = document.createElement("script");
+				element.src = src;
+				element.async = true;
+				element.onload = () => resolve();
+				element.onerror = () => {
+					element.remove();
+					reject(/* @__PURE__ */ new Error(`failed to load script: ${src}`));
+				};
+				document.head.appendChild(element);
+			}).then(() => {
+				inflight.delete(src);
+			}, (error) => {
+				inflight.delete(src);
+				throw error;
+			});
+			inflight.set(src, tracked);
+			return tracked;
+		},
+		catch: (error) => error
+	}), {
+		onFailure: (error) => Effect.succeed(ScriptMessage.LoadFailed({ message: failMessage$1(error) })),
+		onSuccess: () => Effect.succeed(ScriptMessage.Loaded())
+	})
+});
+//#endregion
+//#region src/dom/share.ts
+/**
+* Web Share as a Command: runs in `update` beside any bundle, yields
+* `Shared` on success. Dismissal is its own outcome, not a failure — the
+* application tells a cancelled sheet apart from a broken one. Without a
+* share API (desktop, insecure context) it yields `ShareFailed` instead of
+* throwing, so `update` handles every outcome as a Message.
+*/
+const ShareData = Schema.Struct({
+	title: Schema.optional(Schema.String),
+	text: Schema.optional(Schema.String),
+	url: Schema.optional(Schema.String)
+});
+const ShareMessage = defineMessageUnion({
+	Shared: {},
+	Dismissed: {},
+	ShareFailed: { message: Schema.String }
+});
+const failMessage = (error) => error instanceof Error ? error.message : String(error);
+const isDismissal = (error) => typeof error?.name === "string" && error.name === "AbortError";
+/** Shares data through the platform sheet. */
+const share = (data) => ({
+	name: "Share.share",
+	args: { data },
+	effect: typeof navigator !== "undefined" && typeof navigator.share === "function" ? Effect.matchEffect(Effect.tryPromise({
+		try: () => navigator.share({
+			...data.title !== void 0 ? { title: data.title } : {},
+			...data.text !== void 0 ? { text: data.text } : {},
+			...data.url !== void 0 ? { url: data.url } : {}
+		}),
+		catch: (error) => error
+	}), {
+		onFailure: (error) => Effect.succeed(isDismissal(error) ? ShareMessage.Dismissed() : ShareMessage.ShareFailed({ message: failMessage(error) })),
+		onSuccess: () => Effect.succeed(ShareMessage.Shared())
+	}) : Effect.succeed(ShareMessage.ShareFailed({ message: "share is unavailable" }))
+});
+//#endregion
+export { Autofocus, ClipboardMessage, Focused, Input, InputMask, ScriptMessage, ShareData, ShareMessage, applyMask, copyText, loadScript, share };
+
+//# sourceMappingURL=index.mjs.map

package/dist/dom/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["failMessage","failMessage"],"sources":["../../src/dom/autofocus.ts","../../src/dom/clipboard.ts","../../src/dom/input-mask.ts","../../src/dom/script-loader.ts","../../src/dom/share.ts"],"sourcesContent":["/**\n * Autofocus as a Mount: focuses the element on insert, then emits `Focused`.\n * The message means focus was requested — a non-focusable element or a\n * hidden tab may decline, and the browser does not report that. Plain\n * `focus()`, no scroll options: scroll behavior stays the application's\n * choice.\n */\nimport { Effect, Schema } from 'effect'\nimport * as Mount from 'foldkit/mount'\n\nexport const Focused = Schema.TaggedStruct('Focused', {})\nexport type Focused = typeof Focused.Type\n\nexport const Autofocus = Mount.define('Autofocus', {\n  messages: [Focused],\n  execute: ({ element }) =>\n    Effect.sync(() => {\n      const focusable = element as unknown as { readonly focus?: unknown }\n      if (typeof focusable.focus === 'function') {\n        ;(focusable.focus as () => void).call(element)\n      }\n      return Focused.make({})\n    }),\n})\n","/**\n * Clipboard copy as a Command: runs in `update` beside any bundle, yields\n * `Copied` on success and `CopyFailed` otherwise. No Model involved: the\n * clipboard is not application state.\n */\nimport { Effect, Schema } from 'effect'\nimport type { Command } from 'foldkit/command'\nimport { defineMessageUnion } from 'foldkit/message'\n\nexport const ClipboardMessage = defineMessageUnion({\n  Copied: {},\n  CopyFailed: { message: Schema.String },\n})\nexport type ClipboardMessage = typeof ClipboardMessage.Type\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\n/**\n * Copies text to the clipboard. Without a clipboard API (SSR, insecure\n * context, denied permission) the command yields `CopyFailed` instead of\n * throwing, so `update` handles both outcomes as Messages.\n */\nexport const copyText = (text: string): Command<ClipboardMessage, never, never> => ({\n  name: 'Clipboard.copy',\n  args: { text },\n  effect:\n    typeof navigator !== 'undefined' && typeof navigator.clipboard?.writeText === 'function'\n      ? Effect.matchEffect(\n          Effect.tryPromise({\n            try: () => navigator.clipboard.writeText(text),\n            catch: failMessage,\n          }),\n          {\n            onFailure: message => Effect.succeed(ClipboardMessage.CopyFailed({ message })),\n            onSuccess: () => Effect.succeed(ClipboardMessage.Copied()),\n          },\n        )\n      : Effect.succeed(ClipboardMessage.CopyFailed({ message: 'clipboard is unavailable' })),\n})\n","/**\n * An input mask as a Mount plus a pure mask function. The pattern language\n * is three placeholders — `#` digit, `A` letter, `*` either, all ASCII —\n * with every other character literal. Literals appear only once a later placeholder\n * consumes input, so partial values never dangle a separator. The Mount\n * rewrites the field, restores the caret approximately, and emits `Input`\n * with both the masked and raw values; the parent owns the state, like any\n * controlled input.\n */\nimport { Effect, Queue, Schema, Stream } from 'effect'\nimport * as Mount from 'foldkit/mount'\n\nexport const Input = Schema.TaggedStruct('Input', {\n  value: Schema.String,\n  raw: Schema.String,\n})\nexport type Input = typeof Input.Type\n\nconst isDigit = (char: string): boolean => char >= '0' && char <= '9'\nconst isLetter = (char: string): boolean =>\n  (char >= 'a' && char <= 'z') || (char >= 'A' && char <= 'Z')\n\nconst matches = (placeholder: string, char: string): boolean =>\n  placeholder === '#'\n    ? isDigit(char)\n    : placeholder === 'A'\n      ? isLetter(char)\n      : isDigit(char) || isLetter(char)\n\nconst isPlaceholder = (char: string): boolean => char === '#' || char === 'A' || char === '*'\n\n/** Whether any placeholder at or after `from` consumes any input at or after `at`. */\nconst fillable = (pattern: string, from: number, value: string, at: number): boolean => {\n  for (let i = from; i < pattern.length; i++) {\n    const placeholder = pattern[i]!\n    if (!isPlaceholder(placeholder)) continue\n    for (let j = at; j < value.length; j++) {\n      if (matches(placeholder, value[j]!)) return true\n    }\n  }\n  return false\n}\n\nexport const applyMask = (\n  value: string,\n  pattern: string,\n): { readonly masked: string; readonly raw: string } => {\n  let masked = ''\n  let raw = ''\n  let at = 0\n  for (let i = 0; i < pattern.length; i++) {\n    const slot = pattern[i]!\n    if (isPlaceholder(slot)) {\n      while (at < value.length && !matches(slot, value[at]!)) at++\n      if (at >= value.length) break\n      masked += value[at]!\n      raw += value[at]!\n      at++\n    } else if (fillable(pattern, i + 1, value, at)) {\n      masked += slot\n    } else {\n      break\n    }\n  }\n  return { masked, raw }\n}\n\ninterface MaskableField {\n  value: string\n  selectionStart: number | null\n  addEventListener(type: string, listener: () => void): void\n  removeEventListener(type: string, listener: () => void): void\n  setSelectionRange?(start: number, end: number): void\n}\n\nconst asField = (element: Element): MaskableField | null => {\n  const field = element as unknown as Partial<MaskableField>\n  return typeof field.value === 'string' && typeof field.addEventListener === 'function'\n    ? (field as MaskableField)\n    : null\n}\n\nexport const InputMask = Mount.defineStream('InputMask', {\n  messages: [Input],\n  args: { pattern: Schema.String },\n  execute: ({ element, pattern }) =>\n    Stream.callback<typeof Input.Type>(queue =>\n      Effect.gen(function* () {\n        const field = asField(element)\n        if (field === null) return\n        const onInput = () => {\n          const { masked, raw } = applyMask(field.value, pattern)\n          if (masked !== field.value) {\n            const caret = field.selectionStart ?? masked.length\n            field.value = masked\n            const at = Math.min(caret, masked.length)\n            try {\n              field.setSelectionRange?.(at, at)\n            } catch {\n              // Select-all style inputs reject ranges; the value still stands.\n            }\n          }\n          Queue.offerUnsafe(queue, Input.make({ value: masked, raw }))\n        }\n        yield* Effect.acquireRelease(\n          Effect.sync(() => {\n            field.addEventListener('input', onInput)\n            return field\n          }),\n          current => Effect.sync(() => current.removeEventListener('input', onInput)),\n        )\n      }),\n    ),\n})\n","/**\n * Script loading as a Command: appends a `src` script to the head unless one\n * is already there. Idempotent by URL — concurrent placements collapse onto\n * the first tag instead of fetching twice. Yields `Loaded` on success and\n * `LoadFailed` otherwise (network error, no document), so `update` handles\n * both outcomes as Messages.\n */\nimport { Effect, Schema } from 'effect'\nimport type { Command } from 'foldkit/command'\nimport { defineMessageUnion } from 'foldkit/message'\n\nexport const ScriptMessage = defineMessageUnion({\n  Loaded: {},\n  LoadFailed: { message: Schema.String },\n})\nexport type ScriptMessage = typeof ScriptMessage.Type\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\n// Tags still fetching, by URL: concurrent loads share one tag and its fate.\nconst inflight = new Map<string, Promise<void>>()\n\n/** Loads a script by URL, once per URL. */\nexport const loadScript = (src: string): Command<ScriptMessage, never, never> => ({\n  name: 'Script.load',\n  args: { src },\n  effect: Effect.matchEffect(\n    Effect.tryPromise({\n      try: () => {\n        if (typeof document === 'undefined') {\n          return Promise.reject(new Error('script loading is unavailable'))\n        }\n        // Concurrent loads share one tag and its fate, instead of racing\n        // past the presence check and fetching twice: the in-flight entry\n        // is checked before presence, in the same synchronous block that\n        // appends, so a second load cannot slip between them.\n        const running = inflight.get(src)\n        if (running !== undefined) return running\n        // getAttribute, not .src: the property resolves to an absolute URL\n        // and would never equal the given string.\n        const present = Array.from(document.getElementsByTagName('script')).some(\n          element => element.getAttribute('src') === src,\n        )\n        if (present) return Promise.resolve()\n        const completion = new Promise<void>((resolve, reject) => {\n          const element = document.createElement('script')\n          element.src = src\n          element.async = true\n          element.onload = () => resolve()\n          element.onerror = () => {\n            // A dead tag must not satisfy later presence checks.\n            element.remove()\n            reject(new Error(`failed to load script: ${src}`))\n          }\n          document.head.appendChild(element)\n        })\n        const tracked = completion.then(\n          () => {\n            inflight.delete(src)\n          },\n          (error: unknown) => {\n            inflight.delete(src)\n            throw error\n          },\n        )\n        inflight.set(src, tracked)\n        return tracked\n      },\n      catch: (error: unknown) => error,\n    }),\n    {\n      onFailure: error => Effect.succeed(ScriptMessage.LoadFailed({ message: failMessage(error) })),\n      onSuccess: () => Effect.succeed(ScriptMessage.Loaded()),\n    },\n  ),\n})\n","/**\n * Web Share as a Command: runs in `update` beside any bundle, yields\n * `Shared` on success. Dismissal is its own outcome, not a failure — the\n * application tells a cancelled sheet apart from a broken one. Without a\n * share API (desktop, insecure context) it yields `ShareFailed` instead of\n * throwing, so `update` handles every outcome as a Message.\n */\nimport { Effect, Schema } from 'effect'\nimport type { Command } from 'foldkit/command'\nimport { defineMessageUnion } from 'foldkit/message'\n\nexport const ShareData = Schema.Struct({\n  title: Schema.optional(Schema.String),\n  text: Schema.optional(Schema.String),\n  url: Schema.optional(Schema.String),\n})\nexport type ShareData = typeof ShareData.Type\n\nexport const ShareMessage = defineMessageUnion({\n  Shared: {},\n  Dismissed: {},\n  ShareFailed: { message: Schema.String },\n})\nexport type ShareMessage = typeof ShareMessage.Type\n\nconst failMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error)\n\nconst isDismissal = (error: unknown): boolean =>\n  typeof (error as { readonly name?: unknown } | null)?.name === 'string' &&\n  (error as { readonly name: string }).name === 'AbortError'\n\n/** Shares data through the platform sheet. */\nexport const share = (data: ShareData): Command<ShareMessage, never, never> => ({\n  name: 'Share.share',\n  args: { data },\n  effect:\n    typeof navigator !== 'undefined' && typeof navigator.share === 'function'\n      ? Effect.matchEffect(\n          Effect.tryPromise({\n            // Omit absent fields: the platform type rejects explicit\n            // undefined under exactOptionalPropertyTypes.\n            try: () =>\n              navigator.share({\n                ...(data.title !== undefined ? { title: data.title } : {}),\n                ...(data.text !== undefined ? { text: data.text } : {}),\n                ...(data.url !== undefined ? { url: data.url } : {}),\n              }),\n            catch: (error: unknown) => error,\n          }),\n          {\n            onFailure: error =>\n              Effect.succeed(\n                isDismissal(error)\n                  ? ShareMessage.Dismissed()\n                  : ShareMessage.ShareFailed({ message: failMessage(error) }),\n              ),\n            onSuccess: () => Effect.succeed(ShareMessage.Shared()),\n          },\n        )\n      : Effect.succeed(ShareMessage.ShareFailed({ message: 'share is unavailable' })),\n})\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,UAAU,OAAO,aAAa,WAAW,CAAC,CAAC;AAGxD,MAAa,YAAY,MAAM,OAAO,aAAa;CACjD,UAAU,CAAC,OAAO;CAClB,UAAU,EAAE,cACV,OAAO,WAAW;EAChB,MAAM,YAAY;EAClB,IAAI,OAAO,UAAU,UAAU,YAC5B,UAAW,MAAqB,KAAK,OAAO;EAE/C,OAAO,QAAQ,KAAK,CAAC,CAAC;CACxB,CAAC;AACL,CAAC;;;;;;;;ACdD,MAAa,mBAAmB,mBAAmB;CACjD,QAAQ,CAAC;CACT,YAAY,EAAE,SAAS,OAAO,OAAO;AACvC,CAAC;AAGD,MAAMA,iBAAe,UACnB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;;;;;;AAOvD,MAAa,YAAY,UAA2D;CAClF,MAAM;CACN,MAAM,EAAE,KAAK;CACb,QACE,OAAO,cAAc,eAAe,OAAO,UAAU,WAAW,cAAc,aAC1E,OAAO,YACL,OAAO,WAAW;EAChB,WAAW,UAAU,UAAU,UAAU,IAAI;EAC7C,OAAOA;CACT,CAAC,GACD;EACE,YAAW,YAAW,OAAO,QAAQ,iBAAiB,WAAW,EAAE,QAAQ,CAAC,CAAC;EAC7E,iBAAiB,OAAO,QAAQ,iBAAiB,OAAO,CAAC;CAC3D,CACF,IACA,OAAO,QAAQ,iBAAiB,WAAW,EAAE,SAAS,2BAA2B,CAAC,CAAC;AAC3F;;;;;;;;;;;;AC3BA,MAAa,QAAQ,OAAO,aAAa,SAAS;CAChD,OAAO,OAAO;CACd,KAAK,OAAO;AACd,CAAC;AAGD,MAAM,WAAW,SAA0B,QAAQ,OAAO,QAAQ;AAClE,MAAM,YAAY,SACf,QAAQ,OAAO,QAAQ,OAAS,QAAQ,OAAO,QAAQ;AAE1D,MAAM,WAAW,aAAqB,SACpC,gBAAgB,MACZ,QAAQ,IAAI,IACZ,gBAAgB,MACd,SAAS,IAAI,IACb,QAAQ,IAAI,KAAK,SAAS,IAAI;AAEtC,MAAM,iBAAiB,SAA0B,SAAS,OAAO,SAAS,OAAO,SAAS;;AAG1F,MAAM,YAAY,SAAiB,MAAc,OAAe,OAAwB;CACtF,KAAK,IAAI,IAAI,MAAM,IAAI,QAAQ,QAAQ,KAAK;EAC1C,MAAM,cAAc,QAAQ;EAC5B,IAAI,CAAC,cAAc,WAAW,GAAG;EACjC,KAAK,IAAI,IAAI,IAAI,IAAI,MAAM,QAAQ,KACjC,IAAI,QAAQ,aAAa,MAAM,EAAG,GAAG,OAAO;CAEhD;CACA,OAAO;AACT;AAEA,MAAa,aACX,OACA,YACsD;CACtD,IAAI,SAAS;CACb,IAAI,MAAM;CACV,IAAI,KAAK;CACT,KAAK,IAAI,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;EACvC,MAAM,OAAO,QAAQ;EACrB,IAAI,cAAc,IAAI,GAAG;GACvB,OAAO,KAAK,MAAM,UAAU,CAAC,QAAQ,MAAM,MAAM,GAAI,GAAG;GACxD,IAAI,MAAM,MAAM,QAAQ;GACxB,UAAU,MAAM;GAChB,OAAO,MAAM;GACb;EACF,OAAO,IAAI,SAAS,SAAS,IAAI,GAAG,OAAO,EAAE,GAC3C,UAAU;OAEV;CAEJ;CACA,OAAO;EAAE;EAAQ;CAAI;AACvB;AAUA,MAAM,WAAW,YAA2C;CAC1D,MAAM,QAAQ;CACd,OAAO,OAAO,MAAM,UAAU,YAAY,OAAO,MAAM,qBAAqB,aACvE,QACD;AACN;AAEA,MAAa,YAAY,MAAM,aAAa,aAAa;CACvD,UAAU,CAAC,KAAK;CAChB,MAAM,EAAE,SAAS,OAAO,OAAO;CAC/B,UAAU,EAAE,SAAS,cACnB,OAAO,UAA4B,UACjC,OAAO,IAAI,aAAa;EACtB,MAAM,QAAQ,QAAQ,OAAO;EAC7B,IAAI,UAAU,MAAM;EACpB,MAAM,gBAAgB;GACpB,MAAM,EAAE,QAAQ,QAAQ,UAAU,MAAM,OAAO,OAAO;GACtD,IAAI,WAAW,MAAM,OAAO;IAC1B,MAAM,QAAQ,MAAM,kBAAkB,OAAO;IAC7C,MAAM,QAAQ;IACd,MAAM,KAAK,KAAK,IAAI,OAAO,OAAO,MAAM;IACxC,IAAI;KACF,MAAM,oBAAoB,IAAI,EAAE;IAClC,QAAQ,CAER;GACF;GACA,MAAM,YAAY,OAAO,MAAM,KAAK;IAAE,OAAO;IAAQ;GAAI,CAAC,CAAC;EAC7D;EACA,OAAO,OAAO,eACZ,OAAO,WAAW;GAChB,MAAM,iBAAiB,SAAS,OAAO;GACvC,OAAO;EACT,CAAC,IACD,YAAW,OAAO,WAAW,QAAQ,oBAAoB,SAAS,OAAO,CAAC,CAC5E;CACF,CAAC,CACH;AACJ,CAAC;;;;;;;;;;ACtGD,MAAa,gBAAgB,mBAAmB;CAC9C,QAAQ,CAAC;CACT,YAAY,EAAE,SAAS,OAAO,OAAO;AACvC,CAAC;AAGD,MAAMC,iBAAe,UACnB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAGvD,MAAM,2BAAW,IAAI,IAA2B;;AAGhD,MAAa,cAAc,SAAuD;CAChF,MAAM;CACN,MAAM,EAAE,IAAI;CACZ,QAAQ,OAAO,YACb,OAAO,WAAW;EAChB,WAAW;GACT,IAAI,OAAO,aAAa,aACtB,OAAO,QAAQ,uBAAO,IAAI,MAAM,+BAA+B,CAAC;GAMlE,MAAM,UAAU,SAAS,IAAI,GAAG;GAChC,IAAI,YAAY,KAAA,GAAW,OAAO;GAMlC,IAHgB,MAAM,KAAK,SAAS,qBAAqB,QAAQ,CAAC,CAAC,CAAC,MAClE,YAAW,QAAQ,aAAa,KAAK,MAAM,GAEnC,GAAG,OAAO,QAAQ,QAAQ;GAapC,MAAM,UAAU,IAZO,SAAe,SAAS,WAAW;IACxD,MAAM,UAAU,SAAS,cAAc,QAAQ;IAC/C,QAAQ,MAAM;IACd,QAAQ,QAAQ;IAChB,QAAQ,eAAe,QAAQ;IAC/B,QAAQ,gBAAgB;KAEtB,QAAQ,OAAO;KACf,uBAAO,IAAI,MAAM,0BAA0B,KAAK,CAAC;IACnD;IACA,SAAS,KAAK,YAAY,OAAO;GACnC,CACyB,CAAC,CAAC,WACnB;IACJ,SAAS,OAAO,GAAG;GACrB,IACC,UAAmB;IAClB,SAAS,OAAO,GAAG;IACnB,MAAM;GACR,CACF;GACA,SAAS,IAAI,KAAK,OAAO;GACzB,OAAO;EACT;EACA,QAAQ,UAAmB;CAC7B,CAAC,GACD;EACE,YAAW,UAAS,OAAO,QAAQ,cAAc,WAAW,EAAE,SAASA,cAAY,KAAK,EAAE,CAAC,CAAC;EAC5F,iBAAiB,OAAO,QAAQ,cAAc,OAAO,CAAC;CACxD,CACF;AACF;;;;;;;;;;ACjEA,MAAa,YAAY,OAAO,OAAO;CACrC,OAAO,OAAO,SAAS,OAAO,MAAM;CACpC,MAAM,OAAO,SAAS,OAAO,MAAM;CACnC,KAAK,OAAO,SAAS,OAAO,MAAM;AACpC,CAAC;AAGD,MAAa,eAAe,mBAAmB;CAC7C,QAAQ,CAAC;CACT,WAAW,CAAC;CACZ,aAAa,EAAE,SAAS,OAAO,OAAO;AACxC,CAAC;AAGD,MAAM,eAAe,UACnB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAEvD,MAAM,eAAe,UACnB,OAAQ,OAA8C,SAAS,YAC9D,MAAoC,SAAS;;AAGhD,MAAa,SAAS,UAA0D;CAC9E,MAAM;CACN,MAAM,EAAE,KAAK;CACb,QACE,OAAO,cAAc,eAAe,OAAO,UAAU,UAAU,aAC3D,OAAO,YACL,OAAO,WAAW;EAGhB,WACE,UAAU,MAAM;GACd,GAAI,KAAK,UAAU,KAAA,IAAY,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;GACxD,GAAI,KAAK,SAAS,KAAA,IAAY,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;GACrD,GAAI,KAAK,QAAQ,KAAA,IAAY,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC;EACpD,CAAC;EACH,QAAQ,UAAmB;CAC7B,CAAC,GACD;EACE,YAAW,UACT,OAAO,QACL,YAAY,KAAK,IACb,aAAa,UAAU,IACvB,aAAa,YAAY,EAAE,SAAS,YAAY,KAAK,EAAE,CAAC,CAC9D;EACF,iBAAiB,OAAO,QAAQ,aAAa,OAAO,CAAC;CACvD,CACF,IACA,OAAO,QAAQ,aAAa,YAAY,EAAE,SAAS,uBAAuB,CAAC,CAAC;AACpF"}

package/dist/events/index.d.mts

@@ -0,0 +1,154 @@
+import { Schema, Stream } from "effect";
+import { Bundle } from "foldkit-bundle";
+//#region src/events/active-element.d.ts
+export declare const ActiveElementMessage: import("foldkit/message").MessageUnion<{
+  readonly Changed: {
+    readonly tag: Schema.String;
+    readonly id: Schema.NullOr<Schema.String>;
+  };
+}>;
+export type ActiveElementMessage = typeof ActiveElementMessage.Type;
+/**
+ * Focus changes on the document. Without a document the stream is empty
+ * instead of throwing. Lift with `Subscription.persistent`, mapping into
+ * the parent's Message.
+ */
+export declare const activeElementEvents: () => Stream.Stream<ActiveElementMessage>;
+//#endregion
+//#region src/events/hotkeys.d.ts
+/**
+ * Hotkey matching as a pure function over a `Pressed` payload: `matchHotkey`
+ * answers whether a press is the shortcut, so `update` stays a table of
+ * chords instead of a nest of modifier checks. Patterns read like
+ * `"ctrl+shift+k"`: modifiers first (any order), the key last,
+ * case-insensitive, with `cmd`/`command` and `option` as the Mac names for
+ * meta and alt. Matching is exact — unlisted modifiers must be up — and
+ * auto-repeat never matches, so holding a chord fires once. `space` (or a
+ * bare space) means the space key; `esc` means escape. A pattern with
+ * no key, or two keys, matches nothing: predicates return false, they do
+ * not throw on the hot path.
+ */
+export interface KeyPress {
+  readonly key: string;
+  readonly repeat: boolean;
+  readonly ctrl: boolean;
+  readonly shift: boolean;
+  readonly alt: boolean;
+  readonly meta: boolean;
+}
+export declare const matchHotkey: (pattern: string, press: KeyPress) => boolean;
+//#endregion
+//#region src/events/idle.d.ts
+export declare const IdleModel: Schema.Struct<{
+  readonly idle: Schema.Boolean;
+}>;
+export type IdleModel = typeof IdleModel.Type;
+export declare const IdleMessage: import("foldkit/message").MessageUnion<{
+  readonly BecameIdle: {};
+  readonly BecameActive: {};
+}>;
+export type IdleMessage = typeof IdleMessage.Type;
+export declare const Idle: Bundle.Bundle<"Idle", {
+  readonly timeoutMs: number;
+}, {
+  idle: boolean;
+}, {
+  readonly _tag: "BecameIdle";
+} | {
+  readonly _tag: "BecameActive";
+}, never, never, never, void, {}, {}>;
+//#endregion
+//#region src/events/keyboard.d.ts
+export declare const KeyboardMessage: import("foldkit/message").MessageUnion<{
+  readonly Pressed: {
+    readonly key: Schema.String;
+    readonly repeat: Schema.Boolean;
+    readonly ctrl: Schema.Boolean;
+    readonly shift: Schema.Boolean;
+    readonly alt: Schema.Boolean;
+    readonly meta: Schema.Boolean;
+  };
+  readonly Released: {
+    readonly key: Schema.String;
+  };
+}>;
+export type KeyboardMessage = typeof KeyboardMessage.Type;
+/**
+ * Key presses and releases on the window. Without a window the stream is
+ * empty instead of throwing. Lift with `Subscription.persistent`, mapping
+ * into the parent's Message.
+ */
+export declare const keyboardEvents: () => Stream.Stream<KeyboardMessage>;
+//#endregion
+//#region src/events/pointer.d.ts
+export declare const PointerMessage: import("foldkit/message").MessageUnion<{
+  readonly Moved: {
+    readonly x: Schema.Number;
+    readonly y: Schema.Number;
+  };
+}>;
+export type PointerMessage = typeof PointerMessage.Type;
+/**
+ * Pointer moves on the window. Without a window the stream is empty instead
+ * of throwing. Lift with `Subscription.persistent`, mapping into the
+ * parent's Message.
+ */
+export declare const pointerEvents: () => Stream.Stream<PointerMessage>;
+//#endregion
+//#region src/events/scroll.d.ts
+export declare const ScrollMessage: import("foldkit/message").MessageUnion<{
+  readonly Scrolled: {
+    readonly x: Schema.Number;
+    readonly y: Schema.Number;
+  };
+}>;
+export type ScrollMessage = typeof ScrollMessage.Type;
+/**
+ * Scrolls on the window, in the capture phase so container scrolls (which
+ * do not bubble) report too. Without a window the stream is empty instead
+ * of throwing. Lift with `Subscription.persistent`, mapping into the
+ * parent's Message.
+ */
+export declare const scrollEvents: () => Stream.Stream<ScrollMessage>;
+//#endregion
+//#region src/events/visibility.d.ts
+export declare const VisibilityModel: Schema.Struct<{
+  readonly visible: Schema.Boolean;
+}>;
+export type VisibilityModel = typeof VisibilityModel.Type;
+export declare const VisibilityMessage: import("foldkit/message").MessageUnion<{
+  readonly Changed: {
+    readonly visible: Schema.Boolean;
+  };
+}>;
+export type VisibilityMessage = typeof VisibilityMessage.Type;
+export declare const Visibility: Bundle.Bundle<"Visibility", void, {
+  visible: boolean;
+}, {
+  readonly _tag: "Changed";
+  readonly visible: boolean;
+}, never, never, never, void, {}, {}>;
+//#endregion
+//#region src/events/window-size.d.ts
+export declare const WindowSizeModel: Schema.Struct<{
+  readonly width: Schema.Number;
+  readonly height: Schema.Number;
+}>;
+export type WindowSizeModel = typeof WindowSizeModel.Type;
+export declare const WindowSizeMessage: import("foldkit/message").MessageUnion<{
+  readonly Changed: {
+    readonly width: Schema.Number;
+    readonly height: Schema.Number;
+  };
+}>;
+export type WindowSizeMessage = typeof WindowSizeMessage.Type;
+export declare const WindowSize: Bundle.Bundle<"WindowSize", void, {
+  width: number;
+  height: number;
+}, {
+  readonly _tag: "Changed";
+  readonly width: number;
+  readonly height: number;
+}, never, never, never, void, {}, {}>;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/events/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/events/active-element.ts","../../src/events/hotkeys.ts","../../src/events/idle.ts","../../src/events/keyboard.ts","../../src/events/pointer.ts","../../src/events/scroll.ts","../../src/events/visibility.ts","../../src/events/window-size.ts"],"mappings":";;;qBASa,gDAAoB;;;;;;YAGrB,8BAA8B,qBAAqB;;;;;;qBAOlD,2BAA0B,OAAO,OAAO;;;;;;;;;;;;;;;iBCNpC;WACN;WACA;WACA;WACA;WACA;WACA;;qBAkCE,cAAW,iBAAmB,OAAS;;;qBCvCvC,WAAS,OAAA;;;YACV,mBAAmB,UAAU;qBAE5B,uCAAW;;;;YACZ,qBAAqB,YAAY;qBAchC,MAAI,OAAA;;;;;;;;;;;qBCvBJ,2CAAe;;;;;;;;;;;;;YAWhB,yBAAyB,gBAAgB;;;;;;qBAOxC,sBAAqB,OAAO,OAAO;;;qBClBnC,0CAAc;;;;;;YAGf,wBAAwB,eAAe;;;;;;qBAOtC,qBAAoB,OAAO,OAAO;;;qBCVlC,yCAAa;;;;;;YAGd,uBAAuB,cAAc;;;;;;;qBAQpC,oBAAmB,OAAO,OAAO;;;qBCTjC,iBAAe,OAAA;;;YAChB,yBAAyB,gBAAgB;qBAExC,6CAAiB;;sBAAjB,OAAA;;;YACD,2BAA2B,kBAAkB;qBAiB5C,YAAU,OAAA;;;;;;;;qBCpBV,iBAAe,OAAA;;;;YAChB,yBAAyB,gBAAgB;qBAExC,6CAAiB;;;;;;YAGlB,2BAA2B,kBAAkB;qBAmC5C,YAAU,OAAA"}