@hatiolab/figure-model 0.1.76 → 0.1.77

package/dist/grouping.js

@@ -1,224 +0,0 @@
-/**
- * How parts turn into draw calls. **One answer, used by compile and by the
- * policy check.**
- *
- * ## Why this file exists
- *
- * The policy counted `groupKeyOf` -- distinct colour and slot combinations --
- * while `compile` split further and the runtime split further still. Three
- * places had three answers, and the one shown to the author was the smallest.
- *
- *   conveyor   policy said 3   compile made 17   the screen drew 17
- *   cell tray  policy said 2   compile made  2   the screen drew  9
- *
- * A cell tray that draws nine times passed a limit of three with room to
- * spare. Raising the limit would not have touched that -- the number being
- * compared was the wrong one.
- *
- * ## The three splits
- *
- *   animation   a part some clip moves goes on its own, since it cannot share a
- *               merged geometry with parts that stay put
- *   sizing      a part that does not scale with the instance takes its own
- *               transform, and a merged geometry only takes one
- *   curvature   a cylinder or sphere takes its own transform too, or the one
- *               transform a merged geometry gets turns it oval
- *   repeat      one authored part, many meshes -- each copy is a draw call
- *
- * The first two make groups. The third multiplies inside a group, which is why
- * `drawCallsOf` is not simply `groupsOf().length`.
- *
- * Before any of that, a part that is not drawn at all -- a capability anchor --
- * drops out. See `isDrawn`.
- */
-import { groupKeyOf } from "./keys.js";
-import { CURVED_PRIMITIVES, DEFAULT_SIZING, REPEAT_LIMIT } from "./types.js";
-/**
- * The parts any clip moves.
- *
- * Merging is decided per part, and a clip names its parts from the outside, so
- * the two have to be brought together before grouping can answer anything.
- *
- * It takes anything with channels, not an `AnimationClip`, because a parameter's clip is the
- * same shape without the name — and what decides merging is being transformed on its own, not
- * what does the transforming (ADR-0051 decision ③).
- */
-export function animatedNames(clips) {
-    const names = new Set();
-    for (const clip of clips ?? []) {
-        for (const channel of clip.channels ?? []) {
-            if (typeof channel?.target === 'string')
-                names.add(channel.target);
-        }
-    }
-    return names;
-}
-/**
- * The parts a source moves, by a clip or by a parameter.
- *
- * compile and the release gate both need this set, and they must read it the same way: the gate
- * once read `animations` only, so a figure driven by parameters showed fewer moving parts and
- * fewer draw calls to the gate than compile produced (FORKLIFT: 13 moving parts and 18 draw calls
- * in the blueprint, 0 and 10 at the gate).
- */
-export function movingNames(source) {
-    return new Set([
-        ...animatedNames(source.animations),
-        ...animatedNames((source.parameters ?? []).map(parameter => parameter.clip ?? {}))
-    ]);
-}
-/**
- * Which joint's frame each part moves in: the nearest joint on its parent chain, the part itself included.
- *
- * A part missing from the map hangs from the figure frame. Parts in different frames cannot merge, since
- * one merged geometry takes one transform (ADR-0066 decision 4).
- *
- * The walk stops at a name it has already seen, so a cycle (which validate reports) does not loop.
- */
-export function jointFrames(source) {
-    const parentOf = new Map();
-    for (const part of source.parts)
-        if (typeof part.parent === 'string')
-            parentOf.set(part.name, part.parent);
-    const jointOfChild = new Map();
-    for (const joint of source.joints ?? [])
-        if (!jointOfChild.has(joint.child))
-            jointOfChild.set(joint.child, joint.name);
-    const frames = new Map();
-    for (const part of source.parts) {
-        const seen = new Set();
-        let at = part.name;
-        while (at !== undefined && !seen.has(at)) {
-            seen.add(at);
-            const joint = jointOfChild.get(at);
-            if (joint !== undefined) {
-                frames.set(part.name, joint);
-                break;
-            }
-            at = parentOf.get(at);
-        }
-    }
-    return frames;
-}
-/**
- * A part draws on its own when it cannot be merged with its neighbours.
- *
- * A curved part stands alone whatever its sizing. A merged geometry takes one
- * transform, and an instance scaled differently on each axis turns a cylinder
- * merged into it into an elliptical one -- declared round, drawn oval. Keeping
- * it round means keeping its own transform.
- *
- * `needsOwnMesh` in things-scene must answer the same. When the two disagree,
- * the number the report shows and the number the screen draws come apart, which
- * is the fault this whole file was written to close.
- */
-export function standsAlone(part, animated = EMPTY) {
-    if (animated.has(part.name))
-        return true;
-    if ((part.sizing ?? DEFAULT_SIZING) !== 'scale')
-        return true;
-    return keepsRound(part);
-}
-const EMPTY = new Set();
-const NO_FRAMES = new Map();
-/**
- * What a part merges by: its material and slot, within one joint frame. compile and the gate share it so
- * the groups compile builds and the draw calls the gate counts stay the same number.
- */
-export function mergeKeyOf(part, frames = NO_FRAMES) {
-    const frame = frames.get(part.name);
-    return frame === undefined ? groupKeyOf(part) : `${groupKeyOf(part)}@${frame}`;
-}
-/**
- * Does this part get drawn?
- *
- * A part carrying a `capability` spec is a **place** -- a slot something sits
- * in, a port something enters by. It has no material and no geometry, and
- * `compile` routes it to `anchors` rather than to a group.
- *
- * Every count of what drawing costs has to skip it. Left in, it does not merely
- * inflate a number: `groupKeyOf` reads a material that is not there and throws
- * on a source the format calls valid.
- */
-export function isDrawn(part) {
-    return part.capability === undefined;
-}
-/**
- * The merge groups a set of parts produces.
- *
- * Each entry is the parts that end up in one merged geometry. Parts that stand
- * alone get an entry of their own. Parts that are not drawn make no entry.
- */
-export function groupsOf(parts, animated = EMPTY, frames = NO_FRAMES) {
-    const groups = [];
-    const byKey = new Map();
-    for (const part of parts) {
-        if (!isDrawn(part))
-            continue;
-        if (standsAlone(part, animated)) {
-            groups.push([part]);
-            continue;
-        }
-        const key = mergeKeyOf(part, frames);
-        const merged = byKey.get(key);
-        if (merged) {
-            merged.push(part);
-            continue;
-        }
-        const started = [part];
-        byKey.set(key, started);
-        groups.push(started);
-    }
-    return groups;
-}
-/**
- * Does this part hold its section circular under a lopsided instance?
- *
- * Only curved primitives can, and they do unless the author turns it off. A
- * bolt head nobody looks at is worth merging; a wheel is not.
- */
-export function keepsRound(part) {
-    if (!CURVED_PRIMITIVES.includes(part.primitive))
-        return false;
-    return part.keepRound !== false;
-}
-/**
- * How many meshes one repeat part draws **as authored**.
- *
- * The count grows with the instance, since the row fills the box it is given.
- * This is the count at scale 1 -- the asset's own size, which is what the
- * author is looking at and the only number that does not depend on where it
- * ends up.
- *
- * Must match `repeatPlan` in things-scene. If they drift, the screen and the
- * report disagree about the same tray.
- */
-export function repeatCountOf(part, base) {
-    if (part.sizing !== 'repeat' || !part.repeat)
-        return 1;
-    const { axis, pitch } = part.repeat;
-    if (!(Number.isFinite(pitch) && pitch > 0))
-        return 1;
-    const room = Number.isFinite(base[axis]) && base[axis] > 0 ? base[axis] : pitch;
-    return Math.max(1, Math.min(REPEAT_LIMIT, Math.floor(room / pitch)));
-}
-/**
- * Draw calls one instance costs. **This is what the limit is about.**
- *
- * A merged group is one call. A repeat part is one call per copy.
- */
-export function drawCallsOf(parts, base, animated = EMPTY, frames = NO_FRAMES) {
-    return groupsOf(parts, animated, frames).reduce((total, group) => total + callsForGroup(group, base), 0);
-}
-/**
- * Draw calls for one merged group.
- *
- * **A merged group is one call however many parts went into it** -- that is
- * what merging is for. Only repeat multiplies, and a repeat part always stands
- * alone, so a group either holds one repeat part or is a single call.
- */
-export function callsForGroup(group, base) {
-    const only = group.length === 1 ? group[0] : undefined;
-    return only ? repeatCountOf(only, base) : 1;
-}
-//# sourceMappingURL=grouping.js.map

