@repobit/dex-store-elements 1.7.2 → 2.0.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"compute.scan.js","sourceRoot":"","sources":["../../../src/compute/compute.scan.ts"],"names":[],"mappings":"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","sourcesContent":["// src/compute/compute.scan.ts\n\nimport {\n  isActionElement,\n  readBdActionCommand,\n  readInputValueCommand\n} from '@/actions/action.attributes.js';\nimport type { BdActionCommand } from '@/core/actions.js';\n\nexport const DATA_DEVICES_DOMAIN = 'data-store-devices' as const;\nexport const DATA_SUBSCRIPTION_DOMAIN = 'data-store-subscription' as const;\n\nexport type BdActionDomainKind = 'devices' | 'subscription';\n\nexport type BdActionDomain = Readonly<{\n  type: BdActionDomainKind;\n  min?: number;\n  max?: number;\n}>;\n\n/**\n * A declarative seed scenario used by standalone compute helpers. Live node\n * compute uses resolved ProductOption seeds collected from option nodes.\n */\nexport type BdSeedDeclaration = Readonly<{\n  productId   : string;\n  campaign?   : string;\n  bundle      : boolean;\n  devices     : number;\n  subscription: number;\n}>;\n\n/**\n * Result of scanning the action elements owned by a compute boundary.\n *\n * - staticCommands: concrete jumps (button says product-b, option says\n *   subscription=24, select option children, etc).\n * - domains: controls that represent a devices / subscription space of\n *   whatever product a scenario lands on. Inputs may bound that space by min/max.\n */\nexport type BdComputeScan = Readonly<{\n  staticCommands: readonly BdActionCommand[];\n  domains       : readonly BdActionDomain[];\n}>;\n\nexport const EMPTY_COMPUTE_SCAN: BdComputeScan = Object.freeze({\n  staticCommands: Object.freeze([]),\n  domains       : Object.freeze([])\n});\n\n/**\n * Stable fingerprint of the declared seeds. Used as a compute task arg so the\n * controller only reruns when the declared seed set actually changes, not on\n * every host update.\n */\nexport function seedDeclarationsKey(\n  seeds: readonly BdSeedDeclaration[]\n): string {\n  return seeds\n    .map((seed) =>\n      [\n        seed.productId,\n        seed.campaign ?? '',\n        seed.bundle ? '1' : '0',\n        seed.devices,\n        seed.subscription\n      ].join('|')\n    )\n    .sort()\n    .join(';');\n}\n\n/**\n * Turn the action elements owned by a compute boundary into static commands and\n * dynamic domains. Reuses the same parser as the runtime action layer; the only\n * difference is breadth: a select contributes all of its option children here,\n * not just the selected one.\n */\nexport function scanActionElements(\n  elements: Iterable<HTMLElement>\n): BdComputeScan {\n  const staticCommands: BdActionCommand[] = [];\n  const domains: BdActionDomain[] = [];\n\n  for (const element of elements) {\n    const scan = collectActionElementCompute(element);\n\n    staticCommands.push(...scan.staticCommands);\n    domains.push(...scan.domains);\n  }\n\n  return {\n    staticCommands,\n    domains\n  };\n}\n\nexport function collectActionElementCompute(\n  element: HTMLElement\n): BdComputeScan {\n  const domain = readComputeDomain(element);\n\n  if (domain) {\n    return {\n      staticCommands: [],\n      domains       : [domain]\n    };\n  }\n\n  if (element instanceof HTMLSelectElement) {\n    const staticCommands: BdActionCommand[] = [];\n\n    collectSelectCommands(\n      element,\n      staticCommands\n    );\n\n    return {\n      staticCommands,\n      domains: []\n    };\n  }\n\n  const command =\n    element instanceof HTMLInputElement\n      ? readInputActionCommand(element)\n      : readBdActionCommand(element);\n\n  if (!command) {\n    return EMPTY_COMPUTE_SCAN;\n  }\n\n  return {\n    staticCommands: [command],\n    domains       : []\n  };\n}\n\nexport function mergeComputeScans(\n  scans: Iterable<BdComputeScan>\n): BdComputeScan {\n  const staticCommands: BdActionCommand[] = [];\n  const domains: BdActionDomain[] = [];\n\n  for (const scan of scans) {\n    staticCommands.push(...scan.staticCommands);\n    domains.push(...scan.domains);\n  }\n\n  return {\n    staticCommands,\n    domains\n  };\n}\n\n/**\n * A select / control is a dynamic domain only when it is actionable AND tagged\n * as a devices or subscription dimension. A plain `data-store-devices` span just\n * renders the current value and contributes nothing to compute.\n */\nexport function readComputeDomain(\n  element: HTMLElement\n): BdActionDomain | undefined {\n  if (!isActionElement(element)) {\n    return undefined;\n  }\n\n  if (\n    element instanceof HTMLInputElement &&\n    (\n      element.type === 'number' ||\n      element.type === 'text'\n    )\n  ) {\n    return readInputComputeDomain(element);\n  }\n\n  if (element.hasAttribute(DATA_DEVICES_DOMAIN)) {\n    return {\n      type: 'devices'\n    };\n  }\n\n  if (element.hasAttribute(DATA_SUBSCRIPTION_DOMAIN)) {\n    return {\n      type: 'subscription'\n    };\n  }\n\n  return undefined;\n}\n\nfunction readInputComputeDomain(\n  input: HTMLInputElement\n): BdActionDomain | undefined {\n  const command = readBdActionCommand(input);\n\n  if (command?.kind !== 'update-by-delta') {\n    return undefined;\n  }\n\n  return {\n    type: command.update.type,\n    min : toOptionalNumber(input.min) ?? command.update.min,\n    max : toOptionalNumber(input.max) ?? command.update.max\n  };\n}\n\nfunction readInputActionCommand(\n  input: HTMLInputElement\n): BdActionCommand | undefined {\n  switch (input.type) {\n    case 'number':\n    case 'text':\n      return readInputValueCommand(input);\n\n    default:\n      return readBdActionCommand(input);\n  }\n}\n\nfunction collectSelectCommands(\n  select: HTMLSelectElement,\n  out: BdActionCommand[]\n): void {\n  let collected = false;\n\n  for (const option of Array.from(select.options)) {\n    const command = readBdActionCommand(option);\n\n    if (command) {\n      out.push(command);\n      collected = true;\n    }\n  }\n\n  if (collected) {\n    return;\n  }\n\n  const command = readBdActionCommand(select);\n\n  if (command?.kind === 'set-action') {\n    out.push(command);\n  }\n}\n\nfunction toOptionalNumber(\n  value: string | undefined\n): number | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n\n  const trimmed = value.trim();\n\n  if (!trimmed) {\n    return undefined;\n  }\n\n  const parsed = Number(trimmed);\n\n  return Number.isNaN(parsed)\n    ? undefined\n    : parsed;\n}\n"]}

