@gyral/core 0.1.0 → 0.3.0

package/dist/index.js

@@ -4,32 +4,25 @@ export { focus } from './focus.js';
 export { invokersSupported } from './invokers.js';
 export { ISLAND_ATTRIBUTE } from './islands.js';
 export { define } from './define.js';
+export { intents } from './intent.js';
+export { settled } from './settled.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';
+export { invalid } from './hooks/invalid.js';
+export { findInScope, labelledBy } from './hooks/labelled-by.js';
+export { prop } from './prop.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';
+// Used by the server renderer and @gyral/ssr (ADR 0014, view/06-server.md).
+export { isLightComponent, LIGHT_ATTRIBUTE } from './light-dom.js';
+// The view layer (ADR 0018, docs/design-docs/view/): templates, lists, hooks and styles.
+export { css, defineHook, each, html, HydrationMismatch, nothing, raw } from './view/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"]}
+{"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,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,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,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,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,wEAAwE;AACxE,OAAO,EACL,gBAAgB,IAAI,eAAe,EACnC,iBAAiB,IAAI,sBAAsB,GAC5C,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQvD,4EAA4E;AAC5E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAqBnE,yFAAyF;AACzF,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,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 { intents } from './intent.js';\nexport { settled } from './settled.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 { 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 { runInit } from './init.js';\nexport { invalid } from './hooks/invalid.js';\nexport { findInScope, labelledBy } from './hooks/labelled-by.js';\nexport { prop } from './prop.js';\nexport type { Prop, PropKind, PropsOf } from './prop.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';\n// Used by the server renderer and @gyral/ssr (ADR 0014, view/06-server.md).\nexport { 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 (ADR 0018, docs/design-docs/view/): templates, lists, hooks and styles.\nexport { css, defineHook, each, html, HydrationMismatch, nothing, raw } from './view/index.js';\nexport type {\n  ChildValue,\n  CssValue,\n  HookAttributes,\n  HookResult,\n  HookSpec,\n  ListResult,\n  RawResult,\n  StyleSource,\n  Styles,\n  TemplateResult,\n} from './view/index.js';\n"]}

package/dist/intent.d.ts

@@ -1,16 +1,26 @@
-import type { IntentInput, IntentParser, Tagged } from './types.js';
+import type { IntentInput, IntentNames, IntentParser, Tagged } from './types.js';
+import type { Markup } from './view/index.js';
 /** Event a child component dispatches on its host to send an output up (ADR 0010). */
 export declare const OUTPUT_EVENT = "gyral-output";
+/** Default triggers (`defaultTrigger`): every component root listens for these. */
+export declare const DEFAULT_EVENTS: readonly string[];
 /**
- * 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`.
+ * The events `data-intent-on` usually names. A component root listens (capture phase, so
+ * non-bubbling events such as `toggle` are seen too) for the defaults, for `spec.events`, and
+ * for the `data-intent-on` values in the templates it renders; a template that binds
+ * `data-intent-on` dynamically adds all of these (view/05-element.md "Intent events").
  */
