@elqora/dgp-core 1.0.0

package/README.md

@@ -0,0 +1,83 @@
+# DGP Core
+
+DGP Core is the framework-neutral interpreter for canonical Digital Goods Protocol product definitions. It resolves product context, visibility, relationships, selected-trigger effects, service bindings, capabilities, and fallback registrations into deterministic query results.
+
+DGP Core does not render interfaces, implement editorial workflows, or execute fulfillment. DGP Ordering handles customer orchestration, DGP Workspace supplies reusable editorial infrastructure, and the DGP SDK defines backend execution.
+
+## Responsibilities
+
+- Deterministic product indexing
+- Cycle-safe graph, lineage, and relationship traversal
+- Context and visibility resolution
+- Recursive option traversal and selected-trigger effect resolution
+- Service binding and capability resolution
+- Node-first, then global fallback-candidate resolution
+- A composed, reusable product interpreter
+
+Core accepts canonical v1 definitions as-is. It does not repair or normalize legacy documents, validate publication coherence, mutate customer values, execute expressions, calculate utilities, or select an operational fallback service. Those concerns belong to their owning packages or the backend handler.
+
+## Install
+
+Node.js 22 or newer is required.
+
+```sh
+npm install @elqora/dgp-core @elqora/dgp-spec
+```
+
+## Usage
+
+```ts
+import { createProductInterpreter } from "@elqora/dgp-core";
+
+const product = createProductInterpreter(definition);
+const context = product.resolveContext("checkout", selectedTriggerIds);
+
+context?.visibility.fieldIds;
+context?.capabilities.values;
+```
+
+Public functions are pure with respect to the supplied definition. Returned collections are newly allocated unless explicitly documented as canonical source nodes.
+
+## Interpretation rules
+
+- Filter lineage is returned root-first and traversal terminates safely if a malformed cycle is encountered.
+- Fields bound to the active filter or an ancestor are visible. Only the active filter's direct `includes` and `excludes` apply.
+- Selected field-button and option triggers apply only when their owning field belongs to the active lineage.
+- A nearer trigger overrides an ancestor trigger; at equal depth, exclusion wins.
+- `order_for_tags` pins visible fields first without introducing hidden fields.
+- Ancestor capability requirements take precedence over conflicting descendant declarations, and their origin filter is reported without modifying the document.
+- Option effects may reveal a field and narrow its recursively indexed options. Value effects are returned as declarations for Ordering to apply.
+- Fallback registrations are listed node-first and then by the primary service's global list, with duplicates and self-references removed. Backend policy still decides operational eligibility.
+
+## Development
+
+```sh
+npm install
+npm run lint
+npm run typecheck
+npm test
+npm run check:boundaries
+npm run build
+npm run check
+```
+
+`npm run check` is the repository completion command. It runs linting, strict type checking, tests, dependency/source boundary checks, and the distributable build. Build output in `dist/` is generated and is not committed.
+
+## Ecosystem
+
+- [DGP Spec](https://github.com/elqora/dgp-spec) owns canonical contracts.
+- [DGP Validation](https://github.com/elqora/dgp-validation) validates definitions for ingestion and publication.
+- [DGP Ordering](https://github.com/elqora/dgp-ordering) orchestrates customer ordering flows.
+- [DGP Ordering Form Palette](https://github.com/elqora/dgp-ordering-form-palette) provides the optional Form Palette integration.
+- [DGP Workspace](https://github.com/elqora/dgp-workspace) provides reusable editorial infrastructure.
+- [DGP Studio](https://github.com/elqora/dgp-studio) provides visual authoring, testing, and publication UX.
+- [DGP SDK](https://github.com/elqora/dgp-sdk) defines backend handler and fulfillment contracts.
+- [Digital Service Engine](https://github.com/timeax/digital-service-engine) is the legacy migration source and behavioral reference.
+
+## Status
+
+The initial DGP v1 interpretation slice is implemented against `@elqora/dgp-spec` 1.x.
+
+## License
+
+GPL-3.0-only.

package/dist/capabilities.d.ts

@@ -0,0 +1,13 @@
+import type { CapabilityRequirements, HandlerService, ProductDefinition, ServiceId } from "@elqora/dgp-spec";
+import { type ProductIndex } from "./indexer.js";
+export interface ResolvedCapabilities {
+    values: Readonly<Record<string, boolean>>;
+    origins: Readonly<Record<string, string>>;
+}
+export declare function resolveCapabilities(index: ProductIndex, filterId: string): ResolvedCapabilities;
+export declare function resolveDefinitionCapabilities(definition: ProductDefinition, filterId: string): ResolvedCapabilities;
+export declare function serviceCapabilityEnabled(service: HandlerService, capabilityId: string): boolean;
+export declare function serviceSatisfiesCapabilities(service: HandlerService, requirements: CapabilityRequirements): boolean;
+export declare function matchingServicesForFilter(index: ProductIndex, filterId: string, services: readonly HandlerService[]): HandlerService[];
+export declare function findService(services: readonly HandlerService[], serviceId: ServiceId): HandlerService | undefined;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EACtB,cAAc,EACd,iBAAiB,EACjB,SAAS,EACV,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAa/F;AAED,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,MAAM,GACf,oBAAoB,CAEtB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAE/F;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,sBAAsB,GACnC,OAAO,CAIT;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,cAAc,EAAE,CAKlB;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,SAAS,EAAE,SAAS,GACnB,cAAc,GAAG,SAAS,CAE5B"}

package/dist/capabilities.js

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: GPL-3.0-only
+import { createProductIndex } from "./indexer.js";
+export function resolveCapabilities(index, filterId) {
+    const values = {};
+    const origins = {};
+    for (const filter of index.filterLineage(filterId)) {
+        for (const [capabilityId, required] of Object.entries(filter.capabilities ?? {})) {
+            if (Object.hasOwn(values, capabilityId))
+                continue;
+            values[capabilityId] = required;
+            origins[capabilityId] = filter.id;
+        }
+    }
+    return { values, origins };
+}
+export function resolveDefinitionCapabilities(definition, filterId) {
+    return resolveCapabilities(createProductIndex(definition), filterId);
+}
+export function serviceCapabilityEnabled(service, capabilityId) {
+    return service.capabilities[capabilityId]?.enabled === true;
+}
+export function serviceSatisfiesCapabilities(service, requirements) {
+    return Object.entries(requirements).every(([capabilityId, required]) => serviceCapabilityEnabled(service, capabilityId) === required);
+}
+export function matchingServicesForFilter(index, filterId, services) {
+    const requirements = resolveCapabilities(index, filterId).values;
+    return services.filter((service) => service.state === "enabled" && serviceSatisfiesCapabilities(service, requirements));
+}
+export function findService(services, serviceId) {
+    return services.find((service) => String(service.id) === String(serviceId));
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,wCAAwC;AASxC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC;AAOrE,MAAM,UAAU,mBAAmB,CAAC,KAAmB,EAAE,QAAgB;IACvE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,KAAK,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,CAAC;YACjF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;gBAAE,SAAS;YAClD,MAAM,CAAC,YAAY,CAAC,GAAG,QAAQ,CAAC;YAChC,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,UAA6B,EAC7B,QAAgB;IAEhB,OAAO,mBAAmB,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAuB,EAAE,YAAoB;IACpF,OAAO,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAAuB,EACvB,YAAoC;IAEpC,OAAO,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,EAAE,QAAQ,CAAC,EAAE,EAAE,CACrE,wBAAwB,CAAC,OAAO,EAAE,YAAY,CAAC,KAAK,QAAQ,CAC7D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAmB,EACnB,QAAgB,EAChB,QAAmC;IAEnC,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC;IACjE,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,4BAA4B,CAAC,OAAO,EAAE,YAAY,CAAC,CAChG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,QAAmC,EACnC,SAAoB;IAEpB,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,12 @@
+import type { ProductField, ProductFilter } from "@elqora/dgp-spec";
+import type { ProductIndex } from "./indexer.js";
+export interface ResolvedFilterContext {
+    filter: ProductFilter;
+    lineage: ProductFilter[];
+    lineageDepths: ReadonlyMap<string, number>;
+}
+export declare function resolveFilterContext(index: ProductIndex, filterId: string): ResolvedFilterContext | undefined;
+export declare function fieldOwnerDepth(field: ProductField, lineageDepths: ReadonlyMap<string, number>): number | undefined;
+export declare function triggerOwnerDepth(index: ProductIndex, triggerId: string, lineageDepths: ReadonlyMap<string, number>): number | undefined;
+export declare function relevantSelectedTriggers(index: ProductIndex, filterId: string, selectedTriggerIds: Iterable<string>): string[];
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,GACf,qBAAqB,GAAG,SAAS,CAYnC;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,MAAM,GAAG,SAAS,CAYpB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACzC,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACnC,MAAM,EAAE,CAQV"}

package/dist/context.js

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: GPL-3.0-only
+export function resolveFilterContext(index, filterId) {
+    const filter = index.getFilter(filterId);
+    if (filter === undefined)
+        return undefined;
+    const lineage = index.filterLineage(filterId);
+    const lineageDepths = new Map();
+    for (let indexFromSelf = lineage.length - 1; indexFromSelf >= 0; indexFromSelf -= 1) {
+        const item = lineage[indexFromSelf];
+        if (item !== undefined)
+            lineageDepths.set(item.id, lineage.length - 1 - indexFromSelf);
+    }
+    return { filter, lineage, lineageDepths };
+}
+export function fieldOwnerDepth(field, lineageDepths) {
+    const bindIds = field.bind_id === undefined
+        ? []
+        : Array.isArray(field.bind_id)
+            ? field.bind_id
+            : [field.bind_id];
+    let closest;
+    for (const bindId of bindIds) {
+        const depth = lineageDepths.get(bindId);
+        if (depth !== undefined && (closest === undefined || depth < closest))
+            closest = depth;
+    }
+    return closest;
+}
+export function triggerOwnerDepth(index, triggerId, lineageDepths) {
+    const node = index.getNode(triggerId);
+    if (node.kind === "field") {
+        return node.field.button === true ? fieldOwnerDepth(node.field, lineageDepths) : undefined;
+    }
+    if (node.kind === "option")
+        return fieldOwnerDepth(node.field, lineageDepths);
+    return undefined;
+}
+export function relevantSelectedTriggers(index, filterId, selectedTriggerIds) {
+    const context = resolveFilterContext(index, filterId);
+    if (context === undefined)
+        return [];
+    const relevant = [];
+    for (const triggerId of selectedTriggerIds) {
+        if (triggerOwnerDepth(index, triggerId, context.lineageDepths) !== undefined)
+            relevant.push(triggerId);
+    }
+    return relevant;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAYxC,MAAM,UAAU,oBAAoB,CAClC,KAAmB,EACnB,QAAgB;IAEhB,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,KAAK,IAAI,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,aAAa,IAAI,CAAC,EAAE,aAAa,IAAI,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;QACpC,IAAI,IAAI,KAAK,SAAS;YAAE,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,GAAG,aAAa,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAmB,EACnB,aAA0C;IAE1C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,KAAK,SAAS;QACzC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YAC5B,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtB,IAAI,OAA2B,CAAC;IAChC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC;YAAE,OAAO,GAAG,KAAK,CAAC;IACzF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAmB,EACnB,SAAiB,EACjB,aAA0C;IAE1C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC9E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAmB,EACnB,QAAgB,EAChB,kBAAoC;IAEpC,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;QAC3C,IAAI,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/effects.d.ts

@@ -0,0 +1,10 @@
+import type { FieldValueEffect, ProductDefinition } from "@elqora/dgp-spec";
+import { type ProductIndex } from "./indexer.js";
+export interface ResolvedValueEffect {
+    triggerId: string;
+    targetFieldId: string;
+    effect: FieldValueEffect;
+}
+export declare function resolveValueEffectsWithIndex(definition: ProductDefinition, index: ProductIndex, filterId: string, selectedTriggerIds: Iterable<string>): ResolvedValueEffect[];
+export declare function resolveValueEffects(definition: ProductDefinition, filterId: string, selectedTriggerIds: Iterable<string>): ResolvedValueEffect[];
+//# sourceMappingURL=effects.d.ts.map

package/dist/effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../src/effects.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG5E,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACnC,mBAAmB,EAAE,CAUvB;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,iBAAiB,EAC7B,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACnC,mBAAmB,EAAE,CAOvB"}

package/dist/effects.js

@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: GPL-3.0-only
+import { relevantSelectedTriggers } from "./context.js";
+import { createProductIndex } from "./indexer.js";
+export function resolveValueEffectsWithIndex(definition, index, filterId, selectedTriggerIds) {
+    const effects = [];
+    for (const triggerId of relevantSelectedTriggers(index, filterId, selectedTriggerIds)) {
+        for (const [targetFieldId, effect] of Object.entries(definition.value_effects_for_triggers[triggerId] ?? {})) {
+            effects.push({ triggerId, targetFieldId, effect });
+        }
+    }
+    return effects;
+}
+export function resolveValueEffects(definition, filterId, selectedTriggerIds) {
+    return resolveValueEffectsWithIndex(definition, createProductIndex(definition), filterId, selectedTriggerIds);
+}
+//# sourceMappingURL=effects.js.map

package/dist/effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.js","sourceRoot":"","sources":["../src/effects.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAIxC,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC;AAQrE,MAAM,UAAU,4BAA4B,CAC1C,UAA6B,EAC7B,KAAmB,EACnB,QAAgB,EAChB,kBAAoC;IAEpC,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,KAAK,MAAM,SAAS,IAAI,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,kBAAkB,CAAC,EAAE,CAAC;QACtF,KAAK,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAClD,UAAU,CAAC,0BAA0B,CAAC,SAAS,CAAC,IAAI,EAAE,CACvD,EAAE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,UAA6B,EAC7B,QAAgB,EAChB,kBAAoC;IAEpC,OAAO,4BAA4B,CACjC,UAAU,EACV,kBAAkB,CAAC,UAAU,CAAC,EAC9B,QAAQ,EACR,kBAAkB,CACnB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./capabilities.js";
+export * from "./context.js";
+export * from "./effects.js";
+export * from "./indexer.js";
+export * from "./interpreter.js";
+export * from "./options.js";
+export * from "./services.js";
+export * from "./visibility.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: GPL-3.0-only
+export * from "./capabilities.js";
+export * from "./context.js";
+export * from "./effects.js";
+export * from "./indexer.js";
+export * from "./interpreter.js";
+export * from "./options.js";
+export * from "./services.js";
+export * from "./visibility.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC"}

package/dist/indexer.d.ts

@@ -0,0 +1,37 @@
+import type { FieldOption, ProductDefinition, ProductField, ProductFilter } from "@elqora/dgp-spec";
+export type ProductNodeKind = "filter" | "field" | "option" | "unknown";
+export type FilterRelation = "self" | "ancestor" | "descendant" | "unrelated";
+export type IndexedProductNode = {
+    kind: "filter";
+    id: string;
+    filter: ProductFilter;
+} | {
+    kind: "field";
+    id: string;
+    field: ProductField;
+} | {
+    kind: "option";
+    id: string;
+    option: FieldOption;
+    field: ProductField;
+} | {
+    kind: "unknown";
+    id: string;
+};
+export interface ProductIndex {
+    readonly definition: ProductDefinition;
+    getNode(id: string): IndexedProductNode;
+    getFilter(id: string): ProductFilter | undefined;
+    getField(id: string): ProductField | undefined;
+    getOption(id: string): FieldOption | undefined;
+    getOptionOwner(id: string): ProductField | undefined;
+    filterLineage(id: string): ProductFilter[];
+    filterChildren(id: string): ProductFilter[];
+    filterDescendants(id: string): ProductFilter[];
+    relationBetweenFilters(baseId: string, otherId: string): FilterRelation;
+    fieldBindIds(fieldOrId: ProductField | string): string[];
+    nodeFilterIds(nodeId: string): string[];
+    isFieldBoundWithin(fieldOrId: ProductField | string, filterId: string): boolean;
+}
+export declare function createProductIndex(definition: ProductDefinition): ProductIndex;
+//# sourceMappingURL=indexer.d.ts.map

package/dist/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../src/indexer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIpG,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAE9E,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,CAAC;IACxC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IAC/C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC/C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACrD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAC3C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAC5C,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/C,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAAC;IACxE,YAAY,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;IACzD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxC,kBAAkB,CAAC,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CACjF;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB,GAAG,YAAY,CA8G9E"}

package/dist/indexer.js

@@ -0,0 +1,119 @@
+// SPDX-License-Identifier: GPL-3.0-only
+import { walkFieldOptions } from "./options.js";
+export function createProductIndex(definition) {
+    const filters = new Map();
+    const fields = new Map();
+    const options = new Map();
+    const children = new Map();
+    for (const filter of definition.filters) {
+        if (!filters.has(filter.id))
+            filters.set(filter.id, filter);
+    }
+    for (const field of definition.fields) {
+        if (!fields.has(field.id))
+            fields.set(field.id, field);
+        for (const visit of walkFieldOptions(field)) {
+            if (!options.has(visit.optionId)) {
+                options.set(visit.optionId, { option: visit.option, field });
+            }
+        }
+    }
+    for (const filter of definition.filters) {
+        if (filter.bind_id === undefined || !filters.has(filter.bind_id))
+            continue;
+        const siblings = children.get(filter.bind_id) ?? [];
+        siblings.push(filter);
+        children.set(filter.bind_id, siblings);
+    }
+    function getFilter(id) {
+        return filters.get(id);
+    }
+    function getField(id) {
+        return fields.get(id);
+    }
+    function filterLineage(id) {
+        const reversed = [];
+        const seen = new Set();
+        let current = filters.get(id);
+        while (current !== undefined && !seen.has(current.id)) {
+            reversed.push(current);
+            seen.add(current.id);
+            current = current.bind_id === undefined ? undefined : filters.get(current.bind_id);
+        }
+        return reversed.reverse();
+    }
+    function fieldBindIds(fieldOrId) {
+        const field = typeof fieldOrId === "string" ? fields.get(fieldOrId) : fieldOrId;
+        if (field?.bind_id === undefined)
+            return [];
+        return Array.isArray(field.bind_id) ? [...field.bind_id] : [field.bind_id];
+    }
+    function nodeFilterIds(nodeId) {
+        const filter = filters.get(nodeId);
+        if (filter !== undefined)
+            return [filter.id];
+        const field = fields.get(nodeId);
+        if (field !== undefined)
+            return fieldBindIds(field);
+        const option = options.get(nodeId);
+        return option === undefined ? [] : fieldBindIds(option.field);
+    }
+    function filterDescendants(id) {
+        const result = [];
+        const visited = new Set([id]);
+        const queue = [...(children.get(id) ?? [])];
+        while (queue.length > 0) {
+            const filter = queue.shift();
+            if (filter === undefined || visited.has(filter.id))
+                continue;
+            visited.add(filter.id);
+            result.push(filter);
+            queue.push(...(children.get(filter.id) ?? []));
+        }
+        return result;
+    }
+    return {
+        definition,
+        getNode(id) {
+            const filter = filters.get(id);
+            if (filter !== undefined)
+                return { kind: "filter", id, filter };
+            const field = fields.get(id);
+            if (field !== undefined)
+                return { kind: "field", id, field };
+            const option = options.get(id);
+            if (option !== undefined)
+                return { kind: "option", id, ...option };
+            return { kind: "unknown", id };
+        },
+        getFilter,
+        getField,
+        getOption(id) {
+            return options.get(id)?.option;
+        },
+        getOptionOwner(id) {
+            return options.get(id)?.field;
+        },
+        filterLineage,
+        filterChildren(id) {
+            return [...(children.get(id) ?? [])];
+        },
+        filterDescendants,
+        relationBetweenFilters(baseId, otherId) {
+            if (baseId === otherId && filters.has(baseId))
+                return "self";
+            if (filterLineage(baseId).some((filter) => filter.id === otherId))
+                return "ancestor";
+            if (filterLineage(otherId).some((filter) => filter.id === baseId))
+                return "descendant";
+            return "unrelated";
+        },
+        fieldBindIds,
+        nodeFilterIds,
+        isFieldBoundWithin(fieldOrId, filterId) {
+            const lineage = new Set(filterLineage(filterId).map((filter) => filter.id));
+            return fieldBindIds(fieldOrId).some((id) => lineage.has(id));
+        },
+    };
+}
+//# sourceMappingURL=indexer.js.map

package/dist/indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.js","sourceRoot":"","sources":["../src/indexer.ts"],"names":[],"mappings":"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"}

package/dist/interpreter.d.ts

@@ -0,0 +1,29 @@
+import type { HandlerService, ProductDefinition, ServiceId } from "@elqora/dgp-spec";
+import { type ResolvedCapabilities } from "./capabilities.js";
+import { type ResolvedFilterContext } from "./context.js";
+import { type ResolvedValueEffect } from "./effects.js";
+import { type ProductIndex } from "./indexer.js";
+import { type ResolvedServiceBindings } from "./services.js";
+import { type ResolvedVisibility } from "./visibility.js";
+export interface ResolvedProductContext {
+    filter: ResolvedFilterContext;
+    capabilities: ResolvedCapabilities;
+    visibility: ResolvedVisibility;
+    valueEffects: ResolvedValueEffect[];
+}
+export interface ProductInterpreter {
+    readonly definition: ProductDefinition;
+    readonly index: ProductIndex;
+    resolveFilter(filterId: string): ResolvedFilterContext | undefined;
+    resolveCapabilities(filterId: string): ResolvedCapabilities;
+    resolveVisibility(filterId: string, selectedTriggerIds?: Iterable<string>): ResolvedVisibility;
+    resolveValueEffects(filterId: string, selectedTriggerIds: Iterable<string>): ResolvedValueEffect[];
+    resolveContext(filterId: string, selectedTriggerIds?: Iterable<string>): ResolvedProductContext | undefined;
+    serviceBindingForNode(nodeId: string): ServiceId | undefined;
+    resolveServiceBindings(): ResolvedServiceBindings;
+    resolveFallbackCandidates(primaryServiceId: ServiceId, nodeId?: string): ServiceId[];
+    fallbackCandidatesForNode(nodeId: string): ServiceId[];
+    matchingServicesForFilter(filterId: string, services: readonly HandlerService[]): HandlerService[];
+}
+export declare function createProductInterpreter(definition: ProductDefinition): ProductInterpreter;
+//# sourceMappingURL=interpreter.d.ts.map

package/dist/interpreter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpreter.d.ts","sourceRoot":"","sources":["../src/interpreter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAErF,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAwB,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAgC,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,YAAY,EAAE,oBAAoB,CAAC;IACnC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,YAAY,EAAE,mBAAmB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS,CAAC;IACnE,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAC5D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,kBAAkB,CAAC;IAC/F,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,mBAAmB,EAAE,CAAC;IACnG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,sBAAsB,GAAG,SAAS,CAAC;IAC5G,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7D,sBAAsB,IAAI,uBAAuB,CAAC;IAClD,yBAAyB,CAAC,gBAAgB,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACrF,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACvD,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,EAAE,CAAC;CACpG;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,iBAAiB,GAAG,kBAAkB,CA2C1F"}

package/dist/interpreter.js

@@ -0,0 +1,53 @@
+// SPDX-License-Identifier: GPL-3.0-only
+import { matchingServicesForFilter, resolveCapabilities, } from "./capabilities.js";
+import { resolveFilterContext } from "./context.js";
+import { resolveValueEffectsWithIndex } from "./effects.js";
+import { createProductIndex } from "./indexer.js";
+import { fallbackCandidatesForNode, resolveFallbackCandidates, resolveServiceBindingsWithIndex, serviceBindingForNode, } from "./services.js";
+import { resolveVisibilityWithIndex, } from "./visibility.js";
+export function createProductInterpreter(definition) {
+    const index = createProductIndex(definition);
+    return {
+        definition,
+        index,
+        resolveFilter(filterId) {
+            return resolveFilterContext(index, filterId);
+        },
+        resolveCapabilities(filterId) {
+            return resolveCapabilities(index, filterId);
+        },
+        resolveVisibility(filterId, selectedTriggerIds = []) {
+            return resolveVisibilityWithIndex(definition, index, filterId, selectedTriggerIds);
+        },
+        resolveValueEffects(filterId, selectedTriggerIds) {
+            return resolveValueEffectsWithIndex(definition, index, filterId, selectedTriggerIds);
+        },
+        resolveContext(filterId, selectedTriggerIds = []) {
+            const filter = resolveFilterContext(index, filterId);
+            if (filter === undefined)
+                return undefined;
+            return {
+                filter,
+                capabilities: resolveCapabilities(index, filterId),
+                visibility: resolveVisibilityWithIndex(definition, index, filterId, selectedTriggerIds),
+                valueEffects: resolveValueEffectsWithIndex(definition, index, filterId, selectedTriggerIds),
+            };
+        },
+        serviceBindingForNode(nodeId) {
+            return serviceBindingForNode(index, nodeId);
+        },
+        resolveServiceBindings() {
+            return resolveServiceBindingsWithIndex(definition, index);
+        },
+        resolveFallbackCandidates(primaryServiceId, nodeId) {
+            return resolveFallbackCandidates(definition, primaryServiceId, nodeId);
+        },
+        fallbackCandidatesForNode(nodeId) {
+            return fallbackCandidatesForNode(definition, index, nodeId);
+        },
+        matchingServicesForFilter(filterId, services) {
+            return matchingServicesForFilter(index, filterId, services);
+        },
+    };
+}
+//# sourceMappingURL=interpreter.js.map

package/dist/interpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpreter.js","sourceRoot":"","sources":["../src/interpreter.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAIxC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,GAEpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAA8B,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAA4B,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC;AACrE,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,+BAA+B,EAC/B,qBAAqB,GAEtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,GAE3B,MAAM,iBAAiB,CAAC;AAwBzB,MAAM,UAAU,wBAAwB,CAAC,UAA6B;IACpE,MAAM,KAAK,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO;QACL,UAAU;QACV,KAAK;QACL,aAAa,CAAC,QAAQ;YACpB,OAAO,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QACD,mBAAmB,CAAC,QAAQ;YAC1B,OAAO,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC;QACD,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,EAAE;YACjD,OAAO,0BAA0B,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QACrF,CAAC;QACD,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB;YAC9C,OAAO,4BAA4B,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QACvF,CAAC;QACD,cAAc,CAAC,QAAQ,EAAE,kBAAkB,GAAG,EAAE;YAC9C,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YACrD,IAAI,MAAM,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YAC3C,OAAO;gBACL,MAAM;gBACN,YAAY,EAAE,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAClD,UAAU,EAAE,0BAA0B,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,CAAC;gBACvF,YAAY,EAAE,4BAA4B,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,CAAC;aAC5F,CAAC;QACJ,CAAC;QACD,qBAAqB,CAAC,MAAM;YAC1B,OAAO,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QACD,sBAAsB;YACpB,OAAO,+BAA+B,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC5D,CAAC;QACD,yBAAyB,CAAC,gBAAgB,EAAE,MAAM;YAChD,OAAO,yBAAyB,CAAC,UAAU,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACzE,CAAC;QACD,yBAAyB,CAAC,MAAM;YAC9B,OAAO,yBAAyB,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9D,CAAC;QACD,yBAAyB,CAAC,QAAQ,EAAE,QAAQ;YAC1C,OAAO,yBAAyB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,15 @@
+import type { FieldOption, ProductDefinition, ProductField } from "@elqora/dgp-spec";
+export interface OptionVisit {
+    field: ProductField;
+    fieldId: string;
+    option: FieldOption;
+    optionId: string;
+    depth: number;
+    parentId?: string;
+}
+export declare function walkFieldOptions(field: ProductField): OptionVisit[];
+export declare function walkOptions(definition: ProductDefinition): OptionVisit[];
+export declare function fieldOptionIds(field: ProductField): string[];
+export declare function findFieldOption(field: ProductField | undefined, optionId: string): FieldOption | undefined;
+export declare function filterFieldOptionsById(options: readonly FieldOption[] | undefined, allowed: ReadonlySet<string>): FieldOption[] | undefined;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,EAAE,CAmBnE;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,iBAAiB,GAAG,WAAW,EAAE,CAExE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,EAAE,CAE5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAI1G;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,EAC3C,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,WAAW,EAAE,GAAG,SAAS,CAiB3B"}

package/dist/options.js

@@ -0,0 +1,48 @@
+// SPDX-License-Identifier: GPL-3.0-only
+export function walkFieldOptions(field) {
+    const visits = [];
+    function visit(options, depth, parentId) {
+        for (const option of options ?? []) {
+            visits.push({
+                field,
+                fieldId: field.id,
+                option,
+                optionId: option.id,
+                depth,
+                ...(parentId === undefined ? {} : { parentId }),
+            });
+            visit(option.children, depth + 1, option.id);
+        }
+    }
+    visit(field.options, 0);
+    return visits;
+}
+export function walkOptions(definition) {
+    return definition.fields.flatMap((field) => walkFieldOptions(field));
+}
+export function fieldOptionIds(field) {
+    return walkFieldOptions(field).map((visit) => visit.optionId);
+}
+export function findFieldOption(field, optionId) {
+    return field === undefined
+        ? undefined
+        : walkFieldOptions(field).find((visit) => visit.optionId === optionId)?.option;
+}
+export function filterFieldOptionsById(options, allowed) {
+    if (options === undefined) {
+        return undefined;
+    }
+    const result = [];
+    for (const option of options) {
+        const children = filterFieldOptionsById(option.children, allowed);
+        if (!allowed.has(option.id) && (children === undefined || children.length === 0)) {
+            continue;
+        }
+        result.push({
+            ...option,
+            ...(children === undefined ? {} : { children }),
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAaxC,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,SAAS,KAAK,CAAC,OAA2C,EAAE,KAAa,EAAE,QAAiB;QAC1F,KAAK,MAAM,MAAM,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK;gBACL,OAAO,EAAE,KAAK,CAAC,EAAE;gBACjB,MAAM;gBACN,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,KAAK;gBACL,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;aAChD,CAAC,CAAC;YACH,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAA6B;IACvD,OAAO,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAA+B,EAAE,QAAgB;IAC/E,OAAO,KAAK,KAAK,SAAS;QACxB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,EAAE,MAAM,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAA2C,EAC3C,OAA4B;IAE5B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACjF,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,GAAG,MAAM;YACT,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;SAChD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}