@elqora/dgp-core 1.0.0 → 1.1.0

package/README.md

@@ -1,20 +1,24 @@
 # 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 is the complete framework-neutral product engine for canonical Digital Goods Protocol product definitions. It provides pure interpretation primitives and a stateful `ProductBuilder` facade for canonical authoring normalization, indexing, graph projection, visibility, relationships, services, fallbacks, and deterministic save preparation.
 
 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
+- Canonical authoring normalization and save cleanup
+- Stateful Builder replacement with index/interpreter refresh
+- Framework-neutral graph projection
 - 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
+- Catalog service filtering and fallback eligibility evidence
 - 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.
+Core accepts canonical v1 definitions only. `normalizeProductDefinition` is an authoring-boundary operation that fills canonical collection defaults, normalizes bindings and authored ordering, and never recognizes legacy aliases. Published inputs must still be validated rather than silently repaired. Core does not own publication diagnostics, editorial history, customer validation, expression execution, utility calculation, final pricing, charges, or operational fallback selection.
 
 ## Install
 
@@ -27,13 +31,17 @@ npm install @elqora/dgp-core @elqora/dgp-spec
 ## Usage
 
 ```ts
-import { createProductInterpreter } from "@elqora/dgp-core";
+import { ProductBuilder, createProductInterpreter } from "@elqora/dgp-core";
 
 const product = createProductInterpreter(definition);
 const context = product.resolveContext("checkout", selectedTriggerIds);
 
 context?.visibility.fieldIds;
 context?.capabilities.values;
+
+const builder = new ProductBuilder(definition);
+builder.tree();
+builder.cleanedDefinition();
 ```
 
 Public functions are pure with respect to the supplied definition. Returned collections are newly allocated unless explicitly documented as canonical source nodes.
