@gyral/core 0.2.0 → 0.3.1

package/dist/intent.js

@@ -1,53 +1,84 @@
-import { commandOf, shimInvokers } from './invokers.js';
-/** Event a child component dispatches on its host to send an output up (ADR 0010). */
+import { loadInvokerShim } from '#invoker-fallback';
+import { commandOf, invokersSupported } from './invokers.js';
+import { isLightComponent } from './light-dom.js';
+import { message } from './view/index.js';
+/** Event a child component dispatches on its host to send an output up (ADR 0010); public. */
 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 and for the events its
+ * templates name in `data-intent-<event>` attributes and static `data-intent-on` values; a
+ * template that binds `data-intent-on` dynamically adds all of these. Any other event with a
+ * bound intent takes a per-event attribute, `data-intent-pointerdown=${i.Press}`, whose name the
+ * template carries (view/05-element.md "Intent events").
+ */
+export const INTENT_EVENTS = [
+    ...DEFAULT_EVENTS,
     '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';
+/**
+ * A static `data-intent-<event>` attribute: a per-event intent (the event is in the name), or
+ * `data-intent-on` (its value is the event, or a quoted list of them separated by spaces).
+ */
+const INTENT_ATTR = /\sdata-intent-([\w-]+)=(["']?)(.*?)\2(?=[\s/>])/gi;
+// Names separated by any whitespace; none empty, so no listener for "".
+const eventList = (value) => value.match(/\S+/g) ?? [];
+const eventsByTemplate = new WeakMap();
+/**
+ * The intent events a template's (or `raw()` markup's) `data-intent-<event>` and
+ * `data-intent-on` attributes name. A bound attribute's name is in its part; a bound
+ * `data-intent-on` adds every intent event.
+ */
+export function eventsOf(markup) {
+    let events = eventsByTemplate.get(markup);
+    if (events === undefined) {
+        // Bound attributes are in the parts, by name: listed as ` name=* ` and matched like markup
+        // (other parts' names are never intent attributes; `*` marks a bound data-intent-on).
+        const bound = markup.parts?.map((p) => ` ${p[2]}=* `).join('') ?? '';
+        events = Array.from((markup.html + bound).matchAll(INTENT_ATTR)).flatMap(([, event, , value]) => event !== 'on'
+            ? event
+            : value === '*'
+                ? INTENT_EVENTS
+                : eventList(value));
+        eventsByTemplate.set(markup, events);
+    }
+    return events;
 }
-const CLICK_INPUT_TYPES = new Set(['button', 'submit', 'reset', 'image']);
-/** The event that fires an intent unless `data-intent-on` overrides it. */
+const isToggle = (el) => el instanceof HTMLInputElement && (el.type === 'checkbox' || el.type === 'radio');
+const CLICK_INPUT_TYPES = /^(button|submit|reset|image)$/;
+/**
+ * The event that fires an intent unless `data-intent-on` overrides it. Custom elements
+ * (autonomous: the name has a dash) talk to their parent via outputs.
+ */
 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';
+    const name = el.localName;
+    return name === 'form'
+        ? 'submit'
+        : name === 'select' || isToggle(el)
+            ? 'change'
+            : name === 'textarea' ||
+                (name === 'input' && !CLICK_INPUT_TYPES.test(el.type))
+                ? 'input'
+                : name.includes('-')
+                    ? OUTPUT_EVENT
+                    : 'click';
 }
-function triggerOf(el) {
-    return el.getAttribute('data-intent-on') ?? defaultTrigger(el);
+/** The events that fire `el`'s intent: its `data-intent-on` list, or its default trigger. */
+function triggersOf(el) {
+    return eventList(el.getAttribute('data-intent-on') ?? defaultTrigger(el));
 }
 /** Every class `define()` creates, so intent lookup can tell where a component begins. */
 const hostClasses = new WeakSet();
@@ -55,12 +86,27 @@ 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
- * 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.
+ * same tree (not inside a nested shadow root) with no light-DOM Gyral host between them: a
+ * light-DOM component owns its children (it rendered them). Children of a shadow-DOM host are
+ * the outer template's content, slotted into it, so they stay the outer component's (a form or
+ * a child component slotted into a card). 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();
@@ -69,28 +115,11 @@ function ownedBy(node, root) {
     for (let p = node.parentNode; p !== null; p = p.parentNode) {
         if (p === root)
             return true;
-        if (isGyralHost(p))
+        if (isGyralHost(p) && isLightComponent(p.constructor))
             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 ||
@@ -100,58 +129,122 @@ function valueOf(el) {
     }
     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);
+/**
+ * Reads an event into an IntentInput for the nearest element on its path that names an intent
+ * for it and belongs to `root`: its `data-intent-<type>`, else its `data-intent` when the
+ * event is one of its triggers. With `after`, the search starts past that element (the intent
+ * whose parser declined). Elements inside nested components are ignored: that is component
+ * isolation. Form submissions are prevented and turned into FormData.
+ */
+export function readIntent(event, root, after) {
+    const path = event.composedPath();
+    // indexOf(undefined) is -1: without `after`, the whole path.
+    for (const target of path.slice(path.indexOf(after) + 1)) {
+        if (target === root)
+            return undefined;
+        if (!(target instanceof Element))
+            continue;
+        // An output is the dispatching child's own: only the element it was dispatched on (the
+        // child host, where the direct parent's `data-intent` sits) takes it, never an ancestor.
+        if (event.type === OUTPUT_EVENT && target !== path[0])
+            continue;
+        const name = target.getAttribute('data-intent-' + event.type) ??
+            (triggersOf(target).includes(event.type) ? target.getAttribute('data-intent') : null);
+        if (name === null || !ownedBy(target, root))
+            continue;
+        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,
+            // Read structurally too: only keyboard events carry `key` to elements.
+            key: event.key,
+            // ToggleEvent (popover, <details>) is not Baseline widely available: read it structurally.
+            newState: event.newState,
+            command: commandOf(event),
+        };
     }
-    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),
-    };
+    return undefined;
 }
 // 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`, typed by the component's class (ADR 0023). A row that names intents
+ * this way needs an explicit return type, or the row, the view and the class infer each other
+ * in a circle:
+ *
+ *   const i = intentsOf<typeof TodoList>();
+ *   const Row = (t: Todo): TemplateResult => html`<input value=${t.id} data-intent=${i.Toggle} />`;
+ */
+export function intentsOf() {
+    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())
+            loadInvokerShim(root);
     }
