@hatiolab/figure-model 0.1.30 → 0.1.31

package/dist/v3-asset.js.map

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

package/dist/v3-authoring-session.d.ts

@@ -0,0 +1,119 @@
+import type { V3Document, V3CapabilityEvaluation } from './v3-asset-types.ts';
+import type { V3Unit } from './v3-graph-types.ts';
+export interface V3EditControl {
+    origin: 'ui' | 'ai';
+    expectedRevision: number;
+}
+export interface V3InputChange {
+    kind: 'set-design' | 'set-state';
+    input: string;
+    unit: V3Unit;
+    value: number;
+}
+export interface V3EditRequest extends V3EditControl {
+    changes: V3InputChange[];
+}
+export declare function createV3AuthoringSession(document: V3Document, initialInputs: Record<string, number>): {
+    read: () => {
+        revision: number;
+        inputs: Record<string, number>;
+        evaluation: V3CapabilityEvaluation;
+        canUndo: boolean;
+        canRedo: boolean;
+    };
+    preview(q: V3EditRequest): {
+        candidate: {
+            inputs: Record<string, number>;
+            evaluation: V3CapabilityEvaluation;
+        };
+        baseRevision: number;
+        origin: "ui" | "ai";
+        changes: {
+            before: number | undefined;
+            kind: "set-design" | "set-state";
+            input: string;
+            unit: V3Unit;
+            value: number;
+        }[];
+        effects: {
+            geometry: {
+                added: string[];
+                removed: string[];
+                changed: string[];
+            };
+            bindingsChanged: string[];
+        };
+        validation: {
+            status: string;
+            spatial: string;
+            collision: string;
+            safety: string;
+        };
+    };
+    apply(q: V3EditRequest): {
+        revision: number;
+        inputs: Record<string, number>;
+        evaluation: V3CapabilityEvaluation;
+        canUndo: boolean;
+        canRedo: boolean;
+        report: {
+            baseRevision: number;
+            origin: "ui" | "ai";
+            changes: {
+                before: number | undefined;
+                kind: "set-design" | "set-state";
+                input: string;
+                unit: V3Unit;
+                value: number;
+            }[];
+            effects: {
+                geometry: {
+                    added: string[];
+                    removed: string[];
+                    changed: string[];
+                };
+                bindingsChanged: string[];
+            };
+            validation: {
+                status: string;
+                spatial: string;
+                collision: string;
+                safety: string;
+            };
+        };
+    };
+    undo(q: V3EditControl): {
+        revision: number;
+        inputs: Record<string, number>;
+        evaluation: V3CapabilityEvaluation;
+        canUndo: boolean;
+        canRedo: boolean;
+        origin: "ui" | "ai";
+        effects: {
+            geometry: {
+                added: string[];
+                removed: string[];
+                changed: string[];
+            };
+            bindingsChanged: string[];
+        };
+    };
+    redo(q: V3EditControl): {
+        revision: number;
+        inputs: Record<string, number>;
+        evaluation: V3CapabilityEvaluation;
+        canUndo: boolean;
+        canRedo: boolean;
+        origin: "ui" | "ai";
+        effects: {
+            geometry: {
+                added: string[];
+                removed: string[];
+                changed: string[];
+            };
+            bindingsChanged: string[];
+        };
+    };
+};
+export type V3AuthoringSession = ReturnType<typeof createV3AuthoringSession>;
+//# sourceMappingURL=v3-authoring-session.d.ts.map

package/dist/v3-authoring-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-authoring-session.d.ts","sourceRoot":"","sources":["../src/v3-authoring-session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC7E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,IAAI,GAAG,IAAI,CAAA;IACnB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AACD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,YAAY,GAAG,WAAW,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AACD,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,OAAO,EAAE,aAAa,EAAE,CAAA;CACzB;AA6BD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;eAmErF,aAAa;;;;;;;;;kBAvGpB,YAAY,GAAG,WAAW;mBACzB,MAAM;kBACP,MAAM;mBACL,MAAM;;;;;;;;;;;;;;;;;aAwGF,aAAa;;;;;;;;;;;sBA3GlB,YAAY,GAAG,WAAW;uBACzB,MAAM;sBACP,MAAM;uBACL,MAAM;;;;;;;;;;;;;;;;;;YAkHH,aAAa;;;;;;;;;;;;;;;;YAYb,aAAa;;;;;;;;;;;;;;;;EAaxB;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/v3-authoring-session.js

