@repobit/dex-store-elements 1.7.3 → 2.0.1

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { ActionNode, cleanupActionNode, DATA_ACTION_NODE, handleActionNode } from \"./utilty\";\n\nconst SHADOW_HOST_SELECTOR = '[shadow]';\n\nconst isActionNode = (node: HTMLElement): node is ActionNode => node.matches(DATA_ACTION_NODE);\n\nconst forEachActionNode = (root: HTMLElement | ShadowRoot, fn: (node: ActionNode) => void) => {\n  if (root instanceof HTMLElement && isActionNode(root)) {\n    fn(root);\n  }\n\n  root\n    .querySelectorAll<ActionNode>(DATA_ACTION_NODE)\n    .forEach(fn);\n};\n\nconst forEachShadowRoot = (root: HTMLElement | ShadowRoot, fn: (shadowRoot: ShadowRoot) => void) => {\n  if (root instanceof HTMLElement && root.hasAttribute('shadow') && root.shadowRoot) {\n    fn(root.shadowRoot);\n  }\n\n  root\n    .querySelectorAll<HTMLElement>(SHADOW_HOST_SELECTOR)\n    .forEach((host) => host.shadowRoot && fn(host.shadowRoot));\n};\n\nconst registerActionNodes = (root: HTMLElement | ShadowRoot) => {\n  const observed = new WeakSet<Node>();\n  const observers = new WeakMap<Node, MutationObserver>();\n  const activeObservers = new Set<MutationObserver>();\n\n  const disconnect = (node: Node) => {\n    const observer = observers.get(node);\n    if (!observer) return;\n    observer.disconnect();\n    observers.delete(node);\n    activeObservers.delete(observer);\n  };\n\n  const cleanupShadowTree = (shadowRoot: ShadowRoot) => {\n    forEachActionNode(shadowRoot, cleanupActionNode);\n    forEachShadowRoot(shadowRoot, cleanupShadowTree);\n    disconnect(shadowRoot);\n  };\n\n  const handleAdded = (node: HTMLElement) => {\n    forEachActionNode(node, handleActionNode);\n    forEachShadowRoot(node, watch);\n  };\n\n  const handleRemoved = (node: HTMLElement) => {\n    forEachActionNode(node, cleanupActionNode);\n    forEachShadowRoot(node, cleanupShadowTree);\n  };\n\n  const watch = (node: HTMLElement | ShadowRoot) => {\n    if (observed.has(node)) return;\n    observed.add(node);\n\n    forEachActionNode(node, handleActionNode);\n    forEachShadowRoot(node, watch);\n\n    const mo = new MutationObserver(muts => {\n      for (const m of muts) {\n        for (const added of Array.from(m.addedNodes)) {\n          if (!(added instanceof HTMLElement)) continue;\n          handleAdded(added);\n        }\n        for (const removed of Array.from(m.removedNodes)) {\n          if (!(removed instanceof HTMLElement)) continue;\n          handleRemoved(removed);\n        }\n      }\n    });\n\n    mo.observe(node, {\n      childList: true,\n      subtree  : true\n    });\n    observers.set(node, mo);\n    activeObservers.add(mo);\n  };\n\n  watch(root);\n  return () => {\n    for (const observer of activeObservers) {\n      observer.disconnect();\n    }\n    activeObservers.clear();\n  };\n}\n\nexport { registerActionNodes };\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC","sourcesContent":["export * from './action.adapter.js';\nexport * from './action.attributes.js';\nexport * from './action.registry.js';\n\n"]}

package/dist/src/compute/compute.expand.d.ts