package/dist/grouping.js.map

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

package/dist/keys.d.ts

@@ -1,45 +0,0 @@
-/**
- * 키 — 무엇을 무엇과 나눠 쓰는지, 무엇을 무엇과 합치는지를 정하는 식.
- *
- * **이 파일이 유일한 기준이다.** 검사(`validate.ts`)와 컴파일(`blueprint.ts`)이 같은
- * 식을 써야 한다. 다르면 「묶음 수 한도를 지켰다」고 검사가 말한 것과 실제로 만들어지는
- * 묶음 수가 어긋나고, 그 어긋남은 오류 없이 성능으로만 나타난다.
- *
- * 여기 있는 이유는 순환 참조 때문이기도 하다 — `blueprint.ts` 가 `validate.ts` 를
- * 부르므로 반대 방향으로 부를 수 없다.
- */
-import type { FigurePart, PrimitiveKind } from './types.ts';
-/** 부동소수 오차로 키가 갈리지 않게 자릿수를 맞춘다. */
-export declare function q(n: number): number;
-/** 이 프리미티브가 분할 수를 쓰는가 — 곡면이 있는 것만. */
-export declare function usesSegments(primitive: PrimitiveKind): boolean;
-/**
- * GeometryBank 키.
- *
- * **치수가 키에 들어 있다.** 경로에서 오는 형상(rect·polygon)은 단위로 정규화하면
- * 모서리 반경 비율이 망가지므로 치수를 굽고, 대신 같은 치수끼리만 공유한다.
- */
-export declare function geometryKeyOf(part: FigurePart): string;
-/**
- * MaterialBank 키. 색은 토큰 이름으로 둔다 — 값을 구우면 테마를 바꿔도 안 따라온다.
- *
- * `transparent` 가 키에 들어간다. 투명 재질은 별도 정렬 경로를 타므로 불투명과 합칠 수 없다.
- */
-export declare function materialKeyOf(part: FigurePart): string;
-/**
- * 병합 단위 키 — 이 키가 같은 부품끼리 한 묶음(= draw call 하나)이 된다.
- *
- * 재질에 슬롯을 더한 것이다. 슬롯이 다르면 재질 인덱스가 달라 합칠 수 없다.
- *
- * **검사와 컴파일이 반드시 이 함수를 쓴다.** 정책이 세는 묶음 수와 실제로 만들어지는
- * 묶음 수가 같아야 「한도를 지켰다」는 말이 뜻을 갖는다.
- */
-/**
- * 켜진 재질의 창고 열쇠 — 꺼진 것 뒤에 표시 하나를 붙인다.
- *
- * 램프가 아니면 `null`. 두 재질이 창고에 생기지만 **동시에 그려지지 않으므로** 부품
- * 하나는 어느 쪽을 입든 묶음 하나다.
- */
-export declare function emissiveKeyOf(part: FigurePart): string | null;
-export declare function groupKeyOf(part: FigurePart): string;
-//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG3D,mCAAmC;AACnC,wBAAgB,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnC;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAUtD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAqBtD;AAED;;;;;;;GAOG;AACH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEnD"}

