@repobit/dex-store-elements 1.7.3 → 2.0.0

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

@@ -0,0 +1,110 @@
+import type { ReactiveController } from 'lit';
+import { type BdActionRequestDetail, type BdTransition } from '../core/actions.js';
+import { type BdResolveContext, type BdResolveHookPhase, type BdResolveHost, type BdResolveStatus, type BdWorkKey, type MaybePromise } from './controller.resolve.js';
+export type BdActionResolveTransitionSource = 'local' | 'parent';
+export type BdActionResolveContext = Readonly<{
+    /**
+     * The transition passed to derive/resolve/commit.
+     *
+     * This is only set for a fresh transition. Once the controller marks a
+     * transition committed, the same transition is suppressed from future args.
+     */
+    transition?: BdTransition;
+    transitionSeq?: number;
+    transitionSource?: BdActionResolveTransitionSource;
+    freshTransition: boolean;
+}>;
+export interface BdActionResolveHost extends BdResolveHost, EventTarget {
+}
+export interface BdActionResolveOptions<TArgs extends readonly unknown[], TDerivedArgs extends readonly unknown[], TResult> {
+    name?: string;
+    workKey?: BdWorkKey;
+    /**
+     * Base node inputs. Keep this close to @lit/task naming.
+     *
+     * Examples:
+     *   () => [this.parentScope, this.devices, this.subscription] as const
+     */
+    args: () => TArgs;
+    /**
+     * Optional downward transition source, usually parentScope.transition.
+     *
+     * Local bd-action-request events captured by this controller are considered
+     * alongside this transition, with the latest seq winning.
+     */
+    transition?: (args: TArgs) => BdTransition | undefined;
+    /**
+     * Converts base args + a fresh transition into the actual resolver args.
+     *
+     * This should be pure. It must not publish scope or mutate host props.
+     */
+    derive: (args: TArgs, context: BdActionResolveContext) => TDerivedArgs;
+    enabled?: (args: TDerivedArgs, context: BdActionResolveContext) => boolean;
+    argsEqual?: (oldArgs: TDerivedArgs, newArgs: TDerivedArgs) => boolean;
+    autoRun?: boolean | 'afterUpdate';
+    resolve: (args: TDerivedArgs, resolveContext: BdResolveContext, actionContext: BdActionResolveContext) => MaybePromise<TResult>;
+    commit?: (result: TResult, args: TDerivedArgs, resolveContext: BdResolveContext, actionContext: BdActionResolveContext) => MaybePromise<void>;
+    onPending?: (args: TDerivedArgs, resolveContext: BdResolveContext, actionContext: BdActionResolveContext) => MaybePromise<void>;
+    onDisabled?: (args: TDerivedArgs, resolveContext: BdResolveContext, actionContext: BdActionResolveContext) => MaybePromise<void>;
+    onComplete?: (result: TResult, args: TDerivedArgs, resolveContext: BdResolveContext, actionContext: BdActionResolveContext) => MaybePromise<void>;
+    onError?: (error: unknown, args: TDerivedArgs, resolveContext: BdResolveContext, actionContext: BdActionResolveContext) => MaybePromise<void>;
+    onHookError?: (error: unknown, phase: BdResolveHookPhase) => void;
+    abortOnDisconnect?: boolean;
+    /**
+     * If false, this controller only consumes transitions supplied by options.transition.
+     */
+    captureActions?: boolean;
+    createTransition?: (detail: BdActionRequestDetail, event: CustomEvent<BdActionRequestDetail>) => BdTransition;
+    /**
+     * Optional predicate consulted for every transition candidate (both
+     * local `bd-action-request` events and parent cascades).
+     *
+     * Return `false` to drop the candidate; the controller will not feed it
+     * into `derive` / `resolve` / `commit`. The host typically uses this to
+     * honour the `ignore-events` and `ignore-events-parent` attributes on
+     * `bd-*` provider elements.
+     */
+    filterTransition?: (candidate: TransitionCandidate) => boolean;
+}
+type TransitionCandidate = Readonly<{
+    transition: BdTransition;
+    source: BdActionResolveTransitionSource;
+}>;
+/**
+ * Node workflow controller for the common bd runtime pattern:
+ *
+ *   base args + fresh transition -> derived resolver args
+ *   enabled -> resolve -> commit
+ *   mark transition committed only after successful commit
+ *
+ * It keeps raw DOM requests out of node code and keeps transition seq
+ * bookkeeping out of every concrete resolver.
+ */
+export declare class BdActionResolveController<TArgs extends readonly unknown[], TDerivedArgs extends readonly unknown[], TResult> implements ReactiveController {
+    private readonly host;
+    private readonly options;
+    private readonly _resolver;
+    private _localTransition?;
+    private _lastCommittedTransitionSeq;
+    private _listening;
+    constructor(host: BdActionResolveHost, options: BdActionResolveOptions<TArgs, TDerivedArgs, TResult>);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    get status(): BdResolveStatus;
+    get value(): TResult | undefined;
+    get error(): unknown;
+    get pending(): boolean;
+    get complete(): boolean;
+    get disabled(): boolean;
+    get failed(): boolean;
+    get localTransition(): BdTransition | undefined;
+    run(): Promise<TResult | undefined>;
+    abort(reason?: unknown): void;
+    private _args;
+    private _createActionContext;
+    private _selectTransitionCandidate;
+    private _argsEqual;
+    private _markTransitionCommitted;
+    private readonly _onActionRequest;
+}
+export {};

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