-    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);
+/**
+ * Parses one event with its matching parser and delivers the message (sync or async). A
+ * parser that returns `undefined` synchronously declines: the next intent outward for the same
+ * event gets it, up to the component root. A promise can't decline. The model's `ctx()` is
+ * built only when a parser runs, so its props are those at event time.
+ */
+export function handleIntent(event, root, parsers, tag, model, deliver) {
+    for (let input; (input = readIntent(event, root, input?.target));) {
+        const { name } = input;
+        const parser = parsers[name];
+        if (parser === undefined) {
+            console.warn(message(11, tag, name));
+            return;
+        }
+        // A parser that throws or rejects is reported (ADR 0024) and sends nothing.
+        const failed = (cause) => {
+            model.fail(cause, 'parse', message(12, tag, name), name);
+        };
+        let result;
+        try {
+            // `true`: the intent sends its own tag (types allow it only for field-less variants).
+            result =
+                parser === true
+                    ? { _tag: name }
+                    : parser(input, model.ctx());
+        }
+        catch (cause) {
+            failed(cause);
+            return;
+        }
+        // The direct parent took a child's output: it goes no further (no outer component or page
+        // listener sees it, ADR 0010 addendum). A declining parser lets it go on.
+        if (event.type === OUTPUT_EVENT && result !== undefined)
+            event.stopPropagation();
+        if (result instanceof Promise)
+            return void result.then(deliver, failed);
+        if (result !== undefined) {
+            deliver(result);
+            return;
+        }
     }
 }
 //# sourceMappingURL=intent.js.map

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":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,OAAO,EAAe,MAAM,iBAAiB,CAAC;AAEvD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C,OAAO;IACP,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,YAAY;CACb,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,GAAG,cAAc;IACjB,SAAS;IACT,OAAO;IACP,SAAS;IACT,UAAU;IACV,QAAQ;IACR,SAAS;CACV,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,GAAG,mDAAmD,CAAC;AACxE,wEAAwE;AACxE,MAAM,SAAS,GAAG,CAAC,KAAa,EAAY,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AACzE,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAA6B,CAAC;AAElE;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,IAAI,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,2FAA2F;QAC3F,sFAAsF;QACtF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAW,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC/E,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CACtE,CAAC,CAAC,EAAE,KAAK,EAAE,AAAD,EAAG,KAAK,CAAC,EAAE,EAAE,CACrB,KAAK,KAAK,IAAI;YACZ,CAAC,CAAE,KAAgB;YACnB,CAAC,CAAC,KAAK,KAAK,GAAG;gBACb,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,SAAS,CAAC,KAAe,CAAC,CACnC,CAAC;QACF,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,EAAW,EAA0B,EAAE,CACvD,EAAE,YAAY,gBAAgB,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,UAAU,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;AAEpF,MAAM,iBAAiB,GAAG,+BAA+B,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAW;IACxC,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC;IAC1B,OAAO,IAAI,KAAK,MAAM;QACpB,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC;YACjC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,IAAI,KAAK,UAAU;gBACjB,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAE,EAAuB,CAAC,IAAI,CAAC,CAAC;gBAC9E,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAClB,CAAC,CAAC,YAAY;oBACd,CAAC,CAAC,OAAO,CAAC;AACpB,CAAC;AAED,6FAA6F;AAC7F,SAAS,UAAU,CAAC,EAAW;IAC7B,OAAO,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC,gBAAgB,CAAC,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,0FAA0F;AAC1F,MAAM,WAAW,GAAG,IAAI,OAAO,EAAU,CAAC;AAE1C,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,WAAW,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAW;IACnC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,IAAI,GAAgB,EAAE,CAAC,UAAU,EAAE,IAAI,KAAK,IAAI,GAAG,CAAC;QAC3D,IAAI,WAAW,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QAClC,IAAI,GAAG,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,OAAO,CAAC,IAAa,EAAE,IAAU;IACxC,MAAM,IAAI,GAAG,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACpE,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9C,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC;QAC3D,IAAI,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,EAAW;IAC1B,IACE,EAAE,YAAY,gBAAgB;QAC9B,EAAE,YAAY,iBAAiB;QAC/B,EAAE,YAAY,mBAAmB;QACjC,EAAE,YAAY,iBAAiB,EAC/B,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,CAAC;IAClB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,IAAU,EAAE,KAAe;IAClE,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;IAClC,6DAA6D;IAC7D,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACpE,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACtC,IAAI,CAAC,CAAC,MAAM,YAAY,OAAO,CAAC;YAAE,SAAS;QAC3C,uFAAuF;QACvF,yFAAyF;QACzF,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC;YAAE,SAAS;QAChE,MAAM,IAAI,GACR,MAAM,CAAC,YAAY,CAAC,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC;YAChD,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxF,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC;YAAE,SAAS;QACtD,IAAI,QAA8B,CAAC;QACnC,IAAI,MAAM,YAAY,eAAe,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;YACtE,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACnD,CAAC;QACD,OAAO;YACL,IAAI;YACJ,KAAK;YACL,MAAM;YACN,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC;YACtB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YACtD,QAAQ;YACR,MAAM,EAAE,KAAK,YAAY,WAAW,CAAC,CAAC,CAAE,KAAK,CAAC,MAAkB,CAAC,CAAC,CAAC,SAAS;YAC5E,uEAAuE;YACvE,GAAG,EAAG,KAAmC,CAAC,GAAG;YAC7C,2FAA2F;YAC3F,QAAQ,EAAG,KAAmD,CAAC,QAAQ;YACvE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC;SAC1B,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,kFAAkF;AAClF,yFAAyF;AACzF,MAAM,CAAC,MAAM,WAAW,GAAY,IAAI,KAAK,CAC3C,EAAE,EACF,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CACvE,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS;IAGvB,OAAO,WAAyD,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAU,EACV,SAAsB,EACtB,KAAwB,EACxB,OAA+B;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,iBAAiB,EAAE;YAAE,eAAe,CAAC,IAAI,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAY,EACZ,IAAU,EACV,OAAqE,EACrE,GAAW,EACX,KAGC,EACD,OAA0C;IAE1C,KAAK,IAAI,KAA8B,EAAE,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC;QAC3F,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QACvB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QACD,4EAA4E;QAC5E,MAAM,MAAM,GAAG,CAAC,KAAc,EAAQ,EAAE;YACtC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC,CAAC;QACF,IAAI,MAAwD,CAAC;QAC7D,IAAI,CAAC;YACH,sFAAsF;YACtF,MAAM;gBACJ,MAAM,KAAK,IAAI;oBACb,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;oBAChB,CAAC,CAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,EAAE,CAAsD,CAAC;QACzF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,CAAC;YACd,OAAO;QACT,CAAC;QACD,0FAA0F;QAC1F,0EAA0E;QAC1E,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,eAAe,EAAE,CAAC;QACjF,IAAI,MAAM,YAAY,OAAO;YAAE,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,CAAC;YAChB,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import { loadInvokerShim } from '#invoker-fallback';\nimport { commandOf, invokersSupported } from './invokers.js';\nimport { isLightComponent } from './light-dom.js';\nimport type { IntentInput, IntentNames, IntentParser, ParserCtx, Tagged } from './types.js';\nimport { message, type Markup } from './view/index.js';\n\n/** Event a child component dispatches on its host to send an output up (ADR 0010); public. */\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 and for the events its\n * templates name in `data-intent-<event>` attributes and static `data-intent-on` values; a\n * template that binds `data-intent-on` dynamically adds all of these. Any other event with a\n * bound intent takes a per-event attribute, `data-intent-pointerdown=${i.Press}`, whose name the\n * template carries (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/**\n * A static `data-intent-<event>` attribute: a per-event intent (the event is in the name), or\n * `data-intent-on` (its value is the event, or a quoted list of them separated by spaces).\n */\nconst INTENT_ATTR = /\\sdata-intent-([\\w-]+)=([\"']?)(.*?)\\2(?=[\\s/>])/gi;\n// Names separated by any whitespace; none empty, so no listener for \"\".\nconst eventList = (value: string): string[] => value.match(/\\S+/g) ?? [];\nconst eventsByTemplate = new WeakMap<Markup, readonly string[]>();\n\n/**\n * The intent events a template's (or `raw()` markup's) `data-intent-<event>` and\n * `data-intent-on` attributes name. A bound attribute's name is in its part; a bound\n * `data-intent-on` adds every intent event.\n */\nexport function eventsOf(markup: Markup): readonly string[] {\n  let events = eventsByTemplate.get(markup);\n  if (events === undefined) {\n    // Bound attributes are in the parts, by name: listed as ` name=* ` and matched like markup\n    // (other parts' names are never intent attributes; `*` marks a bound data-intent-on).\n    const bound = markup.parts?.map((p) => ` ${p[2] as string}=* `).join('') ?? '';\n    events = Array.from((markup.html + bound).matchAll(INTENT_ATTR)).flatMap(\n      ([, event, , value]) =>\n        event !== 'on'\n          ? (event as string)\n          : value === '*'\n            ? INTENT_EVENTS\n            : eventList(value as string),\n    );\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\nconst CLICK_INPUT_TYPES = /^(button|submit|reset|image)$/;\n\n/**\n * The event that fires an intent unless `data-intent-on` overrides it. Custom elements\n * (autonomous: the name has a dash) talk to their parent via outputs.\n */\nexport function defaultTrigger(el: Element): string {\n  const name = el.localName;\n  return name === 'form'\n    ? 'submit'\n    : name === 'select' || isToggle(el)\n      ? 'change'\n      : name === 'textarea' ||\n          (name === 'input' && !CLICK_INPUT_TYPES.test((el as HTMLInputElement).type))\n        ? 'input'\n        : name.includes('-')\n          ? OUTPUT_EVENT\n          : 'click';\n}\n\n/** The events that fire `el`'s intent: its `data-intent-on` list, or its default trigger. */\nfunction triggersOf(el: Element): string[] {\n  return eventList(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 light-DOM Gyral host between them: a\n * light-DOM component owns its children (it rendered them). Children of a shadow-DOM host are\n * the outer template's content, slotted into it, so they stay the outer component's (a form or\n * a child component slotted into a card). The nested host element itself (with the parent's\n * `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) && isLightComponent(p.constructor)) return false;\n  }\n  return false;\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/**\n * Reads an event into an IntentInput for the nearest element on its path that names an intent\n * for it and belongs to `root`: its `data-intent-<type>`, else its `data-intent` when the\n * event is one of its triggers. With `after`, the search starts past that element (the intent\n * whose parser declined). Elements inside nested components are ignored: that is component\n * isolation. Form submissions are prevented and turned into FormData.\n */\nexport function readIntent(event: Event, root: Node, after?: Element): IntentInput | undefined {\n  const path = event.composedPath();\n  // indexOf(undefined) is -1: without `after`, the whole path.\n  for (const target of path.slice(path.indexOf(after as Element) + 1)) {\n    if (target === root) return undefined;\n    if (!(target instanceof Element)) continue;\n    // An output is the dispatching child's own: only the element it was dispatched on (the\n    // child host, where the direct parent's `data-intent` sits) takes it, never an ancestor.\n    if (event.type === OUTPUT_EVENT && target !== path[0]) continue;\n    const name =\n      target.getAttribute('data-intent-' + event.type) ??\n      (triggersOf(target).includes(event.type) ? target.getAttribute('data-intent') : null);\n    if (name === null || !ownedBy(target, root)) continue;\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      // Read structurally too: only keyboard events carry `key` to elements.\n      key: (event as { readonly key?: string }).key,\n      // ToggleEvent (popover, <details>) is not Baseline widely available: read it structurally.\n      newState: (event as { readonly newState?: 'open' | 'closed' }).newState,\n      command: commandOf(event),\n    };\n  }\n  return undefined;\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`, typed by the component's class (ADR 0023). A row that names intents\n * this way needs an explicit return type, or the row, the view and the class infer each other\n * in a circle:\n *\n *   const i = intentsOf<typeof TodoList>();\n *   const Row = (t: Todo): TemplateResult => html`<input value=${t.id} data-intent=${i.Toggle} />`;\n */\nexport function intentsOf<C extends { readonly intentNames?: string }>(): IntentNames<\n  NonNullable<C['intentNames']>\n> {\n  return intentNames as IntentNames<NonNullable<C['intentNames']>>;\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()) loadInvokerShim(root);\n  }\n}\n\n/**\n * Parses one event with its matching parser and delivers the message (sync or async). A\n * parser that returns `undefined` synchronously declines: the next intent outward for the same\n * event gets it, up to the component root. A promise can't decline. The model's `ctx()` is\n * built only when a parser runs, so its props are those at event time.\n */\nexport function handleIntent<M>(\n  event: Event,\n  root: Node,\n  parsers: Readonly<Record<string, IntentParser<M> | true | undefined>>,\n  tag: string,\n  model: {\n    ctx(): ParserCtx<unknown>;\n    fail(cause: unknown, phase: 'parse', text: string, msg?: string): unknown;\n  },\n  deliver: (msg: Tagged | undefined) => void,\n): void {\n  for (let input: IntentInput | undefined; (input = readIntent(event, root, input?.target));) {\n    const { name } = input;\n    const parser = parsers[name];\n    if (parser === undefined) {\n      console.warn(message(11, tag, name));\n      return;\n    }\n    // A parser that throws or rejects is reported (ADR 0024) and sends nothing.\n    const failed = (cause: unknown): void => {\n      model.fail(cause, 'parse', message(12, tag, name), name);\n    };\n    let result: Tagged | undefined | Promise<Tagged | undefined>;\n    try {\n      // `true`: the intent sends its own tag (types allow it only for field-less variants).\n      result =\n        parser === true\n          ? { _tag: name }\n          : (parser(input, model.ctx()) as Tagged | undefined | Promise<Tagged | undefined>);\n    } catch (cause) {\n      failed(cause);\n      return;\n    }\n    // The direct parent took a child's output: it goes no further (no outer component or page\n    // listener sees it, ADR 0010 addendum). A declining parser lets it go on.\n    if (event.type === OUTPUT_EVENT && result !== undefined) event.stopPropagation();\n    if (result instanceof Promise) return void result.then(deliver, failed);\n    if (result !== undefined) {\n      deliver(result);\n      return;\n    }\n  }\n}\n"]}