package/dist/src/compute/option-resolver.d.ts

@@ -0,0 +1,31 @@
+import type { BdActionCommand } from '../core/actions.js';
+import type { Product, ProductOption, Store } from '@repobit/dex-store';
+/**
+ * A single reachable point in the product/option space: a resolved product and
+ * one of its resolved options. Both the runtime OptionNode and the dry-run
+ * compute layer reduce over these.
+ */
+export type BdOptionScenario = Readonly<{
+    product: Product;
+    option: ProductOption;
+}>;
+/**
+ * Stable identity for a scenario, used to deduplicate the fixed-point search so
+ * it terminates. Includes the product, the option dimensions, and any bundle
+ * members (a bundle changes price even when dimensions match).
+ */
+export declare function scenarioKey(scenario: BdOptionScenario): string;
+/**
+ * Apply one action command to a scenario as a pure dry-run and return the
+ * resulting scenario, or undefined when the command does not lead anywhere
+ * reachable (missing product/option, missing store for a cross-product jump).
+ *
+ * This mirrors the runtime semantics split across ProductNode (id / campaign /
+ * bundle) and OptionNode (devices / subscription), collapsed into a single
+ * step because compute operates on flat commands rather than the node tree.
+ */
+export declare function resolveScenarioCommand(params: Readonly<{
+    store?: Store;
+    scenario: BdOptionScenario;
+    command: BdActionCommand;
+}>): Promise<BdOptionScenario | undefined>;

package/dist/src/compute/option-resolver.js