package/dist/keys.js

@@ -1,84 +0,0 @@
-/**
- * 키 — 무엇을 무엇과 나눠 쓰는지, 무엇을 무엇과 합치는지를 정하는 식.
- *
- * **이 파일이 유일한 기준이다.** 검사(`validate.ts`)와 컴파일(`blueprint.ts`)이 같은
- * 식을 써야 한다. 다르면 「묶음 수 한도를 지켰다」고 검사가 말한 것과 실제로 만들어지는
- * 묶음 수가 어긋나고, 그 어긋남은 오류 없이 성능으로만 나타난다.
- *
- * 여기 있는 이유는 순환 참조 때문이기도 하다 — `blueprint.ts` 가 `validate.ts` 를
- * 부르므로 반대 방향으로 부를 수 없다.
- */
-import { SEGMENTED_PRIMITIVES } from "./types.js";
-/** 부동소수 오차로 키가 갈리지 않게 자릿수를 맞춘다. */
-export function q(n) {
-    return Math.round(n * 1000) / 1000;
-}
-/** 이 프리미티브가 분할 수를 쓰는가 — 곡면이 있는 것만. */
-export function usesSegments(primitive) {
-    return SEGMENTED_PRIMITIVES.includes(primitive);
-}
-/**
- * GeometryBank 키.
- *
- * **치수가 키에 들어 있다.** 경로에서 오는 형상(rect·polygon)은 단위로 정규화하면
- * 모서리 반경 비율이 망가지므로 치수를 굽고, 대신 같은 치수끼리만 공유한다.
- */
-export function geometryKeyOf(part) {
-    const { size } = part.transform;
-    const dims = `${q(size.x)}x${q(size.y)}x${q(size.z)}`;
-    const seg = part.segments === undefined ? '' : `|s${part.segments}`;
-    const round = part.shape?.round ? `|r${q(part.shape.round)}` : '';
-    const pathLen = part.primitive === 'polygon' ? `|p${part.shape?.path?.length ?? 0}` : '';
-    // 두께가 형상을 정한다 — 빼면 두께만 고친 통이 옛 형상을 그대로 받는다.
-    const h = part.shape?.hollow;
-    const hollow = h ? `|h${q(h.wall)},${q(h.floor ?? h.wall)}` : '';
-    return `${part.primitive}|${dims}${seg}${round}${pathLen}${hollow}`;
-}
-/**
- * MaterialBank 키. 색은 토큰 이름으로 둔다 — 값을 구우면 테마를 바꿔도 안 따라온다.
- *
- * `transparent` 가 키에 들어간다. 투명 재질은 별도 정렬 경로를 타므로 불투명과 합칠 수 없다.
- */
-export function materialKeyOf(part) {
-    const m = part.material;
-    // 표면이 키에 들어간다. 같은 색이라도 표면이 다르면 다른 재질이다. 같은 표면끼리는
-    // 한 재질을 나눠 쓴다(이름으로 가리키는 고정 자산이라 인스턴스와 무관하다).
-    const surface = m.surface ? `s${m.surface.kind}:${m.surface.ref}` : '-';
-    /*
-      켜진 모습도 키에 들어간다.
-  
-      꺼진 모습이 같아도 켜진 모습이 다르면 **다른 부품**이다. 안 넣으면 둘이 한 묶음으로
-      합쳐지고, 그 묶음은 켜진 재질을 하나만 가질 수 있으므로 램프 하나를 켤 때 다른 램프가
-      엉뚱한 색으로 따라 켜진다.
-    */
-    const spec = m.emissive ? `e${m.emissive.token ?? '='}:${m.emissive.intensity}${m.emissive.on ? ':on' : ''}` : '-';
-    return [
-        m.token ?? '-',
-        m.preset ?? '-',
-        m.flatShading ? 'f' : '-',
-        m.transparent ? 't' : '-',
-        surface,
-        spec
-    ].join('|');
-}
-/**
- * 병합 단위 키 — 이 키가 같은 부품끼리 한 묶음(= draw call 하나)이 된다.
- *
- * 재질에 슬롯을 더한 것이다. 슬롯이 다르면 재질 인덱스가 달라 합칠 수 없다.
- *
- * **검사와 컴파일이 반드시 이 함수를 쓴다.** 정책이 세는 묶음 수와 실제로 만들어지는
- * 묶음 수가 같아야 「한도를 지켰다」는 말이 뜻을 갖는다.
- */
-/**
- * 켜진 재질의 창고 열쇠 — 꺼진 것 뒤에 표시 하나를 붙인다.
- *
- * 램프가 아니면 `null`. 두 재질이 창고에 생기지만 **동시에 그려지지 않으므로** 부품
- * 하나는 어느 쪽을 입든 묶음 하나다.
- */
-export function emissiveKeyOf(part) {
-    return part.material.emissive ? `${materialKeyOf(part)}||emissive` : null;
-}
-export function groupKeyOf(part) {
-    return `${materialKeyOf(part)}||${part.materialSlot ?? '-'}`;
-}
-//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

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

