@aelionsdk/material-sdk 0.1.0-beta.1

package/dist/security.js

@@ -0,0 +1,161 @@
+import { throwIfAborted } from '@aelionsdk/core';
+import { verifyMaterialPackage } from './package.js';
+function signatureAlgorithm(algorithm) {
+    return algorithm === 'Ed25519'
+        ? { name: 'Ed25519' }
+        : { name: 'ECDSA', hash: { name: 'SHA-256' } };
+}
+function base64Url(bytes) {
+    let binary = '';
+    for (const value of bytes)
+        binary += String.fromCharCode(value);
+    return btoa(binary).replaceAll('+', '-').replaceAll('/', '_').replaceAll('=', '');
+}
+function fromBase64Url(value) {
+    if (!/^[A-Za-z0-9_-]+$/u.test(value))
+        throw new TypeError('Invalid base64url signature');
+    const padded = value
+        .replaceAll('-', '+')
+        .replaceAll('_', '/')
+        .padEnd(Math.ceil(value.length / 4) * 4, '=');
+    const binary = atob(padded);
+    return Uint8Array.from(binary, character => character.charCodeAt(0));
+}
+function signingPayload(packed) {
+    const domain = new TextEncoder().encode(`AELION-MATERIAL-SIGNATURE-V1\n${packed.integrity}\n`);
+    const payload = new Uint8Array(domain.byteLength + packed.manifestBytes.byteLength);
+    payload.set(domain);
+    payload.set(packed.manifestBytes, domain.byteLength);
+    return payload;
+}
+export async function signMaterialPackage(packed, options) {
+    throwIfAborted(options.signal, 'Material package signing');
+    await verifyMaterialPackage(packed);
+    const signature = new Uint8Array(await crypto.subtle.sign(signatureAlgorithm(options.algorithm), options.privateKey, signingPayload(packed)));
+    throwIfAborted(options.signal, 'Material package signing');
+    return {
+        package: packed,
+        signature: {
+            version: 1,
+            publisherId: options.publisherId,
+            keyId: options.keyId,
+            algorithm: options.algorithm,
+            signedAtMs: options.signedAtMs ?? Date.now(),
+            manifestIntegrity: packed.integrity,
+            signatureBase64Url: base64Url(signature),
+        },
+    };
+}
+export class MaterialTrustStore {
+    #keys = new Map();
+    #revokedKeys = new Map();
+    #revokedPackages = new Map();
+    #audit = [];
+    #maxAuditEntries;
+    #sequence = 0;
+    constructor(maxAuditEntries = 1_024) {
+        if (!Number.isSafeInteger(maxAuditEntries) || maxAuditEntries <= 0) {
+            throw new RangeError('maxAuditEntries must be a positive safe integer');
+        }
+        this.#maxAuditEntries = maxAuditEntries;
+    }
+    addKey(key, nowMs = Date.now()) {
+        const id = this.#keyId(key.publisherId, key.keyId);
+        if (this.#keys.has(id))
+            throw new TypeError('MATERIAL_TRUST_KEY_EXISTS');
+        this.#keys.set(id, key);
+        this.#record({
+            timeMs: nowMs,
+            action: 'key-added',
+            publisherId: key.publisherId,
+            keyId: key.keyId,
+        });
+    }
+    revokeKey(publisherId, keyId, reason, nowMs = Date.now()) {
+        this.#revokedKeys.set(this.#keyId(publisherId, keyId), reason);
+        this.#record({ timeMs: nowMs, action: 'key-revoked', publisherId, keyId, reason });
+    }
+    revokePackage(integrity, reason, nowMs = Date.now()) {
+        this.#revokedPackages.set(integrity, reason);
+        this.#record({ timeMs: nowMs, action: 'package-revoked', integrity, reason });
+    }
+    async verify(signed, options = {}) {
+        const nowMs = options.nowMs ?? Date.now();
+        const { signature, package: packed } = signed;
+        const signatureVersion = Reflect.get(signature, 'version');
+        try {
+            throwIfAborted(options.signal, 'Material signature verification');
+            await verifyMaterialPackage(packed, signature.manifestIntegrity);
+            if (signatureVersion !== 1 ||
+                signature.manifestIntegrity !== packed.integrity ||
+                signature.publisherId !== packed.manifest.package.publisher.id) {
+                throw new TypeError('MATERIAL_SIGNATURE_IDENTITY_MISMATCH');
+            }
+            const keyIdentity = this.#keyId(signature.publisherId, signature.keyId);
+            const revokedKey = this.#revokedKeys.get(keyIdentity);
+            if (revokedKey !== undefined)
+                throw new TypeError(`MATERIAL_KEY_REVOKED: ${revokedKey}`);
+            const revokedPackage = this.#revokedPackages.get(packed.integrity);
+            if (revokedPackage !== undefined) {
+                throw new TypeError(`MATERIAL_PACKAGE_REVOKED: ${revokedPackage}`);
+            }
+            const key = this.#keys.get(keyIdentity);
+            if (key === undefined || key.algorithm !== signature.algorithm) {
+                throw new TypeError('MATERIAL_PUBLISHER_UNTRUSTED');
+            }
+            if ((key.validFromMs !== undefined && signature.signedAtMs < key.validFromMs) ||
+                (key.validUntilMs !== undefined && signature.signedAtMs > key.validUntilMs) ||
+                signature.signedAtMs > nowMs) {
+                throw new TypeError('MATERIAL_SIGNATURE_TIME_INVALID');
+            }
+            const valid = await crypto.subtle.verify(signatureAlgorithm(signature.algorithm), key.publicKey, fromBase64Url(signature.signatureBase64Url), signingPayload(packed));
+            if (!valid)
+                throw new TypeError('MATERIAL_SIGNATURE_INVALID');
+            this.#record({
+                timeMs: nowMs,
+                action: 'verified',
+                publisherId: signature.publisherId,
+                keyId: signature.keyId,
+                integrity: packed.integrity,
+            });
+        }
+        catch (error) {
+            this.#record({
+                timeMs: nowMs,
+                action: 'rejected',
+                publisherId: signature.publisherId,
+                keyId: signature.keyId,
+                integrity: packed.integrity,
+                reason: error instanceof Error ? error.message : 'unknown',
+            });
+            throw error;
+        }
+    }
+    auditLog() {
+        return this.#audit.map(entry => ({ ...entry }));
+    }
+    #keyId(publisherId, keyId) {
+        return `${publisherId}\0${keyId}`;
+    }
+    #record(entry) {
+        this.#audit.push({ sequence: ++this.#sequence, ...entry });
+        if (this.#audit.length > this.#maxAuditEntries)
+            this.#audit.shift();
+    }
+}
+export function enforceMaterialExecutionPolicy(publisherId, requested, host) {
+    if (!host.trustedPublisherIds.has(publisherId))
+        throw new TypeError('MATERIAL_PUBLISHER_UNTRUSTED');
+    if (requested.allowShader && !host.allowShader)
+        throw new TypeError('MATERIAL_SHADER_PERMISSION_DENIED');
+    if (requested.allowWasm && !host.allowWasm)
+        throw new TypeError('MATERIAL_WASM_PERMISSION_DENIED');
+    if (requested.maxMemoryBytes > host.maxMemoryBytes ||
+        requested.maxExecutionMs > host.maxExecutionMs) {
+        throw new RangeError('MATERIAL_EXECUTION_BUDGET_DENIED');
+    }
+    for (const origin of requested.allowedNetworkOrigins) {
+        if (!host.allowedNetworkOrigins.has(origin))
+            throw new TypeError('MATERIAL_NETWORK_PERMISSION_DENIED');
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,245 @@
+import type { Diagnostic, JsonValue } from '@aelionsdk/core';
+import type { MaterialGraph } from '@aelionsdk/material-compiler';
+export declare const MATERIAL_PROTOCOL_VERSION: "1.0.0";
+export declare const MATERIAL_PACKAGE_SCHEMA: "https://schemas.aelion.dev/material/package/v1.json";
+export declare const MATERIAL_DEFINITION_SCHEMA: "https://schemas.aelion.dev/material/definition/v1.json";
+export declare const MATERIAL_GRAPH_SCHEMA: "https://schemas.aelion.dev/material/graph/v1.json";
+export declare const MATERIAL_NODE_SET: "aelion.visual.nodes/1.0.0";
+export type MaterialKind = 'visual-filter' | 'visual-effect' | 'visual-transition' | 'visual-generator';
+export type MaterialScope = 'source' | 'item' | 'track' | 'sequence' | 'transition';
+export type MaterialPortType = 'visual-frame' | 'mask' | 'depth' | 'motion-vectors';
+export type MaterialParameterType = 'boolean' | 'integer' | 'float' | 'enum' | 'vec2' | 'vec3' | 'vec4' | 'color' | 'angle' | 'duration' | 'gradient' | 'curve' | 'string';
+export type MaterialResourceKind = 'texture2d' | 'texture3d' | 'lut1d' | 'lut3d' | 'cube-texture' | 'mask' | 'binary-table';
+export interface MaterialDisplay {
+    readonly name: string;
+    readonly description?: string;
+    readonly category?: string;
+    readonly tags?: readonly string[];
+    readonly icon?: string;
+    readonly thumbnail?: string;
+    readonly preview?: string;
+    readonly localizationPrefix?: string;
+}
+export interface MaterialPort {
+    readonly id: string;
+    readonly direction: 'input' | 'output';
+    readonly type: MaterialPortType;
+    readonly role: 'source' | 'from' | 'to' | 'auxiliary' | 'result';
+    readonly binding: 'host' | 'instance';
+    readonly required: boolean;
+    readonly description?: string;
+}
+export interface MaterialParameter {
+    readonly id: string;
+    readonly type: MaterialParameterType;
+    readonly default: JsonValue;
+    readonly range?: {
+        readonly min?: number;
+        readonly max?: number;
+        readonly softMin?: number;
+        readonly softMax?: number;
+        readonly step?: number;
+    };
+    readonly values?: readonly string[];
+    readonly unit?: 'none' | 'ratio' | 'percent' | 'px' | 'degree' | 'us' | 'db' | 'hz';
+    readonly animatable: boolean;
+    readonly interpolation?: 'hold' | 'linear' | 'cubic-bezier' | 'shortest-angle' | 'linear-color';
+    readonly affects: 'uniform' | 'specialization' | 'graph';
+    readonly ui: {
+        readonly control: 'toggle' | 'slider' | 'number' | 'select' | 'segmented' | 'color' | 'point' | 'curve' | 'gradient' | 'text';
+        readonly group: string;
+        readonly order: number;
+        readonly label: string;
+    };
+}
+export interface BundledMaterialResource {
+    readonly id: string;
+    readonly kind: MaterialResourceKind;
+    readonly path: string;
+    readonly [key: string]: JsonValue;
+}
+export interface MaterialResourceSlot {
+    readonly id: string;
+    readonly kind: MaterialResourceKind;
+    readonly required: boolean;
+    readonly fallbackResourceId?: string;
+    readonly [key: string]: JsonValue | undefined;
+}
+export interface MaterialExecutionContract {
+    readonly color: {
+        readonly input: 'working-linear';
+        readonly output: 'working-linear';
+    };
+    readonly alpha: {
+        readonly input: 'premultiplied';
+        readonly output: 'premultiplied';
+        readonly preservesTransparency: boolean;
+    };
+    readonly resolution: {
+        readonly policy: 'same-as-host' | 'scale';
+        readonly scale?: number;
+        readonly minimum?: {
+            readonly width: number;
+            readonly height: number;
+        };
+    };
+    readonly spatialPadding: {
+        readonly mode: 'none';
+    } | {
+        readonly mode: 'fixed';
+        readonly pixels: number;
+    } | {
+        readonly mode: 'parameter-bound';
+        readonly parameter: string;
+        readonly maximumPixels: number;
+    };
+    readonly temporal: {
+        readonly pastUs: number;
+        readonly futureUs: number;
+        readonly stateful: boolean;
+        readonly seekPolicy: 'stateless' | 'reconstruct' | 'reset-with-warning';
+    };
+    readonly determinism: 'strict' | 'backend-tolerant' | 'non-deterministic';
+    readonly supports: {
+        readonly realtime: boolean;
+        readonly offline: boolean;
+        readonly alpha: boolean;
+        readonly hdr: boolean;
+        readonly tiled: boolean;
+    };
+}
+export type MaterialImplementation = {
+    readonly type: 'graph';
+    readonly graph: string;
+    readonly nodeSet: string;
+} | ({
+    readonly type: 'shader';
+    readonly backend: 'webgpu';
+    readonly abi: 'aelion-material-shader/1';
+    readonly module: string;
+    readonly entryPoint: string;
+    readonly [key: string]: JsonValue;
+} | {
+    readonly type: 'shader';
+    readonly backend: 'webgl2';
+    readonly abi: 'aelion-material-webgl/1';
+    readonly vertexModule?: string;
+    readonly fragmentModule: string;
+    readonly entryPoint: string;
+    readonly [key: string]: JsonValue | undefined;
+}) | {
+    readonly type: 'wasm';
+    readonly module: string;
+    readonly abi: 'aelion-material-wasm/1';
+    readonly [key: string]: JsonValue;
+};
+export interface MaterialDefinition {
+    readonly $schema: typeof MATERIAL_DEFINITION_SCHEMA;
+    readonly protocolVersion: typeof MATERIAL_PROTOCOL_VERSION;
+    readonly id: string;
+    readonly kind: MaterialKind;
+    readonly display: MaterialDisplay;
+    readonly scopes: readonly MaterialScope[];
+    readonly ports: readonly MaterialPort[];
+    readonly parameters: readonly MaterialParameter[];
+    readonly bundledResources: readonly BundledMaterialResource[];
+    readonly resourceSlots: readonly MaterialResourceSlot[];
+    readonly execution: MaterialExecutionContract;
+    readonly implementations: readonly MaterialImplementation[];
+    readonly splitPolicy: 'copy' | 'reset' | 'reject';
+}
+export interface MaterialPackageMetadata {
+    readonly id: string;
+    readonly version: string;
+    readonly displayName: string;
+    readonly publisher: {
+        readonly id: string;
+        readonly name: string;
+    };
+    readonly license: string;
+    readonly engines: {
+        readonly aelion: string;
+        readonly nodeSet: string;
+    };
+    readonly trust: 'declarative' | 'trusted-code';
+}
+export interface MaterialPackageManifest {
+    readonly $schema: typeof MATERIAL_PACKAGE_SCHEMA;
+    readonly protocolVersion: typeof MATERIAL_PROTOCOL_VERSION;
+    readonly package: MaterialPackageMetadata;
+    readonly materials: readonly {
+        readonly id: string;
+        readonly kind: MaterialKind;
+        readonly definition: string;
+    }[];
+    readonly files: readonly {
+        readonly path: string;
+        readonly mediaType: string;
+        readonly bytes: number;
+        readonly sha256: string;
+    }[];
+}
+export interface AuthoredMaterial {
+    readonly definition: MaterialDefinition;
+    readonly graph?: MaterialGraph;
+    readonly definitionPath?: string;
+    readonly graphPath?: string;
+}
+export interface MaterialPackageFile {
+    readonly path: string;
+    readonly mediaType: string;
+    readonly data: Uint8Array | string;
+}
+/** Hard transport bounds applied before package bytes are copied or ZIP bytes are rebuilt. */
+export interface MaterialPackageByteLimits {
+    /** Includes `manifest.json`. ZIP transport cannot represent more than 65,535 entries. */
+    readonly maxFiles: number;
+    /** Maximum bytes for any one non-manifest payload. */
+    readonly maxFileBytes: number;
+    /** Maximum canonical `manifest.json` bytes. */
+    readonly maxManifestBytes: number;
+    /** Maximum sum of `manifest.json` and all payload bytes. */
+    readonly maxPackageBytes: number;
+    /** Maximum deterministic `.aelionmat` ZIP bytes. */
+    readonly maxArchiveBytes: number;
+}
+export type MaterialPackageByteLimitOptions = Partial<MaterialPackageByteLimits>;
+export interface PackMaterialPackageOptions {
+    readonly metadata: MaterialPackageMetadata;
+    readonly materials: readonly AuthoredMaterial[];
+    readonly files?: readonly MaterialPackageFile[];
+    /** Defaults to the fail-closed browser transport limits exported by this package. */
+    readonly limits?: MaterialPackageByteLimitOptions;
+}
+export interface PackedMaterialPackage {
+    /** Derived convenience view; verification authority is the signed `manifestBytes`. */
+    readonly manifest: MaterialPackageManifest;
+    readonly manifestBytes: Uint8Array;
+    /** Includes manifest.json and every manifest-declared payload file. */
+    readonly files: ReadonlyMap<string, Uint8Array>;
+    /** Deterministic, store-only ZIP bytes suitable for a `.aelionmat` file. */
+    readonly archiveBytes: Uint8Array;
+    readonly integrity: `sha256:${string}`;
+}
+export interface MaterialValidationResult {
+    readonly valid: boolean;
+    readonly diagnostics: readonly Diagnostic[];
+}
+export interface MaterialPackageReference {
+    readonly packageId: string;
+    readonly packageVersion: string;
+    readonly packageIntegrity: string;
+    readonly materialId: string;
+}
+export interface ResolvedMaterial {
+    readonly reference: MaterialPackageReference;
+    readonly manifest: MaterialPackageManifest;
+    readonly definition: MaterialDefinition;
+    readonly graph?: MaterialGraph;
+}
+export interface MaterialPackageResolver {
+    resolve(reference: Pick<MaterialPackageReference, 'packageId' | 'packageVersion' | 'packageIntegrity'>, options?: {
+        readonly signal?: AbortSignal;
+    }): Promise<PackedMaterialPackage>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+export const MATERIAL_PROTOCOL_VERSION = '1.0.0';
+export const MATERIAL_PACKAGE_SCHEMA = 'https://schemas.aelion.dev/material/package/v1.json';
+export const MATERIAL_DEFINITION_SCHEMA = 'https://schemas.aelion.dev/material/definition/v1.json';
+export const MATERIAL_GRAPH_SCHEMA = 'https://schemas.aelion.dev/material/graph/v1.json';
+export const MATERIAL_NODE_SET = 'aelion.visual.nodes/1.0.0';

package/dist/validation.d.ts

@@ -0,0 +1,6 @@
+import { type CompileMaterialOptions } from '@aelionsdk/material-compiler';
+import type { AuthoredMaterial, MaterialValidationResult } from './types.js';
+export declare function validateAuthoredMaterial(authored: AuthoredMaterial, options?: {
+    readonly budget?: CompileMaterialOptions['budget'];
+}): MaterialValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEjG,OAAO,KAAK,EACV,gBAAgB,EAGhB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAsEpB,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAA;CAAO,GACnE,wBAAwB,CAgH1B"}

package/dist/validation.js

@@ -0,0 +1,124 @@
+import { compileMaterialGraph } from '@aelionsdk/material-compiler';
+function issue(diagnostics, code, message, path) {
+    diagnostics.push({ code, severity: 'error', message, path, recoverable: false });
+}
+function duplicates(values) {
+    const seen = new Set();
+    const result = new Set();
+    for (const value of values) {
+        if (seen.has(value.id))
+            result.add(value.id);
+        seen.add(value.id);
+    }
+    return [...result];
+}
+function validDefault(parameter) {
+    const value = parameter.default;
+    switch (parameter.type) {
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'integer':
+        case 'duration':
+            return typeof value === 'number' && Number.isSafeInteger(value);
+        case 'float':
+        case 'angle':
+            return typeof value === 'number' && Number.isFinite(value);
+        case 'enum':
+            return typeof value === 'string' && (parameter.values?.includes(value) ?? false);
+        case 'string':
+            return typeof value === 'string';
+        default:
+            return value !== null;
+    }
+}
+function requireHostPort(definition, diagnostics, id, direction, role) {
+    const port = definition.ports.find(value => value.id === id);
+    if (port?.direction !== direction ||
+        port.type !== 'visual-frame' ||
+        port.role !== role ||
+        port.binding !== 'host' ||
+        !port.required) {
+        issue(diagnostics, 'MATERIAL_DEFINITION_INVALID', `${definition.kind} requires host port ${id}:${direction}/${role}`, ['definition', 'ports']);
+    }
+}
+function compilerParameterType(parameter) {
+    if (['float', 'integer', 'angle', 'duration'].includes(parameter.type))
+        return 'float';
+    return parameter.type === 'enum' ? 'enum' : undefined;
+}
+export function validateAuthoredMaterial(authored, options = {}) {
+    const diagnostics = [];
+    const { definition, graph } = authored;
+    for (const [collection, values] of [
+        ['ports', definition.ports],
+        ['parameters', definition.parameters],
+        ['bundledResources', definition.bundledResources],
+        ['resourceSlots', definition.resourceSlots],
+    ]) {
+        for (const id of duplicates(values)) {
+            issue(diagnostics, 'MATERIAL_DEFINITION_INVALID', `Duplicate ${collection} id ${id}`, [
+                'definition',
+                collection,
+            ]);
+        }
+    }
+    if (definition.kind === 'visual-filter' || definition.kind === 'visual-effect') {
+        requireHostPort(definition, diagnostics, 'source', 'input', 'source');
+        requireHostPort(definition, diagnostics, 'result', 'output', 'result');
+    }
+    else if (definition.kind === 'visual-transition') {
+        requireHostPort(definition, diagnostics, 'from', 'input', 'from');
+        requireHostPort(definition, diagnostics, 'to', 'input', 'to');
+        requireHostPort(definition, diagnostics, 'result', 'output', 'result');
+        if (!definition.scopes.includes('transition')) {
+            issue(diagnostics, 'MATERIAL_DEFINITION_INVALID', 'visual-transition requires transition scope', ['definition', 'scopes']);
+        }
+    }
+    else {
+        requireHostPort(definition, diagnostics, 'result', 'output', 'result');
+    }
+    for (const [index, parameter] of definition.parameters.entries()) {
+        if (!validDefault(parameter)) {
+            issue(diagnostics, 'MATERIAL_DEFINITION_INVALID', `Parameter ${parameter.id} has an invalid default`, ['definition', 'parameters', index, 'default']);
+        }
+        if (parameter.animatable && parameter.affects !== 'uniform') {
+            issue(diagnostics, 'MATERIAL_DEFINITION_INVALID', `Animatable parameter ${parameter.id} must affect uniform`, ['definition', 'parameters', index, 'affects']);
+        }
+        if (typeof parameter.default === 'number' &&
+            ((parameter.range?.min !== undefined && parameter.default < parameter.range.min) ||
+                (parameter.range?.max !== undefined && parameter.default > parameter.range.max))) {
+            issue(diagnostics, 'MATERIAL_DEFINITION_INVALID', `Parameter ${parameter.id} default is outside its range`, ['definition', 'parameters', index, 'default']);
+        }
+    }
+    const graphImplementations = definition.implementations.filter(value => value.type === 'graph');
+    if (graphImplementations.length > 0 && graph === undefined) {
+        issue(diagnostics, 'MATERIAL_GRAPH_INVALID', 'A graph implementation requires a Graph payload', ['graph']);
+    }
+    if (graph !== undefined) {
+        const parameters = Object.fromEntries(definition.parameters.flatMap(parameter => {
+            const type = compilerParameterType(parameter);
+            return type === undefined ? [] : [[parameter.id, type]];
+        }));
+        const inputPorts = Object.fromEntries(definition.ports
+            .filter(port => port.direction === 'input' && port.type === 'visual-frame')
+            .map(port => [port.id, 'visual-frame']));
+        const specializationValues = Object.fromEntries(definition.parameters
+            .filter(parameter => parameter.affects === 'specialization')
+            .map(parameter => [parameter.id, parameter.default]));
+        const compiled = compileMaterialGraph(graph, {
+            parameters,
+            inputPorts,
+            systems: { transitionProgress: 'float' },
+            specializationValues,
+            ...(options.budget === undefined ? {} : { budget: options.budget }),
+        });
+        diagnostics.push(...compiled.diagnostics);
+        if (graph.nodeSet !== definition.implementations.find(value => value.type === 'graph')?.nodeSet) {
+            issue(diagnostics, 'MATERIAL_PROTOCOL_UNSUPPORTED', 'Definition and Graph node sets differ', [
+                'graph',
+                'nodeSet',
+            ]);
+        }
+    }
+    return { valid: diagnostics.length === 0, diagnostics };
+}

package/dist/zip.d.ts

@@ -0,0 +1,4 @@
+import type { MaterialPackageByteLimitOptions } from './types.js';
+/** Writes deterministic uncompressed ZIP bytes without platform metadata or variable timestamps. */
+export declare function createDeterministicMaterialArchive(files: ReadonlyMap<string, Uint8Array>, options?: MaterialPackageByteLimitOptions): Uint8Array;
+//# sourceMappingURL=zip.d.ts.map

package/dist/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../src/zip.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAgJlE,oGAAoG;AACpG,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,EACtC,OAAO,GAAE,+BAAoC,GAC5C,UAAU,CAsDZ"}