@hatiolab/figure-model 0.6.4 → 0.6.6

package/dist/contract.d.ts

@@ -4,6 +4,8 @@ import type { FigureFaceMappingNeed } from './shape-edit.ts';
 import type { Axis } from './words.ts';
 import type { LayoutIssue } from './slot-layout.ts';
 import type { FigureClipLoss } from './clip-keeping.ts';
+import type { FigureDataBehavior } from './asset-types.ts';
+import type { FigureDataValueIssue } from './data-interface.ts';
 /**
  * The values a refusal was said from, for a screen to say it in its own words (ADR-0127). The shape is set by the code
  * and the `reason`; the English sentence is said from the same values and stays for logs, tests and readers of the
@@ -167,6 +169,101 @@ export type FigureRefusalDetails = {
  | {
     reason: 'clips-dropped';
     clips: FigureClipLoss[];
+} | {
+    reason: 'data-id-invalid';
+    list: 'bindings' | 'ports' | 'motion-groups';
+    id: string;
+} | {
+    reason: 'data-id-duplicate';
+    list: 'bindings' | 'ports' | 'motion-groups';
+    id: string;
+}
+/** A schema field that does not hold: its place in the schema and what of it. */
+ | {
+    reason: 'data-field-invalid';
+    field: string;
+    what: string;
+} | {
+    reason: 'data-field-duplicate';
+    field: string;
+    name: string;
+}
+/** An accessor that does not go down the schema to what its behavior reads. */
+ | {
+    reason: 'data-accessor-invalid';
+    binding: string;
+    accessor: string;
+    why: 'syntax' | 'absent' | 'not-a-list' | 'not-a-value' | 'list-needs-index' | 'item-id-required';
+} | {
+    reason: 'data-behavior-absent';
+    binding: string;
+    behavior: FigureDataBehavior['kind'];
+    id: string;
+} | {
+    reason: 'data-behavior-duplicate';
+    bindings: [string, string];
+    behavior: FigureDataBehavior['kind'];
+    id: string;
+}
+/** What a rule cannot carry over the whole of a value's domain; the numbers it found, when a range. */
+ | {
+    reason: 'data-rule-domain';
+    binding: string;
+    why: 'kind' | 'unit' | 'range' | 'cases' | 'output' | 'default';
+    from?: string;
+    to?: string;
+    min?: number;
+    max?: number;
+    within?: [number, number];
+    value?: unknown;
+} | {
+    reason: 'data-port-invalid';
+    port: string;
+    what: 'label' | 'token' | 'part' | 'group';
+    id?: string;
+}
+/** A status port still read by a binding, named when an edit would take it away. */
+ | {
+    reason: 'data-port-bound';
+    port: string;
+    bindings: string[];
+} | {
+    reason: 'motion-clip-absent';
+    group: string;
+    clip: string;
+} | {
+    reason: 'motion-clip-shared';
+    clip: string;
+    groups: [string, string];
+} | {
+    reason: 'driver-writers';
+    state: string;
+    clips: string[];
+} | {
+    reason: 'driver-clip-required';
+    state: string;
+    clips: string[];
+} | {
+    reason: 'motion-setting';
+    why: 'group-unknown' | 'clip-not-in-group' | 'speed-out-of-range' | 'group-selection-required';
+    group: string;
+    clip?: string;
+    speed?: number;
+} | {
+    reason: 'item-snapshot-shape';
+} | {
+    reason: 'item-duplicate';
+    item: string;
+} | {
+    reason: 'item-stack-index';
+    slot: string;
+    heights: number[];
+} | {
+    reason: 'item-invalid-dimensions';
+    item: string;
+} | {
+    reason: 'data-values-refused';
+    issues: FigureDataValueIssue[];
 };
 /** Shared error boundary for the experimental runtime. */
 export declare class FigureContractError extends Error {

package/dist/contract.d.ts.map

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

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAyEA,0DAA0D;AAC1D,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,CAAQ;IACZ,IAAI,CAAQ;IACrB,uFAAuF;IAC9E,OAAO,CAAuB;IAEvC,YAAY,IAAY,EAAE,IAAY,EAAE,MAAc,EAAE,OAA8B;QACpF,KAAK,CAAC,GAAG,IAAI,KAAK,IAAI,KAAK,MAAM,EAAE,CAAC,CAAA;QACpC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACnD,CAAC;CACF"}
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAoHA,0DAA0D;AAC1D,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,CAAQ;IACZ,IAAI,CAAQ;IACrB,uFAAuF;IAC9E,OAAO,CAAuB;IAEvC,YAAY,IAAY,EAAE,IAAY,EAAE,MAAc,EAAE,OAA8B;QACpF,KAAK,CAAC,GAAG,IAAI,KAAK,IAAI,KAAK,MAAM,EAAE,CAAC,CAAA;QACpC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACnD,CAAC;CACF"}

package/dist/data-interface.d.ts

@@ -0,0 +1,81 @@
+import type { FigureAsset, FigureDataBinding, FigureDataField, FigureDataInterface, FigureDataNode, FigureStatusPort } from './asset-types.ts';
+/** The fastest a motion group plays: three times its authored speed. 0 stops it. */
+export declare const FIGURE_MOTION_SPEED_MAX = 3;
+/** One step of an accessor: a field of an object, or an element of a list by its index. */
+export type FigureAccessorStep = {
+    field: string;
+} | {
+    index: number;
+};
+/**
+ * An accessor read as steps, or null when it is not one this contract takes: field names joined by `.`, each followed
+ * by at most one `[n]`. The board's accessor (JSONata) reads these the same way; nothing richer is taken, because a
+ * richer expression cannot be followed down the schema.
+ */
+export declare function parseFigureAccessor(accessor: string): FigureAccessorStep[] | null;
+/** An accessor written back from its steps. */
+export declare const figureAccessorOf: (steps: readonly FigureAccessorStep[]) => string;
+/**
+ * Refuses a data interface the contract does not allow (`DATA_INTERFACE`, or `ASSET_SCHEMA` for its shape). Called by
+ * `compileFigureAsset`, after the drivers and motion groups, whose clips a binding may name.
+ */
+export declare function validateFigureDataInterface(asset: FigureAsset): void;
+/**
+ * A place of the data that cannot be taken, and why -- the shape of the issues a consumer reports when it refuses data
+ * (`DATA_VALUE`). The reading and the check are the consumer's (things-scene's figure input, with the board's accessor
+ * and evaluator); this module never walks data.
+ */
+export interface FigureDataValueIssue {
+    reason: 'not-a-record' | 'not-a-list' | 'type-mismatch' | 'out-of-range' | 'value-unknown' | 'json-unreadable' | 'item-id-missing';
+    path: string;
+    value?: unknown;
+}
+/** One binding made ready: what the schema has at its accessor (the node its value is checked against). */
+export interface FigureDataReadyBinding {
+    readonly binding: FigureDataBinding;
+    readonly node: FigureDataNode;
+    /** For an items binding from a list: what the schema has at each element field, by the field's role. */
+    readonly itemNodes?: Readonly<Partial<Record<'id' | 'type' | 'place' | 'stack' | 'status', FigureDataNode>>>;
+}
+/** A figure's data interface checked against its asset. Made once per asset, not per frame. */
+export interface FigureDataPlan {
+    readonly schema: readonly FigureDataField[];
+    readonly ports: readonly FigureStatusPort[];
+    readonly bindings: readonly FigureDataReadyBinding[];
+    /** The accessors of the fields that may come as JSON text, as the board's accessor writes them (`[]` for a list's elements). */
+    readonly jsonFields: readonly string[];
+}
+/** The data interface of an asset, checked, with what the schema has at each binding; null when the figure declares none. */
+export declare function compileFigureDataInterface(asset: FigureAsset): FigureDataPlan | null;
+/** One line of the schema as a person reads it: where, what, and what reads it. */
+export interface FigureDataRow {
+    /** The data's path, `[]` for every element of a list. */
+    path: string;
+    depth: number;
+    name: string;
+    label?: string;
+    node: FigureDataNode;
+    json: boolean;
+    /** The bindings that read this place, by id. */
+    bindings: string[];
+}
+/** The schema as lines, parents before their fields, with the bindings that read each place. */
+export declare function figureDataRows(di: FigureDataInterface): FigureDataRow[];
+/** Data with every field of the schema, each at its default or a value it takes: what a person copies and changes. */
+export declare function figureDataExample(di: FigureDataInterface): Record<string, unknown>;
+/**
+ * A schema guessed from one piece of a site's data: each field's kind as it came, a JSON text read as what it holds.
+ * Units, ranges and fixed values are not guessed -- a person says them. A field name the accessor cannot read bare is
+ * left out.
+ */
+export declare function inferFigureDataSchema(sample: unknown): FigureDataField[];
+/** The interface after a part was renamed: a state input the part owned (`<part>.…`) and a status port's part follow it. */
+export declare function renameDataInterface(asset: FigureAsset, from: string, to: string): void;
+/** The interface after a clip was renamed: every map that selects it in a motion group selects it by its new name. */
+export declare function renameDataInterfaceClip(asset: FigureAsset, group: string, from: string, to: string): void;
+/**
+ * The interface after a field was renamed: the field, and every accessor that goes through it, including an items
+ * binding's element fields. `accessor` names the field by its field names (no list indices); `to` is its new name.
+ */
+export declare function renameDataField(di: FigureDataInterface, accessor: string, to: string): FigureDataInterface;
+//# sourceMappingURL=data-interface.d.ts.map

package/dist/data-interface.d.ts.map

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