@@ -0,0 +1,203 @@
+import { BD_ACTION_REQUEST_EVENT, createBdTransition, isBdActionRequestEvent } from '../core/actions.js';
+import { BdResolveController } from './controller.resolve.js';
+/**
+ * Node workflow controller for the common bd runtime pattern:
+ *
+ *   base args + fresh transition -> derived resolver args
+ *   enabled -> resolve -> commit
+ *   mark transition committed only after successful commit
+ *
+ * It keeps raw DOM requests out of node code and keeps transition seq
+ * bookkeeping out of every concrete resolver.
+ */
+export class BdActionResolveController {
+    constructor(host, options) {
+        this.host = host;
+        this.options = options;
+        this._lastCommittedTransitionSeq = 0;
+        this._listening = false;
+        this._onActionRequest = (event) => {
+            if (!isBdActionRequestEvent(event)) {
+                return;
+            }
+            event.preventDefault();
+            event.stopPropagation();
+            const transition = this.options.createTransition?.(event.detail, event) ??
+                createBdTransition(event.detail, event.target);
+            const filter = this.options.filterTransition;
+            if (filter &&
+                !filter({
+                    transition,
+                    source: 'local'
+                })) {
+                return;
+            }
+            this._localTransition = transition;
+            this.host.requestUpdate();
+        };
+        host.addController(this);
+        this._resolver = new BdResolveController(host, {
+            name: options.name,
+            workKey: options.workKey,
+            autoRun: options.autoRun,
+            abortOnDisconnect: options.abortOnDisconnect,
+            args: () => this._args(),
+            argsEqual: (oldArgs, newArgs) => this._argsEqual(oldArgs, newArgs),
+            enabled: ([args, context]) => options.enabled?.(args, context) ?? true,
+            resolve: ([args, actionContext], resolveContext) => options.resolve(args, resolveContext, actionContext),
+            commit: async (result, [args, actionContext], resolveContext) => {
+                const commitResult = options.commit?.(result, args, resolveContext, actionContext);
+                if (isPromiseLike(commitResult)) {
+                    await commitResult;
+                }
+                this._markTransitionCommitted(actionContext);
+            },
+            onPending: ([args, actionContext], resolveContext) => options.onPending?.(args, resolveContext, actionContext),
+            onDisabled: ([args, actionContext], resolveContext) => options.onDisabled?.(args, resolveContext, actionContext),
+            onComplete: (result, [args, actionContext], resolveContext) => options.onComplete?.(result, args, resolveContext, actionContext),
+            onError: (error, [args, actionContext], resolveContext) => options.onError?.(error, args, resolveContext, actionContext),
+            onHookError: options.onHookError
+        });
+    }
+    hostConnected() {
+        if (this.options.captureActions === false) {
+            return;
+        }
+        if (this._listening) {
+            return;
+        }
+        this.host.addEventListener(BD_ACTION_REQUEST_EVENT, this._onActionRequest);
+        this._listening = true;
+    }
+    hostDisconnected() {
+        if (!this._listening) {
+            return;
+        }
+        this.host.removeEventListener(BD_ACTION_REQUEST_EVENT, this._onActionRequest);
+        this._listening = false;
+    }
+    get status() {
+        return this._resolver.status;
+    }
+    get value() {
+        return this._resolver.value;
+    }
+    get error() {
+        return this._resolver.error;
+    }
+    get pending() {
+        return this._resolver.pending;
+    }
+    get complete() {
+        return this._resolver.complete;
+    }
+    get disabled() {
+        return this._resolver.disabled;
+    }
+    get failed() {
+        return this._resolver.failed;
+    }
+    get localTransition() {
+        return this._localTransition;
+    }
+    run() {
+        return this._resolver.run();
+    }
+    abort(reason) {
+        this._localTransition = undefined;
+        this._resolver.abort(reason);
+    }
+    _args() {
+        const baseArgs = this.options.args();
+        const context = this._createActionContext(baseArgs);
+        const derivedArgs = this.options.derive(baseArgs, context);
+        return [
+            derivedArgs,
+            context
+        ];
+    }
+    _createActionContext(args) {
+        const candidate = this._selectTransitionCandidate(args);
+        if (!candidate ||
+            candidate.transition.seq <= this._lastCommittedTransitionSeq) {
+            return {
+                freshTransition: false
+            };
+        }
+        return {
+            transition: candidate.transition,
+            transitionSeq: candidate.transition.seq,
+            transitionSource: candidate.source,
+            freshTransition: true
+        };
+    }
+    _selectTransitionCandidate(args) {
+        const filter = this.options.filterTransition;
+        const localCandidate = this._localTransition
+            ? {
+                transition: this._localTransition,
+                source: 'local'
+            }
+            : undefined;
+        const parentTransition = this.options.transition?.(args);
+        const parentCandidate = parentTransition
+            ? {
+                transition: parentTransition,
+                source: 'parent'
+            }
+            : undefined;
+        const candidates = [];
+        if (localCandidate && (!filter || filter(localCandidate))) {
+            candidates.push(localCandidate);
+        }
+        if (parentCandidate && (!filter || filter(parentCandidate))) {
+            candidates.push(parentCandidate);
+        }
+        if (candidates.length === 0) {
+            return undefined;
+        }
+        return candidates.reduce((latest, current) => current.transition.seq >= latest.transition.seq ? current : latest);
+    }
+    _argsEqual(oldArgs, newArgs) {
+        const [oldDerivedArgs, oldContext] = oldArgs;
+        const [newDerivedArgs, newContext] = newArgs;
+        if (newContext.freshTransition &&
+            newContext.transitionSeq !== oldContext.transitionSeq) {
+            return false;
+        }
+        return (this.options.argsEqual?.(oldDerivedArgs, newDerivedArgs) ??
+            shallowArrayEqual(oldDerivedArgs, newDerivedArgs));
+    }
+    _markTransitionCommitted(context) {
+        const transition = context.transition;
+        if (!transition || !context.freshTransition) {
+            return;
+        }
+        this._lastCommittedTransitionSeq = Math.max(this._lastCommittedTransitionSeq, transition.seq);
+        if (this._localTransition === transition) {
+            this._localTransition = undefined;
+        }
+        this.host.requestUpdate();
+    }
+}
+function shallowArrayEqual(oldArgs, newArgs) {
+    if (oldArgs === newArgs) {
+        return true;
+    }
+    if (oldArgs.length !== newArgs.length) {
+        return false;
+    }
+    for (let index = 0; index < oldArgs.length; index += 1) {
+        if (!Object.is(oldArgs[index], newArgs[index])) {
+            return false;
+        }
+    }
+    return true;
+}
+function isPromiseLike(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'then' in value &&
+        typeof value.then === 'function');
+}
+//# sourceMappingURL=controller.action-resolve.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller.action-resolve.js","sourceRoot":"","sources":["../../../src/controllers/controller.action-resolve.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ReactiveController } from 'lit';\n\nimport {\n  BD_ACTION_REQUEST_EVENT,\n  createBdTransition,\n  isBdActionRequestEvent,\n  type BdActionRequestDetail,\n  type BdTransition\n} from '@/core/actions.js';\nimport {\n  BdResolveController,\n  type BdResolveContext,\n  type BdResolveHookPhase,\n  type BdResolveHost,\n  type BdResolveStatus,\n  type BdWorkKey,\n  type MaybePromise\n} from './controller.resolve.js';\n\nexport type BdActionResolveTransitionSource =\n  | 'local'\n  | 'parent';\n\nexport type BdActionResolveContext = Readonly<{\n  /**\n   * The transition passed to derive/resolve/commit.\n   *\n   * This is only set for a fresh transition. Once the controller marks a\n   * transition committed, the same transition is suppressed from future args.\n   */\n  transition?: BdTransition;\n\n  transitionSeq?   : number;\n  transitionSource?: BdActionResolveTransitionSource;\n  freshTransition  : boolean;\n}>;\n\nexport interface BdActionResolveHost extends BdResolveHost, EventTarget {}\n\nexport interface BdActionResolveOptions<\n  TArgs extends readonly unknown[],\n  TDerivedArgs extends readonly unknown[],\n  TResult\n> {\n  name?   : string;\n  workKey?: BdWorkKey;\n\n  /**\n   * Base node inputs. Keep this close to @lit/task naming.\n   *\n   * Examples:\n   *   () => [this.parentScope, this.devices, this.subscription] as const\n   */\n  args: () => TArgs;\n\n  /**\n   * Optional downward transition source, usually parentScope.transition.\n   *\n   * Local bd-action-request events captured by this controller are considered\n   * alongside this transition, with the latest seq winning.\n   */\n  transition?: (args: TArgs) => BdTransition | undefined;\n\n  /**\n   * Converts base args + a fresh transition into the actual resolver args.\n   *\n   * This should be pure. It must not publish scope or mutate host props.\n   */\n  derive: (\n    args: TArgs,\n    context: BdActionResolveContext\n  ) => TDerivedArgs;\n\n  enabled?: (\n    args: TDerivedArgs,\n    context: BdActionResolveContext\n  ) => boolean;\n\n  argsEqual?: (\n    oldArgs: TDerivedArgs,\n    newArgs: TDerivedArgs\n  ) => boolean;\n\n  autoRun?: boolean | 'afterUpdate';\n\n  resolve: (\n    args: TDerivedArgs,\n    resolveContext: BdResolveContext,\n    actionContext: BdActionResolveContext\n  ) => MaybePromise<TResult>;\n\n  commit?: (\n    result: TResult,\n    args: TDerivedArgs,\n    resolveContext: BdResolveContext,\n    actionContext: BdActionResolveContext\n  ) => MaybePromise<void>;\n\n  onPending?: (\n    args: TDerivedArgs,\n    resolveContext: BdResolveContext,\n    actionContext: BdActionResolveContext\n  ) => MaybePromise<void>;\n\n  onDisabled?: (\n    args: TDerivedArgs,\n    resolveContext: BdResolveContext,\n    actionContext: BdActionResolveContext\n  ) => MaybePromise<void>;\n\n  onComplete?: (\n    result: TResult,\n    args: TDerivedArgs,\n    resolveContext: BdResolveContext,\n    actionContext: BdActionResolveContext\n  ) => MaybePromise<void>;\n\n  onError?: (\n    error: unknown,\n    args: TDerivedArgs,\n    resolveContext: BdResolveContext,\n    actionContext: BdActionResolveContext\n  ) => MaybePromise<void>;\n\n  onHookError?: (\n    error: unknown,\n    phase: BdResolveHookPhase\n  ) => void;\n\n  abortOnDisconnect?: boolean;\n\n  /**\n   * If false, this controller only consumes transitions supplied by options.transition.\n   */\n  captureActions?: boolean;\n\n  createTransition?: (\n    detail: BdActionRequestDetail,\n    event: CustomEvent<BdActionRequestDetail>\n  ) => BdTransition;\n\n  /**\n   * Optional predicate consulted for every transition candidate (both\n   * local `bd-action-request` events and parent cascades).\n   *\n   * Return `false` to drop the candidate; the controller will not feed it\n   * into `derive` / `resolve` / `commit`. The host typically uses this to\n   * honour the `ignore-events` and `ignore-events-parent` attributes on\n   * `bd-*` provider elements.\n   */\n  filterTransition?: (\n    candidate: TransitionCandidate\n  ) => boolean;\n}\n\ntype BdActionResolveInternalArgs<\n  TDerivedArgs extends readonly unknown[]\n> = readonly [\n  args: TDerivedArgs,\n  context: BdActionResolveContext\n];\n\ntype TransitionCandidate = Readonly<{\n  transition: BdTransition;\n  source    : BdActionResolveTransitionSource;\n}>;\n\n/**\n * Node workflow controller for the common bd runtime pattern:\n *\n *   base args + fresh transition -> derived resolver args\n *   enabled -> resolve -> commit\n *   mark transition committed only after successful commit\n *\n * It keeps raw DOM requests out of node code and keeps transition seq\n * bookkeeping out of every concrete resolver.\n */\nexport class BdActionResolveController<\n  TArgs extends readonly unknown[],\n  TDerivedArgs extends readonly unknown[],\n  TResult\n> implements ReactiveController {\n  private readonly _resolver: BdResolveController<\n    BdActionResolveInternalArgs<TDerivedArgs>,\n    TResult\n  >;\n\n  private _localTransition?: BdTransition;\n  private _lastCommittedTransitionSeq = 0;\n  private _listening = false;\n\n  constructor(\n    private readonly host: BdActionResolveHost,\n    private readonly options:\n    BdActionResolveOptions<TArgs, TDerivedArgs, TResult>\n  ) {\n    host.addController(this);\n\n    this._resolver = new BdResolveController(host, {\n      name             : options.name,\n      workKey          : options.workKey,\n      autoRun          : options.autoRun,\n      abortOnDisconnect: options.abortOnDisconnect,\n      args             : () => this._args(),\n      argsEqual        : (oldArgs, newArgs) =>\n        this._argsEqual(\n          oldArgs,\n          newArgs\n        ),\n      enabled: ([args, context]) =>\n        options.enabled?.(\n          args,\n          context\n        ) ?? true,\n      resolve: ([args, actionContext], resolveContext) =>\n        options.resolve(\n          args,\n          resolveContext,\n          actionContext\n        ),\n      commit: async (\n        result,\n        [args, actionContext],\n        resolveContext\n      ) => {\n        const commitResult =\n          options.commit?.(\n            result,\n            args,\n            resolveContext,\n            actionContext\n          );\n\n        if (isPromiseLike(commitResult)) {\n          await commitResult;\n        }\n\n        this._markTransitionCommitted(actionContext);\n      },\n      onPending: ([args, actionContext], resolveContext) =>\n        options.onPending?.(\n          args,\n          resolveContext,\n          actionContext\n        ),\n      onDisabled: ([args, actionContext], resolveContext) =>\n        options.onDisabled?.(\n          args,\n          resolveContext,\n          actionContext\n        ),\n      onComplete: (\n        result,\n        [args, actionContext],\n        resolveContext\n      ) =>\n        options.onComplete?.(\n          result,\n          args,\n          resolveContext,\n          actionContext\n        ),\n      onError: (\n        error,\n        [args, actionContext],\n        resolveContext\n      ) =>\n        options.onError?.(\n          error,\n          args,\n          resolveContext,\n          actionContext\n        ),\n      onHookError: options.onHookError\n    });\n  }\n\n  hostConnected(): void {\n    if (this.options.captureActions === false) {\n      return;\n    }\n\n    if (this._listening) {\n      return;\n    }\n\n    this.host.addEventListener(\n      BD_ACTION_REQUEST_EVENT,\n      this._onActionRequest as EventListener\n    );\n\n    this._listening = true;\n  }\n\n  hostDisconnected(): void {\n    if (!this._listening) {\n      return;\n    }\n\n    this.host.removeEventListener(\n      BD_ACTION_REQUEST_EVENT,\n      this._onActionRequest as EventListener\n    );\n\n    this._listening = false;\n  }\n\n  get status(): BdResolveStatus {\n    return this._resolver.status;\n  }\n\n  get value(): TResult | undefined {\n    return this._resolver.value;\n  }\n\n  get error(): unknown {\n    return this._resolver.error;\n  }\n\n  get pending(): boolean {\n    return this._resolver.pending;\n  }\n\n  get complete(): boolean {\n    return this._resolver.complete;\n  }\n\n  get disabled(): boolean {\n    return this._resolver.disabled;\n  }\n\n  get failed(): boolean {\n    return this._resolver.failed;\n  }\n\n  get localTransition(): BdTransition | undefined {\n    return this._localTransition;\n  }\n\n  run(): Promise<TResult | undefined> {\n    return this._resolver.run();\n  }\n\n  abort(reason?: unknown): void {\n    this._localTransition = undefined;\n    this._resolver.abort(reason);\n  }\n\n  private _args(): BdActionResolveInternalArgs<TDerivedArgs> {\n    const baseArgs =\n      this.options.args();\n\n    const context =\n      this._createActionContext(baseArgs);\n\n    const derivedArgs =\n      this.options.derive(\n        baseArgs,\n        context\n      );\n\n    return [\n      derivedArgs,\n      context\n    ] as const;\n  }\n\n  private _createActionContext(\n    args: TArgs\n  ): BdActionResolveContext {\n    const candidate =\n      this._selectTransitionCandidate(args);\n\n    if (\n      !candidate ||\n      candidate.transition.seq <= this._lastCommittedTransitionSeq\n    ) {\n      return {\n        freshTransition: false\n      };\n    }\n\n    return {\n      transition      : candidate.transition,\n      transitionSeq   : candidate.transition.seq,\n      transitionSource: candidate.source,\n      freshTransition : true\n    };\n  }\n\n  private _selectTransitionCandidate(\n    args: TArgs\n  ): TransitionCandidate | undefined {\n    const filter = this.options.filterTransition;\n\n    const localCandidate =\n      this._localTransition\n        ? {\n          transition: this._localTransition,\n          source    : 'local' as const\n        }\n        : undefined;\n\n    const parentTransition =\n      this.options.transition?.(args);\n\n    const parentCandidate =\n      parentTransition\n        ? {\n          transition: parentTransition,\n          source    : 'parent' as const\n        }\n        : undefined;\n\n    const candidates: TransitionCandidate[] = [];\n\n    if (localCandidate && (!filter || filter(localCandidate))) {\n      candidates.push(localCandidate);\n    }\n\n    if (parentCandidate && (!filter || filter(parentCandidate))) {\n      candidates.push(parentCandidate);\n    }\n\n    if (candidates.length === 0) {\n      return undefined;\n    }\n\n    return candidates.reduce((latest, current) =>\n      current.transition.seq >= latest.transition.seq ? current : latest\n    );\n  }\n\n  private _argsEqual(\n    oldArgs: BdActionResolveInternalArgs<TDerivedArgs>,\n    newArgs: BdActionResolveInternalArgs<TDerivedArgs>\n  ): boolean {\n    const [oldDerivedArgs, oldContext] = oldArgs;\n    const [newDerivedArgs, newContext] = newArgs;\n\n    if (\n      newContext.freshTransition &&\n      newContext.transitionSeq !== oldContext.transitionSeq\n    ) {\n      return false;\n    }\n\n    return (\n      this.options.argsEqual?.(\n        oldDerivedArgs,\n        newDerivedArgs\n      ) ??\n      shallowArrayEqual(\n        oldDerivedArgs,\n        newDerivedArgs\n      )\n    );\n  }\n\n  private _markTransitionCommitted(\n    context: BdActionResolveContext\n  ): void {\n    const transition = context.transition;\n\n    if (!transition || !context.freshTransition) {\n      return;\n    }\n\n    this._lastCommittedTransitionSeq = Math.max(\n      this._lastCommittedTransitionSeq,\n      transition.seq\n    );\n\n    if (this._localTransition === transition) {\n      this._localTransition = undefined;\n    }\n\n    this.host.requestUpdate();\n  }\n\n  private readonly _onActionRequest = (\n    event: Event\n  ): void => {\n    if (!isBdActionRequestEvent(event)) {\n      return;\n    }\n\n    event.preventDefault();\n    event.stopPropagation();\n\n    const transition =\n      this.options.createTransition?.(\n        event.detail,\n        event\n      ) ??\n      createBdTransition(\n        event.detail,\n        event.target\n      );\n\n    const filter = this.options.filterTransition;\n\n    if (\n      filter &&\n      !filter({\n        transition,\n        source: 'local'\n      })\n    ) {\n      return;\n    }\n\n    this._localTransition = transition;\n\n    this.host.requestUpdate();\n  };\n}\n\nfunction shallowArrayEqual(\n  oldArgs: readonly unknown[],\n  newArgs: readonly unknown[]\n): boolean {\n  if (oldArgs === newArgs) {\n    return true;\n  }\n\n  if (oldArgs.length !== newArgs.length) {\n    return false;\n  }\n\n  for (let index = 0; index < oldArgs.length; index += 1) {\n    if (!Object.is(\n      oldArgs[index],\n      newArgs[index]\n    )) {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction isPromiseLike<T>(\n  value: MaybePromise<T> | undefined\n): value is Promise<T> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'then' in value &&\n    typeof value.then === 'function'\n  );\n}\n"]}