package/dist/origin.d.ts

@@ -1,33 +0,0 @@
-import type { Centred, CentredSource, FigureSource, PartTransform, Vec3 } from './types.ts';
-/**
- * Where a source's coordinates start, and the one place they become the coordinates the rules use.
- *
- * A source measures a part's `position.y` from the bottom face of the base box, and `x` and `z` from
- * its centre (ADR-0065). Moving the bottom face then leaves every part's numbers alone, which is what
- * an author editing a figure's height expects.
- *
- * Everything past the entry points works in box-centred coordinates: compile, the policy checks,
- * sizing and the release gate, exactly as the blueprint and the scene runtime always have. The rules
- * that read which face a part is nearest to depend on that — the automatic anchor is the sign of a
- * centred position. So only the functions that accept a source, or a part taken from one, call into
- * this file, and nothing below them changes.
- */
-/**
- * Rounds away the floating-point residue of shifting by half the box height.
- *
- * `0.1445 + 150 - 150` is `0.14449999999999363`, so a source moved to edition 2 and centred again would
- * not reproduce the number it started from. A millionth of a millimetre is finer than anything the
- * modeller writes (four decimals), so it removes the residue without changing an authored value.
- */
-export declare function roundShift(value: number): number;
-/** A part in box-centred coordinates. */
-export declare function centredPart<P extends {
-    transform: PartTransform;
-}>(part: P, base: Vec3): Centred<P>;
-/** A joint whose origin is in box-centred coordinates. */
-export declare function centredJoint<J extends {
-    origin: Vec3;
-}>(joint: J, base: Vec3): Centred<J>;
-/** A source whose parts and joint origins are in box-centred coordinates. Nothing else in it carries a box position. */
-export declare function centredSource(source: FigureSource): CentredSource;
-//# sourceMappingURL=origin.d.ts.map

