@gyral/core 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -1,35 +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 { intents } from './intent.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 { 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 { runInit } from './init.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 { findInScope, labelledBy } from './hooks/labelled-by.js';
+export type { FormAssociation, FormControlValue, FormControlValidity, FormDisabled, FormReset, FormStateRestore, } from './form-associated.js';
 export { prop } from './prop.js';
-export type { Prop, PropKind, PropsOf } from './prop.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 { 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, defineHook, each, html, HydrationMismatch, nothing, raw } from './view/index.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,28 +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 { intents } from './intent.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 { 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 { runInit } from './init.js';
+export { provideDrivers } from './drivers-scope.js';
+export { defineForm, field, fieldErrors, form } from './forms.js';
 export { invalid } from './hooks/invalid.js';
-export { findInScope, labelledBy } from './hooks/labelled-by.js';
 export { prop } from './prop.js';
-// Devtools event stream (ADR 0017): emitted in development builds only.
-export { DEVTOOLS_ENABLED as devtoolsEnabled, devLiveComponents as devtoolsLiveComponents, } from '#devtools';
-export { DEVTOOLS_GLOBAL } from './devtools-events.js';
-// Used by the server renderer and @gyral/ssr (ADR 0014, view/06-server.md).
-export { isLightComponent, LIGHT_ATTRIBUTE } from './light-dom.js';
 // The view layer (ADR 0018, docs/design-docs/view/): templates, lists, hooks and styles.
