@repobit/dex-store-elements 1.7.3 → 2.0.1

package/dist/src/controllers/controller.resolve.d.ts

@@ -0,0 +1,78 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import { type TaskStatus as LitTaskStatus } from '@lit/task';
+export type MaybePromise<T> = T | Promise<T>;
+export type BdResolveStatus = 'initial' | 'disabled' | 'pending' | 'complete' | 'error';
+export type BdResolveHookPhase = 'pending' | 'disabled' | 'complete' | 'error';
+export type BdResolveContext = Readonly<{
+    signal: AbortSignal;
+    runId: number;
+}>;
+export interface BdResolveHost extends ReactiveControllerHost {
+    trackLocalWork<T>(key: unknown, work: PromiseLike<T>): Promise<T>;
+}
+export type BdWorkKey = object | symbol;
+export interface BdResolveOptions<TArgs extends readonly unknown[], TResult> {
+    /**
+     * Optional debug name.
+     *
+     * This is not used as the tracking key.
+     */
+    name?: string;
+    /**
+     * Advanced escape hatch.
+     *
+     * Usually you should not set this.
+     * By default, the controller instance itself is used as the work key.
+     */
+    workKey?: BdWorkKey;
+    args: () => TArgs;
+    enabled?: (args: TArgs) => boolean;
+    argsEqual?: (oldArgs: TArgs, newArgs: TArgs) => boolean;
+    autoRun?: boolean | 'afterUpdate';
+    resolve: (args: TArgs, context: BdResolveContext) => MaybePromise<TResult>;
+    commit?: (result: TResult, args: TArgs, context: BdResolveContext) => MaybePromise<void>;
+    onPending?: (args: TArgs, context: BdResolveContext) => MaybePromise<void>;
+    onDisabled?: (args: TArgs, context: BdResolveContext) => MaybePromise<void>;
+    onComplete?: (result: TResult, args: TArgs, context: BdResolveContext) => MaybePromise<void>;
+    onError?: (error: unknown, args: TArgs, context: BdResolveContext) => MaybePromise<void>;
+    onHookError?: (error: unknown, phase: BdResolveHookPhase) => void;
+    abortOnDisconnect?: boolean;
+}
+export declare class BdResolveController<TArgs extends readonly unknown[], TResult> implements ReactiveController {
+    private readonly host;
+    private readonly options;
+    status: BdResolveStatus;
+    value?: TResult;
+    error?: unknown;
+    readonly name: string;
+    private readonly _workKey;
+    private readonly _task;
+    private _activeRunId;
+    constructor(host: BdResolveHost, options: BdResolveOptions<TArgs, TResult>);
+    hostDisconnected(): void;
+    get litTaskStatus(): LitTaskStatus;
+    get pending(): boolean;
+    get complete(): boolean;
+    get disabled(): boolean;
+    get failed(): boolean;
+    /**
+     * Manual execution.
+     *
+     * Useful if options.autoRun === false.
+     */
+    run(args?: TArgs): Promise<TResult | undefined>;
+    /**
+     * Abort the current task.
+     *
+     * This also invalidates the current controller runId so an old async result
+     * cannot later commit stale data.
+     */
+    abort(reason?: unknown): void;
+    private _startRunId;
+    private _isCurrentRun;
+    private _run;
+    private _runDisabled;
+    private _runEnabled;
+    private _callHook;
+}
+export declare function throwIfAborted(signal: AbortSignal): void;

package/dist/src/controllers/controller.resolve.js