@@ -0,0 +1,132 @@
+// Shared UI/AI transaction experiment. In-memory, input edits only; not product persistence.
+import { compileV3Document as compileDocument } from "./v3-document.js";
+import { V3ContractError as ContractError } from "./v3-contract.js";
+function fail(code, path, message) {
+    throw new ContractError(code, path, message);
+}
+function fields(o, keys, path) {
+    if (!o ||
+        typeof o !== 'object' ||
+        Array.isArray(o) ||
+        Object.keys(o).length !== keys.length ||
+        keys.some(k => !Object.hasOwn(o, k)))
+        fail('EDIT_SCHEMA', path, `expected ${keys.join(', ')}`);
+}
+const same = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+function diff(before, after) {
+    const a = new Map(before.geometry.map(g => [g.id, g])), b = new Map(after.geometry.map(g => [g.id, g]));
+    const previous = new Map(before.bindings.map(b => [b.id, b]));
+    return {
+        geometry: {
+            added: [...b.keys()].filter(id => !a.has(id)),
+            removed: [...a.keys()].filter(id => !b.has(id)),
+            changed: [...b.keys()].filter(id => a.has(id) && !same(a.get(id), b.get(id)))
+        },
+        bindingsChanged: after.bindings.filter(b => !same(previous.get(b.id), b)).map(b => b.id)
+    };
+}
+export function createV3AuthoringSession(document, initialInputs) {
+    const compiled = compileDocument(document), definitions = new Map(document.model.inputs.map(i => [i.id, structuredClone(i)]));
+    let inputs = structuredClone(initialInputs), evaluation = compiled.evaluate(inputs), revision = 0;
+    const undo = [], redo = [];
+    const historyLimit = 50;
+    function control(q) {
+        if (!['ui', 'ai'].includes(q.origin))
+            fail('EDIT_ORIGIN', 'origin', 'ui or ai required; metadata, not authentication');
+        if (!Number.isSafeInteger(q.expectedRevision) || q.expectedRevision < 0)
+            fail('EDIT_REVISION', 'expectedRevision', 'nonnegative integer required');
+        if (q.expectedRevision !== revision)
+            fail('REVISION_CONFLICT', 'expectedRevision', `expected ${q.expectedRevision}; current ${revision}`);
+    }
+    const snapshot = () => structuredClone({ revision, inputs, evaluation, canUndo: undo.length > 0, canRedo: redo.length > 0 });
+    function candidate(q) {
+        fields(q, ['origin', 'expectedRevision', 'changes'], 'edit');
+        control(q);
+        if (!Array.isArray(q.changes) || !q.changes.length || q.changes.length > 100)
+            fail('EDIT_LIMIT', 'changes', '1..100 changes required');
+        const next = structuredClone(inputs), seen = new Set(), changes = [];
+        for (const change of q.changes) {
+            fields(change, ['kind', 'input', 'unit', 'value'], 'change');
+            const def = definitions.get(change.input);
+            if (!def)
+                fail('UNKNOWN_INPUT', String(change.input), 'input not declared');
+            if (seen.has(change.input))
+                fail('DUPLICATE_EDIT', change.input, 'one assignment per transaction');
+            seen.add(change.input);
+            const kind = def.role === 'state' ? 'set-state' : 'set-design';
+            if (change.kind !== kind)
+                fail('EDIT_ROLE', change.input, `requires ${kind}`);
+            if (change.unit !== def.unit)
+                fail('EDIT_UNIT', change.input, `requires ${def.unit}`);
+            if (typeof change.value !== 'number' || !Number.isFinite(change.value))
+                fail('EDIT_VALUE', change.input, 'finite number required');
+            if (next[change.input] !== change.value)
+                changes.push({ ...change, before: next[change.input] });
+            next[change.input] = change.value;
+        }
+        // Evaluate the final batch once: no invalid intermediate result can escape.
+        const resolved = compiled.evaluate(next);
+        return {
+            next,
+            resolved,
+            report: {
+                baseRevision: revision,
+                origin: q.origin,
+                changes,
+                effects: diff(evaluation, resolved),
+                validation: {
+                    status: 'graph-and-binding-valid',
+                    spatial: 'unverified',
+                    collision: 'unverified',
+                    safety: 'unverified'
+                }
+            }
+        };
+    }
+    function install(next, resolved) {
+        inputs = next;
+        evaluation = resolved;
+        revision++;
+    }
+    return {
+        read: snapshot,
+        preview(q) {
+            const c = candidate(q);
+            return structuredClone({ ...c.report, candidate: { inputs: c.next, evaluation: c.resolved } });
+        },
+        apply(q) {
+            const c = candidate(q);
+            if (c.report.changes.length) {
+                undo.push(structuredClone(inputs));
+                if (undo.length > historyLimit)
+                    undo.shift();
+                redo.length = 0;
+                install(c.next, c.resolved);
+            }
+            return structuredClone({ report: c.report, ...snapshot() });
+        },
+        undo(q) {
+            fields(q, ['origin', 'expectedRevision'], 'undo');
+            control(q);
+            if (!undo.length)
+                fail('NOTHING_TO_UNDO', 'history', 'no undo entry');
+            const next = undo.at(-1), resolved = compiled.evaluate(next), effects = diff(evaluation, resolved);
+            undo.pop();
+            redo.push(structuredClone(inputs));
+            install(next, resolved);
+            return { origin: q.origin, effects, ...snapshot() };
+        },
+        redo(q) {
+            fields(q, ['origin', 'expectedRevision'], 'redo');
+            control(q);
+            if (!redo.length)
+                fail('NOTHING_TO_REDO', 'history', 'no redo entry');
+            const next = redo.at(-1), resolved = compiled.evaluate(next), effects = diff(evaluation, resolved);
+            redo.pop();
+            undo.push(structuredClone(inputs));
+            install(next, resolved);
+            return { origin: q.origin, effects, ...snapshot() };
+        }
+    };
+}
+//# sourceMappingURL=v3-authoring-session.js.map