@@ -0,0 +1,147 @@
+// src/compute/option-resolver.ts
+import { applyOptionUpdate } from '../core/option-update.js';
+/**
+ * Stable identity for a scenario, used to deduplicate the fixed-point search so
+ * it terminates. Includes the product, the option dimensions, and any bundle
+ * members (a bundle changes price even when dimensions match).
+ */
+export function scenarioKey(scenario) {
+    return productOptionKey(scenario.option);
+}
+function productOptionKey(option) {
+    const product = option.getProduct();
+    const bundleKey = option
+        .getBundle()
+        .map((member) => [
+        member.devicesFixed ? '1' : '0',
+        member.subscriptionFixed ? '1' : '0',
+        productOptionKey(member.option)
+    ].join(':'))
+        .sort()
+        .join(',');
+    return [
+        product.getId(),
+        product.getCampaign() ?? '',
+        option.getDevices(),
+        option.getSubscription(),
+        bundleKey
+    ].join('|');
+}
+/**
+ * Apply one action command to a scenario as a pure dry-run and return the
+ * resulting scenario, or undefined when the command does not lead anywhere
+ * reachable (missing product/option, missing store for a cross-product jump).
+ *
+ * This mirrors the runtime semantics split across ProductNode (id / campaign /
+ * bundle) and OptionNode (devices / subscription), collapsed into a single
+ * step because compute operates on flat commands rather than the node tree.
+ */
+export async function resolveScenarioCommand(params) {
+    if (params.command.kind === 'set-action') {
+        return await resolveSetActionScenario(params.store, params.scenario, params.command.action);
+    }
+    return await resolveDeltaScenario(params.scenario, params.command.update);
+}
+async function resolveSetActionScenario(store, scenario, action) {
+    const targetProduct = await resolveTargetProduct(store, scenario.product, action);
+    if (!targetProduct) {
+        return undefined;
+    }
+    const devices = action.devices ?? scenario.option.getDevices();
+    const subscription = action.subscription ?? scenario.option.getSubscription();
+    if (action.bundle && action.id) {
+        return await resolveBundleScenario({
+            store,
+            scenario,
+            targetProduct,
+            action,
+            devices,
+            subscription
+        });
+    }
+    const option = await targetProduct.getOption({
+        devices,
+        subscription
+    });
+    if (!option) {
+        return undefined;
+    }
+    return {
+        product: targetProduct,
+        option
+    };
+}
+async function resolveTargetProduct(store, currentProduct, action) {
+    if (action.id) {
+        if (!store) {
+            return undefined;
+        }
+        return await store.getProduct({
+            id: action.id,
+            campaign: action.campaign
+        });
+    }
+    if (action.campaign !== undefined &&
+        action.campaign !== currentProduct.getCampaign()) {
+        if (!store) {
+            return undefined;
+        }
+        return (await store.getProduct({
+            id: currentProduct.getId(),
+            campaign: action.campaign
+        })) ?? currentProduct;
+    }
+    return currentProduct;
+}
+async function resolveBundleScenario(params) {
+    const { store, scenario, action } = params;
+    if (!store || !action.id) {
+        return undefined;
+    }
+    const bundleProduct = await store.getProduct({
+        id: action.id,
+        campaign: action.campaign
+    });
+    if (!bundleProduct) {
+        return undefined;
+    }
+    const bundleOption = await bundleProduct.getOption({
+        devices: action.devices ?? scenario.option.getDevices(),
+        subscription: action.subscription ?? scenario.option.getSubscription()
+    });
+    if (!bundleOption) {
+        return undefined;
+    }
+    const bundled = await scenario.option.toogleBundle({
+        option: bundleOption,
+        devicesFixed: action.devices !== undefined,
+        subscriptionFixed: action.subscription !== undefined
+    });
+    if (!bundled) {
+        return undefined;
+    }
+    return {
+        product: bundled.getProduct(),
+        option: bundled
+    };
+}
+async function resolveDeltaScenario(scenario, update) {
+    const devices = applyOptionUpdate('devices', scenario.option.getDevices(), update, scenario.product);
+    const subscription = applyOptionUpdate('subscription', scenario.option.getSubscription(), update, scenario.product);
+    if (typeof devices !== 'number' ||
+        typeof subscription !== 'number') {
+        return undefined;
+    }
+    const option = await scenario.product.getOption({
+        devices,
+        subscription
+    });
+    if (!option) {
+        return undefined;
+    }
+    return {
+        product: scenario.product,
+        option
+    };
+}
+//# sourceMappingURL=option-resolver.js.map

