project-tiny-context-harness 0.8.3 → 0.8.5

package/dist/lib/semantic-fact-unit-shape.js

@@ -0,0 +1,89 @@
+import { semanticArray, semanticLiteral, semanticNullable, semanticObject, semanticStableRef, semanticStableRefs, semanticString, } from "./semantic-fact-shape-primitives.js";
+import { parseSemanticFactLocatedValue } from "./semantic-fact-value-shape.js";
+export function parseSemanticFactSubjects(value, label) {
+    return semanticArray(value, label).map((item, index) => {
+        const itemLabel = `${label}[${index}]`;
+        const row = semanticObject(item, itemLabel, [
+            "key",
+            "family_ref",
+            "outcome_ref",
+            "kind",
+            "parent_ref",
+            "owner_ref",
+            "source_item_refs",
+            "basis_refs",
+        ]);
+        return {
+            key: semanticStableRef(row.key, `${itemLabel}.key`),
+            family_ref: semanticStableRef(row.family_ref, `${itemLabel}.family_ref`),
+            outcome_ref: semanticStableRef(row.outcome_ref, `${itemLabel}.outcome_ref`),
+            kind: semanticStableRef(row.kind, `${itemLabel}.kind`),
+            parent_ref: semanticNullable(row.parent_ref, (entry) => semanticStableRef(entry, `${itemLabel}.parent_ref`)),
+            owner_ref: semanticNullable(row.owner_ref, (entry) => semanticStableRef(entry, `${itemLabel}.owner_ref`)),
+            source_item_refs: semanticStableRefs(row.source_item_refs, `${itemLabel}.source_item_refs`),
+            basis_refs: semanticStableRefs(row.basis_refs, `${itemLabel}.basis_refs`),
+        };
+    });
+}
+export function parseSemanticFactRelations(value, label) {
+    return semanticArray(value, label).map((item, index) => {
+        const itemLabel = `${label}[${index}]`;
+        const row = semanticObject(item, itemLabel, [
+            "key",
+            "family_ref",
+            "outcome_ref",
+            "kind",
+            "endpoints",
+            "source_item_refs",
+            "basis_refs",
+        ]);
+        return {
+            key: semanticStableRef(row.key, `${itemLabel}.key`),
+            family_ref: semanticStableRef(row.family_ref, `${itemLabel}.family_ref`),
+            outcome_ref: semanticStableRef(row.outcome_ref, `${itemLabel}.outcome_ref`),
+            kind: semanticStableRef(row.kind, `${itemLabel}.kind`),
+            endpoints: semanticArray(row.endpoints, `${itemLabel}.endpoints`).map((endpoint, endpointIndex) => {
+                const endpointLabel = `${itemLabel}.endpoints[${endpointIndex}]`;
+                const entry = semanticObject(endpoint, endpointLabel, [
+                    "role",
+                    "unit_ref",
+                ]);
+                return {
+                    role: semanticStableRef(entry.role, `${endpointLabel}.role`),
+                    unit_ref: semanticStableRef(entry.unit_ref, `${endpointLabel}.unit_ref`),
+                };
+            }),
+            source_item_refs: semanticStableRefs(row.source_item_refs, `${itemLabel}.source_item_refs`),
+            basis_refs: semanticStableRefs(row.basis_refs, `${itemLabel}.basis_refs`),
+        };
+    });
+}
+export function parseSemanticFactPopulations(value, label) {
+    return semanticArray(value, label).map((item, index) => {
+        const itemLabel = `${label}[${index}]`;
+        const row = semanticObject(item, itemLabel, [
+            "key",
+            "family_ref",
+            "outcome_ref",
+            "kind",
+            "member_unit_refs",
+            "universe",
+            "enumeration_rule",
+            "exclusion_refs",
+            "source_item_refs",
+            "basis_refs",
+        ]);
+        return {
+            key: semanticStableRef(row.key, `${itemLabel}.key`),
+            family_ref: semanticStableRef(row.family_ref, `${itemLabel}.family_ref`),
+            outcome_ref: semanticStableRef(row.outcome_ref, `${itemLabel}.outcome_ref`),
+            kind: semanticLiteral(row.kind, ["static", "dynamic"], `${itemLabel}.kind`),
+            member_unit_refs: semanticStableRefs(row.member_unit_refs, `${itemLabel}.member_unit_refs`),
+            universe: parseSemanticFactLocatedValue(row.universe, `${itemLabel}.universe`),
+            enumeration_rule: semanticString(row.enumeration_rule, `${itemLabel}.enumeration_rule`),
+            exclusion_refs: semanticStableRefs(row.exclusion_refs, `${itemLabel}.exclusion_refs`),
+            source_item_refs: semanticStableRefs(row.source_item_refs, `${itemLabel}.source_item_refs`),
+            basis_refs: semanticStableRefs(row.basis_refs, `${itemLabel}.basis_refs`),
+        };
+    });
+}