package/dist/v3-authoring-session.js.map

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

package/dist/v3-capabilities.d.ts

@@ -0,0 +1,3 @@
+import type { V3CompiledCapabilities } from './v3-asset-types.ts';
+export declare function compileV3Capabilities(model: unknown, declaration: unknown): V3CompiledCapabilities;
+//# sourceMappingURL=v3-capabilities.d.ts.map

package/dist/v3-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-capabilities.d.ts","sourceRoot":"","sources":["../src/v3-capabilities.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAcjE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,sBAAsB,CAElG"}

package/dist/v3-capabilities.js

@@ -0,0 +1,221 @@
+// Experimental capability contracts; eligibility is not collision or safety certification.
+import { compileV3Graph as compile } from "./v3-graph.js";
+import { V3ContractError as ContractError } from "./v3-contract.js";
+const fail = (code, path, message) => {
+    throw new ContractError(code, path, message);
+};
+function fields(o, required, optional, path) {
+    if (!o || typeof o !== 'object' || Array.isArray(o))
+        fail('SCHEMA', path, 'object required');
+    for (const k of required)
+        if (!Object.hasOwn(o, k))
+            fail('SCHEMA', path, `missing ${k}`);
+    for (const k of Object.keys(o))
+        if (![...required, ...optional].includes(k))
+            fail('SCHEMA', path, `unknown ${k}`);
+}
+const name = (s, path) => {
+    if (typeof s !== 'string' || !s.trim())
+        fail('SCHEMA', path, 'nonempty string required');
+};
+export function compileV3Capabilities(model, declaration) {
+    return compileInternal(model, declaration);
+}
+function compileInternal(model, declaration) {
+    const plan = compile(model), doc = structuredClone(declaration), types = plan.outputTypes;
+    const writers = new Map(model.nodes.flatMap((n) => Object.values(n.outputs).map((ref) => [ref, structuredClone(n)]))), surfaces = new Map();
+    fields(doc, ['version', 'assetFrame', 'bindings'], [], 'capabilities');
+    if (doc.version !== 'r3-capability-3')
+        fail('VERSION', 'capabilities', doc.version);
+    name(doc.assetFrame, 'assetFrame');
+    if (!Array.isArray(doc.bindings))
+        fail('SCHEMA', 'bindings', 'array required');
+    const ids = new Set();
+    const typeOf = (ref, path) => {
+        name(ref, path);
+        if (!Object.hasOwn(types, ref))
+            fail('TARGET_ABSENT', path, ref);
+        return types[ref];
+    };
+    const transform = (ref, path, from) => {
+        const t = typeOf(ref, path);
+        if (t.kind !== 'transform' || t.to !== doc.assetFrame || (from !== undefined && t.from !== from))
+            fail('FRAME_TYPE', path, 'transform must map declared local frame to assetFrame');
+    };
+    const resolveSurface = (contact, path) => {
+        fields(contact, ['placement', 'feature'], [], path);
+        const placedType = typeOf(contact.placement, path), featureType = typeOf(contact.feature, path);
+        const place = writers.get(contact.placement), feature = writers.get(contact.feature);
+        let source = place, selection;
+        if (place?.op === 'select-item@1') {
+            const repeat = writers.get(place.args[0]), assembly = repeat?.op === 'repeat@1' ? writers.get(repeat.args[1]) : null;
+            if (assembly?.op !== 'assembly@1' || !assembly.args.includes(place.params.member))
+                fail('SURFACE_PROVENANCE', path, 'selected member must belong to the referenced repeat assembly');
+            source = writers.get(place.params.member);
+            if (source?.op !== 'member@1')
+                fail('SURFACE_PROVENANCE', path, 'selected source must be a declared template member');
+            if (model.inputs.some((i) => i.id === place.args[1] && i.role === 'state'))
+                fail('TARGET_STATE', path, 'binding target index must not change as animation state');
+            selection = { collection: place.args[0], index: place.args[1], member: place.params.member };
+        }
+        else if (place?.op !== 'place@1')
+            fail('SURFACE_PROVENANCE', path, 'actual placement or selected repeated member required');
+        if (feature?.op !== 'feature@1')
+            fail('SURFACE_PROVENANCE', path, 'provider feature required');
+        if (placedType.kind !== 'placed' || placedType.frame !== doc.assetFrame || featureType.kind !== 'transform')
+            fail('FRAME_TYPE', path, 'contact must be in asset frame');
+        if (source.args[0] !== feature.args[0])
+            fail('SURFACE_OWNER', path, 'feature belongs to a different shape declaration');
+        const provider = types[feature.args[0]].provider, face = feature.params.name;
+        const normals = {
+            left: [-1, 0, 0],
+            right: [1, 0, 0],
+            bottom: [0, -1, 0],
+            top: [0, 1, 0],
+            back: [0, 0, -1],
+            front: [0, 0, 1],
+            start: [0, -1, 0],
+            end: [0, 1, 0]
+        };
+        const allowed = provider === 'box'
+            ? ['left', 'right', 'bottom', 'top', 'back', 'front']
+            : provider === 'roundedBox'
+                ? ['bottom', 'top']
+                : provider === 'cylinder'
+                    ? ['start', 'end']
+                    : [];
+        if (!allowed.includes(face))
+            fail('SURFACE_UNSUPPORTED', path, 'feature is not a supported planar surface');
+        return {
+            ...contact,
+            geometryId: selection ? null : place.id,
+            selection,
+            provider,
+            face,
+            frame: featureType.from,
+            normal: normals[face]
+        };
+    };
+    const poses = new Map();
+    for (const b of doc.bindings) {
+        fields(b, ['id', 'label', 'role', 'frame', 'pose', 'accepts', 'capacity'], ['region', 'contacts'], 'binding');
+        for (const key of ['id', 'label', 'frame'])
+            name(b[key], key);
+        if (ids.has(b.id))
+            fail('DUPLICATE_BINDING', b.id, 'duplicate id');
+        ids.add(b.id);
+        if (!['seat', 'grip'].includes(b.role))
+            fail('ROLE', b.id, 'explicit seat or grip required; slot is ambiguous');
+        if (typeof b.pose === 'string')
+            transform(b.pose, b.id, b.frame);
+        else {
+            const s = resolveSurface(b.pose, b.id);
+            if (s.frame !== b.frame)
+                fail('FRAME_TYPE', b.id, 'binding frame must be the selected feature frame');
+            poses.set(b.id, s);
+        }
+        if (!Array.isArray(b.accepts) || !b.accepts.length)
+            fail('SCHEMA', b.id, 'nonempty accepts required');
+        b.accepts.forEach((x) => name(x, b.id));
+        if (new Set(b.accepts).size !== b.accepts.length)
+            fail('SCHEMA', b.id, 'duplicate accepted type');
+        if (!Number.isSafeInteger(b.capacity) || b.capacity < 1)
+            fail('CAPACITY', b.id, 'positive integer capacity required');
+        if (Object.hasOwn(b, 'region')) {
+            fields(b.region, ['kind', 'dimensions'], [], b.id + '.region');
+            if (b.region.kind !== 'centered-box')
+                fail('REGION', b.id, 'only centered-box is specified');
+            if (!Array.isArray(b.region.dimensions) || b.region.dimensions.length !== 3)
+                fail('SCHEMA', b.id, 'three dimension references required');
+            for (const ref of b.region.dimensions)
+                if (JSON.stringify(typeOf(ref, b.id)) !== '[1,0,0]')
+                    fail('TYPE', b.id, 'region dimensions must be lengths');
+        }
+        if (b.contacts !== undefined) {
+            if (!Array.isArray(b.contacts))
+                fail('SCHEMA', b.id, 'contact array required');
+            const seen = new Set(), compiled = [];
+            for (const contact of b.contacts) {
+                const surface = resolveSurface(contact, b.id);
+                const key = JSON.stringify([contact.placement, contact.feature]);
+                if (seen.has(key))
+                    fail('DUPLICATE_CONTACT', b.id, key);
+                seen.add(key);
+                compiled.push(surface);
+            }
+            surfaces.set(b.id, compiled);
+        }
+    }
+    return {
+        evaluate(input, requests = {}) {
+            fields(requests, [], [...ids], 'requests');
+            // Entire result is produced atomically; a failed graph/binding cannot return partial success.
+            const result = plan.evaluate(input);
+            const evaluateSurface = (s) => {
+                const placed = result.values[s.placement], local = result.values[s.feature], r = placed.pose.r;
+                const normal = r.map((row) => row.reduce((v, x, i) => v + x * s.normal[i], 0));
+                const t = r.map((row, j) => placed.pose.t[j] + row.reduce((v, x, i) => v + x * local.t[i], 0));
+                let geometryId = s.geometryId;
+                if (s.selection) {
+                    const q = s.selection, item = result.values[q.collection].items.find((g) => g.index === result.values[q.index] && g.key === q.member);
+                    if (!item)
+                        fail('TARGET_ABSENT', s.placement, 'selected repeated item is absent');
+                    geometryId = item.id;
+                }
+                return {
+                    placement: s.placement,
+                    feature: s.feature,
+                    geometryId,
+                    provider: s.provider,
+                    face: s.face,
+                    pose: { r: r.map((row) => [...row]), t },
+                    normal,
+                    provenance: 'verified-planar-surface'
+                };
+            };
+            const bindings = doc.bindings.map((b) => {
+                let region = null;
+                if (b.region) {
+                    const dimensions = b.region.dimensions.map((ref) => result.values[ref]);
+                    if (dimensions.some((x) => !Number.isFinite(x) || x <= 0))
+                        fail('REGION_DOMAIN', b.id, 'positive region dimensions required');
+                    region = { kind: b.region.kind, dimensions };
+                }
+                let eligibility = { status: 'unverified', reason: 'NO_REQUEST' };
+                if (Object.hasOwn(requests, b.id)) {
+                    const q = requests[b.id];
+                    fields(q, ['type', 'occupied'], [], b.id + '.request');
+                    name(q.type, b.id);
+                    if (!Number.isSafeInteger(q.occupied) || q.occupied < 0)
+                        fail('OCCUPANCY', b.id, 'nonnegative integer occupancy snapshot required');
+                    const reasons = [];
+                    if (!b.accepts.includes(q.type))
+                        reasons.push('TYPE_NOT_ACCEPTED');
+                    if (q.occupied >= b.capacity)
+                        reasons.push('CAPACITY_FULL');
+                    eligibility = { status: reasons.length ? 'failed' : 'satisfied', reasons };
+                }
+                const contacts = (surfaces.get(b.id) ?? []).map(evaluateSurface), bound = poses.has(b.id) ? evaluateSurface(poses.get(b.id)) : null;
+                return {
+                    id: b.id,
+                    label: b.label,
+                    role: b.role,
+                    frame: b.frame,
+                    pose: bound ? bound.pose : result.values[b.pose],
+                    ...(bound ? { targetGeometryId: bound.geometryId } : {}),
+                    region,
+                    contacts,
+                    checks: {
+                        declaration: { status: 'satisfied' },
+                        eligibility,
+                        spatial: { status: 'unverified', reason: 'NO_CONTACT_OR_FIT_SOLVER' },
+                        collision: { status: 'unverified', reason: 'NOT_CHECKED' },
+                        safety: { status: 'unverified', reason: 'NOT_CHECKED' }
+                    }
+                };
+            });
+            return { geometry: result.geometry, bindings };
+        }
+    };
+}
+//# sourceMappingURL=v3-capabilities.js.map

