@flighthq/requirement 0.5.1-edge.1685.dc0e23a

package/LICENSE.md

@@ -0,0 +1,9 @@
+# MIT License
+
+Copyright (c) 2013-2026 Joshua Granick and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,17 @@
+# @flighthq/requirement
+
+Plain requirement collection and set algebra for content-to-registration resolution
+
+## Install
+
+```sh
+npm install @flighthq/requirement
+```
+
+Import the supported application-facing API from `@flighthq/requirement`. The `@flighthq/requirement/contract` export is the wider package-to-package contract used to compose Flight itself.
+
+This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
+
+- [Flight project](https://github.com/flighthq/flight)
+- [Source for @flighthq/requirement@0.5.1-edge.1685.dc0e23a](https://github.com/flighthq/flight/tree/dc0e23a17453ec75c20ccbf07058a57b5ef10c4c/packages/requirement)
+- [License](https://github.com/flighthq/flight/blob/dc0e23a17453ec75c20ccbf07058a57b5ef10c4c/LICENSE.md)

package/dist/contract.d.ts

@@ -0,0 +1,4 @@
+export * from './requirementCollector';
+export * from './requirementSet';
+export { initializeRequirementSet } 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;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/contract.js

@@ -0,0 +1,4 @@
+export * from './requirementCollector';
+export * from './requirementSet';
+export { initializeRequirementSet } 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;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { collectScene2DRequirements, reportRequirement } from './requirementCollector';
+export { createRequirementSet, diffRequirementSets, mergeRequirementSets } from './requirementSet';
+//# 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,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { collectScene2DRequirements, reportRequirement } from './requirementCollector';
+export { createRequirementSet, diffRequirementSets, mergeRequirementSets } from './requirementSet';
+//# 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,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,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,6 @@
+import type { EntityConstruction, 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 initializeRequirementSet(out: EntityConstruction<RequirementSet>, covers: readonly RequirementFacet[], requirements: readonly Readonly<Requirement>[]): void;
+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":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAElH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,YAAY,EAAE,SAAS,QAAQ,CAAC,WAAW,CAAC,EAAE,GAC7C,cAAc,CAIhB;AAID,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,EACtC,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,GACjC,cAAc,CAahB;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,kBAAkB,CAAC,cAAc,CAAC,EACvC,MAAM,EAAE,SAAS,gBAAgB,EAAE,EACnC,YAAY,EAAE,SAAS,QAAQ,CAAC,WAAW,CAAC,EAAE,GAC7C,IAAI,CAGN;AAID,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,SAAS,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,cAAc,CASzG"}

package/dist/requirementSet.js

@@ -0,0 +1,52 @@
+import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
+export function createRequirementSet(covers, requirements) {
+    const out = allocateEntity();
+    initializeRequirementSet(out, covers, requirements);
+    return finishEntity(out);
+}
+// 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))));
+}
+export function initializeRequirementSet(out, covers, requirements) {
+    out.covers = distinctSorted(covers);
+    out.requirements = distinctSortedRequirements(requirements);
+}
+// 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":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@flighthq/requirement",
+  "version": "0.5.1-edge.1685.dc0e23a",
+  "author": "Joshua Granick and other contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flighthq/flight.git",
+    "directory": "packages/requirement"
+  },
+  "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/entity": "0.5.1-edge.1685.dc0e23a",
+    "@flighthq/types": "0.5.1-edge.1685.dc0e23a"
+  },
+  "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).toMatchObject({
+      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,81 @@
+import { RequirementFacet } from '@flighthq/types/contract';
+
+import {
+  createRequirementSet,
+  diffRequirementSets,
+  initializeRequirementSet,
+  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).toMatchObject({
+      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).toMatchObject({
+      covers: [RequirementFacet.SceneNodeKind],
+      requirements: [{ facet: RequirementFacet.SceneNodeKind, key: 'Shape' }],
+    });
+  });
+});
+
+describe('initializeRequirementSet', () => {
+  it('is the construction initializer of createRequirementSet', () => {
+    expect(typeof initializeRequirementSet).toBe('function');
+  });
+});
+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).toMatchObject({
+      covers: [RequirementFacet.SceneNodeKind],
+      requirements: [
+        { facet: RequirementFacet.SceneNodeKind, key: 'Shape' },
+        { facet: RequirementFacet.SceneNodeKind, key: 'Sprite' },
+      ],
+    });
+  });
+});