@field/cascade 0.2.22

package/dist/contracts/capabilities.d.ts

@@ -0,0 +1,109 @@
+import type { AssetRef, ImageRef, JsonValue, TextureHandle } from "./values.js";
+export interface CascadeAbortSignal {
+    readonly aborted: boolean;
+    readonly reason?: unknown;
+    addEventListener(type: "abort", listener: () => void, options?: {
+        once?: boolean;
+    }): void;
+    removeEventListener(type: "abort", listener: () => void): void;
+}
+export interface ResourceLease<T> {
+    readonly value: T;
+    release(): void | Promise<void>;
+}
+export interface ProgressReporter {
+    report(event: {
+        progress?: number;
+        message?: string;
+        detail?: JsonValue;
+    }): void;
+}
+export interface FileCapability {
+    read(path: string, options: {
+        signal: CascadeAbortSignal;
+    }): Promise<Uint8Array>;
+    write(path: string, data: Uint8Array, options: {
+        signal: CascadeAbortSignal;
+    }): Promise<void>;
+    list(path: string, options: {
+        signal: CascadeAbortSignal;
+    }): Promise<readonly string[]>;
+    stat(path: string, options: {
+        signal: CascadeAbortSignal;
+    }): Promise<{
+        size: number;
+        modifiedAt?: number;
+    } | null>;
+}
+export interface AssetCapability {
+    read(ref: AssetRef, options: {
+        signal: CascadeAbortSignal;
+    }): Promise<Uint8Array>;
+    write(data: Uint8Array, metadata: {
+        mediaType?: string;
+        suggestedName?: string;
+    }, options: {
+        signal: CascadeAbortSignal;
+    }): Promise<AssetRef>;
+    resolveUrl?(ref: AssetRef | ImageRef): Promise<ResourceLease<string>>;
+}
+export interface MediaCapability {
+    decodeImage(ref: ImageRef | AssetRef, options: {
+        signal: CascadeAbortSignal;
+    }): Promise<ResourceLease<unknown>>;
+    encodeImage(value: unknown, encoding: JsonValue, options: {
+        signal: CascadeAbortSignal;
+        progress: ProgressReporter;
+    }): Promise<ImageRef | AssetRef>;
+}
+export interface PythonCapability {
+    invoke(request: {
+        operation: string;
+        input: JsonValue;
+        assets?: readonly AssetRef[];
+    }, options: {
+        signal: CascadeAbortSignal;
+        progress: ProgressReporter;
+    }): Promise<JsonValue | AssetRef | ImageRef>;
+}
+export interface WebGLCapability {
+    createTexture(descriptor: JsonValue, options: {
+        signal: CascadeAbortSignal;
+    }): Promise<ResourceLease<TextureHandle>>;
+}
+export interface ShellRunResult {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly code: number | null;
+    readonly timedOut: boolean;
+    readonly cancelled: boolean;
+    readonly outputLimited: boolean;
+}
+export type ShellProcessErrorKind = "nonzero" | "invalid-json" | "spawn" | "timeout" | "cancelled" | "output-limit";
+export declare class ShellProcessError extends Error {
+    readonly kind: ShellProcessErrorKind;
+    readonly result: ShellRunResult;
+    readonly name = "ShellProcessError";
+    constructor(kind: ShellProcessErrorKind, result: ShellRunResult, message?: string);
+}
+export interface ShellRunOptions {
+    readonly cwd?: string;
+    readonly timeout?: number;
+    readonly stdin?: string;
+    readonly env?: Readonly<Record<string, string>>;
+    readonly signal?: CascadeAbortSignal;
+}
+export interface ShellCapability {
+    run(command: string, args?: readonly string[], options?: ShellRunOptions): Promise<ShellRunResult>;
+    runJson<T = unknown>(command: string, args?: readonly string[], options?: ShellRunOptions): Promise<T>;
+}
+export interface CapabilityMap {
+    readonly files: FileCapability;
+    readonly assets: AssetCapability;
+    readonly media: MediaCapability;
+    readonly python: PythonCapability;
+    readonly webgl: WebGLCapability;
+    readonly shell: ShellCapability;
+}
+export type NodeCapabilityName = keyof CapabilityMap;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/contracts/capabilities.d.ts.map

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

package/dist/contracts/capabilities.js