package/dist/origin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"origin.d.ts","sourceRoot":"","sources":["../src/origin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAE3F;;;;;;;;;;;;GAYG;AAEH;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,SAAS,EAAE,aAAa,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAMnG;AAED,0DAA0D;AAC1D,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAEzF;AAED,wHAAwH;AACxH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,CAIjE"}

package/dist/origin.js

@@ -1,46 +0,0 @@
-/*
- * Copyright © HatioLab Inc. All rights reserved.
- */
-/**
- * Where a source's coordinates start, and the one place they become the coordinates the rules use.
- *
- * A source measures a part's `position.y` from the bottom face of the base box, and `x` and `z` from
- * its centre (ADR-0065). Moving the bottom face then leaves every part's numbers alone, which is what
- * an author editing a figure's height expects.
- *
- * Everything past the entry points works in box-centred coordinates: compile, the policy checks,
- * sizing and the release gate, exactly as the blueprint and the scene runtime always have. The rules
- * that read which face a part is nearest to depend on that — the automatic anchor is the sign of a
- * centred position. So only the functions that accept a source, or a part taken from one, call into
- * this file, and nothing below them changes.
- */
-/**
- * Rounds away the floating-point residue of shifting by half the box height.
- *
- * `0.1445 + 150 - 150` is `0.14449999999999363`, so a source moved to edition 2 and centred again would
- * not reproduce the number it started from. A millionth of a millimetre is finer than anything the
- * modeller writes (four decimals), so it removes the residue without changing an authored value.
- */
-export function roundShift(value) {
-    return Math.round(value * 1e6) / 1e6;
-}
-/** A part in box-centred coordinates. */
-export function centredPart(part, base) {
-    const { position } = part.transform;
-    return {
-        ...part,
-        transform: { ...part.transform, position: { ...position, y: roundShift(position.y - base.y / 2) } }
-    };
-}
-/** A joint whose origin is in box-centred coordinates. */
-export function centredJoint(joint, base) {
-    return { ...joint, origin: { ...joint.origin, y: roundShift(joint.origin.y - base.y / 2) } };
-}
-/** A source whose parts and joint origins are in box-centred coordinates. Nothing else in it carries a box position. */
-export function centredSource(source) {
-    const centred = { ...source, parts: source.parts.map(part => centredPart(part, source.base)) };
-    if (source.joints !== undefined)
-        centred.joints = source.joints.map(joint => centredJoint(joint, source.base));
-    return centred;
-}
-//# sourceMappingURL=origin.js.map