package/dist/src/controllers/controller.action-topology.d.ts

@@ -0,0 +1,59 @@
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import { type BdComputeScan } from '../compute/compute.scan.js';
+import type { ProductOption } from '@repobit/dex-store';
+export interface BdActionTopologyHost extends ReactiveControllerHost, EventTarget {
+    readonly topologyBoundary?: boolean;
+}
+/**
+ * Owns the set of native action elements that belong to a single bd node.
+ *
+ * Membership is fed incrementally by BdActionElementAdapter announcements, so
+ * no node ever rescans its DOM children. The nearest bd node catches
+ * bd-action-connect / bd-action-disconnect, exactly like bd-action-request, so
+ * an action's compute radius matches its runtime radius.
+ *
+ * Aggregation across the logical bd subtree is intentionally NOT done here. The
+ * owning element walks its bd children (which it has access to) and unions
+ * their local sets. This controller only owns local membership + a revision
+ * that already reflects descendant changes via the bubbling topology event.
+ */
+export declare class BdActionTopologyController implements ReactiveController {
+    private readonly host;
+    private readonly _localScans;
+    private _localOptionSeed?;
+    private _revision;
+    private _listening;
+    constructor(host: BdActionTopologyHost);
+    /**
+     * Bumped whenever this node's local set changes OR any descendant bd node's
+     * set changes (the change event bubbles through here). Use this as a compute
+     * input so a node recomputes when anything in its subtree changes.
+     */
+    get revision(): number;
+    get localElements(): readonly HTMLElement[];
+    get localActionScans(): readonly BdComputeScan[];
+    get localOptionSeed(): ProductOption | undefined;
+    setLocalOptionSeed(option: ProductOption | undefined): void;
+    /**
+     * Signal that this node's logical subtree shape changed (a bd child node
+     * connected or disconnected) rather than an individual action element.
+     *
+     * Membership is recomputed lazily by the owning element, so this only needs
+     * to bump the revision and notify ancestors. The owning element calls this
+     * from its onBdChildConnected / onBdChildDisconnected hooks, which fire while
+     * this node is still connected even as a child subtree is torn down.
+     */
+    markSubtreeChanged(): void;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private readonly _onActionConnect;
+    private readonly _onActionDisconnect;
+    private readonly _onActionUpdate;
+    /**
+     * Fires on this node (target phase) and every ancestor (bubbling) for a
+     * single change. Each node bumps its own revision exactly once, which is why
+     * local changes also flow through here instead of bumping directly.
+     */
+    private readonly _onTopologyChanged;
+    private _emitChanged;
+}

