@flighthq/requirements 0.3.1-next.616.aa7ae7f

package/dist/contract.d.ts

@@ -0,0 +1,3 @@
+export * from './requirementCollector';
+export * from './requirementSet';
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC"}

package/dist/contract.js

@@ -0,0 +1,3 @@
+export * from './requirementCollector';
+export * from './requirementSet';
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './contract';
+//# 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":"AAAA,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './contract';
+//# 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,cAAc,YAAY,CAAC"}

package/dist/requirementCollector.d.ts

@@ -0,0 +1,4 @@
+import type { Kind, Requirement, RequirementFacet, RequirementSet } from '@flighthq/types/contract';
+export declare function collectScene2DRequirements(run: (sink: Requirement[]) => void): RequirementSet;
+export declare function reportRequirement(sink: Requirement[] | undefined, facet: RequirementFacet, key: Kind): void;
+//# sourceMappingURL=requirementCollector.d.ts.map

package/dist/requirementCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirementCollector.d.ts","sourceRoot":"","sources":["../src/requirementCollector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAOpG,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,IAAI,GAAG,cAAc,CAO7F;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,CAG3G"}

package/dist/requirementCollector.js

@@ -0,0 +1,17 @@
+import { RequirementFacet as Facet } from '@flighthq/types/contract';
+import { createRequirementSet } from './requirementSet';
+// Engages requirement recording for one Scene2D import. Parsers receive the same optional-array sink
+// shape as import diagnostics; an unengaged parse receives `undefined` and allocates no requirement.
+export function collectScene2DRequirements(run) {
+    const requirements = [];
+    run(requirements);
+    return createRequirementSet([Facet.SceneBlendMode, Facet.SceneMaterialKind, Facet.SceneNodeKind, Facet.SceneShapeCommand], requirements);
+}
+// The colocated importer seam. Call it only where a parser has established the content fact; when no
+// collector is engaged the default parse pays one undefined check and records nothing.
+export function reportRequirement(sink, facet, key) {
+    if (sink === undefined)
+        return;
+    sink.push({ facet, key });
+}
+//# sourceMappingURL=requirementCollector.js.map

package/dist/requirementCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirementCollector.js","sourceRoot":"","sources":["../src/requirementCollector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,IAAI,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAErE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,qGAAqG;AACrG,qGAAqG;AACrG,MAAM,UAAU,0BAA0B,CAAC,GAAkC;IAC3E,MAAM,YAAY,GAAkB,EAAE,CAAC;IACvC,GAAG,CAAC,YAAY,CAAC,CAAC;IAClB,OAAO,oBAAoB,CACzB,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,iBAAiB,CAAC,EAC7F,YAAY,CACb,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,uFAAuF;AACvF,MAAM,UAAU,iBAAiB,CAAC,IAA+B,EAAE,KAAuB,EAAE,GAAS;IACnG,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;AAC5B,CAAC"}

package/dist/requirementSet.d.ts

@@ -0,0 +1,5 @@
+import type { Requirement, RequirementFacet, RequirementSet } from '@flighthq/types/contract';
+export declare function createRequirementSet(covers: readonly RequirementFacet[], requirements: readonly Readonly<Requirement>[]): RequirementSet;
+export declare function diffRequirementSets(requirements: Readonly<RequirementSet>, baseline: Readonly<RequirementSet>): RequirementSet;
+export declare function mergeRequirementSets(requirementSets: readonly Readonly<RequirementSet>[]): RequirementSet;
+//# sourceMappingURL=requirementSet.d.ts.map

package/dist/requirementSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirementSet.d.ts","sourceRoot":"","sources":["../src/requirementSet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE9F,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,YAAY,EAAE,SAAS,QAAQ,CAAC,WAAW,CAAC,EAAE,GAC7C,cAAc,CAKhB;AAID,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,EACtC,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,GACjC,cAAc,CAahB;AAID,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,SAAS,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,cAAc,CASzG"}

package/dist/requirementSet.js

