lineadraw 0.6.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[];
@@ -772,7 +919,12 @@ declare module "lineadraw" {
       width: number;
       height: number;
   };
-  /** Options for Drawing.createLayout. */
+  /** What an import added (`objectIds` = the new objects). */
+  export interface ImportReport {
+      objects: number;
+      objectIds: string[];
+  }
+  /** Options for Drawing.addLayout. */
   export type LayoutSpec = {
       /** Default: A3 landscape. */
       sheet?: SheetSpec;
@@ -839,9 +991,12 @@ declare module "lineadraw" {
               name: string;
               objectCount: number;
           }[];
+          settings: {
+              units: "mm" | "in";
+          };
       };
       /** Filtered objects — model space, or one layout via `filter.layout`. */
-      query(filter?: ObjectQuery): ExistingObject[];
+      listObjects(filter?: ObjectQuery): ExistingObject[];
       /** One object from ANY space, or undefined. */
       getObject(id: string): ExistingObject | undefined;
       /** bbox / curve length / enclosed area of one object. */
@@ -849,9 +1004,9 @@ declare module "lineadraw" {
       listLayers(): LayerInfo[];
       listLayouts(): LayoutInfo[];
       /** Compilable block definitions in this document. */
-      listBlocks(): BlockInfo[];
+      listBlockDefinitions(): BlockInfo[];
       /** Compilable command modules travelling with this document. */
-      listCommands(): CommandInfo[];
+      listUserCommands(): CommandInfo[];
       /** Model space (or a layout via `layout`) as an SVG string. */
       renderSvg(opts?: {
           layout?: string;
@@ -859,6 +1014,18 @@ declare module "lineadraw" {
           padding?: number;
           palette?: "color" | "grayscale" | "monochrome";
       }): string;
+      /** Model space (or a layout) as PNG bytes — absent on hosts that can't
+       * rasterize, so check before calling. */
+      renderPng?(opts?: {
+          layout?: string;
+          bbox?: Box;
+          padding?: number;
+          palette?: "color" | "grayscale" | "monochrome";
+          /** Output width in px (height follows). Default 1024. */
+          width?: number;
+          /** Background fill, e.g. "#ffffff". Default: the dark canvas. */
+          background?: string;
+      }): Promise<Uint8Array>;
       /** Multi-page PDF of the layouts (default: all) — absent on hosts
        * without fonts, so check before calling. */
       renderPdf?(opts?: {
@@ -872,10 +1039,10 @@ declare module "lineadraw" {
           version?: string;
       }): Promise<Uint8Array>;
       /** The `.linea` file text. */
-      toJson(): string;
+      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;
@@ -897,7 +1064,7 @@ declare module "lineadraw" {
       /** count TOTAL copies at multiples of delta; returns the new ids. */
       array(ids: readonly string[], count: number, delta: Vec2Like): string[];
       /** Create a paper layout; returns its id. */
-      createLayout(name: string, opts?: LayoutSpec): string;
+      addLayout(name: string, opts?: LayoutSpec): string;
       /** Patch a layout's name / sheet / print palette. A bare preset keeps the
        * layout's current orientation. */
       updateLayout(nameOrId: string, patch: {
@@ -919,20 +1086,108 @@ declare module "lineadraw" {
       /** Explicit total order (names or ids, every layer exactly once). */
       reorderLayers(order: readonly string[]): void;
       setCurrentLayer(nameOrId: string): void;
-      /** Patch a document dimension style (default: the first). */
+      /** 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;
+      } & Record<string, unknown>)[];
+      listDimStyles(): ({
+          id: string;
+          name: string;
+      } & Record<string, unknown>)[];
+      /** Create a style (unique name; unset fields take the defaults); returns
+       * its id. Styles are addressed by name or id. */
+      addTextStyle(props: {
+          name: string;
+      } & Record<string, unknown>): string;
+      updateTextStyle(nameOrId: string, patch: Record<string, unknown>): void;
+      /** Remove a style no object uses (refused otherwise). */
+      removeTextStyle(nameOrId: string): void;
+      addDimStyle(props: {
+          name: string;
+      } & Record<string, unknown>): string;
+      updateDimStyle(nameOrId: string, patch: Record<string, unknown>): void;
+      removeDimStyle(nameOrId: string): void;
+      /** @deprecated Use updateDimStyle (default here: the first style). */
       setDimStyle(patch: Record<string, unknown>, styleId?: string): void;
-      /** Patch a document text style (default: the first). */
+      /** @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;
       /** Remove an asset (refused while an image references it). */
       removeAsset(id: string): void;
+      /** Embedded image assets and how many images use each. */
+      listAssets(): {
+          id: string;
+          mimeType: string;
+          bytes: number;
+          users: number;
+      }[];
+      /** Merge DXF text (new layers, objects, layouts); `unitOverride` = mm
+       * per drawing unit. */
+      importDxfText(text: string, opts?: {
+          unitOverride?: number;
+      }): ImportReport & {
+          layers: number;
+          layouts: number;
+          layoutIds: string[];
+      };
+      /** Merge DWG bytes (transcoded to DXF). */
+      importDwgData(data: Uint8Array, opts?: {
+          unitOverride?: number;
+      }): Promise<ImportReport & {
+          layers: number;
+          layouts: number;
+          layoutIds: string[];
+      }>;
+      /** Merge a PDF: vectors/text onto the current layer, or (`as: "image"`,
+       * not available on every host) each page as an image at true scale. */
+      importPdfData(data: ArrayBuffer | Uint8Array, opts?: {
+          as?: "vectors" | "image";
+          origin?: Vec2Like;
+      }): Promise<ImportReport & {
+          pageCount: number;
+      }>;
       /** Merge block module sources into the document library. */
-      installBlocks(sources: readonly string[]): Promise<MergeReport>;
-      removeBlock(id: string): void;
-      installCommands(sources: readonly string[]): Promise<MergeReport>;
-      removeCommand(id: string): void;
+      addBlockDefinitions(sources: readonly string[]): Promise<MergeReport>;
+      removeBlockDefinition(id: string): void;
+      addUserCommands(sources: readonly string[]): Promise<MergeReport>;
+      removeUserCommand(id: string): void;
       /** Escape hatch: apply an already-shaped kernel op batch (validated,
        * atomic, one undo step). */
       applyOps(ops: readonly Record<string, unknown>[]): void;
@@ -977,7 +1232,14 @@ declare module "lineadraw" {
           layout: string;
       }): void;
       setSelection(ids: readonly string[]): void;
-      zoom(to: "fit" | "selection"): void;
+      /** "fit" (everything in the active space), "selection", some objects'
+       * extents (`{ ids }`), or a window (`{ bbox }`, world mm; sheet mm in a
+       * layout). */
+      zoom(to: "fit" | "selection" | {
+          ids: readonly string[];
+      } | {
+          bbox: Box;
+      }): void;
       /** Await one snapped world point; `referencePoint` enables rubber-band
        * + relative typed entry from there. */
       pickPoint(opts?: {
@@ -1282,7 +1544,7 @@ declare module "lineadraw" {
    *     inputs: ["Anchor"],
    *     params: [{ name: "start", label: "First number", type: "number", default: 1 }],
    *     run: ({ document, editor, inputs: [anchor], params: { start } }) => {
-   *       const texts = document.query({
+   *       const texts = document.listObjects({
    *         type: "text",
    *         near: { point: anchor, tol: 500 },
    *       });
@@ -1367,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. */
@@ -1375,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
@@ -1431,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;
@@ -1445,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
@@ -1460,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;
@@ -1479,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;
@@ -1511,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;
@@ -1546,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;
@@ -1611,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;
@@ -1635,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;
@@ -1659,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?: {
@@ -1737,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;
@@ -1773,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;
@@ -1966,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;
@@ -1999,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;
@@ -2009,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). */
@@ -2088,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[];
@@ -2121,7 +2530,12 @@ type SheetSpec = "A4" | "A3" | "A2" | "A1" | "A0" | {
     width: number;
     height: number;
 };
-/** Options for Drawing.createLayout. */
+/** What an import added (`objectIds` = the new objects). */
+interface ImportReport {
+    objects: number;
+    objectIds: string[];
+}
+/** Options for Drawing.addLayout. */
 type LayoutSpec = {
     /** Default: A3 landscape. */
     sheet?: SheetSpec;
@@ -2188,9 +2602,12 @@ interface Drawing {
             name: string;
             objectCount: number;
         }[];
+        settings: {
+            units: "mm" | "in";
+        };
     };
     /** Filtered objects — model space, or one layout via `filter.layout`. */
-    query(filter?: ObjectQuery): ExistingObject[];
+    listObjects(filter?: ObjectQuery): ExistingObject[];
     /** One object from ANY space, or undefined. */
     getObject(id: string): ExistingObject | undefined;
     /** bbox / curve length / enclosed area of one object. */
@@ -2198,9 +2615,9 @@ interface Drawing {
     listLayers(): LayerInfo[];
     listLayouts(): LayoutInfo[];
     /** Compilable block definitions in this document. */
-    listBlocks(): BlockInfo[];
+    listBlockDefinitions(): BlockInfo[];
     /** Compilable command modules travelling with this document. */
-    listCommands(): CommandInfo[];
+    listUserCommands(): CommandInfo[];
     /** Model space (or a layout via `layout`) as an SVG string. */
     renderSvg(opts?: {
         layout?: string;
@@ -2208,6 +2625,18 @@ interface Drawing {
         padding?: number;
         palette?: "color" | "grayscale" | "monochrome";
     }): string;
+    /** Model space (or a layout) as PNG bytes — absent on hosts that can't
+     * rasterize, so check before calling. */
+    renderPng?(opts?: {
+        layout?: string;
+        bbox?: Box;
+        padding?: number;
+        palette?: "color" | "grayscale" | "monochrome";
+        /** Output width in px (height follows). Default 1024. */
+        width?: number;
+        /** Background fill, e.g. "#ffffff". Default: the dark canvas. */
+        background?: string;
+    }): Promise<Uint8Array>;
     /** Multi-page PDF of the layouts (default: all) — absent on hosts
      * without fonts, so check before calling. */
     renderPdf?(opts?: {
@@ -2221,10 +2650,10 @@ interface Drawing {
         version?: string;
     }): Promise<Uint8Array>;
     /** The `.linea` file text. */
-    toJson(): string;
+    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;
@@ -2246,7 +2675,7 @@ interface Drawing {
     /** count TOTAL copies at multiples of delta; returns the new ids. */
     array(ids: readonly string[], count: number, delta: Vec2Like): string[];
     /** Create a paper layout; returns its id. */
-    createLayout(name: string, opts?: LayoutSpec): string;
+    addLayout(name: string, opts?: LayoutSpec): string;
     /** Patch a layout's name / sheet / print palette. A bare preset keeps the
      * layout's current orientation. */
     updateLayout(nameOrId: string, patch: {
@@ -2268,20 +2697,108 @@ interface Drawing {
     /** Explicit total order (names or ids, every layer exactly once). */
     reorderLayers(order: readonly string[]): void;
     setCurrentLayer(nameOrId: string): void;
-    /** Patch a document dimension style (default: the first). */
+    /** 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;
+    } & Record<string, unknown>)[];
+    listDimStyles(): ({
+        id: string;
+        name: string;
+    } & Record<string, unknown>)[];
+    /** Create a style (unique name; unset fields take the defaults); returns
+     * its id. Styles are addressed by name or id. */
+    addTextStyle(props: {
+        name: string;
+    } & Record<string, unknown>): string;
+    updateTextStyle(nameOrId: string, patch: Record<string, unknown>): void;
+    /** Remove a style no object uses (refused otherwise). */
+    removeTextStyle(nameOrId: string): void;
+    addDimStyle(props: {
+        name: string;
+    } & Record<string, unknown>): string;
+    updateDimStyle(nameOrId: string, patch: Record<string, unknown>): void;
+    removeDimStyle(nameOrId: string): void;
+    /** @deprecated Use updateDimStyle (default here: the first style). */
     setDimStyle(patch: Record<string, unknown>, styleId?: string): void;
-    /** Patch a document text style (default: the first). */
+    /** @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;
     /** Remove an asset (refused while an image references it). */
     removeAsset(id: string): void;
+    /** Embedded image assets and how many images use each. */
+    listAssets(): {
+        id: string;
+        mimeType: string;
+        bytes: number;
+        users: number;
+    }[];
+    /** Merge DXF text (new layers, objects, layouts); `unitOverride` = mm
+     * per drawing unit. */
+    importDxfText(text: string, opts?: {
+        unitOverride?: number;
+    }): ImportReport & {
+        layers: number;
+        layouts: number;
+        layoutIds: string[];
+    };
+    /** Merge DWG bytes (transcoded to DXF). */
+    importDwgData(data: Uint8Array, opts?: {
+        unitOverride?: number;
+    }): Promise<ImportReport & {
+        layers: number;
+        layouts: number;
+        layoutIds: string[];
+    }>;
+    /** Merge a PDF: vectors/text onto the current layer, or (`as: "image"`,
+     * not available on every host) each page as an image at true scale. */
+    importPdfData(data: ArrayBuffer | Uint8Array, opts?: {
+        as?: "vectors" | "image";
+        origin?: Vec2Like;
+    }): Promise<ImportReport & {
+        pageCount: number;
+    }>;
     /** Merge block module sources into the document library. */
-    installBlocks(sources: readonly string[]): Promise<MergeReport>;
-    removeBlock(id: string): void;
-    installCommands(sources: readonly string[]): Promise<MergeReport>;
-    removeCommand(id: string): void;
+    addBlockDefinitions(sources: readonly string[]): Promise<MergeReport>;
+    removeBlockDefinition(id: string): void;
+    addUserCommands(sources: readonly string[]): Promise<MergeReport>;
+    removeUserCommand(id: string): void;
     /** Escape hatch: apply an already-shaped kernel op batch (validated,
      * atomic, one undo step). */
     applyOps(ops: readonly Record<string, unknown>[]): void;
@@ -2326,7 +2843,14 @@ interface EditorSurface {
         layout: string;
     }): void;
     setSelection(ids: readonly string[]): void;
-    zoom(to: "fit" | "selection"): void;
+    /** "fit" (everything in the active space), "selection", some objects'
+     * extents (`{ ids }`), or a window (`{ bbox }`, world mm; sheet mm in a
+     * layout). */
+    zoom(to: "fit" | "selection" | {
+        ids: readonly string[];
+    } | {
+        bbox: Box;
+    }): void;
     /** Await one snapped world point; `referencePoint` enables rubber-band
      * + relative typed entry from there. */
     pickPoint(opts?: {