@@ -0,0 +1,11 @@
+export class ShellProcessError extends Error {
+    kind;
+    result;
+    name = "ShellProcessError";
+    constructor(kind, result, message = `Shell process failed: ${kind}`) {
+        super(message);
+        this.kind = kind;
+        this.result = result;
+    }
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/contracts/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAgGA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAG/B;IACA;IAHF,IAAI,GAAG,mBAAmB,CAAC;IACpC,YACW,IAA2B,EAC3B,MAAsB,EAC/B,OAAO,GAAG,yBAAyB,IAAI,EAAE;QAEzC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAuB;QAC3B,WAAM,GAAN,MAAM,CAAgB;IAIjC,CAAC;CACF"}

package/dist/contracts/color.d.ts

@@ -0,0 +1,67 @@
+import type { Vec4 } from "./values.js";
+/**
+ * Colour is a four-component vector, always. Marcus ruled on that 2026-09-04:
+ * *"colour should only be a 4 component vector; when a hex/string value is
+ * needed we should use conversions with a .toHex and .toString methods."*
+ *
+ * So `Cd` is `vec4`, a `color` prop is `vec4`, and there is no second
+ * representation anywhere in the system. Hex and CSS are *spellings* produced at
+ * the edge by the code that has to emit text, which today is the SVG writer and
+ * tomorrow is a canvas host or a project reading a palette out of JSON.
+ *
+ * ## Why a namespace object rather than methods on a colour
+ *
+ * `.toHex()` on a colour would need a colour to be an object, and a colour is a
+ * `Vec4` — a plain readonly array of four numbers. That is not an accident of
+ * this file: it is what makes a colour a value the graph can carry, serialize as
+ * `[1, 0.5, 0, 1]`, store in a `vec4` port, and share with an attribute's flat
+ * `Float64Array` without a conversion. Giving it methods means giving it a
+ * prototype, and then a colour that survives a round trip through JSON is no
+ * longer a colour. So the operations live beside the type instead of on it, the
+ * way `Math` and `JSON` do, and `Color` is both the type and the namespace, the
+ * way `Array` is.
+ *
+ * Components are unit-range `[0, 1]` for red, green, blue and alpha, in that
+ * order. Everything here clamps rather than throwing on an out-of-range
+ * component, because a colour arriving slightly outside the range is arithmetic
+ * rather than an authoring error; a malformed hex *string* is an authoring error
+ * and `fromHex` says so.
+ */
+export type Color = Vec4;
+export declare const Color: Readonly<{
+    /**
+     * `#rgb`, `#rgba`, `#rrggbb` or `#rrggbbaa` to a colour. Alpha defaults to 1
+     * when the string carries none. The three- and four-digit shorthands are
+     * accepted because CSS accepts them and hand-written palettes use them;
+     * anything else throws, since a colour that silently parses to black is the
+     * failure this whole ruling exists to remove.
+     */
+    fromHex(value: string): Color;
+    /** Whether `fromHex` would accept this string. */
+    isHex(value: unknown): value is string;
+    /**
+     * `#rrggbb`, or `#rrggbbaa` with `includeAlpha`. The default drops alpha
+     * because eight-digit hex is CSS Color 4 and plotter and vector-editor
+     * software of the kind this library exists to feed does not read it. Callers
+     * that need the alpha to survive emit it as a separate opacity, which is what
+     * the SVG writer does.
+     */
+    toHex(color: Color, includeAlpha?: boolean): string;
+    /**
+     * A CSS colour: `rgb(255, 128, 0)`, or `rgba(255, 128, 0, 0.5)` when alpha is
+     * below 1. The legacy comma forms rather than the modern space-separated
+     * ones, for the same compatibility reason `toHex` drops alpha by default.
+     */
+    toString(color: Color): string;
+    /** Alpha on its own, for a renderer that carries opacity separately. */
+    alpha(color: Color): number;
+    /** The same colour at full alpha. */
+    opaque(color: Color): Color;
+    /**
+     * Four unit components from anything indexable, clamping and defaulting a
+     * missing alpha to 1. The reader for a `Cd` attribute's flat array, and the
+     * one place that decides what an under-sized colour means.
+     */
+    fromComponents(components: ArrayLike<number>, offset?: number, size?: number): Color;
+}>;
+//# sourceMappingURL=color.d.ts.map

package/dist/contracts/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,KAAK,GAAG,IAAI,CAAC;AA6BzB,eAAO,MAAM,KAAK;IAChB;;;;;;OAMG;mBACY,MAAM,GAAG,KAAK;IAc7B,kDAAkD;iBACrC,OAAO,GAAG,KAAK,IAAI,MAAM;IAItC;;;;;;OAMG;iBACU,KAAK,2BAAyB,MAAM;IAMjD;;;;OAIG;oBACa,KAAK,GAAG,MAAM;IAO9B,wEAAwE;iBAC3D,KAAK,GAAG,MAAM;IAI3B,qCAAqC;kBACvB,KAAK,GAAG,KAAK;IAI3B;;;;OAIG;+BAEW,SAAS,CAAC,MAAM,CAAC,mCAG5B,KAAK;EAKR,CAAC"}

package/dist/contracts/color.js

@@ -0,0 +1,83 @@
+const HEX = /^#(?:[0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+function clamp(value) {
+    return !Number.isFinite(value) ? 0 : value < 0 ? 0 : value > 1 ? 1 : value;
+}
+function byte(value) {
+    return Math.round(clamp(value) * 255);
+}
+function pair(value) {
+    return byte(value).toString(16).padStart(2, "0");
+}
+/** `0.5` rather than `0.50000000000000001`, and `1` rather than `1.000`. */
+function unit(value) {
+    return String(Number(clamp(value).toFixed(4)));
+}
+function expand(digits) {
+    const wide = digits.length <= 4
+        ? [...digits].map((digit) => `${digit}${digit}`)
+        : (digits.match(/../g) ?? []);
+    return wide.map((component) => Number.parseInt(component, 16) / 255);
+}
+export const Color = Object.freeze({
+    /**
+     * `#rgb`, `#rgba`, `#rrggbb` or `#rrggbbaa` to a colour. Alpha defaults to 1
+     * when the string carries none. The three- and four-digit shorthands are
+     * accepted because CSS accepts them and hand-written palettes use them;
+     * anything else throws, since a colour that silently parses to black is the
+     * failure this whole ruling exists to remove.
+     */
+    fromHex(value) {
+        if (!HEX.test(value))
+            throw new TypeError(`color/invalid-hex: ${value} is not #rgb, #rgba, #rrggbb or #rrggbbaa`);
+        const components = expand(value.slice(1));
+        return [
+            components[0],
+            components[1],
+            components[2],
+            components[3] ?? 1,
+        ];
+    },
+    /** Whether `fromHex` would accept this string. */
+    isHex(value) {
+        return typeof value === "string" && HEX.test(value);
+    },
+    /**
+     * `#rrggbb`, or `#rrggbbaa` with `includeAlpha`. The default drops alpha
+     * because eight-digit hex is CSS Color 4 and plotter and vector-editor
+     * software of the kind this library exists to feed does not read it. Callers
+     * that need the alpha to survive emit it as a separate opacity, which is what
+     * the SVG writer does.
+     */
+    toHex(color, includeAlpha = false) {
+        return `#${pair(color[0])}${pair(color[1])}${pair(color[2])}${includeAlpha ? pair(color[3]) : ""}`;
+    },
+    /**
+     * A CSS colour: `rgb(255, 128, 0)`, or `rgba(255, 128, 0, 0.5)` when alpha is
+     * below 1. The legacy comma forms rather than the modern space-separated
+     * ones, for the same compatibility reason `toHex` drops alpha by default.
+     */
+    toString(color) {
+        const channels = `${byte(color[0])}, ${byte(color[1])}, ${byte(color[2])}`;
+        return clamp(color[3]) >= 1
+            ? `rgb(${channels})`
+            : `rgba(${channels}, ${unit(color[3])})`;
+    },
+    /** Alpha on its own, for a renderer that carries opacity separately. */
+    alpha(color) {
+        return clamp(color[3]);
+    },
+    /** The same colour at full alpha. */
+    opaque(color) {
+        return [clamp(color[0]), clamp(color[1]), clamp(color[2]), 1];
+    },
+    /**
+     * Four unit components from anything indexable, clamping and defaulting a
+     * missing alpha to 1. The reader for a `Cd` attribute's flat array, and the
+     * one place that decides what an under-sized colour means.
+     */
+    fromComponents(components, offset = 0, size = 4) {
+        const at = (component) => component < size ? clamp(components[offset + component] ?? 0) : 0;
+        return [at(0), at(1), at(2), size < 4 ? 1 : at(3)];
+    },
+});
+//# sourceMappingURL=color.js.map