@@ -0,0 +1,205 @@
+import { Task, initialState } from '@lit/task';
+export class BdResolveController {
+    constructor(host, options) {
+        this.host = host;
+        this.options = options;
+        this.status = 'initial';
+        this._activeRunId = 0;
+        this.name =
+            options.name ??
+                'bd-resolve';
+        /**
+         * By default, each controller instance is its own unique work key.
+         * This allows the controller to manage its own work without risk of conflict.
+         */
+        this._workKey =
+            options.workKey ??
+                this;
+        host.addController(this);
+        this._task = new Task(host, {
+            args: options.args,
+            autoRun: options.autoRun ?? true,
+            argsEqual: options.argsEqual,
+            task: (args, { signal }) => {
+                const runId = this._startRunId();
+                const context = {
+                    signal,
+                    runId
+                };
+                const work = this._run(args, context);
+                return this.host.trackLocalWork(this._workKey, work);
+            }
+        });
+    }
+    hostDisconnected() {
+        if (this.options.abortOnDisconnect ?? true) {
+            this.abort(createAbortError('BdResolveController host disconnected.'));
+        }
+    }
+    get litTaskStatus() {
+        return this._task.status;
+    }
+    get pending() {
+        return this.status === 'pending';
+    }
+    get complete() {
+        return this.status === 'complete';
+    }
+    get disabled() {
+        return this.status === 'disabled';
+    }
+    get failed() {
+        return this.status === 'error';
+    }
+    /**
+     * Manual execution.
+     *
+     * Useful if options.autoRun === false.
+     */
+    async run(args) {
+        await this._task.run(args);
+        if (this.status === 'error') {
+            throw this.error;
+        }
+        return this.value;
+    }
+    /**
+     * Abort the current task.
+     *
+     * This also invalidates the current controller runId so an old async result
+     * cannot later commit stale data.
+     */
+    abort(reason) {
+        this._activeRunId += 1;
+        this._task.abort(reason ??
+            createAbortError(`${this.name} aborted.`));
+        this.status = 'initial';
+        this.value = undefined;
+        this.error = undefined;
+        /**
+         * Replace this work slot with a completed promise.
+         *
+         * This prevents updateComplete from being blocked forever by an obsolete
+         * task that ignores AbortSignal.
+         */
+        this.host.trackLocalWork(this._workKey, Promise.resolve(undefined));
+        this.host.requestUpdate();
+    }
+    _startRunId() {
+        this._activeRunId += 1;
+        return this._activeRunId;
+    }
+    _isCurrentRun(context) {
+        return context.runId === this._activeRunId;
+    }
+    async _run(args, context) {
+        try {
+            const enabled = this.options.enabled?.(args) ?? true;
+            if (!enabled) {
+                return await this._runDisabled(args, context);
+            }
+            return await this._runEnabled(args, context);
+        }
+        catch (error) {
+            if (context.signal.aborted ||
+                !this._isCurrentRun(context)) {
+                return initialState;
+            }
+            this.status = 'error';
+            this.error = error;
+            this.value = undefined;
+            this.host.requestUpdate();
+            await this._callHook('error', () => this.options.onError?.(error, args, context));
+            /**
+             * Re-throw so @lit/task also enters ERROR state.
+             */
+            throw error;
+        }
+    }
+    async _runDisabled(args, context) {
+        if (!this._isCurrentRun(context)) {
+            return initialState;
+        }
+        this.status = 'disabled';
+        this.value = undefined;
+        this.error = undefined;
+        this.host.requestUpdate();
+        throwIfAborted(context.signal);
+        if (!this._isCurrentRun(context)) {
+            return initialState;
+        }
+        await this._callHook('disabled', () => this.options.onDisabled?.(args, context));
+        throwIfAborted(context.signal);
+        if (!this._isCurrentRun(context)) {
+            return initialState;
+        }
+        this.host.requestUpdate();
+        return initialState;
+    }
+    async _runEnabled(args, context) {
+        if (!this._isCurrentRun(context)) {
+            return initialState;
+        }
+        this.status = 'pending';
+        this.value = undefined;
+        this.error = undefined;
+        this.host.requestUpdate();
+        throwIfAborted(context.signal);
+        if (!this._isCurrentRun(context)) {
+            return initialState;
+        }
+        await this._callHook('pending', () => this.options.onPending?.(args, context));
+        throwIfAborted(context.signal);
+        if (!this._isCurrentRun(context)) {
+            return initialState;
+        }
+        const result = await this.options.resolve(args, context);
+        throwIfAborted(context.signal);
+        if (!this._isCurrentRun(context)) {
+            return initialState;
+        }
+        await this.options.commit?.(result, args, context);
+        throwIfAborted(context.signal);
+        if (!this._isCurrentRun(context)) {
+            return initialState;
+        }
+        this.status = 'complete';
+        this.value = result;
+        this.error = undefined;
+        this.host.requestUpdate();
+        await this._callHook('complete', () => this.options.onComplete?.(result, args, context));
+        throwIfAborted(context.signal);
+        if (!this._isCurrentRun(context)) {
+            return initialState;
+        }
+        return result;
+    }
+    async _callHook(phase, callback) {
+        try {
+            await callback();
+        }
+        catch (error) {
+            this.options.onHookError?.(error, phase);
+        }
+    }
+}
+export function throwIfAborted(signal) {
+    if (!signal.aborted) {
+        return;
+    }
+    if (typeof signal.throwIfAborted === 'function') {
+        signal.throwIfAborted();
+        return;
+    }
+    throw (signal.reason ??
+        createAbortError('The operation was aborted.'));
+}
+function createAbortError(message) {
+    if (typeof DOMException === 'function') {
+        return new DOMException(message, 'AbortError');
+    }
+    const error = new Error(message);
+    error.name = 'AbortError';
+    return error;
+}
+//# sourceMappingURL=controller.resolve.js.map