-export { css, defineHook, each, html, HydrationMismatch, nothing, raw } from './view/index.js';
+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,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAexD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,mFAAmF;AACnF,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAoB,MAAM,aAAa,CAAC;AACvF,OAAO,EACL,UAAU,EACV,KAAK,EACL,WAAW,EACX,IAAI,EACJ,gBAAgB,EAChB,UAAU,EACV,oBAAoB,EACpB,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,wEAAwE;AACxE,OAAO,EACL,gBAAgB,IAAI,eAAe,EACnC,iBAAiB,IAAI,sBAAsB,GAC5C,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQvD,4EAA4E;AAC5E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAqBnE,yFAAyF;AACzF,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["export { command, defineDriver } from './command.js';\nexport type {\n  AnyDriver,\n  Command,\n  CommandHandlers,\n  Concurrency,\n  Driver,\n  DriverContext,\n  DriverOverrides,\n  Next,\n  RetryPolicy,\n} from './command.js';\nexport { child, emit } from './children.js';\nexport { focus } from './focus.js';\nexport type { FocusOptions } from './focus.js';\nexport { invokersSupported } from './invokers.js';\nexport type { CommandInfo } from './invokers.js';\nexport { ISLAND_ATTRIBUTE } from './islands.js';\nexport type { HydrateStrategy } from './islands.js';\nexport type { ChildSource, OutputSource } from './children.js';\nexport { define } from './define.js';\nexport { intents } from './intent.js';\nexport { settled } from './settled.js';\nexport { changed, defineStore, send } from './store.js';\nexport type {\n  AnyStore,\n  AnyStoreInstance,\n  Store,\n  StoreChanged,\n  StoreInstance,\n  StoreOverrides,\n  StoreRef,\n  StoreSendInput,\n  SeedCheck,\n  StoreResolver,\n  StoreSpec,\n  StoreUpdate,\n} from './store.js';\nexport { STORE_SEND } from './store.js';\n// Store scoping: used by @gyral/ssr (server scope + page seed) and @gyral/testing.\nexport {\n  resetDocumentStores,\n  scriptSafeJson,\n  STORE_SEED_ATTRIBUTE,\n  StoreRegistry,\n  STORES_ELEMENT,\n  withStoreScope,\n} from './store-scope.js';\nexport { DRIVERS_ELEMENT, provideDrivers } from './drivers-scope.js';\nexport { jsonHazard, warnJsonHazard } from './json-safety.js';\nexport { random, randomDriver, randomInt, toInt, type RandomInput } from './random.js';\nexport {\n  defineForm,\n  field,\n  fieldErrors,\n  form,\n  formDataToObject,\n  formFields,\n  intentRejectedSchema,\n  redirectedTo,\n  validateForm,\n} from './forms.js';\nexport type { FormDefinition, FormRedirected, FormResult, FormValue } from './forms.js';\nexport { runInit } from './init.js';\nexport { invalid } from './hooks/invalid.js';\nexport { findInScope, labelledBy } from './hooks/labelled-by.js';\nexport { prop } from './prop.js';\nexport type { Prop, PropKind, PropsOf } from './prop.js';\n// Devtools event stream (ADR 0017): emitted in development builds only.\nexport {\n  DEVTOOLS_ENABLED as devtoolsEnabled,\n  devLiveComponents as devtoolsLiveComponents,\n} from '#devtools';\nexport { DEVTOOLS_GLOBAL } from './devtools-events.js';\nexport type {\n  CommandPhase,\n  CommandTraceEvent,\n  DevComponentRef,\n  DevEvent,\n  DevtoolsHook,\n} from './devtools-events.js';\n// Used by the server renderer and @gyral/ssr (ADR 0014, view/06-server.md).\nexport { isLightComponent, LIGHT_ATTRIBUTE } from './light-dom.js';\nexport type { GyralElement, GyralElementClass } from './define.js';\nexport type {\n  ComponentSpec,\n  Ctx,\n  FieldIssue,\n  FormFields,\n  IntentInput,\n  IntentNames,\n  IntentParser,\n  IntentRejected,\n  Intents,\n  PropDeclarations,\n  Hydrated,\n  PropsChanged,\n  Stateless,\n  StoreReader,\n  Tagged,\n  Update,\n} from './types.js';\n\n// The view layer (ADR 0018, docs/design-docs/view/): templates, lists, hooks and styles.\nexport { css, defineHook, each, html, HydrationMismatch, nothing, raw } from './view/index.js';\nexport type {\n  ChildValue,\n  CssValue,\n  HookAttributes,\n  HookResult,\n  HookSpec,\n  ListResult,\n  RawResult,\n  StyleSource,\n  Styles,\n  TemplateResult,\n} from './view/index.js';\n"]}
+{"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,19 +1,28 @@
-import type { IntentInput, IntentNames, IntentParser, Tagged } from './types.js';
-import type { Markup } from './view/index.js';
-/** Event a child component dispatches on its host to send an output up (ADR 0010). */
+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[];
 /**
  * The events `data-intent-on` usually names. A component root listens (capture phase, so
- * non-bubbling events such as `toggle` are seen too) for the defaults, for `spec.events`, and
- * for the `data-intent-on` values in the templates it renders; a template that binds
- * `data-intent-on` dynamically adds all of these (view/05-element.md "Intent events").
+ * 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-on` attributes name. */
+/**
+ * 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. */
+/**
+ * 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 function defaultTrigger(el: Element): string;
 export declare function markGyralHost(ctor: object): void;
 /**
@@ -22,27 +31,40 @@ export declare function markGyralHost(ctor: object): void;
  */
 export declare function hostDepth(el: Element): number;
 /**
- * Finds the nearest `data-intent` element for this event that belongs to `root`. Elements
- * inside nested components are ignored: that is component isolation.
+ * 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;
 /**
  * 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`:
+ * 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 = intents<Msg>();
- *   const Row = (t: Todo) => html`<input value=${t.id} data-intent=${i.Toggle} />`;
+ *   const i = intentsOf<typeof TodoList>();
+ *   const Row = (t: Todo): TemplateResult => html`<input value=${t.id} data-intent=${i.Toggle} />`;
  */
-export declare function intents<M extends Tagged>(): IntentNames<M>;
+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). */
-export declare function handleIntent<M>(event: Event, root: Node, parsers: Readonly<Record<string, IntentParser<M> | undefined>>, tag: string, deliver: (msg: Tagged | undefined) => 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;