package/dist/v3-capabilities.js.map

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

package/dist/v3-contract.d.ts

@@ -0,0 +1,7 @@
+/** Shared error boundary for the experimental V3 runtime. */
+export declare class V3ContractError extends Error {
+    readonly code: string;
+    readonly path: string;
+    constructor(code: string, path: string, detail: string);
+}
+//# sourceMappingURL=v3-contract.d.ts.map

package/dist/v3-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-contract.d.ts","sourceRoot":"","sources":["../src/v3-contract.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAMvD"}

package/dist/v3-contract.js

@@ -0,0 +1,12 @@
+/** Shared error boundary for the experimental V3 runtime. */
+export class V3ContractError extends Error {
+    code;
+    path;
+    constructor(code, path, detail) {
+        super(`${code}: ${path}: ${detail}`);
+        this.name = 'V3ContractError';
+        this.code = code;
+        this.path = path;
+    }
+}
+//# sourceMappingURL=v3-contract.js.map

package/dist/v3-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-contract.js","sourceRoot":"","sources":["../src/v3-contract.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAQ;IACZ,IAAI,CAAQ;IAErB,YAAY,IAAY,EAAE,IAAY,EAAE,MAAc;QACpD,KAAK,CAAC,GAAG,IAAI,KAAK,IAAI,KAAK,MAAM,EAAE,CAAC,CAAA;QACpC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}

package/dist/v3-create.d.ts

@@ -0,0 +1,25 @@
+import type { V3Asset, V3Material } from './v3-asset-types.ts';
+/** New assets start empty. A box is created only by an explicit authoring action. */
+export declare function createV3Asset(name: string): V3Asset;
+export interface V3BoxCreation {
+    id: string;
+    size: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    rotation?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    material?: V3Material;
+}
+/** Pure authoring operation. Expands to standard graph operators, not a second runtime geometry model. */
+export declare function addV3Box(source: V3Asset, box: V3BoxCreation): V3Asset;
+//# sourceMappingURL=v3-create.d.ts.map

package/dist/v3-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v3-create.d.ts","sourceRoot":"","sources":["../src/v3-create.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAE9D,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAYnD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACzC,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,QAAQ,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C,QAAQ,CAAC,EAAE,UAAU,CAAA;CACtB;AAED,0GAA0G;AAC1G,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAgCrE"}