package/dist/src/controllers/controller.resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.resolve.js","sourceRoot":"","sources":["../../../src/controllers/controller.resolve.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ReactiveController,\n  ReactiveControllerHost\n} from 'lit';\n\nimport {\n  Task,\n  initialState,\n  type TaskStatus as LitTaskStatus\n} from '@lit/task';\n\nexport type MaybePromise<T> = T | Promise<T>;\n\nexport type BdResolveStatus =\n  | 'initial'\n  | 'disabled'\n  | 'pending'\n  | 'complete'\n  | 'error';\n\nexport type BdResolveHookPhase =\n  | 'pending'\n  | 'disabled'\n  | 'complete'\n  | 'error';\n\nexport type BdResolveContext = Readonly<{\n  signal: AbortSignal;\n  runId : number;\n}>;\n\nexport interface BdResolveHost extends ReactiveControllerHost {\n  trackLocalWork<T>(\n    key: unknown,\n    work: PromiseLike<T>,\n  ): Promise<T>;\n}\n\nexport type BdWorkKey = object | symbol;\n\nexport interface BdResolveOptions<\n  TArgs extends readonly unknown[],\n  TResult\n> {\n  /**\n   * Optional debug name.\n   *\n   * This is not used as the tracking key.\n   */\n  name?: string;\n\n  /**\n   * Advanced escape hatch.\n   *\n   * Usually you should not set this.\n   * By default, the controller instance itself is used as the work key.\n   */\n  workKey?: BdWorkKey;\n\n  args: () => TArgs;\n\n  enabled?: (args: TArgs) => boolean;\n\n  argsEqual?: (\n    oldArgs: TArgs,\n    newArgs: TArgs\n  ) => boolean;\n\n  autoRun?: boolean | 'afterUpdate';\n\n  resolve: (\n    args: TArgs,\n    context: BdResolveContext\n  ) => MaybePromise<TResult>;\n\n  commit?: (\n    result: TResult,\n    args: TArgs,\n    context: BdResolveContext\n  ) => MaybePromise<void>;\n\n  onPending?: (\n    args: TArgs,\n    context: BdResolveContext\n  ) => MaybePromise<void>;\n\n  onDisabled?: (\n    args: TArgs,\n    context: BdResolveContext\n  ) => MaybePromise<void>;\n\n  onComplete?: (\n    result: TResult,\n    args: TArgs,\n    context: BdResolveContext\n  ) => MaybePromise<void>;\n\n  onError?: (\n    error: unknown,\n    args: TArgs,\n    context: BdResolveContext\n  ) => MaybePromise<void>;\n\n  onHookError?: (\n    error: unknown,\n    phase: BdResolveHookPhase\n  ) => void;\n\n  abortOnDisconnect?: boolean;\n}\n\nexport class BdResolveController<\n  TArgs extends readonly unknown[],\n  TResult\n> implements ReactiveController {\n  status: BdResolveStatus = 'initial';\n  value?: TResult;\n  error?: unknown;\n\n  readonly name: string;\n\n  private readonly _workKey: BdWorkKey;\n  private readonly _task   : Task<TArgs, TResult>;\n  private _activeRunId = 0;\n\n  constructor(\n    private readonly host: BdResolveHost,\n    private readonly options: BdResolveOptions<TArgs, TResult>\n  ) {\n    this.name =\n      options.name ??\n      'bd-resolve';\n\n    /**\n     * By default, each controller instance is its own unique work key.\n     * This allows the controller to manage its own work without risk of conflict.\n     */\n    this._workKey =\n      options.workKey ??\n      this;\n\n    host.addController(this);\n\n    this._task = new Task<TArgs, TResult>(host, {\n      args: options.args,\n\n      autoRun:\n        options.autoRun ?? true,\n\n      argsEqual:\n        options.argsEqual,\n\n      task: (args, { signal }) => {\n        const runId = this._startRunId();\n\n        const context: BdResolveContext = {\n          signal,\n          runId\n        };\n\n        const work = this._run(\n          args,\n          context\n        );\n\n        return this.host.trackLocalWork(\n          this._workKey,\n          work\n        );\n      }\n    });\n  }\n\n  hostDisconnected(): void {\n    if (this.options.abortOnDisconnect ?? true) {\n      this.abort(\n        createAbortError(\n          'BdResolveController host disconnected.'\n        )\n      );\n    }\n  }\n\n  get litTaskStatus(): LitTaskStatus {\n    return this._task.status;\n  }\n\n  get pending(): boolean {\n    return this.status === 'pending';\n  }\n\n  get complete(): boolean {\n    return this.status === 'complete';\n  }\n\n  get disabled(): boolean {\n    return this.status === 'disabled';\n  }\n\n  get failed(): boolean {\n    return this.status === 'error';\n  }\n\n  /**\n   * Manual execution.\n   *\n   * Useful if options.autoRun === false.\n   */\n  async run(\n    args?: TArgs\n  ): Promise<TResult | undefined> {\n    await this._task.run(args);\n\n    if (this.status === 'error') {\n      throw this.error;\n    }\n\n    return this.value;\n  }\n\n  /**\n   * Abort the current task.\n   *\n   * This also invalidates the current controller runId so an old async result\n   * cannot later commit stale data.\n   */\n  abort(reason?: unknown): void {\n    this._activeRunId += 1;\n\n    this._task.abort(\n      reason ??\n        createAbortError(\n          `${this.name} aborted.`\n        )\n    );\n\n    this.status = 'initial';\n    this.value = undefined;\n    this.error = undefined;\n\n    /**\n     * Replace this work slot with a completed promise.\n     *\n     * This prevents updateComplete from being blocked forever by an obsolete\n     * task that ignores AbortSignal.\n     */\n    this.host.trackLocalWork(\n      this._workKey,\n      Promise.resolve(undefined)\n    );\n\n    this.host.requestUpdate();\n  }\n\n  private _startRunId(): number {\n    this._activeRunId += 1;\n    return this._activeRunId;\n  }\n\n  private _isCurrentRun(\n    context: BdResolveContext\n  ): boolean {\n    return context.runId === this._activeRunId;\n  }\n\n  private async _run(\n    args: TArgs,\n    context: BdResolveContext\n  ): Promise<TResult | typeof initialState> {\n    try {\n      const enabled =\n        this.options.enabled?.(args) ?? true;\n\n      if (!enabled) {\n        return await this._runDisabled(\n          args,\n          context\n        );\n      }\n\n      return await this._runEnabled(\n        args,\n        context\n      );\n    } catch (error) {\n      if (\n        context.signal.aborted ||\n        !this._isCurrentRun(context)\n      ) {\n        return initialState;\n      }\n\n      this.status = 'error';\n      this.error = error;\n      this.value = undefined;\n      this.host.requestUpdate();\n\n      await this._callHook(\n        'error',\n        () =>\n          this.options.onError?.(\n            error,\n            args,\n            context\n          )\n      );\n\n      /**\n       * Re-throw so @lit/task also enters ERROR state.\n       */\n      throw error;\n    }\n  }\n\n  private async _runDisabled(\n    args: TArgs,\n    context: BdResolveContext\n  ): Promise<typeof initialState> {\n    if (!this._isCurrentRun(context)) {\n      return initialState;\n    }\n\n    this.status = 'disabled';\n    this.value = undefined;\n    this.error = undefined;\n    this.host.requestUpdate();\n\n    throwIfAborted(context.signal);\n\n    if (!this._isCurrentRun(context)) {\n      return initialState;\n    }\n\n    await this._callHook(\n      'disabled',\n      () =>\n        this.options.onDisabled?.(\n          args,\n          context\n        )\n    );\n\n    throwIfAborted(context.signal);\n\n    if (!this._isCurrentRun(context)) {\n      return initialState;\n    }\n\n    this.host.requestUpdate();\n\n    return initialState;\n  }\n\n  private async _runEnabled(\n    args: TArgs,\n    context: BdResolveContext\n  ): Promise<TResult | typeof initialState> {\n    if (!this._isCurrentRun(context)) {\n      return initialState;\n    }\n\n    this.status = 'pending';\n    this.value = undefined;\n    this.error = undefined;\n    this.host.requestUpdate();\n\n    throwIfAborted(context.signal);\n\n    if (!this._isCurrentRun(context)) {\n      return initialState;\n    }\n\n    await this._callHook(\n      'pending',\n      () =>\n        this.options.onPending?.(\n          args,\n          context\n        )\n    );\n\n    throwIfAborted(context.signal);\n\n    if (!this._isCurrentRun(context)) {\n      return initialState;\n    }\n\n    const result =\n      await this.options.resolve(\n        args,\n        context\n      );\n\n    throwIfAborted(context.signal);\n\n    if (!this._isCurrentRun(context)) {\n      return initialState;\n    }\n\n    await this.options.commit?.(\n      result,\n      args,\n      context\n    );\n\n    throwIfAborted(context.signal);\n\n    if (!this._isCurrentRun(context)) {\n      return initialState;\n    }\n\n    this.status = 'complete';\n    this.value = result;\n    this.error = undefined;\n    this.host.requestUpdate();\n\n    await this._callHook(\n      'complete',\n      () =>\n        this.options.onComplete?.(\n          result,\n          args,\n          context\n        )\n    );\n\n    throwIfAborted(context.signal);\n\n    if (!this._isCurrentRun(context)) {\n      return initialState;\n    }\n\n    return result;\n  }\n\n  private async _callHook(\n    phase: BdResolveHookPhase,\n    callback: () => MaybePromise<void>\n  ): Promise<void> {\n    try {\n      await callback();\n    } catch (error) {\n      this.options.onHookError?.(\n        error,\n        phase\n      );\n    }\n  }\n}\n\nexport function throwIfAborted(\n  signal: AbortSignal\n): void {\n  if (!signal.aborted) {\n    return;\n  }\n\n  if (typeof signal.throwIfAborted === 'function') {\n    signal.throwIfAborted();\n    return;\n  }\n\n  throw (\n    signal.reason ??\n    createAbortError(\n      'The operation was aborted.'\n    )\n  );\n}\n\nfunction createAbortError(\n  message: string\n): Error | DOMException {\n  if (typeof DOMException === 'function') {\n    return new DOMException(\n      message,\n      'AbortError'\n    );\n  }\n\n  const error = new Error(message);\n  error.name = 'AbortError';\n\n  return error;\n}"]}