@@ -0,0 +1,70 @@
+import type { BdActionCommand } from '../core/actions.js';
+import type { Product, Store } from '@repobit/dex-store';
+import { type BdActionDomain, type BdSeedDeclaration } from './compute.scan.js';
+import { type BdOptionScenario } from './option-resolver.js';
+/**
+ * Min/max reduction over every option reachable from a compute boundary.
+ */
+export type BdComputeValue = Readonly<{
+    value: number;
+    fmt: string;
+}>;
+export type BdComputeRange = Readonly<{
+    min: BdComputeValue;
+    max: BdComputeValue;
+}>;
+export type BdComputeMonthlyRange = Readonly<BdComputeRange & {
+    monthly: BdComputeRange;
+}>;
+export type BdComputeDiscountRange = Readonly<BdComputeMonthlyRange & {
+    percentage: BdComputeMonthlyRange;
+}>;
+export type BdComputeResult = Readonly<{
+    min: number;
+    max: number;
+    minFormatted: string;
+    maxFormatted: string;
+    scenarios: number;
+    price: BdComputeMonthlyRange;
+    discountedPrice: BdComputeMonthlyRange;
+    discount: BdComputeDiscountRange;
+}>;
+/**
+ * Resolve declarative seeds into concrete product/option scenarios. Seeds that
+ * cannot be resolved (unknown product, missing option) are dropped.
+ */
+export declare function resolveSeedScenarios(store: Store, seeds: readonly BdSeedDeclaration[], signal?: AbortSignal): Promise<BdOptionScenario[]>;
+/**
+ * Fixed-point expansion of the reachable option space.
+ *
+ * Starting from the seeds, every static command and every domain-expanded
+ * command is applied to every newly discovered scenario, until no new scenario
+ * appears. Domains expand against the scenario's own product, which is what
+ * makes a product-switching action correctly explore the new product's
+ * device/subscription dimensions rather than the originally rendered ones.
+ */
+export declare function expandScenarios(params: Readonly<{
+    store?: Store;
+    seeds: readonly BdOptionScenario[];
+    staticCommands: readonly BdActionCommand[];
+    domains: readonly BdActionDomain[];
+    signal?: AbortSignal;
+    maxScenarios?: number;
+}>): Promise<BdOptionScenario[]>;
+/**
+ * Expand a domain into per-value set commands against a specific product. A
+ * devices domain becomes one useAsValue update per device value the product
+ * offers, and likewise for subscriptions.
+ */
+export declare function commandsFromDomains(domains: readonly BdActionDomain[], product: Product): BdActionCommand[];
+/**
+ * Reduce a set of scenarios to a min/max price range. Prices are read with the
+ * same ProductOption.getPrice() the runtime uses, so formatting and currency
+ * match exactly.
+ */
+export declare function reducePriceRange(scenarios: readonly BdOptionScenario[]): BdComputeResult | undefined;
+/**
+ * Convenience: a stable signature for a compute result so consumers can cheaply
+ * detect a meaningful change.
+ */
+export declare function computeResultKey(result: BdComputeResult | undefined): string;

package/dist/src/compute/compute.expand.js