package/dist/src/compute/option-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-resolver.js","sourceRoot":"","sources":["../../../src/compute/option-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["// src/compute/option-resolver.ts\n\nimport type {\n  Action,\n  BdActionCommand,\n  UpdateByDelta\n} from '@/core/actions.js';\nimport { applyOptionUpdate } from '@/core/option-update.js';\nimport type {\n  Product,\n  ProductOption,\n  Store\n} from '@repobit/dex-store';\n\n/**\n * A single reachable point in the product/option space: a resolved product and\n * one of its resolved options. Both the runtime OptionNode and the dry-run\n * compute layer reduce over these.\n */\nexport type BdOptionScenario = Readonly<{\n  product: Product;\n  option : ProductOption;\n}>;\n\n/**\n * Stable identity for a scenario, used to deduplicate the fixed-point search so\n * it terminates. Includes the product, the option dimensions, and any bundle\n * members (a bundle changes price even when dimensions match).\n */\nexport function scenarioKey(\n  scenario: BdOptionScenario\n): string {\n  return productOptionKey(scenario.option);\n}\n\nfunction productOptionKey(\n  option: ProductOption\n): string {\n  const product = option.getProduct();\n  const bundleKey =\n    option\n      .getBundle()\n      .map((member) =>\n        [\n          member.devicesFixed ? '1' : '0',\n          member.subscriptionFixed ? '1' : '0',\n          productOptionKey(member.option)\n        ].join(':')\n      )\n      .sort()\n      .join(',');\n\n  return [\n    product.getId(),\n    product.getCampaign() ?? '',\n    option.getDevices(),\n    option.getSubscription(),\n    bundleKey\n  ].join('|');\n}\n\n/**\n * Apply one action command to a scenario as a pure dry-run and return the\n * resulting scenario, or undefined when the command does not lead anywhere\n * reachable (missing product/option, missing store for a cross-product jump).\n *\n * This mirrors the runtime semantics split across ProductNode (id / campaign /\n * bundle) and OptionNode (devices / subscription), collapsed into a single\n * step because compute operates on flat commands rather than the node tree.\n */\nexport async function resolveScenarioCommand(\n  params: Readonly<{\n    store?  : Store;\n    scenario: BdOptionScenario;\n    command : BdActionCommand;\n  }>\n): Promise<BdOptionScenario | undefined> {\n  if (params.command.kind === 'set-action') {\n    return await resolveSetActionScenario(\n      params.store,\n      params.scenario,\n      params.command.action\n    );\n  }\n\n  return await resolveDeltaScenario(\n    params.scenario,\n    params.command.update\n  );\n}\n\nasync function resolveSetActionScenario(\n  store: Store | undefined,\n  scenario: BdOptionScenario,\n  action: Action\n): Promise<BdOptionScenario | undefined> {\n  const targetProduct =\n    await resolveTargetProduct(\n      store,\n      scenario.product,\n      action\n    );\n\n  if (!targetProduct) {\n    return undefined;\n  }\n\n  const devices =\n    action.devices ?? scenario.option.getDevices();\n\n  const subscription =\n    action.subscription ?? scenario.option.getSubscription();\n\n  if (action.bundle && action.id) {\n    return await resolveBundleScenario({\n      store,\n      scenario,\n      targetProduct,\n      action,\n      devices,\n      subscription\n    });\n  }\n\n  const option =\n    await targetProduct.getOption({\n      devices,\n      subscription\n    });\n\n  if (!option) {\n    return undefined;\n  }\n\n  return {\n    product: targetProduct,\n    option\n  };\n}\n\nasync function resolveTargetProduct(\n  store: Store | undefined,\n  currentProduct: Product,\n  action: Action\n): Promise<Product | undefined> {\n  if (action.id) {\n    if (!store) {\n      return undefined;\n    }\n\n    return await store.getProduct({\n      id      : action.id,\n      campaign: action.campaign\n    });\n  }\n\n  if (\n    action.campaign !== undefined &&\n    action.campaign !== currentProduct.getCampaign()\n  ) {\n    if (!store) {\n      return undefined;\n    }\n\n    return (\n      await store.getProduct({\n        id      : currentProduct.getId(),\n        campaign: action.campaign\n      })\n    ) ?? currentProduct;\n  }\n\n  return currentProduct;\n}\n\nasync function resolveBundleScenario(\n  params: Readonly<{\n    store?       : Store;\n    scenario     : BdOptionScenario;\n    targetProduct: Product;\n    action       : Action;\n    devices      : number;\n    subscription : number;\n  }>\n): Promise<BdOptionScenario | undefined> {\n  const { store, scenario, action } = params;\n\n  if (!store || !action.id) {\n    return undefined;\n  }\n\n  const bundleProduct =\n    await store.getProduct({\n      id      : action.id,\n      campaign: action.campaign\n    });\n\n  if (!bundleProduct) {\n    return undefined;\n  }\n\n  const bundleOption =\n    await bundleProduct.getOption({\n      devices     : action.devices ?? scenario.option.getDevices(),\n      subscription: action.subscription ?? scenario.option.getSubscription()\n    });\n\n  if (!bundleOption) {\n    return undefined;\n  }\n\n  const bundled =\n    await scenario.option.toogleBundle({\n      option           : bundleOption,\n      devicesFixed     : action.devices !== undefined,\n      subscriptionFixed: action.subscription !== undefined\n    });\n\n  if (!bundled) {\n    return undefined;\n  }\n\n  return {\n    product: bundled.getProduct(),\n    option : bundled\n  };\n}\n\nasync function resolveDeltaScenario(\n  scenario: BdOptionScenario,\n  update: UpdateByDelta\n): Promise<BdOptionScenario | undefined> {\n  const devices =\n    applyOptionUpdate(\n      'devices',\n      scenario.option.getDevices(),\n      update,\n      scenario.product\n    );\n\n  const subscription =\n    applyOptionUpdate(\n      'subscription',\n      scenario.option.getSubscription(),\n      update,\n      scenario.product\n    );\n\n  if (\n    typeof devices !== 'number' ||\n    typeof subscription !== 'number'\n  ) {\n    return undefined;\n  }\n\n  const option =\n    await scenario.product.getOption({\n      devices,\n      subscription\n    });\n\n  if (!option) {\n    return undefined;\n  }\n\n  return {\n    product: scenario.product,\n    option\n  };\n}\n"]}