package/dist/internal/indexeddb-open.d.ts

@@ -0,0 +1,8 @@
+import type { IndexedDBError, IndexedDBOptions, IndexedDBStores } from '../indexeddb-types.js';
+export declare class DatabaseFailure extends Error {
+    readonly error: IndexedDBError;
+    constructor(error: IndexedDBError);
+}
+export declare function databaseError(database: string, phase: 'encode' | 'open' | 'upgrade' | 'transaction', cause: unknown): DatabaseFailure;
+/** Native open requests cannot be cancelled: retain handlers to abort/close late results. */
+export declare function openDatabase<S extends IndexedDBStores>(options: IndexedDBOptions<S>, signal: AbortSignal): Promise<IDBDatabase>;

package/dist/internal/indexeddb-open.js

@@ -0,0 +1,96 @@
+export class DatabaseFailure extends Error {
+    constructor(error) {
+        super(error._tag);
+        this.error = error;
+    }
+}
+export function databaseError(database, phase, cause) {
+    return new DatabaseFailure({
+        _tag: 'IndexedDBAccessError',
+        database,
+        phase,
+        name: cause instanceof Error ? cause.name : 'Error',
+        message: cause instanceof Error ? cause.message : String(cause),
+    });
+}
+/** Native open requests cannot be cancelled: retain handlers to abort/close late results. */
+export function openDatabase(options, signal) {
+    return new Promise((resolve, reject) => {
+        signal.throwIfAborted();
+        const factory = options.factory?.() ?? (typeof indexedDB === 'undefined' ? undefined : indexedDB);
+        if (factory === undefined)
+            throw new Error('IndexedDB is unavailable.');
+        signal.throwIfAborted();
+        const request = factory.open(options.database, options.version);
+        const state = { ended: false };
+        const end = (cause) => {
+            if (state.ended)
+                return;
+            state.ended = true;
+            signal.removeEventListener('abort', abort);
+            // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors -- preserve AbortSignal reasons
+            reject(cause);
+        };
+        const abort = () => {
+            end(signal.reason);
+            abortUpgrade();
+        };
+        const abortUpgrade = () => {
+            try {
+                request.transaction?.abort();
+            }
+            catch {
+                /* Native abort may already be pending. */
+            }
+        };
+        const cleanup = () => {
+            request.onblocked = null;
+            request.onupgradeneeded = null;
+            request.onerror = null;
+            request.onsuccess = null;
+            signal.removeEventListener('abort', abort);
+        };
+        signal.addEventListener('abort', abort, { once: true });
+        request.onblocked = () => {
+            end(new DatabaseFailure({
+                _tag: 'IndexedDBBlockedError',
+                database: options.database,
+                version: options.version,
+            }));
+        };
+        request.onupgradeneeded = (event) => {
+            const transaction = request.transaction;
+            if (transaction === null)
+                return;
+            if (state.ended) {
+                abortUpgrade();
+                return;
+            }
+            try {
+                options.upgrade?.(request.result, event.oldVersion, event.newVersion ?? options.version, transaction);
+            }
+            catch (cause) {
+                end(databaseError(options.database, 'upgrade', cause));
+                abortUpgrade();
+            }
+        };
+        request.onerror = () => {
+            end(databaseError(options.database, 'open', request.error));
+            cleanup();
+        };
+        request.onsuccess = () => {
+            const db = request.result;
+            if (state.ended)
+                db.close();
+            else {
+                state.ended = true;
+                db.onversionchange = () => {
+                    db.close();
+                };
+                resolve(db);
+            }
+            cleanup();
+        };
+    });
+}
+//# sourceMappingURL=indexeddb-open.js.map