package/dist/lib/semantic-fact-value-shape.d.ts

@@ -0,0 +1,12 @@
+import type { SemanticFactLocatedValueV1 } from "./semantic-fact-types.js";
+export declare function parseSemanticFactAxisValues(value: unknown, label: string): {
+    axis_ref: string;
+    value_ref: string;
+}[];
+export declare function parseSemanticFactLocatedValue(value: unknown, label: string): SemanticFactLocatedValueV1;
+export declare function parseSemanticFactLocator(value: unknown, label: string): {
+    material_ref: string;
+    kind: "api_operation" | "code_symbol" | "custom" | "json_pointer" | "manifest_pointer" | "schema_pointer" | "source_item" | "whole_resource" | "yaml_pointer";
+    value: string;
+};
+export declare function parseSemanticFactBoolean(value: unknown, label: string): boolean;

package/dist/lib/semantic-fact-value-shape.js

@@ -0,0 +1,39 @@
+import { SEMANTIC_FACT_LOCATOR_KINDS } from "./semantic-fact-shape-constants.js";
+import { semanticArray, semanticLiteral, semanticObject, semanticSha256, semanticStableRef, semanticString, } from "./semantic-fact-shape-primitives.js";
+export function parseSemanticFactAxisValues(value, label) {
+    return semanticArray(value, label).map((item, index) => {
+        const itemLabel = `${label}[${index}]`;
+        const row = semanticObject(item, itemLabel, ["axis_ref", "value_ref"]);
+        return {
+            axis_ref: semanticStableRef(row.axis_ref, `${itemLabel}.axis_ref`),
+            value_ref: semanticStableRef(row.value_ref, `${itemLabel}.value_ref`),
+        };
+    });
+}
+export function parseSemanticFactLocatedValue(value, label) {
+    const preliminary = semanticObject(value, label, ["representation", "locator", "sha256"], ["value"]);
+    const representation = semanticLiteral(preliminary.representation, ["inline", "located", "digest_only"], `${label}.representation`);
+    if (representation === "inline" && !Object.hasOwn(preliminary, "value"))
+        throw new Error(`semantic_fact_manifest_invalid:${label}.value:required for inline representation`);
+    if (representation !== "inline" && Object.hasOwn(preliminary, "value"))
+        throw new Error(`semantic_fact_manifest_invalid:${label}.value:forbidden for ${representation} representation`);
+    return {
+        representation,
+        locator: parseSemanticFactLocator(preliminary.locator, `${label}.locator`),
+        sha256: semanticSha256(preliminary.sha256, `${label}.sha256`),
+        ...(representation === "inline" ? { value: preliminary.value } : {}),
+    };
+}
+export function parseSemanticFactLocator(value, label) {
+    const row = semanticObject(value, label, ["material_ref", "kind", "value"]);
+    return {
+        material_ref: semanticStableRef(row.material_ref, `${label}.material_ref`),
+        kind: semanticLiteral(row.kind, SEMANTIC_FACT_LOCATOR_KINDS, `${label}.kind`),
+        value: semanticString(row.value, `${label}.value`),
+    };
+}
+export function parseSemanticFactBoolean(value, label) {
+    if (typeof value !== "boolean")
+        throw new Error(`semantic_fact_manifest_invalid:${label}:must be boolean`);
+    return value;
+}