lineadraw 0.9.0 → 0.10.0

package/dist/{exportDxf-T2RTSTH5.js → exportDxf-C4CLQCC3.js}

@@ -1,10 +1,10 @@
 import {
   DWG_DXF_OPTIONS,
   buildDxf
-} from "./chunk-BQCSFVAF.js";
+} from "./chunk-YYJAXJOY.js";
 import "./chunk-PZ5AY32C.js";
 export {
   DWG_DXF_OPTIONS,
   buildDxf
 };
-//# sourceMappingURL=exportDxf-T2RTSTH5.js.map
+//# sourceMappingURL=exportDxf-C4CLQCC3.js.map

package/dist/sdk.d.ts

@@ -89,6 +89,31 @@ declare const DimStyleSchema: z.ZodObject<{
     precision: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 type DimStyle$1 = z.infer<typeof DimStyleSchema>;
+declare const BlockSchema: z.ZodObject<{
+    id: z.ZodString;
+    layerId: z.ZodString;
+    color: z.ZodOptional<z.ZodString>;
+    lineType: z.ZodOptional<z.ZodString>;
+    lineTypeScale: z.ZodOptional<z.ZodNumber>;
+    lineWidth: z.ZodOptional<z.ZodNumber>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    type: z.ZodLiteral<"block">;
+    definitionId: z.ZodString;
+    rotation: z.ZodDefault<z.ZodNumber>;
+    scale: z.ZodDefault<z.ZodNumber>;
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>, z.ZodJSONSchema]>>>;
+    inputs: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>, unknown>, z.ZodString]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>, unknown>, z.ZodString, z.ZodArray<z.ZodPreprocess<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>, unknown>>, z.ZodArray<z.ZodString>]>>]>>;
+}, z.core.$strip>;
+type Block = z.infer<typeof BlockSchema>;
 /**
  * A LINKED file drawn in place (an xref): the document holds this record,
  * never the file. The file's model space lands with its origin at
@@ -435,11 +460,17 @@ declare const ModelObjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     definitionId: z.ZodString;
     rotation: z.ZodDefault<z.ZodNumber>;
     scale: z.ZodDefault<z.ZodNumber>;
-    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>]>>>;
-    inputs: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+    params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>, z.ZodJSONSchema]>>>;
+    inputs: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>, unknown>, z.ZodString]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>, unknown>, z.ZodString, z.ZodArray<z.ZodPreprocess<z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
-    }, z.core.$strip>, unknown>, z.ZodString]>>>;
+    }, z.core.$strip>, unknown>>, z.ZodArray<z.ZodString>]>>]>>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     layerId: z.ZodString;
@@ -666,7 +697,7 @@ type Layer = z.infer<typeof LayerSchema>;
 declare const LineaDocumentSchema: z.ZodPreprocess<z.ZodObject<{
     id: z.ZodDefault<z.ZodString>;
     type: z.ZodDefault<z.ZodLiteral<"lineadraw">>;
-    version: z.ZodLiteral<23>;
+    version: z.ZodLiteral<24>;
     settings: z.ZodDefault<z.ZodObject<{
         units: z.ZodDefault<z.ZodEnum<{
             in: "in";
@@ -968,11 +999,17 @@ declare const LineaDocumentSchema: z.ZodPreprocess<z.ZodObject<{
         definitionId: z.ZodString;
         rotation: z.ZodDefault<z.ZodNumber>;
         scale: z.ZodDefault<z.ZodNumber>;
-        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>]>>>;
-        inputs: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>, z.ZodJSONSchema]>>>;
+        inputs: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
-        }, z.core.$strip>, unknown>, z.ZodString]>>>;
+        }, z.core.$strip>, unknown>, z.ZodString]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, unknown>, z.ZodString, z.ZodArray<z.ZodPreprocess<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, unknown>>, z.ZodArray<z.ZodString>]>>]>>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         layerId: z.ZodString;
@@ -1453,11 +1490,17 @@ declare const LineaDocumentSchema: z.ZodPreprocess<z.ZodObject<{
             definitionId: z.ZodString;
             rotation: z.ZodDefault<z.ZodNumber>;
             scale: z.ZodDefault<z.ZodNumber>;
-            params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>]>>>;
-            inputs: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+            params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>, z.ZodJSONSchema]>>>;
+            inputs: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, unknown>, z.ZodString]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
                 x: z.ZodNumber;
                 y: z.ZodNumber;
-            }, z.core.$strip>, unknown>, z.ZodString]>>>;
+            }, z.core.$strip>, unknown>, z.ZodString, z.ZodArray<z.ZodPreprocess<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, unknown>>, z.ZodArray<z.ZodString>]>>]>>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
             layerId: z.ZodString;
@@ -1813,6 +1856,12 @@ declare const ParamDefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     hint: z.ZodOptional<z.ZodString>;
     type: z.ZodLiteral<"hatchPattern">;
     default: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    hint: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"data">;
+    default: z.ZodJSONSchema;
 }, z.core.$strip>, z.ZodObject<{
     name: z.ZodString;
     label: z.ZodOptional<z.ZodString>;
@@ -1910,6 +1959,73 @@ declare const ParamDefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>], "type">>;
 }, z.core.$strip>], "type">;
 type ParamDef = z.infer<typeof ParamDefSchema>;
+declare const InputDefSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"point">;
+    optional: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"points">;
+    min: z.ZodDefault<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+    closed: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"object">;
+    types: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        arc: "arc";
+        block: "block";
+        circle: "circle";
+        comment: "comment";
+        dimension: "dimension";
+        ellipse: "ellipse";
+        hatch: "hatch";
+        line: "line";
+        point: "point";
+        polyline: "polyline";
+        reference: "reference";
+        table: "table";
+        text: "text";
+        viewport: "viewport";
+    }>>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"objects">;
+    types: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        arc: "arc";
+        block: "block";
+        circle: "circle";
+        comment: "comment";
+        dimension: "dimension";
+        ellipse: "ellipse";
+        hatch: "hatch";
+        line: "line";
+        point: "point";
+        polyline: "polyline";
+        reference: "reference";
+        table: "table";
+        text: "text";
+        viewport: "viewport";
+    }>>>;
+    min: z.ZodDefault<z.ZodNumber>;
+    max: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"host">;
+    types: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>], "type">;
+type InputDef = z.infer<typeof InputDefSchema>;
 
 /** ISO A-series portrait sizes in mm [width, height]. */
 declare const SHEET_PRESETS: {
@@ -2243,11 +2359,17 @@ declare const PaperLayoutSchema: z.ZodObject<{
         definitionId: z.ZodString;
         rotation: z.ZodDefault<z.ZodNumber>;
         scale: z.ZodDefault<z.ZodNumber>;
-        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>]>>>;
-        inputs: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>, z.ZodJSONSchema]>>>;
+        inputs: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
-        }, z.core.$strip>, unknown>, z.ZodString]>>>;
+        }, z.core.$strip>, unknown>, z.ZodString]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, unknown>, z.ZodString, z.ZodArray<z.ZodPreprocess<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, unknown>>, z.ZodArray<z.ZodString>]>>]>>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         layerId: z.ZodString;
@@ -2448,6 +2570,15 @@ type ModuleExecutor = (script: string) => Record<string, unknown>;
  * Shared by block AND command modules. */
 declare const ensureScriptTranspiler: () => Promise<ModuleExecutor>;
 