package/dist/internal/indexeddb-open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-open.js","sourceRoot":"","sources":["../../src/internal/indexeddb-open.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IndexedDBError, IndexedDBOptions, IndexedDBStores } from '../indexeddb-types.js';\n\nexport class DatabaseFailure extends Error {\n  constructor(readonly error: IndexedDBError) {\n    super(error._tag);\n  }\n}\nexport function databaseError(\n  database: string,\n  phase: 'encode' | 'open' | 'upgrade' | 'transaction',\n  cause: unknown,\n): DatabaseFailure {\n  return new DatabaseFailure({\n    _tag: 'IndexedDBAccessError',\n    database,\n    phase,\n    name: cause instanceof Error ? cause.name : 'Error',\n    message: cause instanceof Error ? cause.message : String(cause),\n  });\n}\n\n/** Native open requests cannot be cancelled: retain handlers to abort/close late results. */\nexport function openDatabase<S extends IndexedDBStores>(\n  options: IndexedDBOptions<S>,\n  signal: AbortSignal,\n): Promise<IDBDatabase> {\n  return new Promise((resolve, reject) => {\n    signal.throwIfAborted();\n    const factory =\n      options.factory?.() ?? (typeof indexedDB === 'undefined' ? undefined : indexedDB);\n    if (factory === undefined) throw new Error('IndexedDB is unavailable.');\n    signal.throwIfAborted();\n    const request = factory.open(options.database, options.version);\n    const state = { ended: false };\n    const end = (cause: unknown): void => {\n      if (state.ended) return;\n      state.ended = true;\n      signal.removeEventListener('abort', abort);\n      // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors -- preserve AbortSignal reasons\n      reject(cause);\n    };\n    const abort = (): void => {\n      end(signal.reason);\n      abortUpgrade();\n    };\n    const abortUpgrade = (): void => {\n      try {\n        request.transaction?.abort();\n      } catch {\n        /* Native abort may already be pending. */\n      }\n    };\n    const cleanup = (): void => {\n      request.onblocked = null;\n      request.onupgradeneeded = null;\n      request.onerror = null;\n      request.onsuccess = null;\n      signal.removeEventListener('abort', abort);\n    };\n    signal.addEventListener('abort', abort, { once: true });\n    request.onblocked = () => {\n      end(\n        new DatabaseFailure({\n          _tag: 'IndexedDBBlockedError',\n          database: options.database,\n          version: options.version,\n        }),\n      );\n    };\n    request.onupgradeneeded = (event) => {\n      const transaction = request.transaction;\n      if (transaction === null) return;\n      if (state.ended) {\n        abortUpgrade();\n        return;\n      }\n      try {\n        options.upgrade?.(\n          request.result,\n          event.oldVersion,\n          event.newVersion ?? options.version,\n          transaction,\n        );\n      } catch (cause) {\n        end(databaseError(options.database, 'upgrade', cause));\n        abortUpgrade();\n      }\n    };\n    request.onerror = () => {\n      end(databaseError(options.database, 'open', request.error));\n      cleanup();\n    };\n    request.onsuccess = () => {\n      const db = request.result;\n      if (state.ended) db.close();\n      else {\n        state.ended = true;\n        db.onversionchange = () => {\n          db.close();\n        };\n        resolve(db);\n      }\n      cleanup();\n    };\n  });\n}\n"]}

package/dist/internal/indexeddb-transaction.d.ts

@@ -0,0 +1,4 @@
+import type { IndexedDBOperation, IndexedDBResult, IndexedDBStores } from '../indexeddb-types.js';
+export type RawResult = IndexedDBResult<IndexedDBStores>;
+/** Queue requests synchronously and resolve only from transaction complete. */
+export declare function transact(db: IDBDatabase, operations: readonly IndexedDBOperation<IndexedDBStores>[], signal: AbortSignal): Promise<readonly RawResult[]>;