package/dist/src/core/action-topology.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Action topology events.
+ *
+ * These describe STRUCTURE, not intent and not resolved state:
+ *
+ *   bd-action-connect / bd-action-disconnect
+ *     A native action element appeared / disappeared. Announced by
+ *     BdActionElementAdapter. Caught by the nearest bd node, which owns that
+ *     element's membership (same boundary that would catch bd-action-request).
+ *
+ *   bd-action-topology-changed
+ *     The set of action elements under some bd node changed. Bubbles up so
+ *     ancestors can bump their action revision and recompute.
+ *
+ * Topology must never be stored in BdScope. It is local node structure, read on
+ * demand by compute. Putting it in scope would break scope immutability and
+ * atomicity.
+ */
+import type { BdComputeScan } from '../compute/compute.scan.js';
+export declare const BD_ACTION_CONNECT_EVENT: "bd-action-connect";
+export declare const BD_ACTION_DISCONNECT_EVENT: "bd-action-disconnect";
+export declare const BD_ACTION_UPDATE_EVENT: "bd-action-update";
+export declare const BD_ACTION_TOPOLOGY_CHANGED_EVENT: "bd-action-topology-changed";
+/**
+ * Sent when an action element connects.
+ *
+ * The nearest bd node calls claim() so the adapter can later announce the
+ * disconnect directly to that owner, even after the element is detached from
+ * the DOM (a bubbling event on a detached element would never reach it).
+ */
+export type BdActionConnectDetail = Readonly<{
+    element: HTMLElement;
+    scan: BdComputeScan;
+    claim: (owner: EventTarget) => void;
+}>;
+export type BdActionDisconnectDetail = Readonly<{
+    element: HTMLElement;
+}>;
+export type BdActionUpdateDetail = Readonly<{
+    element: HTMLElement;
+    scan: BdComputeScan;
+}>;
+declare global {
+    interface HTMLElementEventMap {
+        [BD_ACTION_CONNECT_EVENT]: CustomEvent<BdActionConnectDetail>;
+        [BD_ACTION_DISCONNECT_EVENT]: CustomEvent<BdActionDisconnectDetail>;
+        [BD_ACTION_UPDATE_EVENT]: CustomEvent<BdActionUpdateDetail>;
+        [BD_ACTION_TOPOLOGY_CHANGED_EVENT]: CustomEvent<undefined>;
+    }
+}
+export declare function dispatchBdActionConnect(element: HTMLElement, scan: BdComputeScan, claim: (owner: EventTarget) => void): void;
+/**
+ * Announce a disconnect.
+ *
+ * target should be the claimed owner when available, because the element may
+ * already be detached from the DOM by the time the registry observes its
+ * removal. Dispatching on the retained owner guarantees the owning node hears
+ * it regardless of DOM connectivity.
+ */
+export declare function dispatchBdActionDisconnect(target: EventTarget, element: HTMLElement): void;
+export declare function dispatchBdActionUpdate(target: EventTarget, element: HTMLElement, scan: BdComputeScan): void;
+export declare function dispatchBdActionTopologyChanged(target: EventTarget): void;