+/**
+ * Looks up a referenced object by id — supplied by whoever owns the
+ * document (ids are document-unique, so a document-wide lookup is correct).
+ */
+type BlockObjectResolver = ((id: string) => ModelObject | undefined) & {
+    /** Every block instance in the document (all spaces) — how a host finds
+     * what lives on it (hostedOf). Absent → hosts see no `hosted`. */
+    blocks?: () => readonly Block[];
+};
 /** Identity + metadata derived from a block module's exports. The optional
  * fields are marketplace/listing metadata (docs/block-marketplace.md) —
  * absent ones change nothing about evaluation. */
@@ -2463,6 +2594,10 @@ interface BlockMeta {
      * Declared (a param-dependent path may emit only sometimes), but the
      * save-time dry run REJECTS emitted instances that are not declared. */
     dependencies?: string[];
+    /** The declared input table (`inputs` member) — instances of a module
+     * with one store their inputs as a record by name. Absent for the
+     * positional forms (`place` labels / function, or no `place`). */
+    inputs?: InputDef[];
 }
 /** Non-throwing meta lookup for list UIs. */
 type BlockMetaResult = {
@@ -2677,14 +2812,23 @@ interface CommandMeta {
     version?: string;
     authors?: string[];
     tags?: string[];
-    /** Declared point inputs (labels): picked one by one in the editor before
-     * `run`, or supplied up front by a headless/remote caller. */
-    inputs?: string[];
+    /** Declared inputs, as declared: point LABELS (positional — `ctx.inputs`
+     * is an array) or an input TABLE (named — `ctx.inputs` is a record;
+     * object inputs take the selection first). Acquired before `run`: picked
+     * in the editor, or supplied up front by a headless/remote caller. */
+    inputs?: string[] | CommandInputDef[];
+    /** Asks during the run (editor.pickPoint / prompt / ask), so it can't
+     * run headless: headless runners refuse it up front. */
+    requiresEditor?: boolean;
     /** Declared parameters (the blocks' ParamDef table): prompted in the
      * editor before `run`, or passed by a headless caller; arrive as
      * `ctx.params`. Absent when the command declares none. */
     params?: ParamDef[];
 }
+/** A command input: any input kind but `host` (block-only). */
+type CommandInputDef = Exclude<InputDef, {
+    type: "host";
+}>;
 /** Non-throwing meta lookup for list UIs. */
 type CommandMetaResult = {
     ok: true;
@@ -3156,11 +3300,17 @@ declare const OperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         definitionId: z.ZodString;
         rotation: z.ZodDefault<z.ZodNumber>;
         scale: z.ZodDefault<z.ZodNumber>;
-        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>]>>>;
-        inputs: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>, z.ZodJSONSchema]>>>;
+        inputs: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, unknown>, z.ZodString]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, unknown>, z.ZodString, z.ZodArray<z.ZodPreprocess<z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
-        }, z.core.$strip>, unknown>, z.ZodString]>>>;
+        }, z.core.$strip>, unknown>>, z.ZodArray<z.ZodString>]>>]>>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         layerId: z.ZodString;
@@ -3635,11 +3785,17 @@ declare const OperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         definitionId: z.ZodString;
         rotation: z.ZodDefault<z.ZodNumber>;
         scale: z.ZodDefault<z.ZodNumber>;