@@ -47,6 +55,7 @@ Public functions are pure with respect to the supplied definition. Returned coll
 - `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.
+- The active filter is the first implicit value-effect trigger; ancestor filters are context only, followed by selected button and option triggers in selection order.
 - 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
@@ -76,7 +85,7 @@ npm run check
 
 ## Status
 
-The initial DGP v1 interpretation slice is implemented against `@elqora/dgp-spec` 1.x.
+The complete canonical v1 Core migration is implemented against the ratified, unreleased `@elqora/dgp-spec` 1.4 contract. Package 1.1 is unreleased.
 
 ## License
 

package/dist/builder.d.ts

@@ -0,0 +1,40 @@
+import type { HandlerService, ProductDefinition } from "@elqora/dgp-spec";
+import { type ProductGraphSnapshot } from "./graph.js";
+import { type ProductIndex } from "./indexer.js";
+import { type ProductInterpreter } from "./interpreter.js";
+import { type NormalizeProductDefinitionOptions, type ProductDefinitionDraft } from "./normalization.js";
+import type { ResolvedVisibility } from "./visibility.js";
+export interface ProductBuilderOptions {
+    selected_trigger_ids?: Iterable<string>;
+    services?: readonly HandlerService[];
+    normalization?: NormalizeProductDefinitionOptions;
+}
+/**
+ * Canonical stateful authoring facade. It owns no history and performs no publication validation;
+ * each load simply replaces the current normalized document and refreshes all derived views.
+ */
+export declare class ProductBuilder {
+    #private;
+    constructor(input?: ProductDefinitionDraft, options?: ProductBuilderOptions);
+    get definition(): ProductDefinition;
+    get index(): ProductIndex;
+    get interpreter(): ProductInterpreter;
+    load(input: ProductDefinitionDraft): this;
+    replace(input: ProductDefinitionDraft): this;
+    setOptions(patch: ProductBuilderOptions): this;
+    selectedTriggerIds(): string[];
+    services(): readonly HandlerService[];
+    tree(): ProductGraphSnapshot;
+    resolveVisibility(filterId: string, selectedTriggerIds?: string[]): ResolvedVisibility;
+    visibleFields(filterId: string, selectedTriggerIds?: string[]): string[];
+    cleanedDefinition(): ProductDefinition;
+    getProps(): ProductDefinition;
+    cleanedProps(): ProductDefinition;
+    isFilterId(id: string): boolean;
+    isFieldId(id: string): boolean;
+    isOptionId(id: string): boolean;
+}
+export declare function createProductBuilder(input?: ProductDefinitionDraft, options?: ProductBuilderOptions): ProductBuilder;
+/** Canonical convenience name retained for the established authoring facade experience. */
+export declare const createBuilder: typeof createProductBuilder;
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1E,OAAO,EAAgC,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,oBAAoB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,aAAa,CAAC,EAAE,iCAAiC,CAAC;CACnD;AAED;;;GAGG;AACH,qBAAa,cAAc;;gBASvB,KAAK,GAAE,sBAAkE,EACzE,OAAO,GAAE,qBAA0B;IAUrC,IAAI,UAAU,IAAI,iBAAiB,CAElC;IAED,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,IAAI,WAAW,IAAI,kBAAkB,CAEpC;IAED,IAAI,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAOzC,OAAO,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI;IAI5C,UAAU,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAS9C,kBAAkB,IAAI,MAAM,EAAE;IAI9B,QAAQ,IAAI,SAAS,cAAc,EAAE;IAIrC,IAAI,IAAI,oBAAoB;IAI5B,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,WAA2B,GAAG,kBAAkB;IAItG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,WAA2B,GAAG,MAAM,EAAE;IAIxF,iBAAiB,IAAI,iBAAiB;IAItC,QAAQ,IAAI,iBAAiB;IAI7B,YAAY,IAAI,iBAAiB;IAIjC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI9B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGhC;AAED,wBAAgB,oBAAoB,CAClC,KAAK,CAAC,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,cAAc,CAEhB;AAED,2FAA2F;AAC3F,eAAO,MAAM,aAAa,6BAAuB,CAAC"}

package/dist/builder.js

@@ -0,0 +1,93 @@
+// SPDX-License-Identifier: GPL-3.0-only
+import { prepareProductDefinitionForSave } from "./cleanup.js";
+import { projectProductGraphWithIndex } from "./graph.js";
+import { createProductIndex } from "./indexer.js";
+import { createProductInterpreter } from "./interpreter.js";
+import { normalizeProductDefinition, } from "./normalization.js";
+/**
+ * Canonical stateful authoring facade. It owns no history and performs no publication validation;
+ * each load simply replaces the current normalized document and refreshes all derived views.
+ */
+export class ProductBuilder {
+    #definition;
+    #index;
+    #interpreter;
+    #selectedTriggerIds;
+    #services;
+    #normalization;
+    constructor(input = { id: "draft", name: "Untitled product" }, options = {}) {
+        this.#normalization = { ...options.normalization };
+        this.#selectedTriggerIds = [...(options.selected_trigger_ids ?? [])];
+        this.#services = options.services ?? [];
+        this.#definition = normalizeProductDefinition(input, this.#normalization);
+        this.#index = createProductIndex(this.#definition);
+        this.#interpreter = createProductInterpreter(this.#definition);
+    }
+    get definition() {
+        return this.#definition;
+    }
+    get index() {
+        return this.#index;
+    }
+    get interpreter() {
+        return this.#interpreter;
+    }
+    load(input) {
+        this.#definition = normalizeProductDefinition(input, this.#normalization);
+        this.#index = createProductIndex(this.#definition);
+        this.#interpreter = createProductInterpreter(this.#definition);
+        return this;
+    }
+    replace(input) {
+        return this.load(input);
+    }
+    setOptions(patch) {
+        if (patch.selected_trigger_ids !== undefined) {
+            this.#selectedTriggerIds = [...patch.selected_trigger_ids];
+        }
+        if (patch.services !== undefined)
+            this.#services = patch.services;
+        if (patch.normalization !== undefined)
+            this.#normalization = { ...patch.normalization };
+        return this;
+    }
+    selectedTriggerIds() {
+        return [...this.#selectedTriggerIds];
+    }
+    services() {
+        return this.#services;
+    }
+    tree() {
+        return projectProductGraphWithIndex(this.#definition, this.#index);
+    }
+    resolveVisibility(filterId, selectedTriggerIds = this.#selectedTriggerIds) {
+        return this.#interpreter.resolveVisibility(filterId, selectedTriggerIds);
+    }
+    visibleFields(filterId, selectedTriggerIds = this.#selectedTriggerIds) {
+        return this.resolveVisibility(filterId, selectedTriggerIds).fieldIds;
+    }
+    cleanedDefinition() {
+        return prepareProductDefinitionForSave(this.#definition);
+    }
+    getProps() {
+        return this.#definition;
+    }
+    cleanedProps() {
+        return this.cleanedDefinition();
+    }
+    isFilterId(id) {
+        return this.#index.getFilter(id) !== undefined;
+    }
+    isFieldId(id) {
+        return this.#index.getField(id) !== undefined;
+    }
+    isOptionId(id) {
+        return this.#index.getOption(id) !== undefined;
+    }
+}
+export function createProductBuilder(input, options) {
+    return new ProductBuilder(input, options);
+}
+/** Canonical convenience name retained for the established authoring facade experience. */
+export const createBuilder = createProductBuilder;
+//# sourceMappingURL=builder.js.map

package/dist/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAIxC,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAA6B,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAA2B,MAAM,kBAAkB,CAAC;AACrF,OAAO,EACL,0BAA0B,GAG3B,MAAM,oBAAoB,CAAC;AAS5B;;;GAGG;AACH,MAAM,OAAO,cAAc;IACzB,WAAW,CAAoB;IAC/B,MAAM,CAAe;IACrB,YAAY,CAAqB;IACjC,mBAAmB,CAAW;IAC9B,SAAS,CAA4B;IACrC,cAAc,CAAoC;IAElD,YACE,QAAgC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,EACzE,UAAiC,EAAE;QAEnC,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;QACnD,IAAI,CAAC,mBAAmB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,0BAA0B,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,YAAY,GAAG,wBAAwB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC,KAA6B;QAChC,IAAI,CAAC,WAAW,GAAG,0BAA0B,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,YAAY,GAAG,wBAAwB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,KAA6B;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,UAAU,CAAC,KAA4B;QACrC,IAAI,KAAK,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;YAC7C,IAAI,CAAC,mBAAmB,GAAG,CAAC,GAAG,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC;QAClE,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS;YAAE,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,KAAK,CAAC,aAAa,EAAE,CAAC;QACxF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAI;QACF,OAAO,4BAA4B,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,iBAAiB,CAAC,QAAgB,EAAE,kBAAkB,GAAG,IAAI,CAAC,mBAAmB;QAC/E,OAAO,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAC3E,CAAC;IAED,aAAa,CAAC,QAAgB,EAAE,kBAAkB,GAAG,IAAI,CAAC,mBAAmB;QAC3E,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,QAAQ,CAAC;IACvE,CAAC;IAED,iBAAiB;QACf,OAAO,+BAA+B,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC3D,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAClC,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;IACjD,CAAC;IAED,SAAS,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;IAChD,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;IACjD,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAClC,KAA8B,EAC9B,OAA+B;IAE/B,OAAO,IAAI,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,MAAM,aAAa,GAAG,oBAAoB,CAAC"}

package/dist/cleanup.d.ts

@@ -0,0 +1,5 @@
+import type { ProductDefinition } from "@elqora/dgp-spec";
+import { type ProductDefinitionDraft } from "./normalization.js";
+/** Return deterministic canonical save output with dead authoring references removed. */
+export declare function prepareProductDefinitionForSave(input: ProductDefinitionDraft): ProductDefinition;
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../src/cleanup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,iBAAiB,EAIlB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAA8B,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAwE7F,yFAAyF;AACzF,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,CAuEhG"}

package/dist/cleanup.js

@@ -0,0 +1,149 @@
+// SPDX-License-Identifier: GPL-3.0-only
+import { createProductIndex } from "./indexer.js";
+import { normalizeProductDefinition } from "./normalization.js";
+import { fieldOptionIds } from "./options.js";
+import { serviceBindingForNode } from "./services.js";
+function uniqueKnown(values, known) {
+    const result = [];
+    const seen = new Set();
+    for (const value of values) {
+        if (!known.has(value) || seen.has(value))
+            continue;
+        seen.add(value);
+        result.push(value);
+    }
+    return result;
+}
+function isTrigger(index, id) {
+    const node = index.getNode(id);
+    return node.kind === "option" || (node.kind === "field" && node.field.button === true);
+}
+function fieldIsReachabilityReferenced(definition, fieldId) {
+    if (definition.filters.some((filter) => filter.includes?.includes(fieldId) === true))
+        return true;
+    if (Object.values(definition.includes_for_buttons).some((ids) => ids.includes(fieldId)))
+        return true;
+    return Object.values(definition.option_effects_for_buttons).some((targets) => targets[fieldId]?.force_visible === true);
+}
+function pruneFields(definition) {
+    return definition.fields.filter((field) => {
+        if (field.pricing_role !== "utility" || field.bind_id !== undefined)
+            return true;
+        return fieldIsReachabilityReferenced(definition, field.id);
+    });
+}
+function pruneFallbacks(definition, index) {
+    if (definition.fallbacks === null)
+        return null;
+    const nodes = {};
+    const global = {};
+    for (const [nodeId, candidates] of Object.entries(definition.fallbacks.nodes ?? {})) {
+        const primary = serviceBindingForNode(index, nodeId);
+        if (primary === undefined)
+            continue;
+        const seen = new Set([String(primary)]);
+        const next = candidates.filter((candidate) => {
+            const key = String(candidate);
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+        if (next.length > 0)
+            nodes[nodeId] = next;
+    }
+    for (const [primary, candidates] of Object.entries(definition.fallbacks.global ?? {})) {
+        const seen = new Set([primary]);
+        const next = candidates.filter((candidate) => {
+            const key = String(candidate);
+            if (seen.has(key))
+                return false;
+            seen.add(key);
+            return true;
+        });
+        if (next.length > 0)
+            global[primary] = next;
+    }
+    return Object.keys(nodes).length === 0 && Object.keys(global).length === 0
+        ? null
+        : {
+            ...(Object.keys(nodes).length === 0 ? {} : { nodes }),
+            ...(Object.keys(global).length === 0 ? {} : { global }),
+        };
+}
+/** Return deterministic canonical save output with dead authoring references removed. */
+export function prepareProductDefinitionForSave(input) {
+    const normalized = normalizeProductDefinition(input);
+    const fields = pruneFields(normalized);
+    const base = { ...normalized, fields };
+    const index = createProductIndex(base);
+    const fieldIds = new Set(fields.map((field) => field.id));
+    const filterIds = new Set(base.filters.map((filter) => filter.id));
+    const triggerIds = new Set(index.triggerIds());
+    const orderForTags = {};
+    for (const [filterId, values] of Object.entries(base.order_for_tags)) {
+        const next = uniqueKnown(values, fieldIds);
+        if (filterIds.has(filterId) && next.length > 0)
+            orderForTags[filterId] = next;
+    }
+    const pruneRelationshipMap = (value) => {
+        const result = {};
+        for (const [triggerId, values] of Object.entries(value)) {
+            const next = uniqueKnown(values, fieldIds);
+            if (triggerIds.has(triggerId) && next.length > 0)
+                result[triggerId] = next;
+        }
+        return result;
+    };
+    const optionEffects = {};
+    for (const [triggerId, targets] of Object.entries(base.option_effects_for_buttons)) {
+        if (!isTrigger(index, triggerId))
+            continue;
+        const nextTargets = {};
+        for (const [fieldId, effect] of Object.entries(targets)) {
+            const field = index.getField(fieldId);
+            if (field === undefined)
+                continue;
+            const knownOptions = new Set(fieldOptionIds(field));
+            const include = uniqueKnown(effect.include ?? [], knownOptions);
+            const exclude = uniqueKnown(effect.exclude ?? [], knownOptions);
+            if (effect.force_visible !== true && include.length === 0 && exclude.length === 0)
+                continue;
+            nextTargets[fieldId] = {
+                ...(effect.force_visible === true ? { force_visible: true } : {}),
+                ...(include.length === 0 ? {} : { include }),
+                ...(exclude.length === 0 ? {} : { exclude }),
+            };
+        }
+        if (Object.keys(nextTargets).length > 0)
+            optionEffects[triggerId] = nextTargets;
+    }
+    const valueEffects = {};
+    for (const [triggerId, targets] of Object.entries(base.value_effects_for_triggers)) {
+        if (!triggerIds.has(triggerId) && !filterIds.has(triggerId))
+            continue;
+        const nextTargets = Object.fromEntries(Object.entries(targets).filter(([fieldId]) => fieldIds.has(fieldId)));
+        if (Object.keys(nextTargets).length > 0)
+            valueEffects[triggerId] = nextTargets;
+    }
+    const withMaps = {
+        ...base,
+        filters: base.filters.map((filter) => {
+            const { includes: rawIncludes, excludes: rawExcludes, ...rest } = filter;
+            const includes = uniqueKnown(rawIncludes ?? [], fieldIds);
+            const excludes = uniqueKnown(rawExcludes ?? [], fieldIds);
+            return {
+                ...rest,
+                ...(includes.length === 0 ? {} : { includes }),
+                ...(excludes.length === 0 ? {} : { excludes }),
+            };
+        }),
+        order_for_tags: orderForTags,
+        includes_for_buttons: pruneRelationshipMap(base.includes_for_buttons),
+        excludes_for_buttons: pruneRelationshipMap(base.excludes_for_buttons),
+        option_effects_for_buttons: optionEffects,
+        value_effects_for_triggers: valueEffects,
+    };
+    return { ...withMaps, fallbacks: pruneFallbacks(withMaps, createProductIndex(withMaps)) };
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/cleanup.js.map

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

package/dist/effects.d.ts.map

@@ -1 +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"}
+{"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,CAevB;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

@@ -3,7 +3,12 @@ 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)) {
+    // The active filter is an implicit value-effect trigger. Ancestors are context only.
+    const triggerIds = [
+        ...(index.getFilter(filterId) === undefined ? [] : [filterId]),
+        ...relevantSelectedTriggers(index, filterId, selectedTriggerIds),
+    ];
+    for (const triggerId of triggerIds) {
         for (const [targetFieldId, effect] of Object.entries(definition.value_effects_for_triggers[triggerId] ?? {})) {
             effects.push({ triggerId, targetFieldId, effect });
         }

package/dist/effects.js.map

@@ -1 +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"}
+{"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,qFAAqF;IACrF,MAAM,UAAU,GAAG;QACjB,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC9D,GAAG,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,kBAAkB,CAAC;KACjE,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,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/fallbacks.d.ts

@@ -0,0 +1,22 @@
+import type { HandlerService, ServiceId, ServiceRatePolicy } from "@elqora/dgp-spec";
+import type { ProductIndex } from "./indexer.js";
+export type FallbackIneligibilityReason = "primary_missing" | "self_reference" | "unknown_service" | "unavailable" | "capability_mismatch" | "rate_mismatch" | "context_missing";
+export interface FallbackEligibilityRow {
+    candidate: ServiceId;
+    eligible: boolean;
+    reasons: FallbackIneligibilityReason[];
+    matching_filter_ids: string[];
+}
+export interface ResolveFallbackEligibilityOptions {
+    rate_policy?: ServiceRatePolicy;
+    require_capability_fit?: boolean;
+    exclude_ids?: Iterable<ServiceId>;
+    /** Reachable publication contexts supplied by a caller that resolves relationship visibility. */
+    filter_ids?: readonly string[];
+}
+/**
+ * Evaluate node-scoped fallback candidates against handler catalog evidence. A candidate bound to a
+ * multi-context option remains eligible when it satisfies at least one reachable filter context.
+ */
+export declare function resolveFallbackEligibilityForNode(index: ProductIndex, nodeId: string, candidates: readonly ServiceId[], services: readonly HandlerService[], options?: ResolveFallbackEligibilityOptions): FallbackEligibilityRow[];
+//# sourceMappingURL=fallbacks.d.ts.map

package/dist/fallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbacks.d.ts","sourceRoot":"","sources":["../src/fallbacks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,MAAM,MAAM,2BAA2B,GACnC,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,GACjB,aAAa,GACb,qBAAqB,GACrB,eAAe,GACf,iBAAiB,CAAC;AAEtB,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iCAAiC;IAChD,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClC,iGAAiG;IACjG,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,QAAQ,EAAE,SAAS,cAAc,EAAE,EACnC,OAAO,GAAE,iCAAsC,GAC9C,sBAAsB,EAAE,CA8C1B"}

package/dist/fallbacks.js

@@ -0,0 +1,62 @@
+// SPDX-License-Identifier: GPL-3.0-only
+import { findService, resolveCapabilities, serviceSatisfiesCapabilities } from "./capabilities.js";
+import { serviceRateMatchesPolicy } from "./service-filter.js";
+import { serviceBindingForNode } from "./services.js";
+/**
+ * Evaluate node-scoped fallback candidates against handler catalog evidence. A candidate bound to a
+ * multi-context option remains eligible when it satisfies at least one reachable filter context.
+ */
+export function resolveFallbackEligibilityForNode(index, nodeId, candidates, services, options = {}) {
+    const primaryId = serviceBindingForNode(index, nodeId);
+    const primary = primaryId === undefined ? undefined : findService(services, primaryId);
+    const filterIds = options.filter_ids === undefined
+        ? index.nodeFilterIds(nodeId)
+        : [...new Set(options.filter_ids)];
+    const excluded = new Set([...options.exclude_ids ?? []].map(String));
+    const seen = new Set();
+    const rows = [];
+    for (const candidateId of candidates) {
+        const key = String(candidateId);
+        if (seen.has(key) || excluded.has(key))
+            continue;
+        seen.add(key);
+        const reasons = [];
+        const matchingFilterIds = [];
+        if (primaryId === undefined || primary === undefined)
+            reasons.push("primary_missing");
+        if (primaryId !== undefined && key === String(primaryId))
+            reasons.push("self_reference");
+        const candidate = findService(services, candidateId);
+        if (candidate === undefined)
+            reasons.push("unknown_service");
+        else {
+            if (candidate.state !== "enabled")
+                reasons.push("unavailable");
+            if (options.require_capability_fit === true) {
+                for (const filterId of filterIds) {
+                    if (serviceSatisfiesCapabilities(candidate, resolveCapabilities(index, filterId).values)) {
+                        matchingFilterIds.push(filterId);
+                    }
+                }
+                if (filterIds.length === 0)
+                    reasons.push("context_missing");
+                else if (matchingFilterIds.length === 0)
+                    reasons.push("capability_mismatch");
+            }
+            else {
+                matchingFilterIds.push(...filterIds);
+            }
+            if (primary !== undefined
+                && !serviceRateMatchesPolicy(candidate.rate, primary.rate, options.rate_policy))
+                reasons.push("rate_mismatch");
+        }
+        rows.push({
+            candidate: candidateId,
+            eligible: reasons.length === 0,
+            reasons,
+            matching_filter_ids: matchingFilterIds,
+        });
+    }
+    return rows;
+}
+//# sourceMappingURL=fallbacks.js.map

package/dist/fallbacks.js.map

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

package/dist/graph.d.ts

@@ -0,0 +1,26 @@
+import type { ProductDefinition, ServiceId } from "@elqora/dgp-spec";
+import { type ProductIndex } from "./indexer.js";
+export type ProductGraphNodeKind = "filter" | "field" | "option" | "service";
+export type ProductGraphEdgeKind = "child" | "bind" | "include" | "exclude" | "option" | "option_effect" | "value_effect" | "service";
+export interface ProductGraphNode {
+    id: string;
+    kind: ProductGraphNodeKind;
+    label: string;
+    source_id: string | ServiceId;
+    field_id?: string;
+    parent_option_id?: string;
+}
+export interface ProductGraphEdge {
+    id: string;
+    kind: ProductGraphEdgeKind;
+    from: string;
+    to: string;
+}
+export interface ProductGraphSnapshot {
+    nodes: ProductGraphNode[];
+    edges: ProductGraphEdge[];
+}
+/** Deterministic graph projection over actual canonical node identifiers. */
+export declare function projectProductGraphWithIndex(definition: ProductDefinition, index: ProductIndex): ProductGraphSnapshot;
+export declare function projectProductGraph(definition: ProductDefinition): ProductGraphSnapshot;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAErE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAIrE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,oBAAoB,GAC5B,OAAO,GACP,MAAM,GACN,SAAS,GACT,SAAS,GACT,QAAQ,GACR,eAAe,GACf,cAAc,GACd,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAUD,6EAA6E;AAC7E,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,YAAY,GAClB,oBAAoB,CAiFtB;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,GAAG,oBAAoB,CAEvF"}

package/dist/graph.js

@@ -0,0 +1,99 @@
+// SPDX-License-Identifier: GPL-3.0-only
+import { createProductIndex } from "./indexer.js";
+import { walkOptions } from "./options.js";
+import { serviceBindingForNode } from "./services.js";
+function serviceNodeId(serviceId) {
+    return `service:${String(serviceId)}`;
+}
+function edgeId(kind, from, to, ordinal) {
+    return `${kind}:${from}:${to}:${ordinal}`;
+}
+/** Deterministic graph projection over actual canonical node identifiers. */
+export function projectProductGraphWithIndex(definition, index) {
+    const nodes = [];
+    const edges = [];
+    const edgeOrdinals = new Map();
+    const pushEdge = (kind, from, to) => {
+        const signature = `${kind}:${from}:${to}`;
+        const ordinal = edgeOrdinals.get(signature) ?? 0;
+        edgeOrdinals.set(signature, ordinal + 1);
+        edges.push({ id: edgeId(kind, from, to, ordinal), kind, from, to });
+    };
+    for (const filter of definition.filters) {
+        nodes.push({ id: filter.id, kind: "filter", label: filter.label, source_id: filter.id });
+        if (filter.bind_id !== undefined && index.getFilter(filter.bind_id) !== undefined) {
+            pushEdge("child", filter.bind_id, filter.id);
+        }
+        for (const fieldId of filter.includes ?? []) {
+            if (index.getField(fieldId) !== undefined)
+                pushEdge("include", filter.id, fieldId);
+        }
+        for (const fieldId of filter.excludes ?? []) {
+            if (index.getField(fieldId) !== undefined)
+                pushEdge("exclude", filter.id, fieldId);
+        }
+    }
+    for (const field of definition.fields) {
+        nodes.push({ id: field.id, kind: "field", label: field.label, source_id: field.id });
+        for (const filterId of index.fieldBindIds(field)) {
+            if (index.getFilter(filterId) !== undefined)
+                pushEdge("bind", filterId, field.id);
+        }
+    }
+    for (const visit of walkOptions(definition)) {
+        nodes.push({
+            id: visit.optionId,
+            kind: "option",
+            label: visit.option.label,
+            source_id: visit.optionId,
+            field_id: visit.fieldId,
+            ...(visit.parentId === undefined ? {} : { parent_option_id: visit.parentId }),
+        });
+        pushEdge("option", visit.parentId ?? visit.fieldId, visit.optionId);
+    }
+    const seenServices = new Set();
+    for (const nodeId of index.nodeIds()) {
+        const serviceId = serviceBindingForNode(index, nodeId);
+        if (serviceId === undefined)
+            continue;
+        const id = serviceNodeId(serviceId);
+        if (!seenServices.has(id)) {
+            seenServices.add(id);
+            nodes.push({ id, kind: "service", label: String(serviceId), source_id: serviceId });
+        }
+        pushEdge("service", nodeId, id);
+    }
+    for (const [triggerId, fieldIds] of Object.entries(definition.includes_for_buttons)) {
+        for (const fieldId of fieldIds) {
+            if (index.getNode(triggerId).kind !== "unknown" && index.getField(fieldId) !== undefined) {
+                pushEdge("include", triggerId, fieldId);
+            }
+        }
+    }
+    for (const [triggerId, fieldIds] of Object.entries(definition.excludes_for_buttons)) {
+        for (const fieldId of fieldIds) {
+            if (index.getNode(triggerId).kind !== "unknown" && index.getField(fieldId) !== undefined) {
+                pushEdge("exclude", triggerId, fieldId);
+            }
+        }
+    }
+    for (const [triggerId, targets] of Object.entries(definition.option_effects_for_buttons)) {
+        for (const fieldId of Object.keys(targets)) {
+            if (index.getNode(triggerId).kind !== "unknown" && index.getField(fieldId) !== undefined) {
+                pushEdge("option_effect", triggerId, fieldId);
+            }
+        }
+    }
+    for (const [triggerId, targets] of Object.entries(definition.value_effects_for_triggers)) {
+        for (const fieldId of Object.keys(targets)) {
+            if (index.getNode(triggerId).kind !== "unknown" && index.getField(fieldId) !== undefined) {
+                pushEdge("value_effect", triggerId, fieldId);
+            }
+        }
+    }
+    return { nodes, edges };
+}
+export function projectProductGraph(definition) {
+    return projectProductGraphWithIndex(definition, createProductIndex(definition));
+}
+//# sourceMappingURL=graph.js.map