package/dist/src/core/action-topology.js

@@ -0,0 +1,67 @@
+/**
+ * Action topology events.
+ *
+ * These describe STRUCTURE, not intent and not resolved state:
+ *
+ *   bd-action-connect / bd-action-disconnect
+ *     A native action element appeared / disappeared. Announced by
+ *     BdActionElementAdapter. Caught by the nearest bd node, which owns that
+ *     element's membership (same boundary that would catch bd-action-request).
+ *
+ *   bd-action-topology-changed
+ *     The set of action elements under some bd node changed. Bubbles up so
+ *     ancestors can bump their action revision and recompute.
+ *
+ * Topology must never be stored in BdScope. It is local node structure, read on
+ * demand by compute. Putting it in scope would break scope immutability and
+ * atomicity.
+ */
+export const BD_ACTION_CONNECT_EVENT = 'bd-action-connect';
+export const BD_ACTION_DISCONNECT_EVENT = 'bd-action-disconnect';
+export const BD_ACTION_UPDATE_EVENT = 'bd-action-update';
+export const BD_ACTION_TOPOLOGY_CHANGED_EVENT = 'bd-action-topology-changed';
+export function dispatchBdActionConnect(element, scan, claim) {
+    element.dispatchEvent(new CustomEvent(BD_ACTION_CONNECT_EVENT, {
+        bubbles: true,
+        composed: true,
+        detail: {
+            element,
+            scan,
+            claim
+        }
+    }));
+}
+/**
+ * Announce a disconnect.
+ *
+ * target should be the claimed owner when available, because the element may
+ * already be detached from the DOM by the time the registry observes its
+ * removal. Dispatching on the retained owner guarantees the owning node hears
+ * it regardless of DOM connectivity.
+ */
+export function dispatchBdActionDisconnect(target, element) {
+    target.dispatchEvent(new CustomEvent(BD_ACTION_DISCONNECT_EVENT, {
+        bubbles: true,
+        composed: true,
+        detail: {
+            element
+        }
+    }));
+}
+export function dispatchBdActionUpdate(target, element, scan) {
+    target.dispatchEvent(new CustomEvent(BD_ACTION_UPDATE_EVENT, {
+        bubbles: true,
+        composed: true,
+        detail: {
+            element,
+            scan
+        }
+    }));
+}
+export function dispatchBdActionTopologyChanged(target) {
+    target.dispatchEvent(new CustomEvent(BD_ACTION_TOPOLOGY_CHANGED_EVENT, {
+        bubbles: true,
+        composed: true
+    }));
+}
+//# sourceMappingURL=action-topology.js.map