-        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>]>>>;
-        inputs: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>, z.ZodJSONSchema]>>>;
+        inputs: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
             x: z.ZodNumber;
             y: z.ZodNumber;
-        }, z.core.$strip>, unknown>, z.ZodString]>>>;
+        }, z.core.$strip>, unknown>, z.ZodString]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, unknown>, z.ZodString, z.ZodArray<z.ZodPreprocess<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+        }, z.core.$strip>, unknown>>, z.ZodArray<z.ZodString>]>>]>>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         layerId: z.ZodString;
@@ -4196,11 +4352,17 @@ declare const OperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             definitionId: z.ZodString;
             rotation: z.ZodDefault<z.ZodNumber>;
             scale: z.ZodDefault<z.ZodNumber>;
-            params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>]>>>;
-            inputs: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+            params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>, z.ZodJSONSchema]>>>;
+            inputs: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, unknown>, z.ZodString]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
                 x: z.ZodNumber;
                 y: z.ZodNumber;
-            }, z.core.$strip>, unknown>, z.ZodString]>>>;
+            }, z.core.$strip>, unknown>, z.ZodString, z.ZodArray<z.ZodPreprocess<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, unknown>>, z.ZodArray<z.ZodString>]>>]>>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
             layerId: z.ZodString;
@@ -4704,11 +4866,17 @@ declare const OperationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             definitionId: z.ZodString;
             rotation: z.ZodDefault<z.ZodNumber>;
             scale: z.ZodDefault<z.ZodNumber>;