package/dist/src/controllers/controller.action-topology.js

@@ -0,0 +1,130 @@
+import { BD_ACTION_CONNECT_EVENT, BD_ACTION_DISCONNECT_EVENT, BD_ACTION_TOPOLOGY_CHANGED_EVENT, BD_ACTION_UPDATE_EVENT, dispatchBdActionTopologyChanged } from '../core/action-topology.js';
+/**
+ * Owns the set of native action elements that belong to a single bd node.
+ *
+ * Membership is fed incrementally by BdActionElementAdapter announcements, so
+ * no node ever rescans its DOM children. The nearest bd node catches
+ * bd-action-connect / bd-action-disconnect, exactly like bd-action-request, so
+ * an action's compute radius matches its runtime radius.
+ *
+ * Aggregation across the logical bd subtree is intentionally NOT done here. The
+ * owning element walks its bd children (which it has access to) and unions
+ * their local sets. This controller only owns local membership + a revision
+ * that already reflects descendant changes via the bubbling topology event.
+ */
+export class BdActionTopologyController {
+    constructor(host) {
+        this.host = host;
+        this._localScans = new Map();
+        this._revision = 0;
+        this._listening = false;
+        this._onActionConnect = (event) => {
+            /**
+             * Nearest bd node wins ownership; do not let outer nodes also claim it.
+             */
+            event.stopPropagation();
+            event.detail.claim(this.host);
+            this._localScans.set(event.detail.element, event.detail.scan);
+            this._emitChanged();
+        };
+        this._onActionDisconnect = (event) => {
+            event.stopPropagation();
+            if (!this._localScans.delete(event.detail.element)) {
+                return;
+            }
+            this._emitChanged();
+        };
+        this._onActionUpdate = (event) => {
+            event.stopPropagation();
+            if (!this._localScans.has(event.detail.element)) {
+                return;
+            }
+            const previous = this._localScans.get(event.detail.element);
+            if (previous &&
+                sameComputeScan(previous, event.detail.scan)) {
+                return;
+            }
+            this._localScans.set(event.detail.element, event.detail.scan);
+            this._emitChanged();
+        };
+        /**
+         * Fires on this node (target phase) and every ancestor (bubbling) for a
+         * single change. Each node bumps its own revision exactly once, which is why
+         * local changes also flow through here instead of bumping directly.
+         */
+        this._onTopologyChanged = (event) => {
+            this._revision++;
+            this.host.requestUpdate();
+            if (this.host.topologyBoundary === true) {
+                event.stopPropagation();
+            }
+        };
+        host.addController(this);
+    }
+    /**
+     * Bumped whenever this node's local set changes OR any descendant bd node's
+     * set changes (the change event bubbles through here). Use this as a compute
+     * input so a node recomputes when anything in its subtree changes.
+     */
+    get revision() {
+        return this._revision;
+    }
+    get localElements() {
+        return [...this._localScans.keys()];
+    }
+    get localActionScans() {
+        return [...this._localScans.values()];
+    }
+    get localOptionSeed() {
+        return this._localOptionSeed;
+    }
+    setLocalOptionSeed(option) {
+        if (Object.is(this._localOptionSeed, option)) {
+            return;
+        }
+        this._localOptionSeed = option;
+        this._emitChanged();
+    }
+    /**
+     * Signal that this node's logical subtree shape changed (a bd child node
+     * connected or disconnected) rather than an individual action element.
+     *
+     * Membership is recomputed lazily by the owning element, so this only needs
+     * to bump the revision and notify ancestors. The owning element calls this
+     * from its onBdChildConnected / onBdChildDisconnected hooks, which fire while
+     * this node is still connected even as a child subtree is torn down.
+     */
+    markSubtreeChanged() {
+        this._emitChanged();
+    }
+    hostConnected() {
+        if (this._listening) {
+            return;
+        }
+        this.host.addEventListener(BD_ACTION_CONNECT_EVENT, this._onActionConnect);
+        this.host.addEventListener(BD_ACTION_DISCONNECT_EVENT, this._onActionDisconnect);
+        this.host.addEventListener(BD_ACTION_UPDATE_EVENT, this._onActionUpdate);
+        this.host.addEventListener(BD_ACTION_TOPOLOGY_CHANGED_EVENT, this._onTopologyChanged);
+        this._listening = true;
+    }
+    hostDisconnected() {
+        if (!this._listening) {
+            return;
+        }
+        this.host.removeEventListener(BD_ACTION_CONNECT_EVENT, this._onActionConnect);
+        this.host.removeEventListener(BD_ACTION_DISCONNECT_EVENT, this._onActionDisconnect);
+        this.host.removeEventListener(BD_ACTION_UPDATE_EVENT, this._onActionUpdate);
+        this.host.removeEventListener(BD_ACTION_TOPOLOGY_CHANGED_EVENT, this._onTopologyChanged);
+        this._listening = false;
+        this._localScans.clear();
+        this._localOptionSeed = undefined;
+    }
+    _emitChanged() {
+        dispatchBdActionTopologyChanged(this.host);
+    }
+}
+function sameComputeScan(a, b) {
+    return (JSON.stringify(a.staticCommands) === JSON.stringify(b.staticCommands) &&
+        JSON.stringify(a.domains) === JSON.stringify(b.domains));
+}
+//# sourceMappingURL=controller.action-topology.js.map