@@ -0,0 +1,319 @@
+// src/compute/compute.expand.ts
+import { resolveScenarioCommand, scenarioKey } from './option-resolver.js';
+const DEFAULT_MAX_SCENARIOS = 10000;
+/**
+ * Resolve declarative seeds into concrete product/option scenarios. Seeds that
+ * cannot be resolved (unknown product, missing option) are dropped.
+ */
+export async function resolveSeedScenarios(store, seeds, signal) {
+    const resolved = await Promise.all(seeds.map(async (seed) => {
+        const product = await store.getProduct({
+            id: seed.productId,
+            campaign: seed.campaign
+        });
+        throwIfAborted(signal);
+        if (!product) {
+            return undefined;
+        }
+        const option = await product.getOption({
+            devices: seed.devices,
+            subscription: seed.subscription
+        });
+        if (!option) {
+            return undefined;
+        }
+        return {
+            product,
+            option
+        };
+    }));
+    return resolved.filter((scenario) => scenario !== undefined);
+}
+/**
+ * Fixed-point expansion of the reachable option space.
+ *
+ * Starting from the seeds, every static command and every domain-expanded
+ * command is applied to every newly discovered scenario, until no new scenario
+ * appears. Domains expand against the scenario's own product, which is what
+ * makes a product-switching action correctly explore the new product's
+ * device/subscription dimensions rather than the originally rendered ones.
+ */
+export async function expandScenarios(params) {
+    const limit = params.maxScenarios ?? DEFAULT_MAX_SCENARIOS;
+    const visited = new Map();
+    let frontier = [];
+    for (const seed of params.seeds) {
+        const key = scenarioKey(seed);
+        if (!visited.has(key)) {
+            visited.set(key, seed);
+            frontier.push(seed);
+        }
+    }
+    while (frontier.length > 0 && visited.size < limit) {
+        const next = [];
+        for (const scenario of frontier) {
+            const commands = [
+                ...params.staticCommands,
+                ...commandsFromDomains(params.domains, scenario.product)
+            ];
+            for (const command of commands) {
+                throwIfAborted(params.signal);
+                const result = await resolveScenarioCommand({
+                    store: params.store,
+                    scenario,
+                    command
+                });
+                if (!result) {
+                    continue;
+                }
+                const key = scenarioKey(result);
+                if (visited.has(key)) {
+                    continue;
+                }
+                visited.set(key, result);
+                next.push(result);
+                if (visited.size >= limit) {
+                    break;
+                }
+            }
+            if (visited.size >= limit) {
+                break;
+            }
+        }
+        frontier = next;
+    }
+    return [...visited.values()];
+}
+/**
+ * Expand a domain into per-value set commands against a specific product. A
+ * devices domain becomes one useAsValue update per device value the product
+ * offers, and likewise for subscriptions.
+ */
+export function commandsFromDomains(domains, product) {
+    const commands = [];
+    for (const domain of domains) {
+        const values = domain.type === 'devices'
+            ? product.getDevices().values
+            : product.getSubscriptions().values;
+        for (const value of values) {
+            if (!isValueInDomain(value, domain)) {
+                continue;
+            }
+            commands.push(domainValueCommand(domain.type, value));
+        }
+    }
+    return commands;
+}
+function isValueInDomain(value, domain) {
+    if (domain.min !== undefined &&
+        value < domain.min) {
+        return false;
+    }
+    if (domain.max !== undefined &&
+        value > domain.max) {
+        return false;
+    }
+    return true;
+}
+function domainValueCommand(type, value) {
+    return {
+        kind: 'update-by-delta',
+        update: {
+            type,
+            delta: value,
+            useAsValue: true
+        }
+    };
+}
+/**
+ * Reduce a set of scenarios to a min/max price range. Prices are read with the
+ * same ProductOption.getPrice() the runtime uses, so formatting and currency
+ * match exactly.
+ */
+export function reducePriceRange(scenarios) {
+    const price = createMonthlyAccumulator();
+    const discountedPrice = createMonthlyAccumulator();
+    const discount = createDiscountAccumulator();
+    for (const scenario of scenarios) {
+        collectOptionCompute(scenario.option, {
+            price,
+            discountedPrice,
+            discount
+        });
+    }
+    if (!price.base.hasValue) {
+        return undefined;
+    }
+    const priceRange = finalizeMonthlyAccumulator(price);
+    return {
+        min: priceRange.min.value,
+        max: priceRange.max.value,
+        minFormatted: priceRange.min.fmt,
+        maxFormatted: priceRange.max.fmt,
+        scenarios: scenarios.length,
+        price: priceRange,
+        discountedPrice: finalizeMonthlyAccumulator(discountedPrice),
+        discount: finalizeDiscountAccumulator(discount)
+    };
+}
+/**
+ * Convenience: a stable signature for a compute result so consumers can cheaply
+ * detect a meaningful change.
+ */
+export function computeResultKey(result) {
+    if (!result) {
+        return '';
+    }
+    return [
+        result.scenarios,
+        rangeKey(result.price),
+        rangeKey(result.price.monthly),
+        rangeKey(result.discountedPrice),
+        rangeKey(result.discountedPrice.monthly),
+        rangeKey(result.discount),
+        rangeKey(result.discount.monthly),
+        rangeKey(result.discount.percentage),
+        rangeKey(result.discount.percentage.monthly)
+    ].join('|');
+}
+function collectOptionCompute(option, buckets) {
+    collectMetric(buckets.price.base, readPriceMetric(option));
+    collectMetric(buckets.price.monthly, readPriceMetric(option, { monthly: true }));
+    collectMetric(buckets.discountedPrice.base, readOptionalPriceMetric(option, 'getDiscountedPrice'));
+    collectMetric(buckets.discountedPrice.monthly, readOptionalPriceMetric(option, 'getDiscountedPrice', { monthly: true }));
+    collectMetric(buckets.discount.base, readOptionalPriceMetric(option, 'getDiscount', {
+        percentage: false,
+        symbol: false
+    }, {
+        percentage: false
+    }));
+    collectMetric(buckets.discount.monthly, readOptionalPriceMetric(option, 'getDiscount', {
+        percentage: false,
+        monthly: true,
+        symbol: false
+    }, {
+        percentage: false,
+        monthly: true
+    }));
+    collectMetric(buckets.discount.percentage.base, readOptionalPriceMetric(option, 'getDiscount', {
+        percentage: true,
+        symbol: false
+    }, {
+        percentage: true
+    }));
+    collectMetric(buckets.discount.percentage.monthly, readOptionalPriceMetric(option, 'getDiscount', {
+        percentage: true,
+        monthly: true,
+        symbol: false
+    }, {
+        percentage: true,
+        monthly: true
+    }));
+}
+function readPriceMetric(option, params = {}) {
+    return {
+        value: option.getPrice({
+            ...params,
+            currency: false
+        }),
+        fmt: String(option.getPrice({
+            ...params,
+            currency: true
+        }))
+    };
+}
+function readOptionalPriceMetric(option, method, numericParams = {}, formattedParams = numericParams) {
+    const withOptional = option;
+    const fn = withOptional[method];
+    if (!fn) {
+        return undefined;
+    }
+    const value = fn.call(option, {
+        ...numericParams,
+        currency: false
+    });
+    if (typeof value !== 'number' ||
+        !Number.isFinite(value)) {
+        return undefined;
+    }
+    const fmt = fn.call(option, formattedParams);
+    return {
+        value,
+        fmt: fmt === undefined ? '' : String(fmt)
+    };
+}
+function collectMetric(accumulator, metric) {
+    if (!metric) {
+        return;
+    }
+    if (!accumulator.hasValue ||
+        metric.value < accumulator.min.value) {
+        accumulator.min = metric;
+    }
+    if (!accumulator.hasValue ||
+        metric.value > accumulator.max.value) {
+        accumulator.max = metric;
+    }
+    accumulator.hasValue = true;
+}
+function createAccumulator() {
+    return {
+        min: emptyComputeValue(Number.MAX_SAFE_INTEGER),
+        max: emptyComputeValue(Number.MIN_SAFE_INTEGER),
+        hasValue: false
+    };
+}
+function createMonthlyAccumulator() {
+    return {
+        base: createAccumulator(),
+        monthly: createAccumulator()
+    };
+}
+function createDiscountAccumulator() {
+    return {
+        ...createMonthlyAccumulator(),
+        percentage: createMonthlyAccumulator()
+    };
+}
+function finalizeAccumulator(accumulator) {
+    return {
+        min: accumulator.hasValue
+            ? accumulator.min
+            : emptyComputeValue(Number.MAX_SAFE_INTEGER),
+        max: accumulator.hasValue
+            ? accumulator.max
+            : emptyComputeValue(Number.MIN_SAFE_INTEGER)
+    };
+}
+function finalizeMonthlyAccumulator(accumulator) {
+    return {
+        ...finalizeAccumulator(accumulator.base),
+        monthly: finalizeAccumulator(accumulator.monthly)
+    };
+}
+function finalizeDiscountAccumulator(accumulator) {
+    return {
+        ...finalizeMonthlyAccumulator(accumulator),
+        percentage: finalizeMonthlyAccumulator(accumulator.percentage)
+    };
+}
+function emptyComputeValue(value) {
+    return {
+        value,
+        fmt: ''
+    };
+}
+function rangeKey(range) {
+    return [
+        range.min.value,
+        range.min.fmt,
+        range.max.value,
+        range.max.fmt
+    ].join(':');
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        throw signal.reason ?? new DOMException('Aborted', 'AbortError');
+    }
+}
+//# sourceMappingURL=compute.expand.js.map

