@gyral/core 0.0.0 → 0.1.0

package/dist/index.js

@@ -0,0 +1,35 @@
+export { command, defineDriver } from './command.js';
+export { child, emit } from './children.js';
+export { focus } from './focus.js';
+export { invokersSupported } from './invokers.js';
+export { ISLAND_ATTRIBUTE } from './islands.js';
+export { define } from './define.js';
+export { changed, defineStore, send } from './store.js';
+export { STORE_SEND } from './store.js';
+// Store scoping: used by @gyral/ssr (server scope + page seed) and @gyral/testing.
+export { resetDocumentStores, scriptSafeJson, STORE_SEED_ATTRIBUTE, StoreRegistry, STORES_ELEMENT, withStoreScope, } from './store-scope.js';
+export { defineStoresProvider } from './stores-provider.js';
+export { DRIVERS_ELEMENT, provideDrivers } from './drivers-scope.js';
+export { jsonHazard, warnJsonHazard } from './json-safety.js';
+export { random, randomDriver, randomInt, toInt } from './random.js';
+export { defineForm, field, fieldErrors, form, formDataToObject, formFields, intentRejectedSchema, redirectedTo, validateForm, } from './forms.js';
+export { ElementDirective } from './element-directive.js';
+export { runInit } from './init.js';
+export { invalid } from './invalid.js';
+export { findInScope, labelledBy } from './accessible-name.js';
+export { liveBoolean } from './live-boolean.js';
+export { textarea, textareaMarkup } from './textarea.js';
+// Devtools event stream (ADR 0017): emitted in development builds only.
+export { DEVTOOLS_ENABLED as devtoolsEnabled, devLiveComponents as devtoolsLiveComponents, } from '#devtools';
+export { DEVTOOLS_GLOBAL } from './devtools-events.js';
+// Used by @gyral/ssr to render light-DOM components as plain children (ADR 0014).
+export { HIDDEN_MARKER, HYDRATE_KEY, isLightComponent, LIGHT_ATTRIBUTE } from './light-dom.js';
+// The view layer is Lit. Re-exported so most apps need a single import.
+export { css, html, nothing, svg, unsafeCSS } from 'lit';
+export { directive } from 'lit/directive.js';
+export { classMap } from 'lit/directives/class-map.js';
+export { keyed } from 'lit/directives/keyed.js';
+export { live } from 'lit/directives/live.js';
+export { repeat } from 'lit/directives/repeat.js';
+export { styleMap } from 'lit/directives/style-map.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAYrD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAexD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,mFAAmF;AACnF,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAoB,MAAM,aAAa,CAAC;AACvF,OAAO,EACL,UAAU,EACV,KAAK,EACL,WAAW,EACX,IAAI,EACJ,gBAAgB,EAChB,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,wEAAwE;AACxE,OAAO,EACL,gBAAgB,IAAI,eAAe,EACnC,iBAAiB,IAAI,sBAAsB,GAC5C,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAUvD,kFAAkF;AAClF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAqB/F,wEAAwE;AACxE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC","sourcesContent":["export { command, defineDriver } from './command.js';\nexport type {\n  AnyDriver,\n  Command,\n  CommandHandlers,\n  Concurrency,\n  Driver,\n  DriverContext,\n  DriverOverrides,\n  Next,\n  RetryPolicy,\n} from './command.js';\nexport { child, emit } from './children.js';\nexport { focus } from './focus.js';\nexport type { FocusOptions } from './focus.js';\nexport { invokersSupported } from './invokers.js';\nexport type { CommandInfo } from './invokers.js';\nexport { ISLAND_ATTRIBUTE } from './islands.js';\nexport type { HydrateStrategy } from './islands.js';\nexport type { ChildSource, OutputSource } from './children.js';\nexport { define } from './define.js';\nexport { changed, defineStore, send } from './store.js';\nexport type {\n  AnyStore,\n  AnyStoreInstance,\n  Store,\n  StoreChanged,\n  StoreInstance,\n  StoreOverrides,\n  StoreRef,\n  StoreSendInput,\n  SeedCheck,\n  StoreResolver,\n  StoreSpec,\n  StoreUpdate,\n} from './store.js';\nexport { STORE_SEND } from './store.js';\n// Store scoping: used by @gyral/ssr (server scope + page seed) and @gyral/testing.\nexport {\n  resetDocumentStores,\n  scriptSafeJson,\n  STORE_SEED_ATTRIBUTE,\n  StoreRegistry,\n  STORES_ELEMENT,\n  withStoreScope,\n} from './store-scope.js';\nexport { defineStoresProvider } from './stores-provider.js';\nexport { DRIVERS_ELEMENT, provideDrivers } from './drivers-scope.js';\nexport { jsonHazard, warnJsonHazard } from './json-safety.js';\nexport { random, randomDriver, randomInt, toInt, type RandomInput } from './random.js';\nexport {\n  defineForm,\n  field,\n  fieldErrors,\n  form,\n  formDataToObject,\n  formFields,\n  intentRejectedSchema,\n  redirectedTo,\n  validateForm,\n} from './forms.js';\nexport type { FormDefinition, FormRedirected, FormResult, FormValue } from './forms.js';\nexport { ElementDirective } from './element-directive.js';\nexport { runInit } from './init.js';\nexport { invalid } from './invalid.js';\nexport { findInScope, labelledBy } from './accessible-name.js';\nexport { liveBoolean } from './live-boolean.js';\nexport { textarea, textareaMarkup } from './textarea.js';\n// Devtools event stream (ADR 0017): emitted in development builds only.\nexport {\n  DEVTOOLS_ENABLED as devtoolsEnabled,\n  devLiveComponents as devtoolsLiveComponents,\n} from '#devtools';\nexport { DEVTOOLS_GLOBAL } from './devtools-events.js';\nexport type {\n  CommandPhase,\n  CommandTraceEvent,\n  DevComponentRef,\n  DevEvent,\n  DevtoolsHook,\n} from './devtools-events.js';\nexport type { TextareaAttribute, TextareaOptions } from './textarea.js';\nexport type { Styles } from './styles.js';\n// Used by @gyral/ssr to render light-DOM components as plain children (ADR 0014).\nexport { HIDDEN_MARKER, HYDRATE_KEY, isLightComponent, LIGHT_ATTRIBUTE } from './light-dom.js';\nexport type { GyralElement, GyralElementClass } from './define.js';\nexport type {\n  ComponentSpec,\n  Ctx,\n  FieldIssue,\n  FormFields,\n  IntentInput,\n  IntentNames,\n  IntentParser,\n  IntentRejected,\n  Intents,\n  PropDeclarations,\n  Hydrated,\n  PropsChanged,\n  Stateless,\n  StoreReader,\n  Tagged,\n  Update,\n} from './types.js';\n\n// The view layer is Lit. Re-exported so most apps need a single import.\nexport { css, html, nothing, svg, unsafeCSS } from 'lit';\nexport { directive } from 'lit/directive.js';\nexport { classMap } from 'lit/directives/class-map.js';\nexport { keyed } from 'lit/directives/keyed.js';\nexport { live } from 'lit/directives/live.js';\nexport { repeat } from 'lit/directives/repeat.js';\nexport { styleMap } from 'lit/directives/style-map.js';\n"]}