package/dist/contracts/color.js.map

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

package/dist/contracts/definition.d.ts

@@ -0,0 +1,118 @@
+import type { CapabilityMap, CascadeAbortSignal, NodeCapabilityName, ProgressReporter } from "./capabilities.js";
+import type { CascadeType, CoreType, JsonValue, NamespacedType, SerializableValueForType, ValueForType } from "./values.js";
+export type RuntimeEnvironment = "portable" | "browser" | "server";
+export type CapabilityForEnvironment<E extends RuntimeEnvironment> = E extends "portable" ? "assets" | "media" : E extends "browser" ? "assets" | "media" | "webgl" : "files" | "assets" | "media" | "python" | "shell";
+export type DataTypeForEnvironment<E extends RuntimeEnvironment> = E extends "browser" ? CascadeType : Exclude<CascadeType, "texture">;
+type ControlFor<T extends CascadeType> = T extends "float" ? "number" | "slider" | "range" : T extends "int" ? "int" | "slider" | "range" : T extends "bool" ? "boolean" : T extends "string" ? "text" | "textarea" | "select" : T extends "vec2" | "vec3" | "vec4" | "vec2i" | "vec3i" | "vec4i" ? "vector" : T extends "mat2" | "mat3" | "mat4" ? "matrix" : T extends "color" ? "color" : T extends "image" ? "image" : T extends "asset" ? "asset" | "select" : T extends "texture" ? never : "select";
+type NumericMetadata<T extends CascadeType> = T extends "float" | "int" ? {
+    readonly min?: number;
+    readonly max?: number;
+    readonly step?: number;
+} : {
+    readonly min?: never;
+    readonly max?: never;
+    readonly step?: never;
+};
+type AcceptMetadata<T extends CascadeType> = T extends "image" | "asset" ? {
+    readonly accept?: readonly string[];
+} : {
+    readonly accept?: never;
+};
+type SelectMetadata<T extends CascadeType> = {
+    readonly control?: Exclude<ControlFor<T>, "select">;
+    readonly options?: never;
+} | {
+    readonly control: Extract<ControlFor<T>, "select">;
+    readonly options?: readonly SerializableValueForType<T>[];
+};
+export interface TriggerInputDefinition {
+    readonly kind: "trigger";
+    readonly description?: string;
+}
+export type DataInputDefinition<T extends CascadeType> = {
+    readonly kind: "data";
+    readonly type: T;
+    readonly default?: SerializableValueForType<T>;
+    readonly description?: string;
+    readonly variadic?: boolean;
+} & NumericMetadata<T> & AcceptMetadata<T> & SelectMetadata<T>;
+export type InputDefinitionFor<E extends RuntimeEnvironment> = TriggerInputDefinition | {
+    [T in DataTypeForEnvironment<E>]: DataInputDefinition<T>;
+}[DataTypeForEnvironment<E>];
+export interface TriggerOutputDefinition {
+    readonly kind: "trigger";
+    readonly description?: string;
+}
+export interface DataOutputDefinition<T extends CascadeType> {
+    readonly kind: "data";
+    readonly type: T;
+    readonly description?: string;
+}
+export type OutputDefinitionFor<E extends RuntimeEnvironment> = TriggerOutputDefinition | {
+    [T in DataTypeForEnvironment<E>]: DataOutputDefinition<T>;
+}[DataTypeForEnvironment<E>];
+export type PropDataType = Exclude<CoreType, "texture"> | NamespacedType;
+export type PropDefinition<T extends PropDataType> = {
+    readonly type: T;
+    readonly default: SerializableValueForType<T>;
+    readonly label?: string;
+    readonly description?: string;
+} & NumericMetadata<T> & AcceptMetadata<T> & SelectMetadata<T>;
+export type AnyPropDefinition = {
+    [T in PropDataType]: PropDefinition<T>;
+}[PropDataType];
+export interface NodeDefinitionForEnvironment<E extends RuntimeEnvironment> {
+    readonly apiVersion: 1;
+    readonly runsOn: E;
+    /** Declares that authored nodes may use this node as their parent. */
+    readonly container?: "subnet";
+    readonly capabilities?: readonly CapabilityForEnvironment<E>[];
+    readonly label?: string;
+    readonly description?: string;
+    readonly icon?: string;
+    readonly inputs?: Readonly<Record<string, InputDefinitionFor<E>>>;
+    readonly outputs?: Readonly<Record<string, OutputDefinitionFor<E>>>;
+    readonly props?: Readonly<Record<string, AnyPropDefinition>>;
+}
+export type NodeDefinition = {
+    [E in RuntimeEnvironment]: NodeDefinitionForEnvironment<E>;
+}[RuntimeEnvironment];
+export interface TriggerEvent {
+    readonly id: `${string}:${number}`;
+    readonly runId: string;
+    readonly sequence: number;
+    readonly payload?: JsonValue;
+    readonly source: {
+        readonly kind: "external";
+    } | Readonly<{
+        nodeId: string;
+        outputName: string;
+    }>;
+}
+type Entries<D, K extends "inputs" | "outputs" | "props"> = D extends Record<K, infer R> ? R : Record<never, never>;
+type InputValue<I> = I extends TriggerInputDefinition ? TriggerEvent | undefined : I extends DataInputDefinition<infer T> ? I extends {
+    readonly variadic: true;
+} ? readonly ValueForType<T>[] : "default" extends keyof I ? ValueForType<T> : ValueForType<T> | undefined : never;
+type OutputValue<O> = O extends TriggerOutputDefinition ? {
+    trigger(payload?: JsonValue): void;
+} : O extends DataOutputDefinition<infer T> ? {
+    set(value: ValueForType<T>): void;
+} : never;
+export type DeclaredCapabilities<D extends NodeDefinition> = Readonly<Pick<CapabilityMap, D["capabilities"] extends readonly NodeCapabilityName[] ? D["capabilities"][number] : never>>;
+export interface NodeExecutionContext<D extends NodeDefinition> {
+    readonly inputs: Readonly<{
+        [K in keyof Entries<D, "inputs">]: InputValue<Entries<D, "inputs">[K]>;
+    }>;
+    readonly outputs: Readonly<{
+        [K in keyof Entries<D, "outputs">]: OutputValue<Entries<D, "outputs">[K]>;
+    }>;
+    readonly props: Readonly<{
+        [K in keyof Entries<D, "props">]: Entries<D, "props">[K] extends PropDefinition<infer T> ? ValueForType<T> : never;
+    }>;
+    readonly capabilities: DeclaredCapabilities<D>;
+    readonly signal: CascadeAbortSignal;
+    readonly progress: ProgressReporter;
+}
+export type NodeExecute<D extends NodeDefinition = NodeDefinition> = (context: NodeExecutionContext<D>) => void | Promise<void>;
+export {};
+//# sourceMappingURL=definition.d.ts.map