package/dist/src/compute/compute.expand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute.expand.js","sourceRoot":"","sources":["../../../src/compute/compute.expand.ts"],"names":[],"mappings":"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","sourcesContent":["// src/compute/compute.expand.ts\n\nimport type {\n  BdActionCommand,\n  UpdateByDelta\n} from '@/core/actions.js';\nimport type {\n  Product,\n  ProductOption,\n  Store\n} from '@repobit/dex-store';\nimport {\n  type BdActionDomain,\n  type BdSeedDeclaration\n} from './compute.scan.js';\nimport {\n  resolveScenarioCommand,\n  scenarioKey,\n  type BdOptionScenario\n} from './option-resolver.js';\n\n/**\n * Min/max reduction over every option reachable from a compute boundary.\n */\nexport type BdComputeValue = Readonly<{\n  value: number;\n  fmt  : string;\n}>;\n\nexport type BdComputeRange = Readonly<{\n  min: BdComputeValue;\n  max: BdComputeValue;\n}>;\n\nexport type BdComputeMonthlyRange = Readonly<BdComputeRange & {\n  monthly: BdComputeRange;\n}>;\n\nexport type BdComputeDiscountRange = Readonly<BdComputeMonthlyRange & {\n  percentage: BdComputeMonthlyRange;\n}>;\n\nexport type BdComputeResult = Readonly<{\n  min         : number;\n  max         : number;\n  minFormatted: string;\n  maxFormatted: string;\n  scenarios   : number;\n\n  price          : BdComputeMonthlyRange;\n  discountedPrice: BdComputeMonthlyRange;\n  discount       : BdComputeDiscountRange;\n}>;\n\nconst DEFAULT_MAX_SCENARIOS = 10000;\n\n/**\n * Resolve declarative seeds into concrete product/option scenarios. Seeds that\n * cannot be resolved (unknown product, missing option) are dropped.\n */\nexport async function resolveSeedScenarios(\n  store: Store,\n  seeds: readonly BdSeedDeclaration[],\n  signal?: AbortSignal\n): Promise<BdOptionScenario[]> {\n  const resolved = await Promise.all(\n    seeds.map(async (seed) => {\n      const product =\n        await store.getProduct({\n          id      : seed.productId,\n          campaign: seed.campaign\n        });\n\n      throwIfAborted(signal);\n\n      if (!product) {\n        return undefined;\n      }\n\n      const option =\n        await product.getOption({\n          devices     : seed.devices,\n          subscription: seed.subscription\n        });\n\n      if (!option) {\n        return undefined;\n      }\n\n      return {\n        product,\n        option\n      } satisfies BdOptionScenario;\n    })\n  );\n\n  return resolved.filter(\n    (scenario): scenario is BdOptionScenario => scenario !== undefined\n  );\n}\n\n/**\n * Fixed-point expansion of the reachable option space.\n *\n * Starting from the seeds, every static command and every domain-expanded\n * command is applied to every newly discovered scenario, until no new scenario\n * appears. Domains expand against the scenario's own product, which is what\n * makes a product-switching action correctly explore the new product's\n * device/subscription dimensions rather than the originally rendered ones.\n */\nexport async function expandScenarios(\n  params: Readonly<{\n    store?        : Store;\n    seeds         : readonly BdOptionScenario[];\n    staticCommands: readonly BdActionCommand[];\n    domains       : readonly BdActionDomain[];\n    signal?       : AbortSignal;\n    maxScenarios? : number;\n  }>\n): Promise<BdOptionScenario[]> {\n  const limit =\n    params.maxScenarios ?? DEFAULT_MAX_SCENARIOS;\n\n  const visited = new Map<string, BdOptionScenario>();\n  let frontier: BdOptionScenario[] = [];\n\n  for (const seed of params.seeds) {\n    const key = scenarioKey(seed);\n\n    if (!visited.has(key)) {\n      visited.set(key, seed);\n      frontier.push(seed);\n    }\n  }\n\n  while (frontier.length > 0 && visited.size < limit) {\n    const next: BdOptionScenario[] = [];\n\n    for (const scenario of frontier) {\n      const commands = [\n        ...params.staticCommands,\n        ...commandsFromDomains(params.domains, scenario.product)\n      ];\n\n      for (const command of commands) {\n        throwIfAborted(params.signal);\n\n        const result =\n          await resolveScenarioCommand({\n            store: params.store,\n            scenario,\n            command\n          });\n\n        if (!result) {\n          continue;\n        }\n\n        const key = scenarioKey(result);\n\n        if (visited.has(key)) {\n          continue;\n        }\n\n        visited.set(key, result);\n        next.push(result);\n\n        if (visited.size >= limit) {\n          break;\n        }\n      }\n\n      if (visited.size >= limit) {\n        break;\n      }\n    }\n\n    frontier = next;\n  }\n\n  return [...visited.values()];\n}\n\n/**\n * Expand a domain into per-value set commands against a specific product. A\n * devices domain becomes one useAsValue update per device value the product\n * offers, and likewise for subscriptions.\n */\nexport function commandsFromDomains(\n  domains: readonly BdActionDomain[],\n  product: Product\n): BdActionCommand[] {\n  const commands: BdActionCommand[] = [];\n\n  for (const domain of domains) {\n    const values =\n      domain.type === 'devices'\n        ? product.getDevices().values\n        : product.getSubscriptions().values;\n\n    for (const value of values) {\n      if (!isValueInDomain(value, domain)) {\n        continue;\n      }\n\n      commands.push(\n        domainValueCommand(domain.type, value)\n      );\n    }\n  }\n\n  return commands;\n}\n\nfunction isValueInDomain(\n  value: number,\n  domain: BdActionDomain\n): boolean {\n  if (\n    domain.min !== undefined &&\n    value < domain.min\n  ) {\n    return false;\n  }\n\n  if (\n    domain.max !== undefined &&\n    value > domain.max\n  ) {\n    return false;\n  }\n\n  return true;\n}\n\nfunction domainValueCommand(\n  type: UpdateByDelta['type'],\n  value: number\n): BdActionCommand {\n  return {\n    kind  : 'update-by-delta',\n    update: {\n      type,\n      delta     : value,\n      useAsValue: true\n    }\n  };\n}\n\n/**\n * Reduce a set of scenarios to a min/max price range. Prices are read with the\n * same ProductOption.getPrice() the runtime uses, so formatting and currency\n * match exactly.\n */\nexport function reducePriceRange(\n  scenarios: readonly BdOptionScenario[]\n): BdComputeResult | undefined {\n  const price = createMonthlyAccumulator();\n  const discountedPrice = createMonthlyAccumulator();\n  const discount = createDiscountAccumulator();\n\n  for (const scenario of scenarios) {\n    collectOptionCompute(\n      scenario.option,\n      {\n        price,\n        discountedPrice,\n        discount\n      }\n    );\n  }\n\n  if (!price.base.hasValue) {\n    return undefined;\n  }\n\n  const priceRange = finalizeMonthlyAccumulator(price);\n\n  return {\n    min         : priceRange.min.value,\n    max         : priceRange.max.value,\n    minFormatted: priceRange.min.fmt,\n    maxFormatted: priceRange.max.fmt,\n    scenarios   : scenarios.length,\n\n    price: priceRange,\n    discountedPrice:\n      finalizeMonthlyAccumulator(discountedPrice),\n    discount:\n      finalizeDiscountAccumulator(discount)\n  };\n}\n\n/**\n * Convenience: a stable signature for a compute result so consumers can cheaply\n * detect a meaningful change.\n */\nexport function computeResultKey(\n  result: BdComputeResult | undefined\n): string {\n  if (!result) {\n    return '';\n  }\n\n  return [\n    result.scenarios,\n    rangeKey(result.price),\n    rangeKey(result.price.monthly),\n    rangeKey(result.discountedPrice),\n    rangeKey(result.discountedPrice.monthly),\n    rangeKey(result.discount),\n    rangeKey(result.discount.monthly),\n    rangeKey(result.discount.percentage),\n    rangeKey(result.discount.percentage.monthly)\n  ].join('|');\n}\n\ntype ComputeBuckets = {\n  price          : MonthlyAccumulator;\n  discountedPrice: MonthlyAccumulator;\n  discount       : DiscountAccumulator;\n};\n\ntype Accumulator = {\n  min     : BdComputeValue;\n  max     : BdComputeValue;\n  hasValue: boolean;\n};\n\ntype MonthlyAccumulator = {\n  base   : Accumulator;\n  monthly: Accumulator;\n};\n\ntype DiscountAccumulator = MonthlyAccumulator & {\n  percentage: MonthlyAccumulator;\n};\n\ntype OptionalPriceMethod =\n  | 'getDiscountedPrice'\n  | 'getDiscount';\n\ntype OptionWithOptionalPrices = ProductOption & Partial<Record<\n  OptionalPriceMethod,\n  (params?: Record<string, unknown>) => string | number | undefined\n>>;\n\nfunction collectOptionCompute(\n  option: ProductOption,\n  buckets: ComputeBuckets\n): void {\n  collectMetric(\n    buckets.price.base,\n    readPriceMetric(option)\n  );\n  collectMetric(\n    buckets.price.monthly,\n    readPriceMetric(\n      option,\n      { monthly: true }\n    )\n  );\n\n  collectMetric(\n    buckets.discountedPrice.base,\n    readOptionalPriceMetric(\n      option,\n      'getDiscountedPrice'\n    )\n  );\n  collectMetric(\n    buckets.discountedPrice.monthly,\n    readOptionalPriceMetric(\n      option,\n      'getDiscountedPrice',\n      { monthly: true }\n    )\n  );\n\n  collectMetric(\n    buckets.discount.base,\n    readOptionalPriceMetric(\n      option,\n      'getDiscount',\n      {\n        percentage: false,\n        symbol    : false\n      },\n      {\n        percentage: false\n      }\n    )\n  );\n  collectMetric(\n    buckets.discount.monthly,\n    readOptionalPriceMetric(\n      option,\n      'getDiscount',\n      {\n        percentage: false,\n        monthly   : true,\n        symbol    : false\n      },\n      {\n        percentage: false,\n        monthly   : true\n      }\n    )\n  );\n  collectMetric(\n    buckets.discount.percentage.base,\n    readOptionalPriceMetric(\n      option,\n      'getDiscount',\n      {\n        percentage: true,\n        symbol    : false\n      },\n      {\n        percentage: true\n      }\n    )\n  );\n  collectMetric(\n    buckets.discount.percentage.monthly,\n    readOptionalPriceMetric(\n      option,\n      'getDiscount',\n      {\n        percentage: true,\n        monthly   : true,\n        symbol    : false\n      },\n      {\n        percentage: true,\n        monthly   : true\n      }\n    )\n  );\n}\n\nfunction readPriceMetric(\n  option: ProductOption,\n  params: {\n    monthly?: boolean;\n  } = {}\n): BdComputeValue {\n  return {\n    value: option.getPrice({\n      ...params,\n      currency: false\n    }),\n    fmt: String(\n      option.getPrice({\n        ...params,\n        currency: true\n      })\n    )\n  };\n}\n\nfunction readOptionalPriceMetric(\n  option: ProductOption,\n  method: OptionalPriceMethod,\n  numericParams: Record<string, unknown> = {},\n  formattedParams: Record<string, unknown> = numericParams\n): BdComputeValue | undefined {\n  const withOptional = option as OptionWithOptionalPrices;\n  const fn = withOptional[method];\n\n  if (!fn) {\n    return undefined;\n  }\n\n  const value = fn.call(\n    option,\n    {\n      ...numericParams,\n      currency: false\n    }\n  );\n\n  if (\n    typeof value !== 'number' ||\n    !Number.isFinite(value)\n  ) {\n    return undefined;\n  }\n\n  const fmt = fn.call(\n    option,\n    formattedParams\n  );\n\n  return {\n    value,\n    fmt: fmt === undefined ? '' : String(fmt)\n  };\n}\n\nfunction collectMetric(\n  accumulator: Accumulator,\n  metric: BdComputeValue | undefined\n): void {\n  if (!metric) {\n    return;\n  }\n\n  if (\n    !accumulator.hasValue ||\n    metric.value < accumulator.min.value\n  ) {\n    accumulator.min = metric;\n  }\n\n  if (\n    !accumulator.hasValue ||\n    metric.value > accumulator.max.value\n  ) {\n    accumulator.max = metric;\n  }\n\n  accumulator.hasValue = true;\n}\n\nfunction createAccumulator(): Accumulator {\n  return {\n    min     : emptyComputeValue(Number.MAX_SAFE_INTEGER),\n    max     : emptyComputeValue(Number.MIN_SAFE_INTEGER),\n    hasValue: false\n  };\n}\n\nfunction createMonthlyAccumulator(): MonthlyAccumulator {\n  return {\n    base   : createAccumulator(),\n    monthly: createAccumulator()\n  };\n}\n\nfunction createDiscountAccumulator(): DiscountAccumulator {\n  return {\n    ...createMonthlyAccumulator(),\n    percentage: createMonthlyAccumulator()\n  };\n}\n\nfunction finalizeAccumulator(\n  accumulator: Accumulator\n): BdComputeRange {\n  return {\n    min: accumulator.hasValue\n      ? accumulator.min\n      : emptyComputeValue(Number.MAX_SAFE_INTEGER),\n    max: accumulator.hasValue\n      ? accumulator.max\n      : emptyComputeValue(Number.MIN_SAFE_INTEGER)\n  };\n}\n\nfunction finalizeMonthlyAccumulator(\n  accumulator: MonthlyAccumulator\n): BdComputeMonthlyRange {\n  return {\n    ...finalizeAccumulator(accumulator.base),\n    monthly: finalizeAccumulator(accumulator.monthly)\n  };\n}\n\nfunction finalizeDiscountAccumulator(\n  accumulator: DiscountAccumulator\n): BdComputeDiscountRange {\n  return {\n    ...finalizeMonthlyAccumulator(accumulator),\n    percentage:\n      finalizeMonthlyAccumulator(accumulator.percentage)\n  };\n}\n\nfunction emptyComputeValue(\n  value: number\n): BdComputeValue {\n  return {\n    value,\n    fmt: ''\n  };\n}\n\nfunction rangeKey(\n  range: BdComputeRange\n): string {\n  return [\n    range.min.value,\n    range.min.fmt,\n    range.max.value,\n    range.max.fmt\n  ].join(':');\n}\n\nfunction throwIfAborted(signal?: AbortSignal): void {\n  if (signal?.aborted) {\n    throw signal.reason ?? new DOMException('Aborted', 'AbortError');\n  }\n}\n"]}