package/dist/src/contexts/context.compute.d.ts

@@ -0,0 +1,12 @@
+export declare const bdComputeContext: {
+    __context__: Readonly<{
+        min: number;
+        max: number;
+        minFormatted: string;
+        maxFormatted: string;
+        scenarios: number;
+        price: import("../compute/compute.expand.js").BdComputeMonthlyRange;
+        discountedPrice: import("../compute/compute.expand.js").BdComputeMonthlyRange;
+        discount: import("../compute/compute.expand.js").BdComputeDiscountRange;
+    }> | undefined;
+};

package/dist/src/contexts/context.compute.js

@@ -0,0 +1,4 @@
+// src/contexts/context.compute.ts
+import { createContext } from '@lit/context';
+export const bdComputeContext = createContext(Symbol.for('bd-compute-context'));
+//# sourceMappingURL=context.compute.js.map

package/dist/src/contexts/context.compute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.compute.js","sourceRoot":"","sources":["../../../src/contexts/context.compute.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAI7C,MAAM,CAAC,MAAM,gBAAgB,GAC3B,aAAa,CACX,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CACjC,CAAC","sourcesContent":["// src/contexts/context.compute.ts\n\nimport { createContext } from '@lit/context';\n\nimport type { BdComputeResult } from '@/compute/compute.expand.js';\n\nexport const bdComputeContext =\n  createContext<BdComputeResult | undefined>(\n    Symbol.for('bd-compute-context')\n  );"]}

package/dist/src/contexts/context.scope.d.ts