package/dist/src/controllers/controller.action-topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.action-topology.js","sourceRoot":"","sources":["../../../src/controllers/controller.action-topology.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ReactiveController,\n  ReactiveControllerHost\n} from 'lit';\n\nimport {\n  type BdComputeScan\n} from '@/compute/compute.scan.js';\nimport {\n  BD_ACTION_CONNECT_EVENT,\n  BD_ACTION_DISCONNECT_EVENT,\n  BD_ACTION_TOPOLOGY_CHANGED_EVENT,\n  BD_ACTION_UPDATE_EVENT,\n  dispatchBdActionTopologyChanged,\n  type BdActionConnectDetail,\n  type BdActionDisconnectDetail,\n  type BdActionUpdateDetail\n} from '@/core/action-topology.js';\nimport type { ProductOption } from '@repobit/dex-store';\n\nexport interface BdActionTopologyHost\n  extends ReactiveControllerHost, EventTarget {\n  readonly topologyBoundary?: boolean;\n}\n\n/**\n * Owns the set of native action elements that belong to a single bd node.\n *\n * Membership is fed incrementally by BdActionElementAdapter announcements, so\n * no node ever rescans its DOM children. The nearest bd node catches\n * bd-action-connect / bd-action-disconnect, exactly like bd-action-request, so\n * an action's compute radius matches its runtime radius.\n *\n * Aggregation across the logical bd subtree is intentionally NOT done here. The\n * owning element walks its bd children (which it has access to) and unions\n * their local sets. This controller only owns local membership + a revision\n * that already reflects descendant changes via the bubbling topology event.\n */\nexport class BdActionTopologyController implements ReactiveController {\n  private readonly _localScans = new Map<HTMLElement, BdComputeScan>();\n  private _localOptionSeed?: ProductOption;\n  private _revision = 0;\n  private _listening = false;\n\n  constructor(\n    private readonly host: BdActionTopologyHost\n  ) {\n    host.addController(this);\n  }\n\n  /**\n   * Bumped whenever this node's local set changes OR any descendant bd node's\n   * set changes (the change event bubbles through here). Use this as a compute\n   * input so a node recomputes when anything in its subtree changes.\n   */\n  get revision(): number {\n    return this._revision;\n  }\n\n  get localElements(): readonly HTMLElement[] {\n    return [...this._localScans.keys()];\n  }\n\n  get localActionScans(): readonly BdComputeScan[] {\n    return [...this._localScans.values()];\n  }\n\n  get localOptionSeed(): ProductOption | undefined {\n    return this._localOptionSeed;\n  }\n\n  setLocalOptionSeed(\n    option: ProductOption | undefined\n  ): void {\n    if (Object.is(\n      this._localOptionSeed,\n      option\n    )) {\n      return;\n    }\n\n    this._localOptionSeed = option;\n    this._emitChanged();\n  }\n\n  /**\n   * Signal that this node's logical subtree shape changed (a bd child node\n   * connected or disconnected) rather than an individual action element.\n   *\n   * Membership is recomputed lazily by the owning element, so this only needs\n   * to bump the revision and notify ancestors. The owning element calls this\n   * from its onBdChildConnected / onBdChildDisconnected hooks, which fire while\n   * this node is still connected even as a child subtree is torn down.\n   */\n  markSubtreeChanged(): void {\n    this._emitChanged();\n  }\n\n  hostConnected(): void {\n    if (this._listening) {\n      return;\n    }\n\n    this.host.addEventListener(\n      BD_ACTION_CONNECT_EVENT,\n      this._onActionConnect as EventListener\n    );\n\n    this.host.addEventListener(\n      BD_ACTION_DISCONNECT_EVENT,\n      this._onActionDisconnect as EventListener\n    );\n\n    this.host.addEventListener(\n      BD_ACTION_UPDATE_EVENT,\n      this._onActionUpdate as EventListener\n    );\n\n    this.host.addEventListener(\n      BD_ACTION_TOPOLOGY_CHANGED_EVENT,\n      this._onTopologyChanged as EventListener\n    );\n\n    this._listening = true;\n  }\n\n  hostDisconnected(): void {\n    if (!this._listening) {\n      return;\n    }\n\n    this.host.removeEventListener(\n      BD_ACTION_CONNECT_EVENT,\n      this._onActionConnect as EventListener\n    );\n\n    this.host.removeEventListener(\n      BD_ACTION_DISCONNECT_EVENT,\n      this._onActionDisconnect as EventListener\n    );\n\n    this.host.removeEventListener(\n      BD_ACTION_UPDATE_EVENT,\n      this._onActionUpdate as EventListener\n    );\n\n    this.host.removeEventListener(\n      BD_ACTION_TOPOLOGY_CHANGED_EVENT,\n      this._onTopologyChanged as EventListener\n    );\n\n    this._listening = false;\n    this._localScans.clear();\n    this._localOptionSeed = undefined;\n  }\n\n  private readonly _onActionConnect = (\n    event: CustomEvent<BdActionConnectDetail>\n  ): void => {\n    /**\n     * Nearest bd node wins ownership; do not let outer nodes also claim it.\n     */\n    event.stopPropagation();\n\n    event.detail.claim(this.host);\n    this._localScans.set(\n      event.detail.element,\n      event.detail.scan\n    );\n\n    this._emitChanged();\n  };\n\n  private readonly _onActionDisconnect = (\n    event: CustomEvent<BdActionDisconnectDetail>\n  ): void => {\n    event.stopPropagation();\n\n    if (!this._localScans.delete(event.detail.element)) {\n      return;\n    }\n\n    this._emitChanged();\n  };\n\n  private readonly _onActionUpdate = (\n    event: CustomEvent<BdActionUpdateDetail>\n  ): void => {\n    event.stopPropagation();\n\n    if (!this._localScans.has(event.detail.element)) {\n      return;\n    }\n\n    const previous =\n      this._localScans.get(event.detail.element);\n\n    if (\n      previous &&\n      sameComputeScan(\n        previous,\n        event.detail.scan\n      )\n    ) {\n      return;\n    }\n\n    this._localScans.set(\n      event.detail.element,\n      event.detail.scan\n    );\n\n    this._emitChanged();\n  };\n\n  /**\n   * Fires on this node (target phase) and every ancestor (bubbling) for a\n   * single change. Each node bumps its own revision exactly once, which is why\n   * local changes also flow through here instead of bumping directly.\n   */\n  private readonly _onTopologyChanged = (\n    event: Event\n  ): void => {\n    this._revision++;\n    this.host.requestUpdate();\n\n    if (this.host.topologyBoundary === true) {\n      event.stopPropagation();\n    }\n  };\n\n  private _emitChanged(): void {\n    dispatchBdActionTopologyChanged(this.host);\n  }\n}\n\nfunction sameComputeScan(\n  a: BdComputeScan,\n  b: BdComputeScan\n): boolean {\n  return (\n    JSON.stringify(a.staticCommands) === JSON.stringify(b.staticCommands) &&\n    JSON.stringify(a.domains) === JSON.stringify(b.domains)\n  );\n}\n"]}

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