package/dist/src/compute/compute.scan.d.ts

@@ -0,0 +1,54 @@
+import type { BdActionCommand } from '../core/actions.js';
+export declare const DATA_DEVICES_DOMAIN: "data-store-devices";
+export declare const DATA_SUBSCRIPTION_DOMAIN: "data-store-subscription";
+export type BdActionDomainKind = 'devices' | 'subscription';
+export type BdActionDomain = Readonly<{
+    type: BdActionDomainKind;
+    min?: number;
+    max?: number;
+}>;
+/**
+ * A declarative seed scenario used by standalone compute helpers. Live node
+ * compute uses resolved ProductOption seeds collected from option nodes.
+ */
+export type BdSeedDeclaration = Readonly<{
+    productId: string;
+    campaign?: string;
+    bundle: boolean;
+    devices: number;
+    subscription: number;
+}>;
+/**
+ * Result of scanning the action elements owned by a compute boundary.
+ *
+ * - staticCommands: concrete jumps (button says product-b, option says
+ *   subscription=24, select option children, etc).
+ * - domains: controls that represent a devices / subscription space of
+ *   whatever product a scenario lands on. Inputs may bound that space by min/max.
+ */
+export type BdComputeScan = Readonly<{
+    staticCommands: readonly BdActionCommand[];
+    domains: readonly BdActionDomain[];
+}>;
+export declare const EMPTY_COMPUTE_SCAN: BdComputeScan;
+/**
+ * Stable fingerprint of the declared seeds. Used as a compute task arg so the
+ * controller only reruns when the declared seed set actually changes, not on
+ * every host update.
+ */
+export declare function seedDeclarationsKey(seeds: readonly BdSeedDeclaration[]): string;
+/**
+ * Turn the action elements owned by a compute boundary into static commands and
+ * dynamic domains. Reuses the same parser as the runtime action layer; the only
+ * difference is breadth: a select contributes all of its option children here,
+ * not just the selected one.
+ */
+export declare function scanActionElements(elements: Iterable<HTMLElement>): BdComputeScan;
+export declare function collectActionElementCompute(element: HTMLElement): BdComputeScan;
+export declare function mergeComputeScans(scans: Iterable<BdComputeScan>): BdComputeScan;
+/**
+ * A select / control is a dynamic domain only when it is actionable AND tagged
+ * as a devices or subscription dimension. A plain `data-store-devices` span just
+ * renders the current value and contributes nothing to compute.
+ */
+export declare function readComputeDomain(element: HTMLElement): BdActionDomain | undefined;