package/dist/contracts/definition.d.ts.map

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

package/dist/contracts/definition.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=definition.js.map

package/dist/contracts/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":""}

package/dist/contracts/document.d.ts

@@ -0,0 +1,50 @@
+import type { SerializableValue } from "./values.js";
+export interface CascadeDocumentNode {
+    readonly id: string;
+    readonly module?: string;
+    readonly type?: string;
+    readonly parent?: string;
+    readonly inputs?: readonly Readonly<{
+        name: string;
+        defaultValue?: unknown;
+        value?: unknown;
+    }>[] | Readonly<Record<string, unknown>>;
+    readonly props?: Readonly<Record<string, unknown>>;
+}
+export interface CascadeDocumentAnnotation {
+    readonly id: string;
+    readonly type: string;
+    readonly parent?: string;
+    readonly position?: readonly [number, number] | Readonly<{
+        x: number;
+        y: number;
+    }>;
+    readonly content?: string;
+    readonly src?: string;
+    readonly [key: string]: unknown;
+}
+export type CascadeConnectionEndpoint = readonly [string, number, string?];
+export type CascadeDocumentConnection = readonly [CascadeConnectionEndpoint, CascadeConnectionEndpoint] | Readonly<{
+    source: Readonly<{
+        nodeId: string;
+        outputName: string;
+    }>;
+    target: Readonly<{
+        nodeId: string;
+        inputName: string;
+    }>;
+}>;
+export interface CascadeDocument {
+    readonly version?: string;
+    readonly nodes: readonly CascadeDocumentNode[];
+    readonly annotations?: readonly CascadeDocumentAnnotation[];
+    readonly connections?: readonly CascadeDocumentConnection[];
+}
+export interface CascadePreset {
+    readonly version: 1;
+    readonly nodes: Readonly<Record<string, Readonly<{
+        inputs?: Readonly<Record<string, SerializableValue>>;
+        props?: Readonly<Record<string, SerializableValue>>;
+    }>>>;
+}
+//# sourceMappingURL=document.d.ts.map

package/dist/contracts/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,QAAQ,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrI,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,yBAAyB,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC3E,MAAM,MAAM,yBAAyB,GACjC,SAAS,CAAC,yBAAyB,EAAE,yBAAyB,CAAC,GAC/D,QAAQ,CAAC;IACP,MAAM,EAAE,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,MAAM,EAAE,QAAQ,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD,CAAC,CAAC;AAEP,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC7D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;QAC/C,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACrD,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;KACrD,CAAC,CAAC,CAAC,CAAC;CACN"}

package/dist/contracts/document.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=document.js.map

package/dist/contracts/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":""}