@@ -0,0 +1,139 @@
+import type { BdComputeResult } from '../compute/compute.expand.js';
+import type { BdTransition } from '../core/actions.js';
+import type { EtaMutationBatchSchedule } from '../eta/types.js';
+import type { Product, ProductOption, Store } from '@repobit/dex-store';
+/**
+ * Shape that `derived(scope, compute)` callbacks receive.
+ *
+ * The four fields mirror `BdScopedTemplateContext`. A `derived`
+ * factory reads from this input and returns a new object whose
+ * properties are exposed to templates under the `derived` key.
+ */
+export type BdScopeDerivationInput = Readonly<{
+    store: Store | undefined;
+    product: Product | undefined;
+    option: ProductOption | undefined;
+}>;
+/**
+ * Result shape of a `derived` factory.
+ *
+ * Returned object is shallow-merged into the Eta context under
+ * the `derived` key, so templates can write `<%= it.derived.foo %>`
+ * instead of pulling each derived value into the top-level scope.
+ *
+ * The default is `unknown` to allow flexible per-scope shapes; a
+ * concrete node can narrow it locally via a typed wrapper.
+ */
+export type BdScopeDerived = Readonly<Record<string, unknown>>;
+/**
+ * Pure function that derives additional Eta template context
+ * from the current scope and compute result.
+ *
+ * The function MUST be pure — it is invoked synchronously inside
+ * `EtaTemplateController`'s `context` callback on every render.
+ * The same `store` / `product` / `option` identity arguments
+ * produce the same output (by reference) so the `@lit/task` args
+ * tuple can short-circuit re-renders.
+ *
+ * @example
+ *
+ * ```ts
+ * const scope: BdScope = {
+ *   ...createBdStoreScope(store),
+ *   derived: ({ store, product, option }) => ({
+ *     hasProduct: Boolean(product),
+ *     canBuy    : Boolean(store && product && option)
+ *   })
+ * };
+ * ```
+ */
+export type BdScopeDeriveFn = (scope: BdScopeDerivationInput) => BdScopeDerived;
+/**
+ * Snapshot delivered to `BdScope.onScopeChange` callbacks.
+ *
+ * Intentionally narrow — the hook fires when the published
+ * scope of a `BdScopedElement` changes, but consumers should
+ * only need the fields that drive template rendering. Adding a
+ * new field here is a public surface change (every consumer can
+ * read it), so prefer extending `BdScope` and rebinding this
+ * snapshot rather than spreading the full scope.
+ *
+ * `state` carries the current compute result for the scope;
+ * `undefined` when compute is disabled or has not run yet.
+ */
+export type BdScopeChangeSnapshot = Readonly<{
+    store: Store | undefined;
+    product: Product | undefined;
+    option: ProductOption | undefined;
+    state: BdComputeResult | undefined;
+}>;
+/**
+ * Callback fired when the published scope of a
+ * `BdScopedElement` changes.
+ *
+ * Invoked from `BdScopedElement.publishScope(...)` when the
+ * normalized published scope reference actually changes, and
+ * from `BdScopedElement.clearScope()` with all-undefined fields
+ * when the scope is cleared. The hook receives the new
+ * snapshot — it does NOT need to read the scope itself.
+ *
+ * The hook is stored on the published scope (`BdScope.onScopeChange`)
+ * so it cascades to descendants via `parentScope.onScopeChange`.
+ * Descendants may override the inherited hook by supplying
+ * their own `onScopeChange` property.
+ */
+export type BdScopeChangeFn = (snapshot: BdScopeChangeSnapshot) => void;
+export type BdDataLayerEvent = 'all' | 'info' | 'comparison' | (string & {});
+export type BdDataLayerPayload = Readonly<{
+    option: ProductOption;
+    event: BdDataLayerEvent;
+}>;
+export type BdDataLayerFn = (payload: BdDataLayerPayload) => void;
+export type BdScope = Readonly<Partial<{
+    store: Store;
+    product: Product;
+    option: ProductOption;
+    transition: BdTransition;
+    computeDisabled: boolean;
+    etaDisabled: boolean;
+    derived: BdScopeDeriveFn;
+    mutationBatchSchedule: EtaMutationBatchSchedule;
+    onScopeChange: BdScopeChangeFn;
+    dataLayer: BdDataLayerFn;
+}>>;
+/**
+ * Result of running `scope.derived(scope)` — exposed by helpers
+ * that want to apply the derivation outside the Eta context
+ * builder (e.g. tests, diagnostics).
+ */
+export type BdDerivedResult = BdScopeDerived;
+export declare function createBdStoreScope(store: Store, transition?: BdTransition): BdScope;
+export declare function extendBdContextScope(parentScope: BdScope, transition?: BdTransition): BdScope;
+export declare function extendBdProductScope(parentScope: BdScope, product: Product, transition?: BdTransition): BdScope;
+export declare function extendBdOptionScope(parentScope: BdScope, option: ProductOption, transition?: BdTransition): BdScope;
+/**
+ * Invokes `scope.derived` when present, otherwise returns
+ * `undefined`.
+ *
+ * Exposed so non-Eta consumers (tests, diagnostics, future
+ * controllers) can reuse the same derivation rule without going
+ * through `EtaTemplateController`. Returning `undefined` when no
+ * `derived` is configured keeps the caller in charge of deciding
+ * what to do with the absence (omit the `derived` key vs.
+ * publish an empty object).
+ */
+export declare function runBdScopeDerived(scope: BdScope | undefined): BdDerivedResult | undefined;
+export declare const bdScopeContext: {
+    __context__: Readonly<Partial<{
+        store: Store;
+        product: Product;
+        option: ProductOption;
+        transition: BdTransition;
+        computeDisabled: boolean;
+        etaDisabled: boolean;
+        derived: BdScopeDeriveFn;
+        mutationBatchSchedule: EtaMutationBatchSchedule;
+        onScopeChange: BdScopeChangeFn;
+        dataLayer: BdDataLayerFn;
+    }>> | undefined;
+};