package/dist/src/compute/compute.scan.js

@@ -0,0 +1,160 @@
+// src/compute/compute.scan.ts
+import { isActionElement, readBdActionCommand, readInputValueCommand } from '../actions/action.attributes.js';
+export const DATA_DEVICES_DOMAIN = 'data-store-devices';
+export const DATA_SUBSCRIPTION_DOMAIN = 'data-store-subscription';
+export const EMPTY_COMPUTE_SCAN = Object.freeze({
+    staticCommands: Object.freeze([]),
+    domains: Object.freeze([])
+});
+/**
+ * Stable fingerprint of the declared seeds. Used as a compute task arg so the
+ * controller only reruns when the declared seed set actually changes, not on
+ * every host update.
+ */
+export function seedDeclarationsKey(seeds) {
+    return seeds
+        .map((seed) => [
+        seed.productId,
+        seed.campaign ?? '',
+        seed.bundle ? '1' : '0',
+        seed.devices,
+        seed.subscription
+    ].join('|'))
+        .sort()
+        .join(';');
+}
+/**
+ * Turn the action elements owned by a compute boundary into static commands and
+ * dynamic domains. Reuses the same parser as the runtime action layer; the only
+ * difference is breadth: a select contributes all of its option children here,
+ * not just the selected one.
+ */
+export function scanActionElements(elements) {
+    const staticCommands = [];
+    const domains = [];
+    for (const element of elements) {
+        const scan = collectActionElementCompute(element);
+        staticCommands.push(...scan.staticCommands);
+        domains.push(...scan.domains);
+    }
+    return {
+        staticCommands,
+        domains
+    };
+}
+export function collectActionElementCompute(element) {
+    const domain = readComputeDomain(element);
+    if (domain) {
+        return {
+            staticCommands: [],
+            domains: [domain]
+        };
+    }
+    if (element instanceof HTMLSelectElement) {
+        const staticCommands = [];
+        collectSelectCommands(element, staticCommands);
+        return {
+            staticCommands,
+            domains: []
+        };
+    }
+    const command = element instanceof HTMLInputElement
+        ? readInputActionCommand(element)
+        : readBdActionCommand(element);
+    if (!command) {
+        return EMPTY_COMPUTE_SCAN;
+    }
+    return {
+        staticCommands: [command],
+        domains: []
+    };
+}
+export function mergeComputeScans(scans) {
+    const staticCommands = [];
+    const domains = [];
+    for (const scan of scans) {
+        staticCommands.push(...scan.staticCommands);
+        domains.push(...scan.domains);
+    }
+    return {
+        staticCommands,
+        domains
+    };
+}
+/**
+ * A select / control is a dynamic domain only when it is actionable AND tagged
+ * as a devices or subscription dimension. A plain `data-store-devices` span just
+ * renders the current value and contributes nothing to compute.
+ */
+export function readComputeDomain(element) {
+    if (!isActionElement(element)) {
+        return undefined;
+    }
+    if (element instanceof HTMLInputElement &&
+        (element.type === 'number' ||
+            element.type === 'text')) {
+        return readInputComputeDomain(element);
+    }
+    if (element.hasAttribute(DATA_DEVICES_DOMAIN)) {
+        return {
+            type: 'devices'
+        };
+    }
+    if (element.hasAttribute(DATA_SUBSCRIPTION_DOMAIN)) {
+        return {
+            type: 'subscription'
+        };
+    }
+    return undefined;
+}
+function readInputComputeDomain(input) {
+    const command = readBdActionCommand(input);
+    if (command?.kind !== 'update-by-delta') {
+        return undefined;
+    }
+    return {
+        type: command.update.type,
+        min: toOptionalNumber(input.min) ?? command.update.min,
+        max: toOptionalNumber(input.max) ?? command.update.max
+    };
+}
+function readInputActionCommand(input) {
+    switch (input.type) {
+        case 'number':
+        case 'text':
+            return readInputValueCommand(input);
+        default:
+            return readBdActionCommand(input);
+    }
+}
+function collectSelectCommands(select, out) {
+    let collected = false;
+    for (const option of Array.from(select.options)) {
+        const command = readBdActionCommand(option);
+        if (command) {
+            out.push(command);
+            collected = true;
+        }
+    }
+    if (collected) {
+        return;
+    }
+    const command = readBdActionCommand(select);
+    if (command?.kind === 'set-action') {
+        out.push(command);
+    }
+}
+function toOptionalNumber(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    const parsed = Number(trimmed);
+    return Number.isNaN(parsed)
+        ? undefined
+        : parsed;
+}
+//# sourceMappingURL=compute.scan.js.map