package/dist/src/core/action-topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-topology.js","sourceRoot":"","sources":["../../../src/core/action-topology.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,CAAC,MAAM,uBAAuB,GAClC,mBAA4B,CAAC;AAE/B,MAAM,CAAC,MAAM,0BAA0B,GACrC,sBAA+B,CAAC;AAElC,MAAM,CAAC,MAAM,sBAAsB,GACjC,kBAA2B,CAAC;AAE9B,MAAM,CAAC,MAAM,gCAAgC,GAC3C,4BAAqC,CAAC;AAiCxC,MAAM,UAAU,uBAAuB,CACrC,OAAoB,EACpB,IAAmB,EACnB,KAAmC;IAEnC,OAAO,CAAC,aAAa,CACnB,IAAI,WAAW,CACb,uBAAuB,EACvB;QACE,OAAO,EAAG,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,MAAM,EAAI;YACR,OAAO;YACP,IAAI;YACJ,KAAK;SACN;KACF,CACF,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAmB,EACnB,OAAoB;IAEpB,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CACb,0BAA0B,EAC1B;QACE,OAAO,EAAG,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,MAAM,EAAI;YACR,OAAO;SACR;KACF,CACF,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAmB,EACnB,OAAoB,EACpB,IAAmB;IAEnB,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CACb,sBAAsB,EACtB;QACE,OAAO,EAAG,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,MAAM,EAAI;YACR,OAAO;YACP,IAAI;SACL;KACF,CACF,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,MAAmB;IAEnB,MAAM,CAAC,aAAa,CAClB,IAAI,WAAW,CACb,gCAAgC,EAChC;QACE,OAAO,EAAG,IAAI;QACd,QAAQ,EAAE,IAAI;KACf,CACF,CACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Action topology events.\n *\n * These describe STRUCTURE, not intent and not resolved state:\n *\n *   bd-action-connect / bd-action-disconnect\n *     A native action element appeared / disappeared. Announced by\n *     BdActionElementAdapter. Caught by the nearest bd node, which owns that\n *     element's membership (same boundary that would catch bd-action-request).\n *\n *   bd-action-topology-changed\n *     The set of action elements under some bd node changed. Bubbles up so\n *     ancestors can bump their action revision and recompute.\n *\n * Topology must never be stored in BdScope. It is local node structure, read on\n * demand by compute. Putting it in scope would break scope immutability and\n * atomicity.\n */\n\nimport type { BdComputeScan } from '@/compute/compute.scan.js';\n\nexport const BD_ACTION_CONNECT_EVENT =\n  'bd-action-connect' as const;\n\nexport const BD_ACTION_DISCONNECT_EVENT =\n  'bd-action-disconnect' as const;\n\nexport const BD_ACTION_UPDATE_EVENT =\n  'bd-action-update' as const;\n\nexport const BD_ACTION_TOPOLOGY_CHANGED_EVENT =\n  'bd-action-topology-changed' as const;\n\n/**\n * Sent when an action element connects.\n *\n * The nearest bd node calls claim() so the adapter can later announce the\n * disconnect directly to that owner, even after the element is detached from\n * the DOM (a bubbling event on a detached element would never reach it).\n */\nexport type BdActionConnectDetail = Readonly<{\n  element: HTMLElement;\n  scan   : BdComputeScan;\n  claim  : (owner: EventTarget) => void;\n}>;\n\nexport type BdActionDisconnectDetail = Readonly<{\n  element: HTMLElement;\n}>;\n\nexport type BdActionUpdateDetail = Readonly<{\n  element: HTMLElement;\n  scan   : BdComputeScan;\n}>;\n\ndeclare global {\n  interface HTMLElementEventMap {\n    [BD_ACTION_CONNECT_EVENT]         : CustomEvent<BdActionConnectDetail>;\n    [BD_ACTION_DISCONNECT_EVENT]      : CustomEvent<BdActionDisconnectDetail>;\n    [BD_ACTION_UPDATE_EVENT]          : CustomEvent<BdActionUpdateDetail>;\n    [BD_ACTION_TOPOLOGY_CHANGED_EVENT]: CustomEvent<undefined>;\n  }\n}\n\nexport function dispatchBdActionConnect(\n  element: HTMLElement,\n  scan: BdComputeScan,\n  claim: (owner: EventTarget) => void\n): void {\n  element.dispatchEvent(\n    new CustomEvent<BdActionConnectDetail>(\n      BD_ACTION_CONNECT_EVENT,\n      {\n        bubbles : true,\n        composed: true,\n        detail  : {\n          element,\n          scan,\n          claim\n        }\n      }\n    )\n  );\n}\n\n/**\n * Announce a disconnect.\n *\n * target should be the claimed owner when available, because the element may\n * already be detached from the DOM by the time the registry observes its\n * removal. Dispatching on the retained owner guarantees the owning node hears\n * it regardless of DOM connectivity.\n */\nexport function dispatchBdActionDisconnect(\n  target: EventTarget,\n  element: HTMLElement\n): void {\n  target.dispatchEvent(\n    new CustomEvent<BdActionDisconnectDetail>(\n      BD_ACTION_DISCONNECT_EVENT,\n      {\n        bubbles : true,\n        composed: true,\n        detail  : {\n          element\n        }\n      }\n    )\n  );\n}\n\nexport function dispatchBdActionUpdate(\n  target: EventTarget,\n  element: HTMLElement,\n  scan: BdComputeScan\n): void {\n  target.dispatchEvent(\n    new CustomEvent<BdActionUpdateDetail>(\n      BD_ACTION_UPDATE_EVENT,\n      {\n        bubbles : true,\n        composed: true,\n        detail  : {\n          element,\n          scan\n        }\n      }\n    )\n  );\n}\n\nexport function dispatchBdActionTopologyChanged(\n  target: EventTarget\n): void {\n  target.dispatchEvent(\n    new CustomEvent<undefined>(\n      BD_ACTION_TOPOLOGY_CHANGED_EVENT,\n      {\n        bubbles : true,\n        composed: true\n      }\n    )\n  );\n}\n"]}