-export declare const INTENT_EVENTS: readonly ["click", "submit", "input", "change", "keydown", "keyup", "focusin", "focusout", "toggle", "command", "gyral-output"];
+export declare const INTENT_EVENTS: readonly string[];
+/** The intent events a template's (or `raw()` markup's) `data-intent-on` attributes name. */
+export declare function eventsOf(markup: Markup): readonly string[];
 /** 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;
+/**
+ * The number of Gyral host ancestors of `el` in the composed tree (across shadow roots): the
+ * scheduler renders smaller depths first (view/04-scheduler.md "Marking").
+ */
+export declare function hostDepth(el: Element): number;
 /**
  * Finds the nearest `data-intent` element for this event that belongs to `root`. Elements
  * inside nested components are ignored: that is component isolation.
@@ -19,7 +29,20 @@ export declare function findIntentElement(event: Event, root: Node): Element | u
 /** 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;
+/**
+ * A component's intent names as a module-level constant, so pure list rows can name intents
+ * without passing them through `pick` (view/03-lists.md "Rows must be pure"). The same object
+ * the view gets as `i`:
+ *
+ *   const i = intents<Msg>();
+ *   const Row = (t: Todo) => html`<input value=${t.id} data-intent=${i.Toggle} />`;
+ */
+export declare function intents<M extends Tagged>(): IntentNames<M>;
+/**
+ * Adds capture listeners for `types` to a component root, skipping those in `listening`. A
+ * root that listens for `command` in a browser without invoker commands loads the fallback
+ * (invokers-shim.ts, ADR 0003 tier 3); settled() waits for it.
+ */
+export declare function listenForIntents(root: Node, listening: Set<string>, types: 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

@@ -1,25 +1,44 @@
-import { commandOf, shimInvokers } from './invokers.js';
+import { commandOf, invokersSupported } from './invokers.js';
+import { hold } from './scheduler.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 = [
+/** Default triggers (`defaultTrigger`): every component root listens for these. */
+export const DEFAULT_EVENTS = [
     'click',
     'submit',
     'input',
     'change',
+    OUTPUT_EVENT,
+];
+/**
+ * The events `data-intent-on` usually names. A component root listens (capture phase, so
+ * non-bubbling events such as `toggle` are seen too) for the defaults, for `spec.events`, and
+ * for the `data-intent-on` values in the templates it renders; a template that binds
+ * `data-intent-on` dynamically adds all of these (view/05-element.md "Intent events").
+ */
+export const INTENT_EVENTS = [
+    ...DEFAULT_EVENTS,
     'keydown',
     'keyup',
     'focusin',
     'focusout',
     'toggle',
     'command',
-    OUTPUT_EVENT,
 ];
+/** A static `data-intent-on` value, quoted or not (event names have no spaces or quotes). */
+const INTENT_ON = /\sdata-intent-on=["']?([^"'\s>]+)/gi;
+const eventsByTemplate = new WeakMap();
+/** The intent events a template's (or `raw()` markup's) `data-intent-on` attributes name. */
+export function eventsOf(markup) {
+    let events = eventsByTemplate.get(markup);
+    if (events === undefined) {
+        events = markup.parts?.some((p) => p[2] === 'data-intent-on') // a bound attribute's name
+            ? INTENT_EVENTS
+            : Array.from(markup.html.matchAll(INTENT_ON), (m) => m[1] ?? '');
+        eventsByTemplate.set(markup, events);
+    }
+    return events;
+}
 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) {
@@ -27,24 +46,25 @@ function toggleState(event) {
         return undefined;
     return event.newState === 'open' ? 'open' : 'closed';
 }
-const CLICK_INPUT_TYPES = new Set(['button', 'submit', 'reset', 'image']);
+const CLICK_INPUT_TYPES = /^(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';
+    switch (el.localName) {
+        case 'form':
+            return 'submit';
+        case 'select':
+            return 'change';
+        case 'textarea':
+            return 'input';
+        case 'input': {
+            const type = el.type;
+            if (CLICK_INPUT_TYPES.test(type))
+                return 'click';
+            return type === 'checkbox' || 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';
+    return el.localName.includes('-') ? OUTPUT_EVENT : 'click';
 }
 function triggerOf(el) {
     return el.getAttribute('data-intent-on') ?? defaultTrigger(el);
@@ -55,6 +75,19 @@ export function markGyralHost(ctor) {
     hostClasses.add(ctor);
 }
 const isGyralHost = (node) => hostClasses.has(node.constructor);
+/**
+ * The number of Gyral host ancestors of `el` in the composed tree (across shadow roots): the
+ * scheduler renders smaller depths first (view/04-scheduler.md "Marking").
+ */
+export function hostDepth(el) {
+    let depth = 0;
+    for (let node = el.parentNode; node !== null;) {
+        if (isGyralHost(node))
+            depth += 1;
+        node = node instanceof ShadowRoot ? node.host : node.parentNode;
+    }
+    return depth;
+}
 /**
  * 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
@@ -127,12 +160,34 @@ export function readIntent(event, root) {
 // 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])) {
+/**
+ * A component's intent names as a module-level constant, so pure list rows can name intents
+ * without passing them through `pick` (view/03-lists.md "Rows must be pure"). The same object
+ * the view gets as `i`:
+ *
+ *   const i = intents<Msg>();
+ *   const Row = (t: Todo) => html`<input value=${t.id} data-intent=${i.Toggle} />`;
+ */
+export function intents() {
+    return intentNames;
+}
+/**
+ * Adds capture listeners for `types` to a component root, skipping those in `listening`. A
+ * root that listens for `command` in a browser without invoker commands loads the fallback
+ * (invokers-shim.ts, ADR 0003 tier 3); settled() waits for it.
+ */
+export function listenForIntents(root, listening, types, handler) {
+    for (const type of types) {
+        if (listening.has(type))
+            continue;
+        listening.add(type);
         root.addEventListener(type, handler, { capture: true });
+        if (type === 'command' && !invokersSupported()) {
+            hold(import('./invokers-shim.js').then((shim) => {
+                shim.shimInvokers(root);
+            }, reportError));
+        }
     }
-    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) {

package/dist/intent.js.map

@@ -1 +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"]}
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../src/intent.ts"],"names":[],"mappings":"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","sourcesContent":["import { commandOf, invokersSupported } from './invokers.js';\nimport { hold } from './scheduler.js';\nimport type { IntentInput, IntentNames, IntentParser, Tagged } from './types.js';\nimport type { Markup } from './view/index.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/** Default triggers (`defaultTrigger`): every component root listens for these. */\nexport const DEFAULT_EVENTS: readonly string[] = [\n  'click',\n  'submit',\n  'input',\n  'change',\n  OUTPUT_EVENT,\n];\n\n/**\n * The events `data-intent-on` usually names. A component root listens (capture phase, so\n * non-bubbling events such as `toggle` are seen too) for the defaults, for `spec.events`, and\n * for the `data-intent-on` values in the templates it renders; a template that binds\n * `data-intent-on` dynamically adds all of these (view/05-element.md \"Intent events\").\n */\nexport const INTENT_EVENTS: readonly string[] = [\n  ...DEFAULT_EVENTS,\n  'keydown',\n  'keyup',\n  'focusin',\n  'focusout',\n  'toggle',\n  'command',\n];\n\n/** A static `data-intent-on` value, quoted or not (event names have no spaces or quotes). */\nconst INTENT_ON = /\\sdata-intent-on=[\"']?([^\"'\\s>]+)/gi;\nconst eventsByTemplate = new WeakMap<Markup, readonly string[]>();\n\n/** The intent events a template's (or `raw()` markup's) `data-intent-on` attributes name. */\nexport function eventsOf(markup: Markup): readonly string[] {\n  let events = eventsByTemplate.get(markup);\n  if (events === undefined) {\n    events = markup.parts?.some((p) => p[2] === 'data-intent-on') // a bound attribute's name\n      ? INTENT_EVENTS\n      : Array.from(markup.html.matchAll(INTENT_ON), (m) => m[1] ?? '');\n    eventsByTemplate.set(markup, events);\n  }\n  return events;\n}\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 = /^(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  switch (el.localName) {\n    case 'form':\n      return 'submit';\n    case 'select':\n      return 'change';\n    case 'textarea':\n      return 'input';\n    case 'input': {\n      const type = (el as HTMLInputElement).type;\n      if (CLICK_INPUT_TYPES.test(type)) return 'click';\n      return type === 'checkbox' || type === 'radio' ? 'change' : 'input';\n    }\n  }\n  // Custom elements (autonomous: the name has a dash) talk to their parent via outputs.\n  return el.localName.includes('-') ? OUTPUT_EVENT : '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 * The number of Gyral host ancestors of `el` in the composed tree (across shadow roots): the\n * scheduler renders smaller depths first (view/04-scheduler.md \"Marking\").\n */\nexport function hostDepth(el: Element): number {\n  let depth = 0;\n  for (let node: Node | null = el.parentNode; node !== null;) {\n    if (isGyralHost(node)) depth += 1;\n    node = node instanceof ShadowRoot ? node.host : node.parentNode;\n  }\n  return depth;\n}\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/**\n * A component's intent names as a module-level constant, so pure list rows can name intents\n * without passing them through `pick` (view/03-lists.md \"Rows must be pure\"). The same object\n * the view gets as `i`:\n *\n *   const i = intents<Msg>();\n *   const Row = (t: Todo) => html`<input value=${t.id} data-intent=${i.Toggle} />`;\n */\nexport function intents<M extends Tagged>(): IntentNames<M> {\n  return intentNames as IntentNames<M>;\n}\n\n/**\n * Adds capture listeners for `types` to a component root, skipping those in `listening`. A\n * root that listens for `command` in a browser without invoker commands loads the fallback\n * (invokers-shim.ts, ADR 0003 tier 3); settled() waits for it.\n */\nexport function listenForIntents(\n  root: Node,\n  listening: Set<string>,\n  types: readonly string[],\n  handler: (event: Event) => void,\n): void {\n  for (const type of types) {\n    if (listening.has(type)) continue;\n    listening.add(type);\n    root.addEventListener(type, handler, { capture: true });\n    if (type === 'command' && !invokersSupported()) {\n      hold(\n        import('./invokers-shim.js').then((shim) => {\n          shim.shimInvokers(root);\n        }, reportError),\n      );\n    }\n  }\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

@@ -1,8 +1,14 @@
-import type { AnyDriver, Command } from '../command.js';
+import type { AnyDriver, Command, DriverOverrides } from '../command.js';
 import type { CommandTrace } from '../devtools-events.js';
+import type { FeatureHost } from '../features.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>;
+/**
+ * A component's interpreter (registered by `command()`, features.ts). Drivers resolve by name:
+ * el.drivers → nearest provider → spec.drivers → the command's own (gyral-czi.35).
+ */
+export declare const hostInterpreter: <M>(el: FeatureHost, drivers: DriverOverrides | undefined, dispatch: (msg: M) => void, trace: CommandTrace | undefined) => Interpreter<M>;

package/dist/internal/interpreter.js

@@ -1,66 +1,99 @@
-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))));
+import { providedDriver } from '../drivers-scope.js';
+/** Rejects when `signal` aborts. Marked handled so a losing race never reports it. */
+const aborted = (signal) => {
+    const promise = new Promise((_resolve, reject) => {
+        // Callers check `signal.aborted`, never the reason.
+        const interrupt = () => {
+            reject(signal.reason);
+        };
+        if (signal.aborted)
+            interrupt();
+        else
+            signal.addEventListener('abort', interrupt, { once: true });
+    });
+    promise.catch(() => undefined);
+    return promise;
 };
-const execute = (driver, cmd, dispatch, report) => {
-    const deliver = (output) => {
+/** Waits `ms`, or rejects as soon as `signal` aborts. */
+const sleep = (ms, signal) => Promise.race([
+    new Promise((resolve) => {
+        const timer = setTimeout(resolve, ms);
+        signal.addEventListener('abort', () => {
+            clearTimeout(timer);
+        }, { once: true });
+    }),
+    aborted(signal),
+]);
+/** Delay before retry number `retry` (0-based): fixed, or doubling from `delayMs`. */
+const delayFor = (policy, retry) => {
+    const base = policy.delayMs ?? 0;
+    return policy.backoff === 'exponential' ? base * 2 ** retry : base;
+};
+async function attemptWithRetry(driver, cmd, signal, emit) {
+    const policy = driver.retry;
+    for (let retry = 0;; retry += 1) {
         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(() => {
+            return await Promise.race([result, aborted(signal)]);
+        }
+        catch (cause) {
+            if (signal.aborted || policy === undefined || retry >= policy.times)
+                throw cause;
+            await sleep(delayFor(policy, retry), signal);
+        }
+    }
+}
+/** Maps a result to a message and dispatches it; a throwing mapper is logged, not fatal. */
+const deliver = (map, dispatch) => {
+    try {
+        const msg = map();
         if (msg !== undefined)
             dispatch(msg);
-    })), Effect.catchAllDefect((defect) => Effect.logError('gyral: command mapper threw', defect)));
+    }
+    catch (defect) {
+        console.error('gyral: command mapper threw', defect);
+    }
 };
+async function execute(driver, cmd, signal, dispatch, report) {
+    let settled = false;
+    const emit = (output) => {
+        if (!settled && !signal.aborted)
+            deliver(() => cmd.onSuccess(output), dispatch);
+    };
+    if (DEVTOOLS_ENABLED && report !== undefined) {
+        signal.addEventListener('abort', () => {
+            if (!settled)
+                report('interrupted');
+        }, { once: true });
+    }
+    let output;
+    try {
+        output = await attemptWithRetry(driver, cmd, signal, emit);
+    }
+    catch (cause) {
+        if (signal.aborted)
+            return; // interrupted: reported by the abort listener
+        settled = true;
+        const error = driver.toError === undefined ? cause : driver.toError(cause);
+        if (DEVTOOLS_ENABLED)
+            report?.('failed', error);
+        if (cmd.onFailure === undefined) {
+            console.warn(`gyral: unhandled failure from driver "${driver.name}"`, error);
+            return;
+        }
+        const onFailure = cmd.onFailure;
+        deliver(() => onFailure(error), dispatch);
+        return;
+    }
+    if (signal.aborted)
+        return;
+    settled = true;
+    if (DEVTOOLS_ENABLED)
+        report?.('settled', output);
+    deliver(() => cmd.onSuccess(output), dispatch);
+}
 export function makeInterpreter(resolve, dispatch, trace) {
     const reporter = (driver, lane, policy, input) => trace === undefined
         ? undefined
@@ -81,16 +114,24 @@ export function makeInterpreter(resolve, dispatch, trace) {
         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)
+    const start = (lane, driver, cmd, report, after) => {
+        const controller = new AbortController();
+        const task = { controller, running: true, done: Promise.resolve() };
+        const body = async () => {
+            if (after !== undefined)
+                await after.done;
+            if (!controller.signal.aborted) {
+                await execute(driver, cmd, controller.signal, guardedDispatch, report);
+            }
+        };
+        task.done = body().finally(() => {
+            task.running = false;
+            all.delete(task);
+            if (lanes.get(lane) === task)
                 lanes.delete(lane);
         });
+        lanes.set(lane, task);
+        all.add(task);
     };
     const run = (cmd) => {
         if (!active)
@@ -99,9 +140,8 @@ export function makeInterpreter(resolve, dispatch, trace) {
         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 inFlight = previous?.running === true ? 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');
@@ -109,20 +149,25 @@ export function makeInterpreter(resolve, dispatch, trace) {
         }
         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));
+        if (inFlight !== undefined && policy === 'switch')
+            inFlight.controller.abort();
+        start(lane, driver, cmd, report, inFlight !== undefined && policy === 'queue' ? inFlight : undefined);
     };
     const dispose = () => {
         active = false;
-        fork(Fiber.interruptAll([...all]));
+        for (const task of all)
+            task.controller.abort();
         all.clear();
         lanes.clear();
     };
     return { run, dispose };
 }
+/**
+ * A component's interpreter (registered by `command()`, features.ts). Drivers resolve by name:
+ * el.drivers → nearest provider → spec.drivers → the command's own (gyral-czi.35).
+ */
+export const hostInterpreter = (el, drivers, dispatch, trace) => makeInterpreter((driver) => el.drivers[driver.name] ??
+    providedDriver(el, driver.name) ??
+    drivers?.[driver.name] ??
+    driver, dispatch, trace);
 //# sourceMappingURL=interpreter.js.map