@@ -0,0 +1,48 @@
+export function createRequirementSet(covers, requirements) {
+    return {
+        covers: distinctSorted(covers),
+        requirements: distinctSortedRequirements(requirements),
+    };
+}
+// A difference can claim completeness only where both operands inspected the facet. Requirements from
+// an unshared facet are therefore unknown, not absent, and do not enter the result.
+export function diffRequirementSets(requirements, baseline) {
+    const covers = intersectSorted(requirements.covers, baseline.covers);
+    const baselineKeys = new Set(baseline.requirements.map((requirement) => requirementIdentity(requirement.facet, requirement.key)));
+    return createRequirementSet(covers, requirements.requirements.filter((requirement) => covers.includes(requirement.facet) &&
+        !baselineKeys.has(requirementIdentity(requirement.facet, requirement.key))));
+}
+// A merged set is complete for a facet only when every input inspected it. Requirements themselves are
+// unioned, because a partial producer can still contribute a positive fact without proving negatives.
+export function mergeRequirementSets(requirementSets) {
+    if (requirementSets.length === 0)
+        return createRequirementSet([], []);
+    let covers = distinctSorted(requirementSets[0].covers);
+    const requirements = [];
+    for (const requirementSet of requirementSets) {
+        covers = intersectSorted(covers, requirementSet.covers);
+        requirements.push(...requirementSet.requirements);
+    }
+    return createRequirementSet(covers, requirements);
+}
+function distinctSorted(values) {
+    return [...new Set(values)].sort();
+}
+function distinctSortedRequirements(requirements) {
+    const byIdentity = new Map();
+    for (const requirement of requirements) {
+        byIdentity.set(requirementIdentity(requirement.facet, requirement.key), {
+            facet: requirement.facet,
+            key: requirement.key,
+        });
+    }
+    return [...byIdentity.values()].sort((a, b) => a.facet.localeCompare(b.facet) || a.key.localeCompare(b.key));
+}
+function intersectSorted(first, second) {
+    const secondValues = new Set(second);
+    return distinctSorted(first.filter((value) => secondValues.has(value)));
+}
+function requirementIdentity(facet, key) {
+    return `${facet}\0${key}`;
+}
+//# sourceMappingURL=requirementSet.js.map

package/dist/requirementSet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirementSet.js","sourceRoot":"","sources":["../src/requirementSet.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAClC,MAAmC,EACnC,YAA8C;IAE9C,OAAO;QACL,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC;QAC9B,YAAY,EAAE,0BAA0B,CAAC,YAAY,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,sGAAsG;AACtG,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CACjC,YAAsC,EACtC,QAAkC;IAElC,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,mBAAmB,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CACpG,CAAC;IACF,OAAO,oBAAoB,CACzB,MAAM,EACN,YAAY,CAAC,YAAY,CAAC,MAAM,CAC9B,CAAC,WAAW,EAAE,EAAE,CACd,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;QAClC,CAAC,YAAY,CAAC,GAAG,CAAC,mBAAmB,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAC7E,CACF,CAAC;AACJ,CAAC;AAED,uGAAuG;AACvG,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAAC,eAAoD;IACvF,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,oBAAoB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACtE,IAAI,MAAM,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACvD,MAAM,YAAY,GAA4B,EAAE,CAAC;IACjD,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC7C,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;QACxD,YAAY,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,oBAAoB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,cAAc,CAAC,MAAmC;IACzD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,0BAA0B,CAAC,YAA8C;IAChF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;IAClD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,UAAU,CAAC,GAAG,CAAC,mBAAmB,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE;YACtE,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,GAAG,EAAE,WAAW,CAAC,GAAG;SACrB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/G,CAAC;AAED,SAAS,eAAe,CAAC,KAAkC,EAAE,MAAmC;IAC9F,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAuB,EAAE,GAAW;IAC/D,OAAO,GAAG,KAAK,KAAK,GAAG,EAAE,CAAC;AAC5B,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@flighthq/requirements",
+  "version": "0.3.1-next.616.aa7ae7f",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/requirements"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract.d.ts",
+      "default": "./dist/contract.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/types": "0.3.1-next.616.aa7ae7f"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Plain requirement collection and set algebra for content-to-registration resolution",
+  "sideEffects": false
+}

package/src/requirementCollector.test.ts

