@gyral/core 0.2.0 → 0.3.1

package/dist/hydration.js.map

@@ -1 +1 @@
-{"version":3,"file":"hydration.js","sourceRoot":"","sources":["../src/hydration.ts"],"names":[],"mappings":"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","sourcesContent":["// Server-render seeds (docs/design-docs/0012-ssr.md). The server writes each element's\n// state, plus the props an attribute can't carry, into one attribute; the client reads it\n// before its first (hydrating) render so both sides render the same template.\nimport type { PropertyDeclaration } from 'lit';\nimport { warnJsonHazard } from './json-safety.js';\n\n/** Host attribute holding the JSON seed. Removed once the client has read it. */\nexport const SEED_ATTRIBUTE = 'data-gyral-seed';\n\nexport interface Seed {\n  /**\n   * The server's state. Omitted when it equals what `init(props)` returns for the seeded\n   * props (gyral-czi 4k7.10): the client recomputes it instead of reading a second copy of\n   * data the props already carry.\n   */\n  readonly state?: unknown;\n  readonly props: Readonly<Record<string, unknown>>;\n}\n\n/** JSON equality: seeds are JSON, so two values that serialize alike hydrate alike. */\nexport const sameJson = (a: unknown, b: unknown): boolean =>\n  JSON.stringify(a) === JSON.stringify(b);\n\ntype Declarations = Readonly<Record<string, PropertyDeclaration>>;\n\nfunction attributeName(name: string, decl: PropertyDeclaration): string | undefined {\n  if (decl.attribute === false) return undefined;\n  return typeof decl.attribute === 'string' ? decl.attribute : name.toLowerCase();\n}\n\n/**\n * Server side: records the element's state and its props that are not already present as\n * attributes (property bindings such as `.items=${data}` are not in the HTML otherwise).\n * The SSR renderer escapes attribute values, so the JSON is HTML-safe.\n */\nexport function writeSeed(\n  host: Element,\n  state: unknown,\n  props: Readonly<Record<string, unknown>>,\n  declarations: Declarations,\n  initialState?: { readonly value: unknown },\n): void {\n  const carried: Record<string, unknown> = {};\n  for (const [name, value] of Object.entries(props)) {\n    const decl = declarations[name] ?? {};\n    const attr = attributeName(name, decl);\n    if (value !== undefined && (attr === undefined || !host.hasAttribute(attr))) {\n      carried[name] = value;\n    }\n  }\n  const derivable = initialState !== undefined && sameJson(state, initialState.value);\n  const seed: Seed = derivable ? { props: carried } : { state, props: carried };\n  warnJsonHazard(`<${host.localName}>`, seed, 'seed');\n  host.setAttribute(SEED_ATTRIBUTE, JSON.stringify(seed));\n}\n\n/**\n * Client side, right after hydration (gyral-4k7.12, ADR 0012): Lit SSR writes nothing for\n * an empty primitive (`''`, `null`, `undefined`), so `<!--lit-part--><!--/lit-part-->`\n * has no Text node between the markers. Hydration still records the primitive as the\n * part's committed value, and the next text commit writes `.data` into the\n * `<!--/lit-part-->` comment instead. Restore the empty Text node a client render would\n * have created. Harmless for `nothing` and empty iterables, which clear or insert before\n * the end marker. Shadow roots below `root` are handled by their own hosts.\n */\nexport function fillEmptyTextParts(root: Node): void {\n  const doc = root.ownerDocument ?? (root as Document);\n  const walker = doc.createTreeWalker(root, NodeFilter.SHOW_COMMENT);\n  const empty: Comment[] = [];\n  for (let node = walker.nextNode(); node !== null; node = walker.nextNode()) {\n    const next = node.nextSibling;\n    if (\n      (node as Comment).data === 'lit-part' &&\n      next instanceof Comment &&\n      next.data === '/lit-part'\n    ) {\n      empty.push(node as Comment);\n    }\n  }\n  for (const start of empty) start.after(doc.createTextNode(''));\n}\n\n/** Client side: reads and removes the seed, if this element was server-rendered by Gyral. */\nexport function takeSeed(host: Element): Seed | undefined {\n  const raw = host.getAttribute(SEED_ATTRIBUTE);\n  if (raw === null) return undefined;\n  host.removeAttribute(SEED_ATTRIBUTE);\n  try {\n    const parsed = JSON.parse(raw) as Partial<Seed> | null;\n    if (parsed === null || typeof parsed !== 'object') return undefined;\n    const props = parsed.props ?? {};\n    return 'state' in parsed ? { state: parsed.state, props } : { props };\n  } catch (error) {\n    console.error(`<${host.localName}> has an unreadable ${SEED_ATTRIBUTE}`, error);\n    return undefined;\n  }\n}\n"]}
+{"version":3,"file":"hydration.js","sourceRoot":"","sources":["../src/hydration.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,0FAA0F;AAC1F,+FAA+F;AAC/F,6FAA6F;AAC7F,2FAA2F;AAC3F,yFAAyF;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAEtC,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAYhD,uFAAuF;AACvF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAE,CAAU,EAAW,EAAE,CAC1D,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,GAAW,EACX,KAAc,EACd,OAAgB,EAChB,OAA0C;IAE1C,MAAM,IAAI,GAAS,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC7F,IAAI,GAAG;QAAE,cAAc,CAAC,IAAI,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,wCAAwC;IAE3F,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["// Server-render seeds (docs/design-docs/0012-ssr.md, view/06-server.md \"Components\"). The\n// server writes each component's state, plus the props an attribute can't carry, into one\n// attribute; the client reads it on connect, before its first render, so both sides start from\n// the same state. The client reads seeds in hydration-loader.ts (core's `#hydration-loader`:\n// hydration-off.ts in client-only builds); the walk that then hydrates the server's DOM is\n// hydration-client.ts, which the loader imports lazily (view/07-hydration.md \"Loading\").\nimport { warnJsonHazard } from './json-safety.js';\nimport { DEV } from './view/index.js';\n\n/** Host attribute holding the JSON seed. Removed once the client has read it. */\nexport const SEED_ATTRIBUTE = 'data-gyral-seed';\n\nexport interface Seed {\n  /**\n   * The server's state. Omitted when it equals what `init(props)` returns for the seeded\n   * props (gyral-czi 4k7.10): the client recomputes it instead of reading a second copy of\n   * data the props already carry.\n   */\n  readonly state?: unknown;\n  readonly props: Readonly<Record<string, unknown>>;\n}\n\n/** JSON equality: seeds are JSON, so two values that serialize alike hydrate alike. */\nexport const sameJson = (a: unknown, b: unknown): boolean =>\n  JSON.stringify(a) === JSON.stringify(b);\n\n/**\n * Server side: the seed for a component whose props `carried` travel in no attribute\n * (property holes) and whose state is `state`; `initial` is `init(props)`'s state.\n */\nexport function makeSeed(\n  tag: string,\n  state: unknown,\n  initial: unknown,\n  carried: Readonly<Record<string, unknown>>,\n): Seed {\n  const seed: Seed = sameJson(state, initial) ? { props: carried } : { state, props: carried };\n  if (DEV) warnJsonHazard(`<${tag}>`, seed, 'seed'); // view/06-server.md \"Seed\": development\n\n  return seed;\n}\n"]}

package/dist/index.d.ts

@@ -1,43 +1,31 @@
 export { command, defineDriver } from './command.js';
-export type { AnyDriver, Command, CommandHandlers, Concurrency, Driver, DriverContext, DriverOverrides, Next, RetryPolicy, } from './command.js';
-export { child, emit } from './children.js';
+export type { AnyDriver, Command, CommandHandlers, Concurrency, Driver, DriverContext, DriverOverrides, DriverToken, Next, RetryPolicy, } from './command.js';
+export { retry } from './retry.js';
+export { subscription } from './subscription.js';
+export type { SubscriptionContext, SubscriptionOptions, Unsubscribe } from './subscription.js';
+export { child, outputs } from './children.js';
 export { focus } from './focus.js';
+export { call, type CallInput } from './call.js';
 export type { FocusOptions } from './focus.js';
-export { invokersSupported } from './invokers.js';
 export type { CommandInfo } from './invokers.js';
-export { ISLAND_ATTRIBUTE } from './islands.js';
 export type { HydrateStrategy } from './islands.js';
-export type { ChildSource, OutputSource } from './children.js';
+export type { ChildSource, OutputEvent, OutputSource, OutputsOf } from './children.js';
 export { define } from './define.js';
+export { intentsOf, OUTPUT_EVENT } from './intent.js';
+export { settled } from './settled.js';
+export { componentsReady } from './components-ready.js';
+export { GyralError, type ErrorPhase } from './errors.js';
 export { changed, defineStore, send } from './store.js';
-export type { AnyStore, AnyStoreInstance, Store, StoreChanged, StoreInstance, StoreOverrides, StoreRef, StoreSendInput, SeedCheck, StoreResolver, StoreSpec, StoreUpdate, } from './store.js';
-export { STORE_SEND } from './store.js';
-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, type RandomInput } from './random.js';
-export { defineForm, field, fieldErrors, form, formDataToObject, formFields, intentRejectedSchema, redirectedTo, validateForm, } from './forms.js';
-export type { FormDefinition, FormRedirected, FormResult, FormValue } 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 { DEVTOOLS_ENABLED as devtoolsEnabled, devLiveComponents as devtoolsLiveComponents, } from '#devtools';
-export { DEVTOOLS_GLOBAL } from './devtools-events.js';
-export type { CommandPhase, CommandTraceEvent, DevComponentRef, DevEvent, DevtoolsHook, } from './devtools-events.js';
-export type { TextareaAttribute, TextareaOptions } from './textarea.js';
-export type { Styles } from './styles.js';
-export { HIDDEN_MARKER, HYDRATE_KEY, isLightComponent, LIGHT_ATTRIBUTE } from './light-dom.js';
-export type { GyralElement, GyralElementClass } from './define.js';
-export type { ComponentSpec, Ctx, FieldIssue, FormFields, IntentInput, IntentNames, IntentParser, IntentRejected, Intents, PropDeclarations, Hydrated, PropsChanged, Stateless, StoreReader, Tagged, Update, } from './types.js';
-export { css, nothing, unsafeCSS } from 'lit';
-export { html, svg } from './templates.js';
-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';
+export type { AnyStore, AnyStoreInstance, Store, StoreChanged, StoreInstance, StoreOverrides, StoreRef, SeedCheck, StoreResolver, StoreSpec, StoreUpdate, } from './store.js';
+export { provideDrivers } from './drivers-scope.js';
+export { defineForm, field, fieldErrors, form } from './forms.js';
+export type { FieldName, FormDefinition, FormOptions, FormResult, FormValue, FormValues, } from './forms.js';
+export { invalid } from './hooks/invalid.js';
+export type { FormAssociation, FormControlValue, FormControlValidity, FormDisabled, FormReset, FormStateRestore, } from './form-associated.js';
+export { prop } from './prop.js';
+export type { Prop, PropGuard, PropKind, PropsOf } from './prop.js';
+export type { Definer, GyralElement, GyralElementClass } from './define.js';
+export type { ComponentSpec, Ctx, FieldIssue, FormFields, IntentInput, IntentNames, IntentParser, IntentRejected, Intents, ParserCtx, ParserFor, PropDeclarations, Errored, Hydrated, PropsChanged, ShadowOption, Stateless, StoreReader, Tagged, Update, } from './types.js';
+export { css, defineHook, each, html, keyed, nothing, raw, svg } from './view/index.js';
+export type { ChildValue, CssValue, HookAttributes, HookResult, HookSpec, ListResult, RawResult, StyleSource, Styles, TemplateResult, } from './view/index.js';
+export type { Head, HeadLink, HeadMeta, JsonValue } from './head.js';

package/dist/index.js

@@ -1,37 +1,19 @@
 export { command, defineDriver } from './command.js';
-export { child, emit } from './children.js';
+export { retry } from './retry.js';
+export { subscription } from './subscription.js';
+export { child, outputs } from './children.js';
 export { focus } from './focus.js';
-export { invokersSupported } from './invokers.js';
-export { ISLAND_ATTRIBUTE } from './islands.js';
+export { call } from './call.js';
 export { define } from './define.js';
+export { intentsOf, OUTPUT_EVENT } from './intent.js';
+export { settled } from './settled.js';
+export { componentsReady } from './components-ready.js';
+export { GyralError } from './errors.js';
 export { changed, defineStore, send } from './store.js';
-export { STORE_SEND } from './store.js';
-// Store scoping: used by @gyral/ssr (server scope + page seed) and @gyral/testing.
-export { resetDocumentStores, scriptSafeJson, STORE_SEED_ATTRIBUTE, StoreRegistry, STORES_ELEMENT, withStoreScope, } from './store-scope.js';
-export { defineStoresProvider } from './stores-provider.js';
-export { DRIVERS_ELEMENT, provideDrivers } from './drivers-scope.js';
-export { jsonHazard, warnJsonHazard } from './json-safety.js';
-export { random, randomDriver, randomInt, toInt } from './random.js';
-export { defineForm, field, fieldErrors, form, formDataToObject, formFields, intentRejectedSchema, redirectedTo, validateForm, } from './forms.js';
-export { ElementDirective } from './element-directive.js';
-export { runInit } from './init.js';
-export { invalid } from './invalid.js';
-export { findInScope, labelledBy } from './accessible-name.js';
-export { liveBoolean } from './live-boolean.js';
-export { textarea, textareaMarkup } from './textarea.js';
-// Devtools event stream (ADR 0017): emitted in development builds only.
-export { DEVTOOLS_ENABLED as devtoolsEnabled, devLiveComponents as devtoolsLiveComponents, } from '#devtools';
-export { DEVTOOLS_GLOBAL } from './devtools-events.js';
-// Used by @gyral/ssr to render light-DOM components as plain children (ADR 0014).
-export { HIDDEN_MARKER, HYDRATE_KEY, isLightComponent, LIGHT_ATTRIBUTE } from './light-dom.js';
-// The view layer is Lit. Re-exported so most apps need a single import. `html` and `svg` are
-// Lit's tags with indentation whitespace removed (template-whitespace.ts, gyral-9rf).
-export { css, nothing, unsafeCSS } from 'lit';
-export { html, svg } from './templates.js';
-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';
+export { provideDrivers } from './drivers-scope.js';
+export { defineForm, field, fieldErrors, form } from './forms.js';
+export { invalid } from './hooks/invalid.js';
+export { prop } from './prop.js';
+// The view layer (ADR 0018, docs/design-docs/view/): templates, lists, hooks and styles.
+export { css, defineHook, each, html, keyed, nothing, raw, svg } 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,6FAA6F;AAC7F,sFAAsF;AACtF,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAC3C,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. `html` and `svg` are\n// Lit's tags with indentation whitespace removed (template-whitespace.ts, gyral-9rf).\nexport { css, nothing, unsafeCSS } from 'lit';\nexport { html, svg } from './templates.js';\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;AAarD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAkB,MAAM,WAAW,CAAC;AAKjD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAmB,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAcxD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AASlE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAS7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA0BjC,yFAAyF;AACzF,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,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  DriverToken,\n  Next,\n  RetryPolicy,\n} from './command.js';\nexport { retry } from './retry.js';\nexport { subscription } from './subscription.js';\nexport type { SubscriptionContext, SubscriptionOptions, Unsubscribe } from './subscription.js';\nexport { child, outputs } from './children.js';\nexport { focus } from './focus.js';\nexport { call, type CallInput } from './call.js';\nexport type { FocusOptions } from './focus.js';\nexport type { CommandInfo } from './invokers.js';\nexport type { HydrateStrategy } from './islands.js';\nexport type { ChildSource, OutputEvent, OutputSource, OutputsOf } from './children.js';\nexport { define } from './define.js';\nexport { intentsOf, OUTPUT_EVENT } from './intent.js';\nexport { settled } from './settled.js';\nexport { componentsReady } from './components-ready.js';\nexport { GyralError, type ErrorPhase } from './errors.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  SeedCheck,\n  StoreResolver,\n  StoreSpec,\n  StoreUpdate,\n} from './store.js';\nexport { provideDrivers } from './drivers-scope.js';\nexport { defineForm, field, fieldErrors, form } from './forms.js';\nexport type {\n  FieldName,\n  FormDefinition,\n  FormOptions,\n  FormResult,\n  FormValue,\n  FormValues,\n} from './forms.js';\nexport { invalid } from './hooks/invalid.js';\nexport type {\n  FormAssociation,\n  FormControlValue,\n  FormControlValidity,\n  FormDisabled,\n  FormReset,\n  FormStateRestore,\n} from './form-associated.js';\nexport { prop } from './prop.js';\nexport type { Prop, PropGuard, PropKind, PropsOf } from './prop.js';\nexport type { Definer, 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  ParserCtx,\n  ParserFor,\n  PropDeclarations,\n  Errored,\n  Hydrated,\n  PropsChanged,\n  ShadowOption,\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, keyed, nothing, raw, svg } 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\n// The head model (ADR 0019): shared by @gyral/ssr's renderPage() and @gyral/router's setHead().\nexport type { Head, HeadLink, HeadMeta, JsonValue } from './head.js';\n"]}

package/dist/indexeddb-types.d.ts

@@ -0,0 +1,97 @@
+import type { StandardSchemaV1 } from '@standard-schema/spec';
+export type IndexedDBStores = Readonly<Record<string, StandardSchemaV1>>;
+export type IndexedDBRecord<S extends StandardSchemaV1> = StandardSchemaV1.InferOutput<S>;
+export type IndexedDBRange = {
+    readonly _tag: 'Only';
+    readonly key: IDBValidKey;
+} | {
+    readonly _tag: 'Lower' | 'Upper';
+    readonly key: IDBValidKey;
+    readonly open?: boolean;
+} | {
+    readonly _tag: 'Bound';
+    readonly lower: IDBValidKey;
+    readonly upper: IDBValidKey;
+    readonly lowerOpen?: boolean;
+    readonly upperOpen?: boolean;
+};
+export type IndexedDBOperation<S extends IndexedDBStores> = {
+    [K in keyof S & string]: {
+        readonly _tag: 'Read' | 'Delete';
+        readonly store: K;
+        readonly key: IDBValidKey;
+    } | {
+        readonly _tag: 'Put';
+        readonly store: K;
+        readonly value: IndexedDBRecord<S[K]>;
+        readonly key?: IDBValidKey;
+    } | {
+        readonly _tag: 'Query';
+        readonly store: K;
+        readonly index?: string;
+        readonly range?: IndexedDBRange;
+        readonly direction?: IDBCursorDirection;
+        readonly limit: number;
+    };
+}[keyof S & string];
+export type IndexedDBInput<S extends IndexedDBStores> = IndexedDBOperation<S> | {
+    readonly _tag: 'Transaction';
+    readonly operations: readonly IndexedDBOperation<S>[];
+};
+export type IndexedDBResult<S extends IndexedDBStores> = {
+    [K in keyof S & string]: {
+        readonly _tag: 'Record';
+        readonly store: K;
+        readonly key: IDBValidKey;
+        readonly entry: {
+            readonly found: false;
+        } | {
+            readonly found: true;
+            readonly value: IndexedDBRecord<S[K]>;
+        };
+    } | {
+        readonly _tag: 'Put' | 'Deleted';
+        readonly store: K;
+        readonly key: IDBValidKey;
+    } | {
+        readonly _tag: 'Records';
+        readonly store: K;
+        readonly records: readonly {
+            readonly key: IDBValidKey;
+            readonly value: IndexedDBRecord<S[K]>;
+        }[];
+    };
+}[keyof S & string];
+export type IndexedDBOutput<S extends IndexedDBStores> = IndexedDBResult<S> | {
+    readonly _tag: 'Committed';
+    readonly results: readonly IndexedDBResult<S>[];
+};
+export type IndexedDBError = {
+    readonly _tag: 'IndexedDBBlockedError';
+    readonly database: string;
+    readonly version: number;
+} | {
+    readonly _tag: 'IndexedDBInputError';
+    readonly message: string;
+} | {
+    readonly _tag: 'IndexedDBAccessError';
+    readonly database: string;
+    readonly phase: 'encode' | 'open' | 'upgrade' | 'transaction';
+    readonly name: string;
+    readonly message: string;
+} | {
+    readonly _tag: 'IndexedDBDecodeError';
+    readonly store: string;
+    readonly issues: readonly StandardSchemaV1.Issue[];
+    /** Native transaction completed before decoding. Its writes cannot be undone. */
+    readonly committed: true;
+};
+export interface IndexedDBOptions<S extends IndexedDBStores> {
+    readonly database: string;
+    readonly version: number;
+    readonly name?: string;
+    readonly factory?: () => IDBFactory;
+    /** Synchronous: queue migration requests before returning; never await. */
+    readonly upgrade?: (db: IDBDatabase, oldVersion: number, newVersion: number, transaction: IDBTransaction) => void;
+    readonly encode?: <K extends keyof S & string>(store: K, value: IndexedDBRecord<S[K]>) => unknown;
+}

package/dist/indexeddb-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=indexeddb-types.js.map

package/dist/indexeddb-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-types.js","sourceRoot":"","sources":["../src/indexeddb-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\n\nexport type IndexedDBStores = Readonly<Record<string, StandardSchemaV1>>;\nexport type IndexedDBRecord<S extends StandardSchemaV1> = StandardSchemaV1.InferOutput<S>;\nexport type IndexedDBRange =\n  | { readonly _tag: 'Only'; readonly key: IDBValidKey }\n  | { readonly _tag: 'Lower' | 'Upper'; readonly key: IDBValidKey; readonly open?: boolean }\n  | {\n      readonly _tag: 'Bound';\n      readonly lower: IDBValidKey;\n      readonly upper: IDBValidKey;\n      readonly lowerOpen?: boolean;\n      readonly upperOpen?: boolean;\n    };\nexport type IndexedDBOperation<S extends IndexedDBStores> = {\n  [K in keyof S & string]:\n    | { readonly _tag: 'Read' | 'Delete'; readonly store: K; readonly key: IDBValidKey }\n    | {\n        readonly _tag: 'Put';\n        readonly store: K;\n        readonly value: IndexedDBRecord<S[K]>;\n        readonly key?: IDBValidKey;\n      }\n    | {\n        readonly _tag: 'Query';\n        readonly store: K;\n        readonly index?: string;\n        readonly range?: IndexedDBRange;\n        readonly direction?: IDBCursorDirection;\n        readonly limit: number;\n      };\n}[keyof S & string];\nexport type IndexedDBInput<S extends IndexedDBStores> =\n  | IndexedDBOperation<S>\n  | { readonly _tag: 'Transaction'; readonly operations: readonly IndexedDBOperation<S>[] };\nexport type IndexedDBResult<S extends IndexedDBStores> = {\n  [K in keyof S & string]:\n    | {\n        readonly _tag: 'Record';\n        readonly store: K;\n        readonly key: IDBValidKey;\n        readonly entry:\n          | { readonly found: false }\n          | { readonly found: true; readonly value: IndexedDBRecord<S[K]> };\n      }\n    | { readonly _tag: 'Put' | 'Deleted'; readonly store: K; readonly key: IDBValidKey }\n    | {\n        readonly _tag: 'Records';\n        readonly store: K;\n        readonly records: readonly {\n          readonly key: IDBValidKey;\n          readonly value: IndexedDBRecord<S[K]>;\n        }[];\n      };\n}[keyof S & string];\nexport type IndexedDBOutput<S extends IndexedDBStores> =\n  | IndexedDBResult<S>\n  | { readonly _tag: 'Committed'; readonly results: readonly IndexedDBResult<S>[] };\nexport type IndexedDBError =\n  | { readonly _tag: 'IndexedDBBlockedError'; readonly database: string; readonly version: number }\n  | { readonly _tag: 'IndexedDBInputError'; readonly message: string }\n  | {\n      readonly _tag: 'IndexedDBAccessError';\n      readonly database: string;\n      readonly phase: 'encode' | 'open' | 'upgrade' | 'transaction';\n      readonly name: string;\n      readonly message: string;\n    }\n  | {\n      readonly _tag: 'IndexedDBDecodeError';\n      readonly store: string;\n      readonly issues: readonly StandardSchemaV1.Issue[];\n      /** Native transaction completed before decoding. Its writes cannot be undone. */\n      readonly committed: true;\n    };\nexport interface IndexedDBOptions<S extends IndexedDBStores> {\n  readonly database: string;\n  readonly version: number;\n  readonly name?: string;\n  readonly factory?: () => IDBFactory;\n  /** Synchronous: queue migration requests before returning; never await. */\n  readonly upgrade?: (\n    db: IDBDatabase,\n    oldVersion: number,\n    newVersion: number,\n    transaction: IDBTransaction,\n  ) => void;\n  readonly encode?: <K extends keyof S & string>(store: K, value: IndexedDBRecord<S[K]>) => unknown;\n}\n"]}

package/dist/indexeddb.d.ts

@@ -0,0 +1,5 @@
+import type { Driver } from './command.js';
+import type { IndexedDBError, IndexedDBInput, IndexedDBOptions, IndexedDBOutput, IndexedDBStores } from './indexeddb-types.js';
+export type { IndexedDBError, IndexedDBInput, IndexedDBOperation, IndexedDBOptions, IndexedDBOutput, IndexedDBRange, IndexedDBRecord, IndexedDBResult, IndexedDBStores, } from './indexeddb-types.js';
+/** Typed record operations and atomic batches over application-owned stores and migrations. */
+export declare function makeIndexedDBDriver<S extends IndexedDBStores>(stores: S, options: IndexedDBOptions<S>): Driver<IndexedDBInput<S>, IndexedDBOutput<S>, IndexedDBError>;

package/dist/indexeddb.js

@@ -0,0 +1,118 @@
+import { DatabaseFailure, databaseError, openDatabase } from './internal/indexeddb-open.js';
+import { transact } from './internal/indexeddb-transaction.js';
+/** Typed record operations and atomic batches over application-owned stores and migrations. */
+export function makeIndexedDBDriver(stores, options) {
+    const decode = async (store, value) => {
+        const schema = stores[store];
+        if (schema === undefined)
+            throw new DatabaseFailure({
+                _tag: 'IndexedDBInputError',
+                message: `Unknown store ${store}.`,
+            });
+        try {
+            const result = await schema['~standard'].validate(value);
+            if (result.issues !== undefined)
+                throw new DatabaseFailure({
+                    _tag: 'IndexedDBDecodeError',
+                    store,
+                    issues: result.issues,
+                    committed: true,
+                });
+            return result.value;
+        }
+        catch (cause) {
+            if (cause instanceof DatabaseFailure)
+                throw cause;
+            throw new DatabaseFailure({
+                _tag: 'IndexedDBDecodeError',
+                store,
+                committed: true,
+                issues: [{ message: cause instanceof Error ? cause.message : String(cause) }],
+            });
+        }
+    };
+    const decodeResult = async (result) => {
+        let decoded = result;
+        if (result._tag === 'Record' && result.entry.found)
+            decoded = {
+                ...result,
+                entry: { found: true, value: await decode(result.store, result.entry.value) },
+            };
+        else if (result._tag === 'Records')
+            decoded = {
+                ...result,
+                records: await Promise.all(result.records.map(async (r) => ({
+                    key: r.key,
+                    value: await decode(result.store, r.value),
+                }))),
+            };
+        // The store name originates in the typed input, and each value passed that store's schema.
+        return decoded;
+    };
+    return {
+        name: options.name ?? 'indexeddb',
+        concurrency: 'merge',
+        toError: (cause) => cause instanceof DatabaseFailure
+            ? cause.error
+            : databaseError(options.database, 'open', cause).error,
+        run: async (input, ctx) => {
+            ctx.signal.throwIfAborted();
+            let phase = 'encode';
+            try {
+                const operations = input._tag === 'Transaction' ? input.operations : [input];
+                if (operations.length === 0)
+                    throw new DatabaseFailure({
+                        _tag: 'IndexedDBInputError',
+                        message: 'Transactions require at least one operation.',
+                    });
+                for (const op of operations) {
+                    if (stores[op.store] === undefined)
+                        throw new DatabaseFailure({
+                            _tag: 'IndexedDBInputError',
+                            message: `Unknown store ${op.store}.`,
+                        });
+                    if (op._tag === 'Query' &&
+                        (!Number.isInteger(op.limit) || op.limit < 1 || op.limit > 0xffffffff))
+                        throw new DatabaseFailure({
+                            _tag: 'IndexedDBInputError',
+                            message: 'Query limit must be an integer from 1 to 2^32 - 1.',
+                        });
+                }
+                const encoded = operations.map((op) => {
+                    if (op._tag !== 'Put' || options.encode === undefined)
+                        return op;
+                    return {
+                        _tag: 'Put',
+                        store: op.store,
+                        value: options.encode(op.store, op.value),
+                        ...(op.key === undefined ? {} : { key: op.key }),
+                    };
+                });
+                phase = 'open';
+                const db = await openDatabase(options, ctx.signal);
+                phase = 'transaction';
+                let raw;
+                try {
+                    raw = await transact(db, encoded, ctx.signal);
+                }
+                finally {
+                    db.close();
+                }
+                const results = await Promise.all(raw.map(decodeResult));
+                ctx.signal.throwIfAborted();
+                if (input._tag === 'Transaction')
+                    return { _tag: 'Committed', results };
+                const result = results[0];
+                if (result === undefined)
+                    throw new Error('Missing transaction result.');
+                return result;
+            }
+            catch (cause) {
+                if (ctx.signal.aborted || cause instanceof DatabaseFailure)
+                    throw cause;
+                throw databaseError(options.database, phase, cause);
+            }
+        },
+    };
+}
+//# sourceMappingURL=indexeddb.js.map

package/dist/indexeddb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb.js","sourceRoot":"","sources":["../src/indexeddb.ts"],"names":[],"mappings":"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","sourcesContent":["// Optional native IndexedDB commands; native resources only exist while commands run (ADR 0028).\nimport type { Driver } from './command.js';\nimport type {\n  IndexedDBError,\n  IndexedDBInput,\n  IndexedDBOptions,\n  IndexedDBOperation,\n  IndexedDBOutput,\n  IndexedDBResult,\n  IndexedDBStores,\n} from './indexeddb-types.js';\nimport { DatabaseFailure, databaseError, openDatabase } from './internal/indexeddb-open.js';\nimport { transact, type RawResult } from './internal/indexeddb-transaction.js';\nexport type {\n  IndexedDBError,\n  IndexedDBInput,\n  IndexedDBOperation,\n  IndexedDBOptions,\n  IndexedDBOutput,\n  IndexedDBRange,\n  IndexedDBRecord,\n  IndexedDBResult,\n  IndexedDBStores,\n} from './indexeddb-types.js';\n\n/** Typed record operations and atomic batches over application-owned stores and migrations. */\nexport function makeIndexedDBDriver<S extends IndexedDBStores>(\n  stores: S,\n  options: IndexedDBOptions<S>,\n): Driver<IndexedDBInput<S>, IndexedDBOutput<S>, IndexedDBError> {\n  const decode = async (store: string, value: unknown): Promise<unknown> => {\n    const schema = stores[store];\n    if (schema === undefined)\n      throw new DatabaseFailure({\n        _tag: 'IndexedDBInputError',\n        message: `Unknown store ${store}.`,\n      });\n    try {\n      const result = await schema['~standard'].validate(value);\n      if (result.issues !== undefined)\n        throw new DatabaseFailure({\n          _tag: 'IndexedDBDecodeError',\n          store,\n          issues: result.issues,\n          committed: true,\n        });\n      return result.value;\n    } catch (cause) {\n      if (cause instanceof DatabaseFailure) throw cause;\n      throw new DatabaseFailure({\n        _tag: 'IndexedDBDecodeError',\n        store,\n        committed: true,\n        issues: [{ message: cause instanceof Error ? cause.message : String(cause) }],\n      });\n    }\n  };\n  const decodeResult = async (result: RawResult): Promise<IndexedDBResult<S>> => {\n    let decoded: RawResult = result;\n    if (result._tag === 'Record' && result.entry.found)\n      decoded = {\n        ...result,\n        entry: { found: true, value: await decode(result.store, result.entry.value) },\n      };\n    else if (result._tag === 'Records')\n      decoded = {\n        ...result,\n        records: await Promise.all(\n          result.records.map(async (r) => ({\n            key: r.key,\n            value: await decode(result.store, r.value),\n          })),\n        ),\n      };\n    // The store name originates in the typed input, and each value passed that store's schema.\n    return decoded;\n  };\n  return {\n    name: options.name ?? 'indexeddb',\n    concurrency: 'merge',\n    toError: (cause) =>\n      cause instanceof DatabaseFailure\n        ? cause.error\n        : databaseError(options.database, 'open', cause).error,\n    run: async (input, ctx) => {\n      ctx.signal.throwIfAborted();\n      let phase: 'encode' | 'open' | 'transaction' = 'encode';\n      try {\n        const operations = input._tag === 'Transaction' ? input.operations : [input];\n        if (operations.length === 0)\n          throw new DatabaseFailure({\n            _tag: 'IndexedDBInputError',\n            message: 'Transactions require at least one operation.',\n          });\n        for (const op of operations) {\n          if (stores[op.store] === undefined)\n            throw new DatabaseFailure({\n              _tag: 'IndexedDBInputError',\n              message: `Unknown store ${op.store}.`,\n            });\n          if (\n            op._tag === 'Query' &&\n            (!Number.isInteger(op.limit) || op.limit < 1 || op.limit > 0xffffffff)\n          )\n            throw new DatabaseFailure({\n              _tag: 'IndexedDBInputError',\n              message: 'Query limit must be an integer from 1 to 2^32 - 1.',\n            });\n        }\n        const encoded = operations.map((op): IndexedDBOperation<IndexedDBStores> => {\n          if (op._tag !== 'Put' || options.encode === undefined) return op;\n          return {\n            _tag: 'Put',\n            store: op.store,\n            value: options.encode(op.store, op.value),\n            ...(op.key === undefined ? {} : { key: op.key }),\n          };\n        });\n        phase = 'open';\n        const db = await openDatabase(options, ctx.signal);\n        phase = 'transaction';\n        let raw: readonly RawResult[];\n        try {\n          raw = await transact(db, encoded, ctx.signal);\n        } finally {\n          db.close();\n        }\n        const results = await Promise.all(raw.map(decodeResult));\n        ctx.signal.throwIfAborted();\n        if (input._tag === 'Transaction') return { _tag: 'Committed', results };\n        const result = results[0];\n        if (result === undefined) throw new Error('Missing transaction result.');\n        return result;\n      } catch (cause) {\n        if (ctx.signal.aborted || cause instanceof DatabaseFailure) throw cause;\n        throw databaseError(options.database, phase, cause);\n      }\n    },\n  };\n}\n"]}

package/dist/intent.d.ts

@@ -1,25 +1,70 @@
-import type { IntentInput, IntentParser, Tagged } from './types.js';
-/** Event a child component dispatches on its host to send an output up (ADR 0010). */
+import type { IntentInput, IntentNames, IntentParser, ParserCtx, 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); public. */
 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 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 declare const INTENT_EVENTS: readonly string[];
+/**
+ * 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 declare function eventsOf(markup: Markup): readonly string[];
+/**
+ * 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 declare const INTENT_EVENTS: readonly ["click", "submit", "input", "change", "keydown", "keyup", "focusin", "focusout", "toggle", "command", "gyral-output"];
-/** The event that fires an intent unless `data-intent-on` overrides it. */
 export declare function defaultTrigger(el: Element): string;
 export declare function markGyralHost(ctor: object): void;
 /**
- * Finds the nearest `data-intent` element for this event that belongs to `root`. Elements
- * inside nested components are ignored: that is component isolation.
+ * 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;
+/**
+ * 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 declare function findIntentElement(event: Event, root: Node): Element | undefined;
-/** Reads an event into an IntentInput. Form submissions are prevented and turned into FormData. */
-export declare function readIntent(event: Event, root: Node): IntentInput | undefined;
+export declare function readIntent(event: Event, root: Node, after?: Element): IntentInput | undefined;
 export declare const intentNames: unknown;
-/** Listens for intent events on a component root (capture phase: `toggle` doesn't bubble). */
-export declare function listenForIntents(root: Node, extra: readonly string[], handler: (event: Event) => void): void;
-/** Parses one event with its matching parser and delivers the message (sync or async). */
-export declare function handleIntent<M>(event: Event, root: Node, parsers: Readonly<Record<string, IntentParser<M> | undefined>>, tag: string, deliver: (msg: Tagged | undefined) => void): void;
+/**
+ * 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 declare function intentsOf<C extends {
+    readonly intentNames?: string;
+}>(): IntentNames<NonNullable<C['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 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). 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 declare function handleIntent<M>(event: Event, root: Node, parsers: Readonly<Record<string, IntentParser<M> | true | undefined>>, tag: string, model: {
+    ctx(): ParserCtx<unknown>;
+    fail(cause: unknown, phase: 'parse', text: string, msg?: string): unknown;
+}, deliver: (msg: Tagged | undefined) => void): void;