package/dist/src/core/actions.d.ts

@@ -0,0 +1,64 @@
+export type UpdateByDelta = Readonly<{
+    type: 'devices' | 'subscription';
+    delta: number | 'next' | 'prev';
+    min?: number;
+    max?: number;
+    useAsValue?: boolean;
+    /**
+     * Optional identifier for the action source element
+     * (`data-store-event-id`). Consumers filter against this id via the
+     * `ignore-events` attribute on `bd-*` provider elements.
+     */
+    eventId?: string;
+}>;
+export type Action = Readonly<{
+    id?: string;
+    campaign?: string;
+    bundle?: boolean;
+    devices?: number;
+    subscription?: number;
+    /**
+     * Optional identifier for the action source element
+     * (`data-store-event-id`). Consumers filter against this id via the
+     * `ignore-events` attribute on `bd-*` provider elements.
+     */
+    eventId?: string;
+}>;
+export type BdActionCommand = Readonly<{
+    kind: 'update-by-delta';
+    update: UpdateByDelta;
+}> | Readonly<{
+    kind: 'set-action';
+    action: Action;
+}>;
+export type BdTransition = Readonly<{
+    seq: number;
+    command: BdActionCommand;
+    originNode?: EventTarget | null;
+    createdAt: number;
+}>;
+export declare const BD_ACTION_REQUEST_EVENT: "bd-action-request";
+export type BdActionRequestDetail = Readonly<{
+    command: BdActionCommand;
+}>;
+declare global {
+    interface HTMLElementEventMap {
+        [BD_ACTION_REQUEST_EVENT]: CustomEvent<BdActionRequestDetail>;
+    }
+}
+export declare function createBdTransition(detail: BdActionRequestDetail, originNode?: EventTarget | null): BdTransition;
+export declare function dispatchBdActionRequest(eventTarget: EventTarget, detail: BdActionRequestDetail): boolean;
+export declare function isBdActionRequestEvent(event: Event): event is CustomEvent<BdActionRequestDetail>;
+/**
+ * Pulls the optional `eventId` off the command carried by a transition.
+ *
+ * `eventId` is set on the action element via `data-store-event-id="…"` and
+ * is the matching key for the `ignore-events="…"` attribute on `bd-*`
+ * provider elements. Returns `undefined` for commands that did not declare
+ * one.
+ */
+export declare function getCommandEventId(command: BdActionCommand): string | undefined;
+/**
+ * Convenience wrapper around {@link getCommandEventId} for transitions.
+ */
+export declare function getTransitionEventId(transition: BdTransition): string | undefined;

package/dist/src/core/actions.js

@@ -0,0 +1,47 @@
+export const BD_ACTION_REQUEST_EVENT = 'bd-action-request';
+let bdTransitionSeq = 0;
+export function createBdTransition(detail, originNode) {
+    return {
+        seq: ++bdTransitionSeq,
+        command: detail.command,
+        originNode,
+        createdAt: Date.now()
+    };
+}
+export function dispatchBdActionRequest(eventTarget, detail) {
+    return eventTarget.dispatchEvent(new CustomEvent(BD_ACTION_REQUEST_EVENT, {
+        bubbles: true,
+        composed: true,
+        cancelable: true,
+        detail
+    }));
+}
+export function isBdActionRequestEvent(event) {
+    if (event.type !== BD_ACTION_REQUEST_EVENT) {
+        return false;
+    }
+    const detail = event.detail;
+    return (typeof detail === 'object' &&
+        detail !== null &&
+        'command' in detail);
+}
+/**
+ * Pulls the optional `eventId` off the command carried by a transition.
+ *
+ * `eventId` is set on the action element via `data-store-event-id="…"` and
+ * is the matching key for the `ignore-events="…"` attribute on `bd-*`
+ * provider elements. Returns `undefined` for commands that did not declare
+ * one.
+ */
+export function getCommandEventId(command) {
+    return command.kind === 'set-action'
+        ? command.action.eventId
+        : command.update.eventId;
+}
+/**
+ * Convenience wrapper around {@link getCommandEventId} for transitions.
+ */
+export function getTransitionEventId(transition) {
+    return getCommandEventId(transition.command);
+}
+//# sourceMappingURL=actions.js.map