@@ -0,0 +1,36 @@
+import type { Requirement } from '@flighthq/types/contract';
+import { RequirementFacet } from '@flighthq/types/contract';
+
+import { collectScene2DRequirements, reportRequirement } from './requirementCollector';
+
+describe('collectScene2DRequirements', () => {
+  it('returns deterministic distinct requirements and the facets inspected by the collector', () => {
+    const result = collectScene2DRequirements((sink) => {
+      reportRequirement(sink, RequirementFacet.SceneNodeKind, 'Shape');
+      reportRequirement(sink, RequirementFacet.SceneBlendMode, 'Multiply');
+      reportRequirement(sink, RequirementFacet.SceneNodeKind, 'Shape');
+    });
+
+    expect(result).toEqual({
+      covers: [
+        RequirementFacet.SceneBlendMode,
+        RequirementFacet.SceneMaterialKind,
+        RequirementFacet.SceneNodeKind,
+        RequirementFacet.SceneShapeCommand,
+      ],
+      requirements: [
+        { facet: RequirementFacet.SceneBlendMode, key: 'Multiply' },
+        { facet: RequirementFacet.SceneNodeKind, key: 'Shape' },
+      ],
+    });
+  });
+});
+
+describe('reportRequirement', () => {
+  it('records only when a collector is engaged', () => {
+    const sink: Requirement[] = [];
+    reportRequirement(undefined, RequirementFacet.SceneNodeKind, 'Shape');
+    reportRequirement(sink, RequirementFacet.SceneNodeKind, 'Shape');
+    expect(sink).toEqual([{ facet: RequirementFacet.SceneNodeKind, key: 'Shape' }]);
+  });
+});

package/src/requirementSet.test.ts

@@ -0,0 +1,71 @@
+import { RequirementFacet } from '@flighthq/types/contract';
+
+import { createRequirementSet, diffRequirementSets, mergeRequirementSets } from './requirementSet';
+
+describe('createRequirementSet', () => {
+  it('copies, sorts, and deduplicates both dimensions', () => {
+    const covers = [RequirementFacet.SceneNodeKind, RequirementFacet.SceneBlendMode];
+    const requirements = [
+      { facet: RequirementFacet.SceneNodeKind, key: 'Shape' },
+      { facet: RequirementFacet.SceneBlendMode, key: 'Multiply' },
+      { facet: RequirementFacet.SceneNodeKind, key: 'Shape' },
+    ];
+    const result = createRequirementSet(covers, requirements);
+    covers.length = 0;
+    requirements.length = 0;
+
+    expect(result).toEqual({
+      covers: [RequirementFacet.SceneBlendMode, RequirementFacet.SceneNodeKind],
+      requirements: [
+        { facet: RequirementFacet.SceneBlendMode, key: 'Multiply' },
+        { facet: RequirementFacet.SceneNodeKind, key: 'Shape' },
+      ],
+    });
+  });
+});
+
+describe('diffRequirementSets', () => {
+  it('subtracts facts only for facets both operands cover', () => {
+    const result = diffRequirementSets(
+      createRequirementSet(
+        [RequirementFacet.SceneBlendMode, RequirementFacet.SceneNodeKind],
+        [
+          { facet: RequirementFacet.SceneBlendMode, key: 'Multiply' },
+          { facet: RequirementFacet.SceneNodeKind, key: 'Shape' },
+        ],
+      ),
+      createRequirementSet(
+        [RequirementFacet.SceneNodeKind],
+        [{ facet: RequirementFacet.SceneNodeKind, key: 'Sprite' }],
+      ),
+    );
+
+    expect(result).toEqual({
+      covers: [RequirementFacet.SceneNodeKind],
+      requirements: [{ facet: RequirementFacet.SceneNodeKind, key: 'Shape' }],
+    });
+  });
+});
+
+describe('mergeRequirementSets', () => {
+  it('unions facts while intersecting completeness', () => {
+    const result = mergeRequirementSets([
+      createRequirementSet(
+        [RequirementFacet.SceneBlendMode, RequirementFacet.SceneNodeKind],
+        [{ facet: RequirementFacet.SceneNodeKind, key: 'Shape' }],
+      ),
+      createRequirementSet(
+        [RequirementFacet.SceneNodeKind],
+        [{ facet: RequirementFacet.SceneNodeKind, key: 'Sprite' }],
+      ),
+    ]);
+
+    expect(result).toEqual({
+      covers: [RequirementFacet.SceneNodeKind],
+      requirements: [
+        { facet: RequirementFacet.SceneNodeKind, key: 'Shape' },
+        { facet: RequirementFacet.SceneNodeKind, key: 'Sprite' },
+      ],
+    });
+  });
+});