-            params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>]>>>;
-            inputs: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+            params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodString>, z.ZodJSONSchema]>>>;
+            inputs: z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, unknown>, z.ZodString]>>, z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodPreprocess<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strip>, unknown>, z.ZodString, z.ZodArray<z.ZodPreprocess<z.ZodObject<{
                 x: z.ZodNumber;
                 y: z.ZodNumber;
-            }, z.core.$strip>, unknown>, z.ZodString]>>>;
+            }, z.core.$strip>, unknown>>, z.ZodArray<z.ZodString>]>>]>>;
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodString;
             layerId: z.ZodString;
@@ -5227,8 +5395,9 @@ interface DrawingHooks {
     revision(): number;
     /** Text metrics for bounds and DXF (default: approximate font metrics). */
     measure?: TextMeasurer;
-    /** Document-wide object lookup for block reference inputs. */
-    resolveObject?: (id: string) => ModelObject | undefined;
+    /** Document-wide object lookup for block reference inputs (and the
+     * document's block list, for hosted blocks). */
+    resolveObject?: BlockObjectResolver;
     /** Loaded reference content (default: the drawing's referenceContent). */
     resolveReference?: (ref: Reference) => ReferenceContent | null;
     /** Snap/hit-test geometry, e.g. from a cache (default: built per call). */
@@ -5740,11 +5909,17 @@ declare class LocalDrawing implements Drawing$1 {
             definitionId: string;
             rotation: number;
             scale: number;
-            params: Record<string, string | number | boolean | string[] | number[]>;
+            params: Record<string, string[] | number[] | z.JSONType>;
             inputs: (string | {
                 x: number;
                 y: number;
-            })[];
+            })[] | Record<string, string | string[] | {
+                x: number;
+                y: number;
+            }[] | {
+                x: number;
+                y: number;
+            }>;
         } | {
             id: string;
             layerId: string;
@@ -5892,7 +6067,7 @@ declare class LocalDrawing implements Drawing$1 {
                 maxY: number;
             } | undefined;
         })[];
-        resolveObject: (id: string) => ModelObject | undefined;
+        resolveObject: BlockObjectResolver;
         resolveReference: (ref: Reference) => ReferenceContent | null;
     };
     protected resolveLayout(nameOrId: string): PaperLayout;