@@ -0,0 +1,72 @@
+import { type BdComputeResult } from '../compute/compute.expand.js';
+import { type BdComputeScan } from '../compute/compute.scan.js';
+import type { ProductOption, Store } from '@repobit/dex-store';
+import type { ReactiveController } from 'lit';
+import { type BdResolveHost } from './controller.resolve.js';
+export declare const BD_COMPUTE_CHANGED_EVENT: "bd-compute-changed";
+export type BdComputeChangedDetail = Readonly<{
+    result?: BdComputeResult;
+}>;
+declare global {
+    interface HTMLElementEventMap {
+        [BD_COMPUTE_CHANGED_EVENT]: CustomEvent<BdComputeChangedDetail>;
+    }
+}
+/**
+ * Host requirements for the compute controller. Any BdNodeElement satisfies
+ * this: it tracks local work, is an EventTarget, can query its own subtree, and
+ * exposes the incremental action topology.
+ */
+export interface BdComputeHost extends BdResolveHost, EventTarget, ParentNode {
+    readonly actionTopologyRevision: number;
+    collectActionScans(): BdComputeScan[];
+    collectOptionSeeds(): ProductOption[];
+}
+export interface BdComputeOptions {
+    name?: string;
+    /**
+     * The store used to resolve products. Usually `() => this.scope?.store`.
+     */
+    store: () => Store | undefined;
+    /**
+     * Global/local compute switch. Disabled compute publishes an undefined result.
+     */
+    enabled?: () => boolean;
+    /**
+     * Extra change signal mixed into the task args. Defaults to the host's action
+     * topology revision, which already bumps on action and bd-subtree changes.
+     */
+    revision?: () => number;
+    /**
+     * Safety cap on the fixed-point search size.
+     */
+    maxScenarios?: number;
+    onResult?: (result: BdComputeResult | undefined) => void;
+}
+/**
+ * Dry-run min/max price compute over every product/option combination reachable
+ * from a bd node boundary.
+ *
+ * It never dispatches bd-action-request. It reads resolved option seeds and
+ * collected action declarations from topology, expands them against the same
+ * command shapes the runtime would honor, and reduces price. Reruns are driven
+ * by the store scope, the resolved seed set, and the action topology revision.
+ */
+export declare class BdComputeController implements ReactiveController {
+    private readonly host;
+    private readonly options;
+    result?: BdComputeResult;
+    private readonly _resolver;
+    constructor(host: BdComputeHost, options: BdComputeOptions);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    get pending(): boolean;
+    get complete(): boolean;
+    get failed(): boolean;
+    get error(): unknown;
+    run(): Promise<BdComputeResult | undefined>;
+    private _compute;
+    private _publish;
+    private _revision;
+    private _enabled;
+}