package/dist/src/contexts/context.scope.js

@@ -0,0 +1,48 @@
+import { createContext } from '@lit/context';
+export function createBdStoreScope(store, transition) {
+    return {
+        store,
+        transition
+    };
+}
+export function extendBdContextScope(parentScope, transition) {
+    return {
+        ...parentScope,
+        transition
+    };
+}
+export function extendBdProductScope(parentScope, product, transition) {
+    return {
+        ...parentScope,
+        product,
+        option: undefined,
+        transition
+    };
+}
+export function extendBdOptionScope(parentScope, option, transition) {
+    return {
+        ...parentScope,
+        option,
+        transition
+    };
+}
+/**
+ * Invokes `scope.derived` when present, otherwise returns
+ * `undefined`.
+ *
+ * Exposed so non-Eta consumers (tests, diagnostics, future
+ * controllers) can reuse the same derivation rule without going
+ * through `EtaTemplateController`. Returning `undefined` when no
+ * `derived` is configured keeps the caller in charge of deciding
+ * what to do with the absence (omit the `derived` key vs.
+ * publish an empty object).
+ */
+export function runBdScopeDerived(scope) {
+    return scope?.derived?.({
+        store: scope.store,
+        product: scope.product,
+        option: scope.option
+    });
+}
+export const bdScopeContext = createContext(Symbol.for('bd:scope'));
+//# sourceMappingURL=context.scope.js.map