package/dist/origin.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"origin.js","sourceRoot":"","sources":["../src/origin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;GAYG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAA;AACtC,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,WAAW,CAAyC,IAAO,EAAE,IAAU;IACrF,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAA;IACnC,OAAO;QACL,GAAG,IAAI;QACP,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE;KACtF,CAAA;AACjB,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,YAAY,CAA6B,KAAQ,EAAE,IAAU;IAC3E,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAgB,CAAA;AAC5G,CAAC;AAED,wHAAwH;AACxH,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,MAAM,OAAO,GAAG,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAA;IAC9F,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IAC9G,OAAO,OAAwB,CAAA;AACjC,CAAC"}

package/dist/release-contract.d.ts

@@ -1,38 +0,0 @@
-import type { FigureSource } from './types.ts';
-/** 무엇이 달라졌나. 소비처의 식별자·의미를 없애는 일만 막고, 외형 변화는 알린다. */
-export type ContractChangeCode = 
-/** 기준 상자의 x:z 비율이 달라졌다 — 이미 놓인 인스턴스의 외형이 달라질 수 있다. */
-'base-ratio-changed'
-/** 배치 기준(floor · ceiling · center)이 달라졌다. */
- | 'placement-changed'
-/** 자리·문·파라미터·능력이 사라졌거나 뜻이 바뀌었다. */
- | 'interface-gone'
-/** 배율 1 에서 센 칸 수가 달라졌다. */
- | 'slot-count-changed'
-/** 기준 상자의 절대 크기가 달라졌다 — 비율은 그대로다. */
- | 'base-size-changed'
-/** 자리·문·파라미터·능력이 새로 생겼다. */
- | 'interface-added'
-/** 자리가 받아 주는 타입이 좁아졌다 — 이미 든 것은 그대로다. */
- | 'accepts-narrowed';
-export interface ContractChange {
-    code: ContractChangeCode;
-    /** 참이면 발행을 막는다. */
-    blocking: boolean;
-    /** 무엇의 이야기인가 — 자리·문·파라미터·능력의 이름. 도형 전체의 일이면 없다. */
-    subject?: string;
-    /** 무엇이 달라졌나. 잰 값으로. */
-    message: string;
-    /** **왜 그것이 문제인가.** 달라진 것만 말하면 읽는 사람은 「그래서?」에서 멈춘다. */
-    why: string;
-}
-/**
- * 직전 발행판과 견준다. **둘 다 컴파일되는 정본이어야 한다** — 부르는 쪽이 새 정본을 먼저
- * 검사하고, 앞의 것은 발행될 때 이미 통과한 것이다.
- *
- * 낸 목록이 비어 있으면 이 발행은 놓인 것을 건드리지 않는다.
- */
-export declare function contractChanges(before: FigureSource, after: FigureSource): ContractChange[];
-/** 이 발행이 놓인 것을 깨나. `contractChanges` 를 부르는 쪽의 편의. */
-export declare function breaksContract(changes: readonly ContractChange[]): boolean;
-//# sourceMappingURL=release-contract.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"release-contract.d.ts","sourceRoot":"","sources":["../src/release-contract.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAmB,YAAY,EAAQ,MAAM,YAAY,CAAA;AAsCrE,oDAAoD;AACpD,MAAM,MAAM,kBAAkB;AAC5B,sDAAsD;AACpD,oBAAoB;AACtB,6CAA6C;GAC3C,mBAAmB;AACrB,mCAAmC;GACjC,gBAAgB;AAClB,2BAA2B;GACzB,oBAAoB;AACtB,qCAAqC;GACnC,mBAAmB;AACrB,4BAA4B;GAC1B,iBAAiB;AACnB,yCAAyC;GACvC,kBAAkB,CAAA;AAEtB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAA;IACxB,mBAAmB;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAA;CACZ;AA4ED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,cAAc,EAAE,CA+K3F;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAE1E"}