package/dist/init.d.ts

@@ -0,0 +1,7 @@
+import type { Next } from './command.js';
+import type { ComponentSpec, Tagged } from './types.js';
+/**
+ * Runs a spec's `init`, or starts from `{}` when a stateless component omits it. Used by
+ * `define()` and by `@gyral/testing`.
+ */
+export declare function runInit<S, M extends Tagged, P>(spec: ComponentSpec<S, M, P>, props: P): Next<S, M>;

package/dist/init.js

@@ -0,0 +1,10 @@
+/**
+ * Runs a spec's `init`, or starts from `{}` when a stateless component omits it. Used by
+ * `define()` and by `@gyral/testing`.
+ */
+export function runInit(spec, props) {
+    const { init } = spec;
+    // Sound: InitField only lets `init` be omitted when `{}` is a valid S.
+    return init === undefined ? {} : init(props);
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,OAAO,CACrB,IAA4B,EAC5B,KAAQ;IAER,MAAM,EAAE,IAAI,EAAE,GAAG,IAAoD,CAAC;IACtE,uEAAuE;IACvE,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAE,EAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import type { Next } from './command.js';\nimport type { ComponentSpec, Tagged } from './types.js';\n\n/**\n * Runs a spec's `init`, or starts from `{}` when a stateless component omits it. Used by\n * `define()` and by `@gyral/testing`.\n */\nexport function runInit<S, M extends Tagged, P>(\n  spec: ComponentSpec<S, M, P>,\n  props: P,\n): Next<S, M> {\n  const { init } = spec as { readonly init?: (props: P) => Next<S, M> };\n  // Sound: InitField only lets `init` be omitted when `{}` is a valid S.\n  return init === undefined ? ({} as S) : init(props);\n}\n"]}

package/dist/intent.d.ts

@@ -0,0 +1,25 @@
+import type { IntentInput, IntentParser, Tagged } from './types.js';
+/** Event a child component dispatches on its host to send an output up (ADR 0010). */
+export declare const OUTPUT_EVENT = "gyral-output";
+/**
+ * Events the intent layer listens for on each component's shadow root (capture phase, so
+ * non-bubbling events such as `toggle` are seen too). Only `click`, `submit`, `input`,
+ * `change` and outputs are default triggers; the rest fire via `data-intent-on="…"`.
+ * Components may add more with `spec.events`.
+ */
+export declare const INTENT_EVENTS: readonly ["click", "submit", "input", "change", "keydown", "keyup", "focusin", "focusout", "toggle", "command", "gyral-output"];
+/** The event that fires an intent unless `data-intent-on` overrides it. */
+export declare function defaultTrigger(el: Element): string;
+export declare function markGyralHost(ctor: object): void;
+/**
+ * Finds the nearest `data-intent` element for this event that belongs to `root`. Elements
+ * inside nested components are ignored: that is component isolation.
+ */
+export declare function findIntentElement(event: Event, root: Node): Element | undefined;
+/** Reads an event into an IntentInput. Form submissions are prevented and turned into FormData. */
+export declare function readIntent(event: Event, root: Node): IntentInput | undefined;
+export declare const intentNames: unknown;
+/** Listens for intent events on a component root (capture phase: `toggle` doesn't bubble). */
+export declare function listenForIntents(root: Node, extra: readonly string[], handler: (event: Event) => void): void;
+/** Parses one event with its matching parser and delivers the message (sync or async). */
+export declare function handleIntent<M>(event: Event, root: Node, parsers: Readonly<Record<string, IntentParser<M> | undefined>>, tag: string, deliver: (msg: Tagged | undefined) => void): void;

package/dist/intent.js

@@ -0,0 +1,157 @@
+import { commandOf, shimInvokers } from './invokers.js';
+/** Event a child component dispatches on its host to send an output up (ADR 0010). */
+export const OUTPUT_EVENT = 'gyral-output';
+/**
+ * Events the intent layer listens for on each component's shadow root (capture phase, so
+ * non-bubbling events such as `toggle` are seen too). Only `click`, `submit`, `input`,
+ * `change` and outputs are default triggers; the rest fire via `data-intent-on="…"`.
+ * Components may add more with `spec.events`.
+ */
+export const INTENT_EVENTS = [
+    'click',
+    'submit',
+    'input',
+    'change',
+    'keydown',
+    'keyup',
+    'focusin',
+    'focusout',
+    'toggle',
+    'command',
+    OUTPUT_EVENT,
+];
+const isToggle = (el) => el instanceof HTMLInputElement && (el.type === 'checkbox' || el.type === 'radio');
+// ToggleEvent (popover, <details>) is not Baseline widely available; read it structurally.
+function toggleState(event) {
+    if (event.type !== 'toggle' || !('newState' in event))
+        return undefined;
+    return event.newState === 'open' ? 'open' : 'closed';
+}
+const CLICK_INPUT_TYPES = new Set(['button', 'submit', 'reset', 'image']);
+/** The event that fires an intent unless `data-intent-on` overrides it. */
+export function defaultTrigger(el) {
+    if (el instanceof HTMLFormElement)
+        return 'submit';
+    if (el instanceof HTMLSelectElement)
+        return 'change';
+    if (el instanceof HTMLTextAreaElement)
+        return 'input';
+    if (el instanceof HTMLInputElement) {
+        if (CLICK_INPUT_TYPES.has(el.type))
+            return 'click';
+        return el.type === 'checkbox' || el.type === 'radio' ? 'change' : 'input';
+    }
+    // Custom elements (autonomous: the name has a dash) talk to their parent via outputs.
+    if (el.localName.includes('-'))
+        return OUTPUT_EVENT;
+    return 'click';
+}
+function triggerOf(el) {
+    return el.getAttribute('data-intent-on') ?? defaultTrigger(el);
+}
+/** Every class `define()` creates, so intent lookup can tell where a component begins. */
+const hostClasses = new WeakSet();
+export function markGyralHost(ctor) {
+    hostClasses.add(ctor);
+}
+const isGyralHost = (node) => hostClasses.has(node.constructor);
+/**
+ * Does `node` belong to the component whose intent root is `root`? `root` is the component's
+ * shadow root, or the host itself for light-DOM components (ADR 0014). The node must be in the
+ * same tree (not inside a nested shadow root) with no other Gyral host between them: a nested
+ * component, light-DOM or shadow, owns its own content. The nested host element itself (with
+ * the parent's `data-intent` on it) still belongs to the parent.
+ */
+function ownedBy(node, root) {
+    const tree = root instanceof ShadowRoot ? root : root.getRootNode();
+    if (node.getRootNode() !== tree)
+        return false;
+    for (let p = node.parentNode; p !== null; p = p.parentNode) {
+        if (p === root)
+            return true;
+        if (isGyralHost(p))
+            return false;
+    }
+    return false;
+}
+/**
+ * Finds the nearest `data-intent` element for this event that belongs to `root`. Elements
+ * inside nested components are ignored: that is component isolation.
+ */
+export function findIntentElement(event, root) {
+    for (const node of event.composedPath()) {
+        if (node === root)
+            return undefined;
+        if (node instanceof Element &&
+            node.hasAttribute('data-intent') &&
+            triggerOf(node) === event.type &&
+            ownedBy(node, root)) {
+            return node;
+        }
+    }
+    return undefined;
+}
+function valueOf(el) {
+    if (el instanceof HTMLInputElement ||
+        el instanceof HTMLSelectElement ||
+        el instanceof HTMLTextAreaElement ||
+        el instanceof HTMLButtonElement) {
+        return el.value;
+    }
+    return undefined;
+}
+/** Reads an event into an IntentInput. Form submissions are prevented and turned into FormData. */
+export function readIntent(event, root) {
+    const target = findIntentElement(event, root);
+    const name = target?.getAttribute('data-intent');
+    if (target === undefined || name == null)
+        return undefined;
+    let formData;
+    if (target instanceof HTMLFormElement && event instanceof SubmitEvent) {
+        event.preventDefault();
+        formData = new FormData(target, event.submitter);
+    }
+    return {
+        name,
+        event,
+        target,
+        value: valueOf(target),
+        checked: isToggle(target) ? target.checked : undefined,
+        formData,
+        detail: event instanceof CustomEvent ? event.detail : undefined,
+        key: event instanceof KeyboardEvent ? event.key : undefined,
+        newState: toggleState(event),
+        command: commandOf(event),
+    };
+}
+// Any property read returns its own name, so `intents.Increment === 'Increment'`.
+// Types restrict reads to real message tags; a tag without a parser warns at event time.
+export const intentNames = new Proxy({}, { get: (_target, key) => (typeof key === 'string' ? key : undefined) });
+/** Listens for intent events on a component root (capture phase: `toggle` doesn't bubble). */
+export function listenForIntents(root, extra, handler) {
+    for (const type of new Set([...INTENT_EVENTS, ...extra])) {
+        root.addEventListener(type, handler, { capture: true });
+    }
+    shimInvokers(root); // `command` intents in browsers without invoker commands
+}
+/** Parses one event with its matching parser and delivers the message (sync or async). */
+export function handleIntent(event, root, parsers, tag, deliver) {
+    const input = readIntent(event, root);
+    if (input === undefined)
+        return;
+    const parser = parsers[input.name];
+    if (parser === undefined) {
+        console.warn(`<${tag}> has no intent parser for data-intent="${input.name}".`);
+        return;
+    }
+    const result = parser(input);
+    if (result instanceof Promise) {
+        result.then(deliver, (error) => {
+            console.error(`<${tag}> intent parser for "${input.name}" failed`, error);
+        });
+    }
+    else {
+        deliver(result);
+    }
+}
+//# sourceMappingURL=intent.js.map

package/dist/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../src/intent.ts"],"names":[],"mappings":"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","sourcesContent":["import { commandOf, shimInvokers } from './invokers.js';\nimport type { IntentInput, IntentParser, Tagged } from './types.js';\n\n/** Event a child component dispatches on its host to send an output up (ADR 0010). */\nexport const OUTPUT_EVENT = 'gyral-output';\n\n/**\n * Events the intent layer listens for on each component's shadow root (capture phase, so\n * non-bubbling events such as `toggle` are seen too). Only `click`, `submit`, `input`,\n * `change` and outputs are default triggers; the rest fire via `data-intent-on=\"…\"`.\n * Components may add more with `spec.events`.\n */\nexport const INTENT_EVENTS = [\n  'click',\n  'submit',\n  'input',\n  'change',\n  'keydown',\n  'keyup',\n  'focusin',\n  'focusout',\n  'toggle',\n  'command',\n  OUTPUT_EVENT,\n] as const;\n\nconst isToggle = (el: Element): el is HTMLInputElement =>\n  el instanceof HTMLInputElement && (el.type === 'checkbox' || el.type === 'radio');\n\n// ToggleEvent (popover, <details>) is not Baseline widely available; read it structurally.\nfunction toggleState(event: Event): 'open' | 'closed' | undefined {\n  if (event.type !== 'toggle' || !('newState' in event)) return undefined;\n  return event.newState === 'open' ? 'open' : 'closed';\n}\n\nconst CLICK_INPUT_TYPES = new Set(['button', 'submit', 'reset', 'image']);\n\n/** The event that fires an intent unless `data-intent-on` overrides it. */\nexport function defaultTrigger(el: Element): string {\n  if (el instanceof HTMLFormElement) return 'submit';\n  if (el instanceof HTMLSelectElement) return 'change';\n  if (el instanceof HTMLTextAreaElement) return 'input';\n  if (el instanceof HTMLInputElement) {\n    if (CLICK_INPUT_TYPES.has(el.type)) return 'click';\n    return el.type === 'checkbox' || el.type === 'radio' ? 'change' : 'input';\n  }\n  // Custom elements (autonomous: the name has a dash) talk to their parent via outputs.\n  if (el.localName.includes('-')) return OUTPUT_EVENT;\n  return 'click';\n}\n\nfunction triggerOf(el: Element): string {\n  return el.getAttribute('data-intent-on') ?? defaultTrigger(el);\n}\n\n/** Every class `define()` creates, so intent lookup can tell where a component begins. */\nconst hostClasses = new WeakSet<object>();\n\nexport function markGyralHost(ctor: object): void {\n  hostClasses.add(ctor);\n}\n\nconst isGyralHost = (node: Node): boolean => hostClasses.has(node.constructor);\n\n/**\n * Does `node` belong to the component whose intent root is `root`? `root` is the component's\n * shadow root, or the host itself for light-DOM components (ADR 0014). The node must be in the\n * same tree (not inside a nested shadow root) with no other Gyral host between them: a nested\n * component, light-DOM or shadow, owns its own content. The nested host element itself (with\n * the parent's `data-intent` on it) still belongs to the parent.\n */\nfunction ownedBy(node: Element, root: Node): boolean {\n  const tree = root instanceof ShadowRoot ? root : root.getRootNode();\n  if (node.getRootNode() !== tree) return false;\n  for (let p = node.parentNode; p !== null; p = p.parentNode) {\n    if (p === root) return true;\n    if (isGyralHost(p)) return false;\n  }\n  return false;\n}\n\n/**\n * Finds the nearest `data-intent` element for this event that belongs to `root`. Elements\n * inside nested components are ignored: that is component isolation.\n */\nexport function findIntentElement(event: Event, root: Node): Element | undefined {\n  for (const node of event.composedPath()) {\n    if (node === root) return undefined;\n    if (\n      node instanceof Element &&\n      node.hasAttribute('data-intent') &&\n      triggerOf(node) === event.type &&\n      ownedBy(node, root)\n    ) {\n      return node;\n    }\n  }\n  return undefined;\n}\n\nfunction valueOf(el: Element): string | undefined {\n  if (\n    el instanceof HTMLInputElement ||\n    el instanceof HTMLSelectElement ||\n    el instanceof HTMLTextAreaElement ||\n    el instanceof HTMLButtonElement\n  ) {\n    return el.value;\n  }\n  return undefined;\n}\n\n/** Reads an event into an IntentInput. Form submissions are prevented and turned into FormData. */\nexport function readIntent(event: Event, root: Node): IntentInput | undefined {\n  const target = findIntentElement(event, root);\n  const name = target?.getAttribute('data-intent');\n  if (target === undefined || name == null) return undefined;\n  let formData: FormData | undefined;\n  if (target instanceof HTMLFormElement && event instanceof SubmitEvent) {\n    event.preventDefault();\n    formData = new FormData(target, event.submitter);\n  }\n  return {\n    name,\n    event,\n    target,\n    value: valueOf(target),\n    checked: isToggle(target) ? target.checked : undefined,\n    formData,\n    detail: event instanceof CustomEvent ? (event.detail as unknown) : undefined,\n    key: event instanceof KeyboardEvent ? event.key : undefined,\n    newState: toggleState(event),\n    command: commandOf(event),\n  };\n}\n\n// Any property read returns its own name, so `intents.Increment === 'Increment'`.\n// Types restrict reads to real message tags; a tag without a parser warns at event time.\nexport const intentNames: unknown = new Proxy(\n  {},\n  { get: (_target, key) => (typeof key === 'string' ? key : undefined) },\n);\n\n/** Listens for intent events on a component root (capture phase: `toggle` doesn't bubble). */\nexport function listenForIntents(\n  root: Node,\n  extra: readonly string[],\n  handler: (event: Event) => void,\n): void {\n  for (const type of new Set([...INTENT_EVENTS, ...extra])) {\n    root.addEventListener(type, handler, { capture: true });\n  }\n  shimInvokers(root); // `command` intents in browsers without invoker commands\n}\n\n/** Parses one event with its matching parser and delivers the message (sync or async). */\nexport function handleIntent<M>(\n  event: Event,\n  root: Node,\n  parsers: Readonly<Record<string, IntentParser<M> | undefined>>,\n  tag: string,\n  deliver: (msg: Tagged | undefined) => void,\n): void {\n  const input = readIntent(event, root);\n  if (input === undefined) return;\n  const parser = parsers[input.name];\n  if (parser === undefined) {\n    console.warn(`<${tag}> has no intent parser for data-intent=\"${input.name}\".`);\n    return;\n  }\n  const result = parser(input) as Tagged | undefined | Promise<Tagged | undefined>;\n  if (result instanceof Promise) {\n    result.then(deliver, (error: unknown) => {\n      console.error(`<${tag}> intent parser for \"${input.name}\" failed`, error);\n    });\n  } else {\n    deliver(result);\n  }\n}\n"]}

package/dist/internal/interpreter.d.ts

@@ -0,0 +1,8 @@
+import type { AnyDriver, Command } from '../command.js';
+import type { CommandTrace } from '../devtools-events.js';
+/** Runs commands for one connected element. Disposed on disconnect. */
+export interface Interpreter<M> {
+    readonly run: (cmd: Command<M>) => void;
+    readonly dispose: () => void;
+}
+export declare function makeInterpreter<M>(resolve: (driver: AnyDriver) => AnyDriver, dispatch: (msg: M) => void, trace?: CommandTrace): Interpreter<M>;

package/dist/internal/interpreter.js

@@ -0,0 +1,128 @@
+import { Data, Duration, Effect, Fiber, Schedule } from 'effect';
+import { DEVTOOLS_ENABLED } from '#devtools';
+import { fork } from './runtime.js';
+class DriverFailure extends Data.TaggedError('DriverFailure') {
+}
+const isRunning = (fiber) => fiber !== undefined && fiber.unsafePoll() === null;
+const withRetry = (attempt, policy) => {
+    if (policy === undefined || policy.times <= 0)
+        return attempt;
+    const base = Duration.millis(policy.delayMs ?? 0);
+    const delays = policy.backoff === 'exponential' ? Schedule.exponential(base) : Schedule.spaced(base);
+    return Effect.retry(attempt, delays.pipe(Schedule.intersect(Schedule.recurs(policy.times))));
+};
+const execute = (driver, cmd, dispatch, report) => {
+    const deliver = (output) => {
+        try {
+            const msg = cmd.onSuccess(output);
+            if (msg !== undefined)
+                dispatch(msg);
+        }
+        catch (defect) {
+            console.error('gyral: command mapper threw', defect);
+        }
+    };
+    const attempt = Effect.tryPromise({
+        try: (signal) => {
+            let settled = false;
+            const emit = (output) => {
+                if (!settled && !signal.aborted)
+                    deliver(output);
+            };
+            // The input type was erased by command(); it was built for this driver's name.
+            const result = Promise.resolve(driver.run(cmd.input, { signal, emit }));
+            return result.finally(() => {
+                settled = true;
+            });
+        },
+        catch: (cause) => new DriverFailure({ cause }),
+    });
+    const traced = DEVTOOLS_ENABLED && report !== undefined
+        ? withRetry(attempt, driver.retry).pipe(Effect.onInterrupt(() => Effect.sync(() => {
+            report('interrupted');
+        })))
+        : withRetry(attempt, driver.retry);
+    return traced.pipe(Effect.matchEffect({
+        onSuccess: (output) => {
+            if (DEVTOOLS_ENABLED)
+                report?.('settled', output);
+            return Effect.succeed(cmd.onSuccess(output));
+        },
+        onFailure: (failure) => {
+            const error = driver.toError === undefined ? failure.cause : driver.toError(failure.cause);
+            if (DEVTOOLS_ENABLED)
+                report?.('failed', error);
+            return cmd.onFailure === undefined
+                ? Effect.logWarning(`gyral: unhandled failure from driver "${driver.name}"`, error).pipe(Effect.as(undefined))
+                : Effect.succeed(cmd.onFailure(error));
+        },
+    }), Effect.flatMap((msg) => Effect.sync(() => {
+        if (msg !== undefined)
+            dispatch(msg);
+    })), Effect.catchAllDefect((defect) => Effect.logError('gyral: command mapper threw', defect)));
+};
+export function makeInterpreter(resolve, dispatch, trace) {
+    const reporter = (driver, lane, policy, input) => trace === undefined
+        ? undefined
+        : (phase, result) => {
+            trace({
+                phase,
+                driver,
+                lane,
+                policy,
+                input,
+                ...(result === undefined ? {} : { result }),
+            });
+        };
+    const lanes = new Map();
+    const all = new Set();
+    let active = true;
+    const guardedDispatch = (msg) => {
+        if (active)
+            dispatch(msg);
+    };
+    const track = (lane, fiber) => {
+        if (!isRunning(fiber))
+            return;
+        lanes.set(lane, fiber);
+        all.add(fiber);
+        fiber.addObserver(() => {
+            all.delete(fiber);
+            if (lanes.get(lane) === fiber)
+                lanes.delete(lane);
+        });
+    };
+    const run = (cmd) => {
+        if (!active)
+            return;
+        const driver = resolve(cmd.driver);
+        const lane = cmd.key ?? driver.name;
+        const policy = cmd.concurrency ?? driver.concurrency ?? 'merge';
+        const previous = lanes.get(lane);
+        const inFlight = isRunning(previous) ? previous : undefined;
+        const report = DEVTOOLS_ENABLED ? reporter(driver.name, lane, policy, cmd.input) : undefined;
+        let program = execute(driver, cmd, guardedDispatch, report);
+        if (inFlight !== undefined && policy === 'exhaust') {
+            if (DEVTOOLS_ENABLED)
+                report?.('dropped');
+            return;
+        }
+        if (DEVTOOLS_ENABLED)
+            report?.('issued');
+        if (inFlight !== undefined) {
+            if (policy === 'switch')
+                program = Effect.zipRight(Fiber.interrupt(inFlight), program);
+            if (policy === 'queue')
+                program = Effect.zipRight(Fiber.await(inFlight), program);
+        }
+        track(lane, fork(program));
+    };
+    const dispose = () => {
+        active = false;
+        fork(Fiber.interruptAll([...all]));
+        all.clear();
+        lanes.clear();
+    };
+    return { run, dispose };
+}
+//# sourceMappingURL=interpreter.js.map

package/dist/internal/interpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpreter.js","sourceRoot":"","sources":["../../src/internal/interpreter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEpC,MAAM,aAAc,SAAQ,IAAI,CAAC,WAAW,CAAC,eAAe,CAA8B;CAAG;AAU7F,MAAM,SAAS,GAAG,CAAC,KAA0B,EAAoB,EAAE,CACjE,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC;AAErD,MAAM,SAAS,GAAG,CAChB,OAAwC,EACxC,MAA+B,EACE,EAAE;IACnC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAClD,MAAM,MAAM,GACV,MAAM,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxF,OAAO,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/F,CAAC,CAAC;AAKF,MAAM,OAAO,GAAG,CACd,MAAiB,EACjB,GAAe,EACf,QAA0B,EAC1B,MAAc,EACO,EAAE;IACvB,MAAM,OAAO,GAAG,CAAC,MAAe,EAAQ,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,GAAG,KAAK,SAAS;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC;QAChC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE;YACd,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,IAAI,GAAG,CAAC,MAAe,EAAQ,EAAE;gBACrC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO;oBAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACnD,CAAC,CAAC;YACF,+EAA+E;YAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,KAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YACjF,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;gBACzB,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC;KAC/C,CAAC,CAAC;IACH,MAAM,MAAM,GACV,gBAAgB,IAAI,MAAM,KAAK,SAAS;QACtC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CACnC,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,CACtB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YACf,MAAM,CAAC,aAAa,CAAC,CAAC;QACxB,CAAC,CAAC,CACH,CACF;QACH,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,IAAI,CAChB,MAAM,CAAC,WAAW,CAAC;QACjB,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YACpB,IAAI,gBAAgB;gBAAE,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAClD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACrB,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC3F,IAAI,gBAAgB;gBAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAChD,OAAO,GAAG,CAAC,SAAS,KAAK,SAAS;gBAChC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,yCAAyC,MAAM,CAAC,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC,IAAI,CACpF,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CACrB;gBACH,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC,EACF,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CACrB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,IAAI,GAAG,KAAK,SAAS;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC,CAAC,CACH,EACD,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC,CAC1F,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,UAAU,eAAe,CAC7B,OAAyC,EACzC,QAA0B,EAC1B,KAAoB;IAEpB,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,IAAY,EAAE,MAAmB,EAAE,KAAc,EAAU,EAAE,CAC7F,KAAK,KAAK,SAAS;QACjB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAChB,KAAK,CAAC;gBACJ,KAAK;gBACL,MAAM;gBACN,IAAI;gBACJ,MAAM;gBACN,KAAK;gBACL,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;aAC5C,CAAC,CAAC;QACL,CAAC,CAAC;IACR,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAW,CAAC;IAC/B,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,MAAM,eAAe,GAAG,CAAC,GAAM,EAAQ,EAAE;QACvC,IAAI,MAAM;YAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,KAAc,EAAQ,EAAE;QACnD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO;QAC9B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACf,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;YACrB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAClB,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK;gBAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,GAAG,GAAG,CAAC,GAAe,EAAQ,EAAE;QACpC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;QACpC,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC;QAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7F,IAAI,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;QAC5D,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACnD,IAAI,gBAAgB;gBAAE,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1C,OAAO;QACT,CAAC;QACD,IAAI,gBAAgB;YAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,MAAM,KAAK,QAAQ;gBAAE,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;YACvF,IAAI,MAAM,KAAK,OAAO;gBAAE,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QACpF,CAAC;QACD,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC7B,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,MAAM,GAAG,KAAK,CAAC;QACf,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACnC,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAC1B,CAAC","sourcesContent":["import { Data, Duration, Effect, Fiber, Schedule } from 'effect';\nimport { DEVTOOLS_ENABLED } from '#devtools';\nimport type { AnyDriver, Command, Concurrency, RetryPolicy } from '../command.js';\nimport type { CommandPhase, CommandTrace } from '../devtools-events.js';\nimport { fork } from './runtime.js';\n\nclass DriverFailure extends Data.TaggedError('DriverFailure')<{ readonly cause: unknown }> {}\n\ntype Running = Fiber.RuntimeFiber<void>;\n\n/** Runs commands for one connected element. Disposed on disconnect. */\nexport interface Interpreter<M> {\n  readonly run: (cmd: Command<M>) => void;\n  readonly dispose: () => void;\n}\n\nconst isRunning = (fiber: Running | undefined): fiber is Running =>\n  fiber !== undefined && fiber.unsafePoll() === null;\n\nconst withRetry = <A>(\n  attempt: Effect.Effect<A, DriverFailure>,\n  policy: RetryPolicy | undefined,\n): Effect.Effect<A, DriverFailure> => {\n  if (policy === undefined || policy.times <= 0) return attempt;\n  const base = Duration.millis(policy.delayMs ?? 0);\n  const delays: Schedule.Schedule<unknown> =\n    policy.backoff === 'exponential' ? Schedule.exponential(base) : Schedule.spaced(base);\n  return Effect.retry(attempt, delays.pipe(Schedule.intersect(Schedule.recurs(policy.times))));\n};\n\n/** Reports one command's lifecycle to devtools (ADR 0017); undefined in production. */\ntype Report = ((phase: CommandPhase, result?: unknown) => void) | undefined;\n\nconst execute = <M>(\n  driver: AnyDriver,\n  cmd: Command<M>,\n  dispatch: (msg: M) => void,\n  report: Report,\n): Effect.Effect<void> => {\n  const deliver = (output: unknown): void => {\n    try {\n      const msg = cmd.onSuccess(output);\n      if (msg !== undefined) dispatch(msg);\n    } catch (defect) {\n      console.error('gyral: command mapper threw', defect);\n    }\n  };\n  const attempt = Effect.tryPromise({\n    try: (signal) => {\n      let settled = false;\n      const emit = (output: unknown): void => {\n        if (!settled && !signal.aborted) deliver(output);\n      };\n      // The input type was erased by command(); it was built for this driver's name.\n      const result = Promise.resolve(driver.run(cmd.input as never, { signal, emit }));\n      return result.finally(() => {\n        settled = true;\n      });\n    },\n    catch: (cause) => new DriverFailure({ cause }),\n  });\n  const traced =\n    DEVTOOLS_ENABLED && report !== undefined\n      ? withRetry(attempt, driver.retry).pipe(\n          Effect.onInterrupt(() =>\n            Effect.sync(() => {\n              report('interrupted');\n            }),\n          ),\n        )\n      : withRetry(attempt, driver.retry);\n  return traced.pipe(\n    Effect.matchEffect({\n      onSuccess: (output) => {\n        if (DEVTOOLS_ENABLED) report?.('settled', output);\n        return Effect.succeed(cmd.onSuccess(output));\n      },\n      onFailure: (failure) => {\n        const error = driver.toError === undefined ? failure.cause : driver.toError(failure.cause);\n        if (DEVTOOLS_ENABLED) report?.('failed', error);\n        return cmd.onFailure === undefined\n          ? Effect.logWarning(`gyral: unhandled failure from driver \"${driver.name}\"`, error).pipe(\n              Effect.as(undefined),\n            )\n          : Effect.succeed(cmd.onFailure(error));\n      },\n    }),\n    Effect.flatMap((msg) =>\n      Effect.sync(() => {\n        if (msg !== undefined) dispatch(msg);\n      }),\n    ),\n    Effect.catchAllDefect((defect) => Effect.logError('gyral: command mapper threw', defect)),\n  );\n};\n\nexport function makeInterpreter<M>(\n  resolve: (driver: AnyDriver) => AnyDriver,\n  dispatch: (msg: M) => void,\n  trace?: CommandTrace,\n): Interpreter<M> {\n  const reporter = (driver: string, lane: string, policy: Concurrency, input: unknown): Report =>\n    trace === undefined\n      ? undefined\n      : (phase, result) => {\n          trace({\n            phase,\n            driver,\n            lane,\n            policy,\n            input,\n            ...(result === undefined ? {} : { result }),\n          });\n        };\n  const lanes = new Map<string, Running>();\n  const all = new Set<Running>();\n  let active = true;\n  const guardedDispatch = (msg: M): void => {\n    if (active) dispatch(msg);\n  };\n\n  const track = (lane: string, fiber: Running): void => {\n    if (!isRunning(fiber)) return;\n    lanes.set(lane, fiber);\n    all.add(fiber);\n    fiber.addObserver(() => {\n      all.delete(fiber);\n      if (lanes.get(lane) === fiber) lanes.delete(lane);\n    });\n  };\n\n  const run = (cmd: Command<M>): void => {\n    if (!active) return;\n    const driver = resolve(cmd.driver);\n    const lane = cmd.key ?? driver.name;\n    const policy = cmd.concurrency ?? driver.concurrency ?? 'merge';\n    const previous = lanes.get(lane);\n    const inFlight = isRunning(previous) ? previous : undefined;\n    const report = DEVTOOLS_ENABLED ? reporter(driver.name, lane, policy, cmd.input) : undefined;\n    let program = execute(driver, cmd, guardedDispatch, report);\n    if (inFlight !== undefined && policy === 'exhaust') {\n      if (DEVTOOLS_ENABLED) report?.('dropped');\n      return;\n    }\n    if (DEVTOOLS_ENABLED) report?.('issued');\n    if (inFlight !== undefined) {\n      if (policy === 'switch') program = Effect.zipRight(Fiber.interrupt(inFlight), program);\n      if (policy === 'queue') program = Effect.zipRight(Fiber.await(inFlight), program);\n    }\n    track(lane, fork(program));\n  };\n\n  const dispose = (): void => {\n    active = false;\n    fork(Fiber.interruptAll([...all]));\n    all.clear();\n    lanes.clear();\n  };\n\n  return { run, dispose };\n}\n"]}

package/dist/internal/runtime.d.ts

@@ -0,0 +1,7 @@
+import { Effect, type Fiber } from 'effect';
+/**
+ * The single place Gyral starts Effect programs (ADR 0006). There are no services to
+ * provide yet, so the default runtime is enough; a ManagedRuntime with layers goes here
+ * when drivers need shared resources.
+ */
+export declare const fork: <A>(program: Effect.Effect<A>) => Fiber.RuntimeFiber<A>;

package/dist/internal/runtime.js

@@ -0,0 +1,8 @@
+import { Effect } from 'effect';
+/**
+ * The single place Gyral starts Effect programs (ADR 0006). There are no services to
+ * provide yet, so the default runtime is enough; a ManagedRuntime with layers goes here
+ * when drivers need shared resources.
+ */
+export const fork = (program) => Effect.runFork(program);
+//# sourceMappingURL=runtime.js.map

package/dist/internal/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/internal/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAc,MAAM,QAAQ,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAI,OAAyB,EAAyB,EAAE,CAC1E,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC","sourcesContent":["import { Effect, type Fiber } from 'effect';\n\n/**\n * The single place Gyral starts Effect programs (ADR 0006). There are no services to\n * provide yet, so the default runtime is enough; a ManagedRuntime with layers goes here\n * when drivers need shared resources.\n */\nexport const fork = <A>(program: Effect.Effect<A>): Fiber.RuntimeFiber<A> =>\n  Effect.runFork(program);\n"]}

package/dist/invalid.d.ts

@@ -0,0 +1,21 @@
+import { ElementDirective } from './element-directive.js';
+type Errors = readonly string[] | string | undefined;
+/**
+ * Mirrors model errors to native validity (ADR 0008): sets `setCustomValidity` and
+ * `aria-invalid`, so `:user-invalid` and native bubbles agree with the model.
+ *
+ * The custom error clears when:
+ * - the control fires `input` or `change` (the user edited it);
+ * - the bound errors become `undefined` or empty (the model cleared them);
+ * - a submit finds the error stale: the value changed without an event (set from code, e.g.
+ *   by a test or a script). Then the error is dropped and the form is submitted again once.
+ *
+ * An error is applied again only when a new value arrives (keep `fieldErrors()` results in
+ * state). Element parts don't render on the server, so this only runs in the browser.
+ */
+declare class InvalidDirective extends ElementDirective<[errors?: Errors]> {
+    #private;
+    apply(el: Element, [errors]: [errors?: Errors]): void;
+}
+export declare const invalid: (errors?: Errors) => import("lit/directive.js").DirectiveResult<typeof InvalidDirective>;
+export {};

package/dist/invalid.js

@@ -0,0 +1,70 @@
+import { directive } from 'lit/directive.js';
+import { ElementDirective } from './element-directive.js';
+const isValidatable = (el) => 'setCustomValidity' in el;
+const valueOf = (el) => ('value' in el ? el.value : undefined);
+const formOf = (el) => {
+    const form = 'form' in el ? el.form : undefined;
+    return form instanceof HTMLFormElement ? form : undefined;
+};
+// Forms with a resubmit already queued: several stale fields in one validation pass resubmit once.
+const resubmitting = new WeakSet();
+/**
+ * Mirrors model errors to native validity (ADR 0008): sets `setCustomValidity` and
+ * `aria-invalid`, so `:user-invalid` and native bubbles agree with the model.
+ *
+ * The custom error clears when:
+ * - the control fires `input` or `change` (the user edited it);
+ * - the bound errors become `undefined` or empty (the model cleared them);
+ * - a submit finds the error stale: the value changed without an event (set from code, e.g.
+ *   by a test or a script). Then the error is dropped and the form is submitted again once.
+ *
+ * An error is applied again only when a new value arrives (keep `fieldErrors()` results in
+ * state). Element parts don't render on the server, so this only runs in the browser.
+ */
+class InvalidDirective extends ElementDirective {
+    #last;
+    #listening;
+    apply(el, [errors]) {
+        if (errors === this.#last)
+            return;
+        this.#last = errors;
+        this.#listening?.abort();
+        this.#listening = undefined;
+        const message = typeof errors === 'string' ? errors : (errors ?? []).join(' ');
+        if (isValidatable(el))
+            el.setCustomValidity(message);
+        if (message === '') {
+            el.removeAttribute('aria-invalid');
+            return;
+        }
+        el.setAttribute('aria-invalid', 'true');
+        const listening = new AbortController();
+        this.#listening = listening;
+        const { signal } = listening;
+        const rejectedValue = valueOf(el);
+        const clear = () => {
+            listening.abort();
+            if (isValidatable(el))
+                el.setCustomValidity('');
+            el.removeAttribute('aria-invalid');
+        };
+        el.addEventListener('input', clear, { signal });
+        el.addEventListener('change', clear, { signal });
+        el.addEventListener('invalid', (event) => {
+            if (Object.is(valueOf(el), rejectedValue))
+                return; // still the rejected value
+            event.preventDefault(); // no bubble for an error that no longer applies
+            clear();
+            const form = formOf(el);
+            if (form === undefined || resubmitting.has(form))
+                return;
+            resubmitting.add(form);
+            queueMicrotask(() => {
+                resubmitting.delete(form);
+                form.requestSubmit();
+            });
+        }, { signal });
+    }
+}
+export const invalid = directive(InvalidDirective);
+//# sourceMappingURL=invalid.js.map

package/dist/invalid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid.js","sourceRoot":"","sources":["../src/invalid.ts"],"names":[],"mappings":"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","sourcesContent":["import { directive } from 'lit/directive.js';\nimport { ElementDirective } from './element-directive.js';\n\ntype Errors = readonly string[] | string | undefined;\n\ninterface Validatable extends Element {\n  setCustomValidity(message: string): void;\n}\n\nconst isValidatable = (el: Element): el is Validatable => 'setCustomValidity' in el;\n\nconst valueOf = (el: Element): unknown => ('value' in el ? el.value : undefined);\n\nconst formOf = (el: Element): HTMLFormElement | undefined => {\n  const form = 'form' in el ? el.form : undefined;\n  return form instanceof HTMLFormElement ? form : undefined;\n};\n\n// Forms with a resubmit already queued: several stale fields in one validation pass resubmit once.\nconst resubmitting = new WeakSet<HTMLFormElement>();\n\n/**\n * Mirrors model errors to native validity (ADR 0008): sets `setCustomValidity` and\n * `aria-invalid`, so `:user-invalid` and native bubbles agree with the model.\n *\n * The custom error clears when:\n * - the control fires `input` or `change` (the user edited it);\n * - the bound errors become `undefined` or empty (the model cleared them);\n * - a submit finds the error stale: the value changed without an event (set from code, e.g.\n *   by a test or a script). Then the error is dropped and the form is submitted again once.\n *\n * An error is applied again only when a new value arrives (keep `fieldErrors()` results in\n * state). Element parts don't render on the server, so this only runs in the browser.\n */\nclass InvalidDirective extends ElementDirective<[errors?: Errors]> {\n  #last: Errors;\n  #listening: AbortController | undefined;\n\n  apply(el: Element, [errors]: [errors?: Errors]): void {\n    if (errors === this.#last) return;\n    this.#last = errors;\n    this.#listening?.abort();\n    this.#listening = undefined;\n    const message = typeof errors === 'string' ? errors : (errors ?? []).join(' ');\n    if (isValidatable(el)) el.setCustomValidity(message);\n    if (message === '') {\n      el.removeAttribute('aria-invalid');\n      return;\n    }\n    el.setAttribute('aria-invalid', 'true');\n\n    const listening = new AbortController();\n    this.#listening = listening;\n    const { signal } = listening;\n    const rejectedValue = valueOf(el);\n    const clear = (): void => {\n      listening.abort();\n      if (isValidatable(el)) el.setCustomValidity('');\n      el.removeAttribute('aria-invalid');\n    };\n    el.addEventListener('input', clear, { signal });\n    el.addEventListener('change', clear, { signal });\n    el.addEventListener(\n      'invalid',\n      (event) => {\n        if (Object.is(valueOf(el), rejectedValue)) return; // still the rejected value\n        event.preventDefault(); // no bubble for an error that no longer applies\n        clear();\n        const form = formOf(el);\n        if (form === undefined || resubmitting.has(form)) return;\n        resubmitting.add(form);\n        queueMicrotask(() => {\n          resubmitting.delete(form);\n          form.requestSubmit();\n        });\n      },\n      { signal },\n    );\n  }\n}\n\nexport const invalid = directive(InvalidDirective);\n"]}

package/dist/invokers.d.ts

@@ -0,0 +1,15 @@
+export interface CommandInfo {
+    /** The command, e.g. `--clear`. */
+    readonly command: string;
+    /** The invoker (the button) that sent it. */
+    readonly source: Element | undefined;
+}
+/** Native invoker commands available? */
+export declare const invokersSupported: () => boolean;
+/** The command carried by a native `CommandEvent` or by Gyral's fallback event. */
+export declare function commandOf(event: Event): CommandInfo | undefined;
+/**
+ * Fallback for browsers without invoker commands: a click on a `command="--…"` invoker inside
+ * `root` dispatches a `command` CustomEvent on its `commandfor` target (same tree scope).
+ */
+export declare function shimInvokers(root: Node): void;