lineadraw 0.7.0 → 0.8.0

package/lineadraw.d.ts

@@ -18,6 +18,13 @@ declare module "lineadraw" {
   } | readonly [number, number, number?];
   /** Style overrides children may carry (otherwise inherited from the instance). */
   export type BaseStyle = {
+      /** Id of a document layer this object sits on. For a block child: absent
+       * = the instance's layer (the portable default; an id unknown to the
+       * document falls back to it); a child that names another layer hides
+       * with that layer, while its color / line type / width still follow the
+       * instance unless it sets its own (ByBlock, as in CAD). For
+       * `document.add`: absent = the current layer. */
+      layerId?: string;
       /** #rrggbb; absent = by layer. */
       color?: string;
       /** Line type; absent = by layer. */
@@ -26,6 +33,8 @@ declare module "lineadraw" {
       lineTypeScale?: number;
       /** Line weight in mm; absent = by layer. */
       lineWidth?: number;
+      /** Paint opacity 0..1; absent = by layer (opaque unless the layer says). */
+      opacity?: number;
   };
   /**
    * T plus the shared style fields, FLATTENED (the homomorphic map forces the
@@ -82,6 +91,17 @@ declare module "lineadraw" {
       }[];
       fill?: {
           kind: "solid";
+      }
+      /** A named pattern: the built-in catalogue (ANSI31, AR-CONC, …) or one of
+       * the document's own hatch patterns, by name. `angle` radians, `scale`
+       * multiplies the definition's mm; `origin` anchors the pattern frame
+       * (block-local mm; absent = the block origin). */
+       | {
+          kind: "pattern";
+          name: string;
+          angle: number;
+          scale: number;
+          origin?: Vec2Like;
       } | {
           kind: "lines";
           angle: number;
@@ -96,10 +116,26 @@ declare module "lineadraw" {
       /** Pattern spacing multiplier. */
       scale?: number;
   }>;
+  /** Character formatting over [start, end) of a text's `content` (JS string
+   * indices). Absent attributes inherit the text's style; `height` is a ratio
+   * of its cap height. Setting `content` without `spans` drops old spans. */
+  export type TextSpan = {
+      start: number;
+      end: number;
+      font?: string;
+      bold?: boolean;
+      italic?: boolean;
+      underline?: boolean;
+      /** "#rrggbb". */
+      color?: string;
+      height?: number;
+      script?: "sub" | "super";
+  };
   export type Text = Styled<{
       type: "text";
       position: Vec2Like;
       content: string;
+      spans?: readonly TextSpan[];
       rotation?: number;
       /** Justification, as in AutoCAD / DXF: which edge sits on the point —
        * "left" = the text runs right of it, "right" = left of it; vAlign
@@ -111,6 +147,8 @@ declare module "lineadraw" {
       frame?: "none" | "rectangle" | "circle" | "slot" | "bottom" | "firstLine";
       /** MLEADER-style arrow polylines pointing at the text (arrowhead at [0]). */
       leaderLines?: readonly (readonly Vec2Like[])[];
+      /** The document text style to follow (name or id); absent = the first. */
+      styleId?: string;
       /** Style overrides; absent keys inherit the document text style. */
       styleOverride?: {
           font?: string;
@@ -130,11 +168,26 @@ declare module "lineadraw" {
       kind?: "linear" | "angular" | "radial" | "diameter";
       /** linear: 2+ chained points (measured point to point); angular: [vertex, a, b]; radial: [center, p]; diameter: [p1, p2]. */
       points: readonly Vec2Like[];
-      /** Dimension line offset from the kind's anchor (points[0]; diameter: the
-       * points' midpoint). anchor + offset lies on the dimension line (angular:
-       * on the arc; radial/diameter: at the text). */
-      offset: Vec2Like;
-      textOverride?: string;
+      /** linear only: the measuring direction, radians CCW from +X. Unset =
+       * aligned to the points. */
+      rotation?: number;
+      /** linear: signed distance of the dimension line from points[0], positive
+       * to the LEFT of the measuring direction; angular: signed arc radius
+       * (negative = the complementary arc). Not for radial/diameter. */
+      offset?: number;
+      /** One per measured segment (linear chain: points.length − 1, others: 1).
+       * `along` (mm along the line from the segment origin — radial/diameter:
+       * from the center) and `across` (mm off the line) place the text, unset =
+       * automatic; `content` is the text, `{value}` = the measurement. */
+      labels?: readonly {
+          along?: number;
+          across?: number;
+          content?: string;
+          /** Formatting over `content` (spans covering `{value}` format it). */
+          spans?: readonly TextSpan[];
+      }[];
+      /** The document dimension style to follow (name or id); absent = the first. */
+      styleId?: string;
       styleOverride?: {
           textHeight?: number;
           arrowSize?: number;
@@ -162,7 +215,9 @@ declare module "lineadraw" {
   }>;
   /** A table cell: plain text, or text with merge / alignment / style. */
   export type TableCell = string | {
-      text?: string;
+      content?: string;
+      /** Character formatting over `content`. */
+      spans?: readonly TextSpan[];
       /** Merge from this (top-left) cell; covered cells are ignored. */
       span?: {
           cols: number;
@@ -197,7 +252,14 @@ declare module "lineadraw" {
       styleId?: string;
       styleOverride?: TextStyleOverride;
   }>;
-  export type ModelObject = Line | Point | Polyline | Circle | Arc | Ellipse | Hatch | Text | Dimension | Block | Table;
+  /** What a script WRITES — the union of the authoring DTOs above (what
+   * `draw` returns, what `document.add` takes). Read results are
+   * `StoredObject`. */
+  export type ObjectInput = Line | Point | Polyline | Circle | Arc | Ellipse | Hatch | Text | Dimension | Block | Table;
+  /** @deprecated The input union is `ObjectInput`; in the SDK and core
+   * `ModelObject` is the STORED shape, so this name misled. Kept so existing
+   * scripts compile. */
+  export type ModelObject = ObjectInput;
   /** Identity + shared style fields every stored object carries. */
   export type StoredObjectBase = {
       id: string;
@@ -262,6 +324,8 @@ declare module "lineadraw" {
       name: string;
       angle: number;
       scale: number;
+      /** World anchor of the pattern frame; absent = the drawing origin. */
+      origin?: Vec2;
   } | {
       kind: "lines";
       angle: number;
@@ -286,6 +350,7 @@ declare module "lineadraw" {
       type: "text";
       position: Vec2;
       content: string;
+      spans?: readonly TextSpan[];
       leaderLines: readonly (readonly Vec2[])[];
       /** Word-wrap / frame width in mm; absent = no wrapping. */
       width?: number;
@@ -310,8 +375,14 @@ declare module "lineadraw" {
       type: "dimension";
       kind: "linear" | "angular" | "radial" | "diameter";
       points: readonly Vec2[];
-      offset: Vec2;
-      textOverride?: string;
+      rotation?: number;
+      offset?: number;
+      labels: readonly {
+          along?: number;
+          across?: number;
+          content?: string;
+          spans?: readonly TextSpan[];
+      }[];
       styleId?: string;
       /** Only the keys the user actually overrode on this dimension. */
       styleOverride?: {
@@ -388,6 +459,8 @@ declare module "lineadraw" {
       hiddenLayers: readonly string[];
       /** Switched off: not drawn. */
       hidden?: boolean;
+      /** Locked in the References panel: drawn and snapped, never picked. */
+      locked?: boolean;
       /** Crop rectangle in file coordinates. */
       clip?: {
           minX: number;
@@ -424,7 +497,8 @@ declare module "lineadraw" {
   /** One table cell as stored. */
   export type StoredTableCell = {
       /** Plain text; "\n" = line break. */
-      text: string;
+      content: string;
+      spans?: readonly TextSpan[];
       /** Merge, on the anchor (top-left) cell; covered cells are ignored. */
       span?: {
           cols: number;
@@ -617,7 +691,7 @@ declare module "lineadraw" {
    */
   export type BlockParamDefs = readonly ParamDef[];
   /** What the script's `draw` export must return. */
-  export type BlockScriptResult = ModelObject[];
+  export type BlockScriptResult = ObjectInput[];
   /** The value an enum option denotes (its string, or `value` of the record form). */
   type OptionValue<O extends ParameterOption> = O extends string ? O : O extends {
       value: infer V extends string;
@@ -650,6 +724,37 @@ declare module "lineadraw" {
           name: infer N extends string;
       } ? N : never]: E extends ParamDef ? ParamValue<E> : never;
   } : P;
+  /** A document line type definition — objects and layers name it in
+   * `lineType`, ahead of the built-in catalogue. */
+  export type LineType = {
+      /** Case-insensitive, unique per document. */
+      name: string;
+      description?: string;
+      /** Signed dash cycle, mm per 1 mm of line width: >0 dash, <0 gap, 0 dot.
+       * Empty = continuous. */
+      dashesMm: number[];
+  };
+  /** One line family of a hatch pattern, in the pattern's own frame. */
+  export type HatchPatternLine = {
+      /** Radians CCW. */
+      angle: number;
+      /** Base point, mm. */
+      origin: Vec2;
+      /** Shift along the line between successive lines (dash phase), mm. */
+      deltaX: number;
+      /** Perpendicular spacing between successive lines, mm. */
+      deltaY: number;
+      /** Dash cycle along the line: >0 dash, <0 gap, 0 dot; absent = solid. */
+      dashesMm?: number[];
+  };
+  /** A document hatch pattern definition — pattern fills name it in
+   * `fill.name`, ahead of the built-in catalogue. */
+  export type HatchPattern = {
+      /** Case-insensitive, unique per document. */
+      name: string;
+      description?: string;
+      lines: HatchPatternLine[];
+  };
   /** An axis-aligned box in world mm. */
   export type Box = {
       minX: number;
@@ -660,7 +765,7 @@ declare module "lineadraw" {
   /** Filters for Drawing.query — all present filters AND together. */
   export type ObjectQuery = {
       ids?: readonly string[];
-      type?: ModelObject["type"];
+      type?: ObjectInput["type"];
       /** Layer name or id. */
       layer?: string;
       /** #rrggbb override (objects without one inherit from their layer). */
@@ -739,6 +844,48 @@ declare module "lineadraw" {
       params?: readonly ParamDef[];
   };
   /** What installing module sources reports. */
+  /** One configured marketplace (a block / command collection). */
+  export type MarketplaceConfig = {
+      kind: "builtin";
+  } | {
+      kind: "github";
+      spec: string;
+      token?: string;
+  } | {
+      kind: "folder";
+      folder: string;
+  };
+  /** A configured marketplace as listed — the token itself never shows. */
+  export type MarketplaceInfo = {
+      key: string;
+      kind: "builtin" | "github" | "folder";
+      label: string;
+      spec?: string;
+      folder?: string;
+      hasToken: boolean;
+  };
+  /** A marketplace search hit: the catalog row plus where it came from and
+   * how it relates to this document's modules. */
+  export type MarketplaceHit = {
+      kind: "block" | "command";
+      id: string;
+      name: string;
+      version: string;
+      description?: string;
+      tags: string[];
+      authors: string[];
+      dependencies: string[];
+      marketplace: MarketplaceInfo;
+      status: {
+          kind: "absent";
+      } | {
+          kind: "installed";
+          version?: string;
+      } | {
+          kind: "update";
+          from?: string;
+      };
+  };
   export type MergeReport = {
       /** The full library after the merge. */
       merged: readonly string[];
@@ -844,6 +991,9 @@ declare module "lineadraw" {
               name: string;
               objectCount: number;
           }[];
+          settings: {
+              units: "mm" | "in";
+          };
       };
       /** Filtered objects — model space, or one layout via `filter.layout`. */
       listObjects(filter?: ObjectQuery): ExistingObject[];
@@ -892,7 +1042,7 @@ declare module "lineadraw" {
       toLinea(): string;
       /** Add objects (each may carry `layer` — a name — instead of an id);
        * returns the created ids. */
-      add(objects: readonly (ModelObject & {
+      add(objects: readonly (ObjectInput & {
           layer?: string;
       })[], opts?: {
           layout?: string;
@@ -936,6 +1086,26 @@ declare module "lineadraw" {
       /** Explicit total order (names or ids, every layer exactly once). */
       reorderLayers(order: readonly string[]): void;
       setCurrentLayer(nameOrId: string): void;
+      /** Document-wide settings, merged over the current record. */
+      updateSettings(patch: {
+          units?: "mm" | "in";
+      }): void;
+      /** Configured marketplaces, priority order (tokens hidden). */
+      listMarketplaces(): MarketplaceInfo[];
+      /** Add marketplaces at the top of the priority list; each catalog must be
+       * fetchable. `{ kind: "github", spec: "owner/repo[@branch]", token? }` or
+       * `{ kind: "folder", folder }`. */
+      addMarketplaces(list: readonly MarketplaceConfig[]): Promise<MarketplaceInfo[]>;
+      /** Remove by key, spec, folder or label; the built-in collection stays. */
+      removeMarketplaces(names: readonly string[]): MarketplaceInfo[];
+      /** Search entries across the marketplaces, with install status. */
+      searchMarketplaces(q?: {
+          query?: string;
+          kind?: "block" | "command";
+          marketplace?: string;
+      }): Promise<MarketplaceHit[]>;
+      /** Install (or update) entries by id, dependencies first — one undo step. */
+      installMarketplaceEntries(ids: readonly string[], marketplace?: string): Promise<MergeReport>;
       listTextStyles(): ({
           id: string;
           name: string;
@@ -961,6 +1131,21 @@ declare module "lineadraw" {
       setDimStyle(patch: Record<string, unknown>, styleId?: string): void;
       /** @deprecated Use updateTextStyle (default here: the first style). */
       setTextStyle(patch: Record<string, unknown>, styleId?: string): void;
+      /** The document's own line type definitions (objects and layers name
+       * them, ahead of the built-in catalogue). */
+      listLineTypes(): LineType[];
+      /** Add definitions (names unique, case-insensitive; a clash is refused). */
+      addLineTypes(lineTypes: readonly LineType[]): void;
+      updateLineType(name: string, patch: Partial<LineType>): void;
+      /** Remove a definition; objects still naming it fall back to the
+       * catalogue or continuous. */
+      removeLineType(name: string): void;
+      /** The document's own hatch pattern definitions (same model as line
+       * types: fills name them, ahead of the catalogue). */
+      listHatchPatterns(): HatchPattern[];
+      addHatchPatterns(patterns: readonly HatchPattern[]): void;
+      updateHatchPattern(name: string, patch: Partial<HatchPattern>): void;
+      removeHatchPattern(name: string): void;
       /** Embed image pixels (a data URL); returns the content-keyed assetId
        * that `image` objects reference. */
       addAsset(dataUrl: string): string;
@@ -1444,6 +1629,13 @@ type PolylineVertexLike = {
 } | readonly [number, number, number?];
 /** Style overrides children may carry (otherwise inherited from the instance). */
 type BaseStyle = {
+    /** Id of a document layer this object sits on. For a block child: absent
+     * = the instance's layer (the portable default; an id unknown to the
+     * document falls back to it); a child that names another layer hides
+     * with that layer, while its color / line type / width still follow the
+     * instance unless it sets its own (ByBlock, as in CAD). For
+     * `document.add`: absent = the current layer. */
+    layerId?: string;
     /** #rrggbb; absent = by layer. */
     color?: string;
     /** Line type; absent = by layer. */
@@ -1452,6 +1644,8 @@ type BaseStyle = {
     lineTypeScale?: number;
     /** Line weight in mm; absent = by layer. */
     lineWidth?: number;
+    /** Paint opacity 0..1; absent = by layer (opaque unless the layer says). */
+    opacity?: number;
 };
 /**
  * T plus the shared style fields, FLATTENED (the homomorphic map forces the
@@ -1508,6 +1702,17 @@ type Hatch = Styled<{
     }[];
     fill?: {
         kind: "solid";
+    }
+    /** A named pattern: the built-in catalogue (ANSI31, AR-CONC, …) or one of
+     * the document's own hatch patterns, by name. `angle` radians, `scale`
+     * multiplies the definition's mm; `origin` anchors the pattern frame
+     * (block-local mm; absent = the block origin). */
+     | {
+        kind: "pattern";
+        name: string;
+        angle: number;
+        scale: number;
+        origin?: Vec2Like;
     } | {
         kind: "lines";
         angle: number;
@@ -1522,10 +1727,26 @@ type Hatch = Styled<{
     /** Pattern spacing multiplier. */
     scale?: number;
 }>;
+/** Character formatting over [start, end) of a text's `content` (JS string
+ * indices). Absent attributes inherit the text's style; `height` is a ratio
+ * of its cap height. Setting `content` without `spans` drops old spans. */
+type TextSpan = {
+    start: number;
+    end: number;
+    font?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    /** "#rrggbb". */
+    color?: string;
+    height?: number;
+    script?: "sub" | "super";
+};
 type Text = Styled<{
     type: "text";
     position: Vec2Like;
     content: string;
+    spans?: readonly TextSpan[];
     rotation?: number;
     /** Justification, as in AutoCAD / DXF: which edge sits on the point —
      * "left" = the text runs right of it, "right" = left of it; vAlign
@@ -1537,6 +1758,8 @@ type Text = Styled<{
     frame?: "none" | "rectangle" | "circle" | "slot" | "bottom" | "firstLine";
     /** MLEADER-style arrow polylines pointing at the text (arrowhead at [0]). */
     leaderLines?: readonly (readonly Vec2Like[])[];
+    /** The document text style to follow (name or id); absent = the first. */
+    styleId?: string;
     /** Style overrides; absent keys inherit the document text style. */
     styleOverride?: {
         font?: string;
@@ -1556,11 +1779,26 @@ type Dimension = Styled<{
     kind?: "linear" | "angular" | "radial" | "diameter";
     /** linear: 2+ chained points (measured point to point); angular: [vertex, a, b]; radial: [center, p]; diameter: [p1, p2]. */
     points: readonly Vec2Like[];
-    /** Dimension line offset from the kind's anchor (points[0]; diameter: the
-     * points' midpoint). anchor + offset lies on the dimension line (angular:
-     * on the arc; radial/diameter: at the text). */
-    offset: Vec2Like;
-    textOverride?: string;
+    /** linear only: the measuring direction, radians CCW from +X. Unset =
+     * aligned to the points. */
+    rotation?: number;
+    /** linear: signed distance of the dimension line from points[0], positive
+     * to the LEFT of the measuring direction; angular: signed arc radius
+     * (negative = the complementary arc). Not for radial/diameter. */
+    offset?: number;
+    /** One per measured segment (linear chain: points.length − 1, others: 1).
+     * `along` (mm along the line from the segment origin — radial/diameter:
+     * from the center) and `across` (mm off the line) place the text, unset =
+     * automatic; `content` is the text, `{value}` = the measurement. */
+    labels?: readonly {
+        along?: number;
+        across?: number;
+        content?: string;
+        /** Formatting over `content` (spans covering `{value}` format it). */
+        spans?: readonly TextSpan[];
+    }[];
+    /** The document dimension style to follow (name or id); absent = the first. */
+    styleId?: string;
     styleOverride?: {
         textHeight?: number;
         arrowSize?: number;
@@ -1588,7 +1826,9 @@ type Block = Styled<{
 }>;
 /** A table cell: plain text, or text with merge / alignment / style. */
 type TableCell = string | {
-    text?: string;
+    content?: string;
+    /** Character formatting over `content`. */
+    spans?: readonly TextSpan[];
     /** Merge from this (top-left) cell; covered cells are ignored. */
     span?: {
         cols: number;
@@ -1623,7 +1863,14 @@ type Table = Styled<{
     styleId?: string;
     styleOverride?: TextStyleOverride;
 }>;
-type ModelObject = Line | Point | Polyline | Circle | Arc | Ellipse | Hatch | Text | Dimension | Block | Table;
+/** What a script WRITES — the union of the authoring DTOs above (what
+ * `draw` returns, what `document.add` takes). Read results are
+ * `StoredObject`. */
+type ObjectInput = Line | Point | Polyline | Circle | Arc | Ellipse | Hatch | Text | Dimension | Block | Table;
+/** @deprecated The input union is `ObjectInput`; in the SDK and core
+ * `ModelObject` is the STORED shape, so this name misled. Kept so existing
+ * scripts compile. */
+type ModelObject = ObjectInput;
 /** Identity + shared style fields every stored object carries. */
 type StoredObjectBase = {
     id: string;
@@ -1688,6 +1935,8 @@ type StoredHatchFill = {
     name: string;
     angle: number;
     scale: number;
+    /** World anchor of the pattern frame; absent = the drawing origin. */
+    origin?: Vec2;
 } | {
     kind: "lines";
     angle: number;
@@ -1712,6 +1961,7 @@ type StoredText = StoredShape<{
     type: "text";
     position: Vec2;
     content: string;
+    spans?: readonly TextSpan[];
     leaderLines: readonly (readonly Vec2[])[];
     /** Word-wrap / frame width in mm; absent = no wrapping. */
     width?: number;
@@ -1736,8 +1986,14 @@ type StoredDimension = StoredShape<{
     type: "dimension";
     kind: "linear" | "angular" | "radial" | "diameter";
     points: readonly Vec2[];
-    offset: Vec2;
-    textOverride?: string;
+    rotation?: number;
+    offset?: number;
+    labels: readonly {
+        along?: number;
+        across?: number;
+        content?: string;
+        spans?: readonly TextSpan[];
+    }[];
     styleId?: string;
     /** Only the keys the user actually overrode on this dimension. */
     styleOverride?: {
@@ -1814,6 +2070,8 @@ type StoredReference = StoredShape<{
     hiddenLayers: readonly string[];
     /** Switched off: not drawn. */
     hidden?: boolean;
+    /** Locked in the References panel: drawn and snapped, never picked. */
+    locked?: boolean;
     /** Crop rectangle in file coordinates. */
     clip?: {
         minX: number;
@@ -1850,7 +2108,8 @@ type TextStyleOverride = {
 /** One table cell as stored. */
 type StoredTableCell = {
     /** Plain text; "\n" = line break. */
-    text: string;
+    content: string;
+    spans?: readonly TextSpan[];
     /** Merge, on the anchor (top-left) cell; covered cells are ignored. */
     span?: {
         cols: number;
@@ -2043,7 +2302,7 @@ type FlatParam<Q> = Q extends {
  */
 type BlockParamDefs = readonly ParamDef[];
 /** What the script's `draw` export must return. */
-type BlockScriptResult = ModelObject[];
+type BlockScriptResult = ObjectInput[];
 /** The value an enum option denotes (its string, or `value` of the record form). */
 type OptionValue<O extends ParameterOption> = O extends string ? O : O extends {
     value: infer V extends string;
@@ -2076,6 +2335,37 @@ type ParamValues<P> = P extends () => infer R ? ParamValues<R> : P extends reado
         name: infer N extends string;
     } ? N : never]: E extends ParamDef ? ParamValue<E> : never;
 } : P;
+/** A document line type definition — objects and layers name it in
+ * `lineType`, ahead of the built-in catalogue. */
+type LineType = {
+    /** Case-insensitive, unique per document. */
+    name: string;
+    description?: string;
+    /** Signed dash cycle, mm per 1 mm of line width: >0 dash, <0 gap, 0 dot.
+     * Empty = continuous. */
+    dashesMm: number[];
+};
+/** One line family of a hatch pattern, in the pattern's own frame. */
+type HatchPatternLine = {
+    /** Radians CCW. */
+    angle: number;
+    /** Base point, mm. */
+    origin: Vec2;
+    /** Shift along the line between successive lines (dash phase), mm. */
+    deltaX: number;
+    /** Perpendicular spacing between successive lines, mm. */
+    deltaY: number;
+    /** Dash cycle along the line: >0 dash, <0 gap, 0 dot; absent = solid. */
+    dashesMm?: number[];
+};
+/** A document hatch pattern definition — pattern fills name it in
+ * `fill.name`, ahead of the built-in catalogue. */
+type HatchPattern = {
+    /** Case-insensitive, unique per document. */
+    name: string;
+    description?: string;
+    lines: HatchPatternLine[];
+};
 /** An axis-aligned box in world mm. */
 type Box = {
     minX: number;
@@ -2086,7 +2376,7 @@ type Box = {
 /** Filters for Drawing.query — all present filters AND together. */
 type ObjectQuery = {
     ids?: readonly string[];
-    type?: ModelObject["type"];
+    type?: ObjectInput["type"];
     /** Layer name or id. */
     layer?: string;
     /** #rrggbb override (objects without one inherit from their layer). */
@@ -2165,6 +2455,48 @@ type CommandInfo = {
     params?: readonly ParamDef[];
 };
 /** What installing module sources reports. */
+/** One configured marketplace (a block / command collection). */
+type MarketplaceConfig = {
+    kind: "builtin";
+} | {
+    kind: "github";
+    spec: string;
+    token?: string;
+} | {
+    kind: "folder";
+    folder: string;
+};
+/** A configured marketplace as listed — the token itself never shows. */
+type MarketplaceInfo = {
+    key: string;
+    kind: "builtin" | "github" | "folder";
+    label: string;
+    spec?: string;
+    folder?: string;
+    hasToken: boolean;
+};
+/** A marketplace search hit: the catalog row plus where it came from and
+ * how it relates to this document's modules. */
+type MarketplaceHit = {
+    kind: "block" | "command";
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    tags: string[];
+    authors: string[];
+    dependencies: string[];
+    marketplace: MarketplaceInfo;
+    status: {
+        kind: "absent";
+    } | {
+        kind: "installed";
+        version?: string;
+    } | {
+        kind: "update";
+        from?: string;
+    };
+};
 type MergeReport = {
     /** The full library after the merge. */
     merged: readonly string[];
@@ -2270,6 +2602,9 @@ interface Drawing {
             name: string;
             objectCount: number;
         }[];
+        settings: {
+            units: "mm" | "in";
+        };
     };
     /** Filtered objects — model space, or one layout via `filter.layout`. */
     listObjects(filter?: ObjectQuery): ExistingObject[];
@@ -2318,7 +2653,7 @@ interface Drawing {
     toLinea(): string;
     /** Add objects (each may carry `layer` — a name — instead of an id);
      * returns the created ids. */
-    add(objects: readonly (ModelObject & {
+    add(objects: readonly (ObjectInput & {
         layer?: string;
     })[], opts?: {
         layout?: string;
@@ -2362,6 +2697,26 @@ interface Drawing {
     /** Explicit total order (names or ids, every layer exactly once). */
     reorderLayers(order: readonly string[]): void;
     setCurrentLayer(nameOrId: string): void;
+    /** Document-wide settings, merged over the current record. */
+    updateSettings(patch: {
+        units?: "mm" | "in";
+    }): void;
+    /** Configured marketplaces, priority order (tokens hidden). */
+    listMarketplaces(): MarketplaceInfo[];
+    /** Add marketplaces at the top of the priority list; each catalog must be
+     * fetchable. `{ kind: "github", spec: "owner/repo[@branch]", token? }` or
+     * `{ kind: "folder", folder }`. */
+    addMarketplaces(list: readonly MarketplaceConfig[]): Promise<MarketplaceInfo[]>;
+    /** Remove by key, spec, folder or label; the built-in collection stays. */
+    removeMarketplaces(names: readonly string[]): MarketplaceInfo[];
+    /** Search entries across the marketplaces, with install status. */
+    searchMarketplaces(q?: {
+        query?: string;
+        kind?: "block" | "command";
+        marketplace?: string;
+    }): Promise<MarketplaceHit[]>;
+    /** Install (or update) entries by id, dependencies first — one undo step. */
+    installMarketplaceEntries(ids: readonly string[], marketplace?: string): Promise<MergeReport>;
     listTextStyles(): ({
         id: string;
         name: string;
@@ -2387,6 +2742,21 @@ interface Drawing {
     setDimStyle(patch: Record<string, unknown>, styleId?: string): void;
     /** @deprecated Use updateTextStyle (default here: the first style). */
     setTextStyle(patch: Record<string, unknown>, styleId?: string): void;
+    /** The document's own line type definitions (objects and layers name
+     * them, ahead of the built-in catalogue). */
+    listLineTypes(): LineType[];
+    /** Add definitions (names unique, case-insensitive; a clash is refused). */
+    addLineTypes(lineTypes: readonly LineType[]): void;
+    updateLineType(name: string, patch: Partial<LineType>): void;
+    /** Remove a definition; objects still naming it fall back to the
+     * catalogue or continuous. */
+    removeLineType(name: string): void;
+    /** The document's own hatch pattern definitions (same model as line
+     * types: fills name them, ahead of the catalogue). */
+    listHatchPatterns(): HatchPattern[];
+    addHatchPatterns(patterns: readonly HatchPattern[]): void;
+    updateHatchPattern(name: string, patch: Partial<HatchPattern>): void;
+    removeHatchPattern(name: string): void;
     /** Embed image pixels (a data URL); returns the content-keyed assetId
      * that `image` objects reference. */
     addAsset(dataUrl: string): string;