package/dist/src/contexts/context.scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.scope.js","sourceRoot":"","sources":["../../../src/contexts/context.scope.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgI7C,MAAM,UAAU,kBAAkB,CAChC,KAAY,EACZ,UAAyB;IAEzB,OAAO;QACL,KAAK;QACL,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,WAAoB,EACpB,UAAyB;IAEzB,OAAO;QACL,GAAG,WAAW;QACd,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,WAAoB,EACpB,OAAgB,EAChB,UAAyB;IAEzB,OAAO;QACL,GAAG,WAAW;QACd,OAAO;QACP,MAAM,EAAE,SAAS;QACjB,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,WAAoB,EACpB,MAAqB,EACrB,UAAyB;IAEzB,OAAO;QACL,GAAG,WAAW;QACd,MAAM;QACN,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA0B;IAE1B,OAAO,KAAK,EAAE,OAAO,EAAE,CAAC;QACtB,KAAK,EAAI,KAAK,CAAC,KAAK;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAG,KAAK,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GACzB,aAAa,CACX,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CACvB,CAAC","sourcesContent":["import type { BdComputeResult } from '@/compute/compute.expand.js';\nimport type { BdTransition } from '@/core/actions.js';\nimport type { EtaMutationBatchSchedule } from '@/eta/types.js';\nimport { createContext } from '@lit/context';\nimport type { Product, ProductOption, Store } from '@repobit/dex-store';\n\n/**\n * Shape that `derived(scope, compute)` callbacks receive.\n *\n * The four fields mirror `BdScopedTemplateContext`. A `derived`\n * factory reads from this input and returns a new object whose\n * properties are exposed to templates under the `derived` key.\n */\nexport type BdScopeDerivationInput = Readonly<{\n  store  : Store | undefined;\n  product: Product | undefined;\n  option : ProductOption | undefined;\n}>;\n\n/**\n * Result shape of a `derived` factory.\n *\n * Returned object is shallow-merged into the Eta context under\n * the `derived` key, so templates can write `<%= it.derived.foo %>`\n * instead of pulling each derived value into the top-level scope.\n *\n * The default is `unknown` to allow flexible per-scope shapes; a\n * concrete node can narrow it locally via a typed wrapper.\n */\nexport type BdScopeDerived = Readonly<Record<string, unknown>>;\n\n/**\n * Pure function that derives additional Eta template context\n * from the current scope and compute result.\n *\n * The function MUST be pure — it is invoked synchronously inside\n * `EtaTemplateController`'s `context` callback on every render.\n * The same `store` / `product` / `option` identity arguments\n * produce the same output (by reference) so the `@lit/task` args\n * tuple can short-circuit re-renders.\n *\n * @example\n *\n * ```ts\n * const scope: BdScope = {\n *   ...createBdStoreScope(store),\n *   derived: ({ store, product, option }) => ({\n *     hasProduct: Boolean(product),\n *     canBuy    : Boolean(store && product && option)\n *   })\n * };\n * ```\n */\nexport type BdScopeDeriveFn = (\n  scope : BdScopeDerivationInput\n) => BdScopeDerived;\n\n/**\n * Snapshot delivered to `BdScope.onScopeChange` callbacks.\n *\n * Intentionally narrow — the hook fires when the published\n * scope of a `BdScopedElement` changes, but consumers should\n * only need the fields that drive template rendering. Adding a\n * new field here is a public surface change (every consumer can\n * read it), so prefer extending `BdScope` and rebinding this\n * snapshot rather than spreading the full scope.\n *\n * `state` carries the current compute result for the scope;\n * `undefined` when compute is disabled or has not run yet.\n */\nexport type BdScopeChangeSnapshot = Readonly<{\n  store  : Store | undefined;\n  product: Product | undefined;\n  option : ProductOption | undefined;\n  state  : BdComputeResult | undefined;\n}>;\n\n/**\n * Callback fired when the published scope of a\n * `BdScopedElement` changes.\n *\n * Invoked from `BdScopedElement.publishScope(...)` when the\n * normalized published scope reference actually changes, and\n * from `BdScopedElement.clearScope()` with all-undefined fields\n * when the scope is cleared. The hook receives the new\n * snapshot — it does NOT need to read the scope itself.\n *\n * The hook is stored on the published scope (`BdScope.onScopeChange`)\n * so it cascades to descendants via `parentScope.onScopeChange`.\n * Descendants may override the inherited hook by supplying\n * their own `onScopeChange` property.\n */\nexport type BdScopeChangeFn = (\n  snapshot: BdScopeChangeSnapshot\n) => void;\n\nexport type BdDataLayerEvent =\n  | 'all'\n  | 'info'\n  | 'comparison'\n  | (string & {});\n\nexport type BdDataLayerPayload = Readonly<{\n  option: ProductOption;\n  event : BdDataLayerEvent;\n}>;\n\nexport type BdDataLayerFn = (\n  payload: BdDataLayerPayload\n) => void;\n\nexport type BdScope = Readonly<Partial<{\n  store                : Store;\n  product              : Product;\n  option               : ProductOption;\n  transition           : BdTransition;\n  computeDisabled      : boolean;\n  etaDisabled          : boolean;\n  derived              : BdScopeDeriveFn;\n  mutationBatchSchedule: EtaMutationBatchSchedule;\n  onScopeChange        : BdScopeChangeFn;\n  dataLayer            : BdDataLayerFn;\n}>>\n\n/**\n * Result of running `scope.derived(scope)` — exposed by helpers\n * that want to apply the derivation outside the Eta context\n * builder (e.g. tests, diagnostics).\n */\nexport type BdDerivedResult = BdScopeDerived;\n\nexport function createBdStoreScope(\n  store: Store,\n  transition?: BdTransition\n): BdScope {\n  return {\n    store,\n    transition\n  };\n}\n\nexport function extendBdContextScope(\n  parentScope: BdScope,\n  transition?: BdTransition\n): BdScope {\n  return {\n    ...parentScope,\n    transition\n  };\n}\n\nexport function extendBdProductScope(\n  parentScope: BdScope,\n  product: Product,\n  transition?: BdTransition\n): BdScope {\n  return {\n    ...parentScope,\n    product,\n    option: undefined,\n    transition\n  };\n}\n\nexport function extendBdOptionScope(\n  parentScope: BdScope,\n  option: ProductOption,\n  transition?: BdTransition\n): BdScope {\n  return {\n    ...parentScope,\n    option,\n    transition\n  };\n}\n\n/**\n * Invokes `scope.derived` when present, otherwise returns\n * `undefined`.\n *\n * Exposed so non-Eta consumers (tests, diagnostics, future\n * controllers) can reuse the same derivation rule without going\n * through `EtaTemplateController`. Returning `undefined` when no\n * `derived` is configured keeps the caller in charge of deciding\n * what to do with the absence (omit the `derived` key vs.\n * publish an empty object).\n */\nexport function runBdScopeDerived(\n  scope: BdScope | undefined\n): BdDerivedResult | undefined {\n  return scope?.derived?.({\n    store  : scope.store,\n    product: scope.product,\n    option : scope.option\n  });\n}\n\nexport const bdScopeContext =\n  createContext<BdScope | undefined>(\n    Symbol.for('bd:scope')\n  );\n"]}