@@ -6109,9 +6284,12 @@ type BlockInput = ObjectInputShape<{
     /** Applied last, about the pivot (the first input point). */
     rotation?: number;
     scale?: number;
-    params?: Record<string, number | string | boolean | readonly number[] | readonly string[]>;
-    /** Input points in the PARENT's local coords; the first is the pivot. */
-    inputs?: readonly Vec2Like[];
+    params?: Record<string, number | string | boolean | readonly number[] | readonly string[] | JsonValue>;
+    /** Input points in the PARENT's local coords (the first is the pivot):
+     * in pick order, or by input name for a block declaring an `inputs`
+     * table. Object ids (a `host`, picked objects) only on instances a
+     * script ADDS to the document — a block's own children can't reference. */
+    inputs?: readonly Vec2Like[] | Readonly<Record<string, Vec2Like | readonly Vec2Like[] | string | readonly string[]>>;
 }>;
 /** A table cell: plain text, or text with merge / alignment / style. */
 type TableCellInput = string | {
@@ -6207,7 +6385,7 @@ type ViewportInput = ObjectInputShape<{
     modelCenter?: Vec2Like;
     /** Drawing-scale denominator (model mm per paper mm); 1:50 => 50. */
     scale?: number;
-    /** Pinned: no pan/zoom-through, no move/resize grips. */
+    /** Pinned: no pan/zoom-through, no move/resize handles. */
     locked?: boolean;
     /** Layer ids hidden in this viewport only. */
     hiddenLayerIds?: readonly string[];
@@ -6260,6 +6438,10 @@ type DimStyle = {
     readonly extensionOvershoot: number;
     readonly precision: number;
 };
+/** Any JSON value — what a `data` param holds. */
+type JsonValue = string | number | boolean | null | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
 
 /** A world point in mm, as `[x, y]` or `{x, y}`. */
 type PointInput = Vec2$1 | readonly [number, number];
@@ -6559,10 +6741,30 @@ interface EditorSurface {
     zoom(to: ZoomTarget): void;
     /** Await one snapped world point; rejects when the user cancels. */
     pickPoint(opts?: PickPointOptions): Promise<Vec2$1>;
-    /** Await one object click; resolves the object's id. */
+    /** Await one object click; resolves the object's id. `types` limits what
+     * can be picked (ModelObject types; empty/absent = any). */
     pickObject(opts?: {
         label?: string;
+        types?: readonly string[];
     }): Promise<string>;
+    /** Await a chain of snapped points (rubber band from the previous);
+     * Enter/Esc finishes once `min` (default 1) is met, `max` ends it.
+     * Rejects when the user cancels below `min`. */
+    pickPoints(opts?: PickPointsOptions): Promise<Vec2$1[]>;
+    /** Await several object picks (each once); Enter/Esc finishes once
+     * `min` (default 1) is met. Rejects when the user cancels below `min`. */
+    pickObjects(opts?: {
+        label?: string;
+        types?: readonly string[];
+        min?: number;
+        max?: number;
+    }): Promise<string[]>;
+    /** Ask several values in one dialog — the command params form, from a
+     * ParamDef table; resolves the values by name, rejects on cancel. */
+    ask(params: readonly ParamDef[], opts?: {
+        title?: string;
+        description?: string;
+    }): Promise<Record<string, unknown>>;
     /** Await a typed value from a small input dialog; rejects on cancel. */
     prompt(message: string, opts?: {
         initial?: string;
@@ -6574,7 +6776,21 @@ interface EditorSurface {
     /** Trigger a command by id (interactive tools start and wait for the
      * user; macros with declared inputs / params accept them up front —
      * params passed skip the params dialog). */
-    runCommand(id: string, inputs?: readonly PointInput[], params?: Readonly<Record<string, unknown>>): Promise<void>;
+    runCommand(id: string, inputs?: CommandInputsArg, params?: Readonly<Record<string, unknown>>): Promise<void>;
+}
+/** Inputs a caller supplies to a command: positional points (a command
+ * declaring labels) or a record by input name (a command declaring a
+ * table — points as [x, y], objects as ids). */
+type CommandInputsArg = readonly PointInput[] | Readonly<Record<string, PointInput | readonly PointInput[] | string | readonly string[]>>;
+interface PickPointsOptions {
+    label?: string;
+    /** Default 1. */
+    min?: number;
+    max?: number;
+    /** Preview the closing segment (a polygon). */
+    closed?: boolean;
+    /** Rubber band from here to the first pick. */
+    referencePoint?: PointInput;
 }
 /** Where `EditorSurface.zoom` moves the camera: everything in the active
  * space, the selection, some objects' extents, or a window (world mm; sheet
@@ -6647,12 +6863,13 @@ declare class Drawing extends LocalDrawing {
     importDwg(path: string, opts?: DxfImportOptions): Promise<DxfImportReport>;
     importPdf(path: string, opts?: PdfImportOptions): Promise<PdfImportReport>;
     /** Run a command module source (`defineCommand`) against this drawing as
-     * ONE undo step, headlessly: declared `inputs` must be supplied; declared
+     * ONE undo step, headlessly: declared `inputs` must be supplied (points
+     * in label order, or a record by name for an inputs table); declared
      * `params` take their defaults unless given by name (unknown names and
      * wrong types throw). Resolves with the script's return value. */
-    runScript(source: string, inputs?: readonly PointInput[], params?: Readonly<Record<string, unknown>>): Promise<unknown>;
+    runScript(source: string, inputs?: CommandInputsArg, params?: Readonly<Record<string, unknown>>): Promise<unknown>;
     /** Run one of the document's own commands (by exported id). */
-    runUserCommand(id: string, inputs?: readonly PointInput[], params?: Readonly<Record<string, unknown>>): Promise<unknown>;
+    runUserCommand(id: string, inputs?: CommandInputsArg, params?: Readonly<Record<string, unknown>>): Promise<unknown>;
 }
 /** A fresh empty document, optionally named (until saved to a file, whose
  * name then takes over). */