package/dist/src/core/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/core/actions.ts"],"names":[],"mappings":"AA6CA,MAAM,CAAC,MAAM,uBAAuB,GAClC,mBAA4B,CAAC;AAY/B,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB,MAAM,UAAU,kBAAkB,CAChC,MAA6B,EAC7B,UAA+B;IAE/B,OAAO;QACL,GAAG,EAAQ,EAAE,eAAe;QAC5B,OAAO,EAAI,MAAM,CAAC,OAAO;QACzB,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,WAAwB,EACxB,MAA6B;IAE7B,OAAO,WAAW,CAAC,aAAa,CAC9B,IAAI,WAAW,CACb,uBAAuB,EACvB;QACE,OAAO,EAAK,IAAI;QAChB,QAAQ,EAAI,IAAI;QAChB,UAAU,EAAE,IAAI;QAChB,MAAM;KACP,CACF,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAY;IAEZ,IAAI,KAAK,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAI,KAA8B,CAAC,MAAM,CAAC;IAEtD,OAAO,CACL,OAAO,MAAM,KAAK,QAAQ;QAC1B,MAAM,KAAK,IAAI;QACf,SAAS,IAAI,MAAM,CACpB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAwB;IAExB,OAAO,OAAO,CAAC,IAAI,KAAK,YAAY;QAClC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO;QACxB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAwB;IAExB,OAAO,iBAAiB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC","sourcesContent":["export type UpdateByDelta = Readonly<{\n  type       : 'devices' | 'subscription';\n  delta      : number | 'next' | 'prev';\n  min?       : number;\n  max?       : number;\n  useAsValue?: boolean;\n  /**\n   * Optional identifier for the action source element\n   * (`data-store-event-id`). Consumers filter against this id via the\n   * `ignore-events` attribute on `bd-*` provider elements.\n   */\n  eventId?   : string;\n}>;\n\nexport type Action = Readonly<{\n  id?          : string;\n  campaign?    : string;\n  bundle?      : boolean;\n  devices?     : number;\n  subscription?: number;\n  /**\n   * Optional identifier for the action source element\n   * (`data-store-event-id`). Consumers filter against this id via the\n   * `ignore-events` attribute on `bd-*` provider elements.\n   */\n  eventId?     : string;\n}>;\n\nexport type BdActionCommand =\n  | Readonly<{\n    kind  : 'update-by-delta';\n    update: UpdateByDelta;\n  }>\n  | Readonly<{\n    kind  : 'set-action';\n    action: Action;\n  }>;\n\nexport type BdTransition = Readonly<{\n  seq        : number;\n  command    : BdActionCommand;\n  originNode?: EventTarget | null;\n  createdAt  : number;\n}>;\n\nexport const BD_ACTION_REQUEST_EVENT =\n  'bd-action-request' as const;\n\nexport type BdActionRequestDetail = Readonly<{\n  command: BdActionCommand;\n}>;\n\ndeclare global {\n  interface HTMLElementEventMap {\n    [BD_ACTION_REQUEST_EVENT]: CustomEvent<BdActionRequestDetail>;\n  }\n}\n\nlet bdTransitionSeq = 0;\n\nexport function createBdTransition(\n  detail: BdActionRequestDetail,\n  originNode?: EventTarget | null\n): BdTransition {\n  return {\n    seq      : ++bdTransitionSeq,\n    command  : detail.command,\n    originNode,\n    createdAt: Date.now()\n  };\n}\n\nexport function dispatchBdActionRequest(\n  eventTarget: EventTarget,\n  detail: BdActionRequestDetail\n): boolean {\n  return eventTarget.dispatchEvent(\n    new CustomEvent<BdActionRequestDetail>(\n      BD_ACTION_REQUEST_EVENT,\n      {\n        bubbles   : true,\n        composed  : true,\n        cancelable: true,\n        detail\n      }\n    )\n  );\n}\n\nexport function isBdActionRequestEvent(\n  event: Event\n): event is CustomEvent<BdActionRequestDetail> {\n  if (event.type !== BD_ACTION_REQUEST_EVENT) {\n    return false;\n  }\n\n  const detail = (event as CustomEvent<unknown>).detail;\n\n  return (\n    typeof detail === 'object' &&\n    detail !== null &&\n    'command' in detail\n  );\n}\n\n/**\n * Pulls the optional `eventId` off the command carried by a transition.\n *\n * `eventId` is set on the action element via `data-store-event-id=\"…\"` and\n * is the matching key for the `ignore-events=\"…\"` attribute on `bd-*`\n * provider elements. Returns `undefined` for commands that did not declare\n * one.\n */\nexport function getCommandEventId(\n  command: BdActionCommand\n): string | undefined {\n  return command.kind === 'set-action'\n    ? command.action.eventId\n    : command.update.eventId;\n}\n\n/**\n * Convenience wrapper around {@link getCommandEventId} for transitions.\n */\nexport function getTransitionEventId(\n  transition: BdTransition\n): string | undefined {\n  return getCommandEventId(transition.command);\n}\n"]}