@snaptrude/plugin-core 0.0.0-dev-20260708130115 → 0.0.0-dev-20260827135706

package/dist/api/design/query/index.d.ts

@@ -3,6 +3,7 @@ import { PluginApiReturn } from "../../../types";
 import { ComponentHandle, BBoxComponents } from "../../../handles";
 import { PluginDesignQueryGeometryApi } from "./geometry";
 import { PluginDesignQuerySpacesApi } from "./spaces";
+import { PluginDesignQueryReferenceLinesApi } from "./referenceLines";
 /**
  * The kind of a BIM entity — the discovery/filter vocabulary for the whole
  * `design.query.*` surface. Values are clean `lowerCamel` tokens; the host maps
@@ -34,15 +35,15 @@ export declare const PluginEntityType: z.ZodEnum<{
     floor: "floor";
     wall: "wall";
     ceiling: "ceiling";
-    space: "space";
     door: "door";
     window: "window";
+    furniture: "furniture";
+    space: "space";
     slab: "slab";
     roof: "roof";
     column: "column";
     beam: "beam";
     staircase: "staircase";
-    furniture: "furniture";
     referenceLine: "referenceLine";
     curtainWall: "curtainWall";
     mullion: "mullion";
@@ -80,15 +81,15 @@ export declare const PluginEntityFilter: z.ZodObject<{
         floor: "floor";
         wall: "wall";
         ceiling: "ceiling";
-        space: "space";
         door: "door";
         window: "window";
+        furniture: "furniture";
+        space: "space";
         slab: "slab";
         roof: "roof";
         column: "column";
         beam: "beam";
         staircase: "staircase";
-        furniture: "furniture";
         referenceLine: "referenceLine";
         curtainWall: "curtainWall";
         mullion: "mullion";
@@ -159,15 +160,15 @@ export declare const PluginDesignQueryListByTypeArgs: z.ZodObject<{
         floor: "floor";
         wall: "wall";
         ceiling: "ceiling";
-        space: "space";
         door: "door";
         window: "window";
+        furniture: "furniture";
+        space: "space";
         slab: "slab";
         roof: "roof";
         column: "column";
         beam: "beam";
         staircase: "staircase";
-        furniture: "furniture";
         referenceLine: "referenceLine";
         curtainWall: "curtainWall";
         mullion: "mullion";
@@ -231,15 +232,15 @@ export declare const PluginDesignQueryListByTypeArgs: z.ZodObject<{
         floor: "floor";
         wall: "wall";
         ceiling: "ceiling";
-        space: "space";
         door: "door";
         window: "window";
+        furniture: "furniture";
+        space: "space";
         slab: "slab";
         roof: "roof";
         column: "column";
         beam: "beam";
         staircase: "staircase";
-        furniture: "furniture";
         referenceLine: "referenceLine";
         curtainWall: "curtainWall";
         mullion: "mullion";
@@ -280,6 +281,7 @@ export type PluginDesignQueryComponentsArgs = z.infer<typeof PluginDesignQueryCo
  * | `spaceType` | {@linkcode PluginSpaceType} | Space-type (spaces only) |
  * | `areaClass` | {@linkcode PluginAreaClass} | Area classification (spaces only) |
  * | `departmentId` | `string` | Department (masses only) |
+ * | `buildingType` | `string` | Assigned building type NAME (walls / slabs / floors / roofs / ceilings only) — the Object Properties panel's Wall/Slab/Floor/Roof/Ceiling Type dropdown value, matching the names from `design.types.list(kind)` |
  * | `isLocked` | `boolean` | Lock flag |
  * | `isHidden` | `boolean` | User-hidden flag |
  * | `isSelected` | `boolean` | Current selection state |
@@ -293,15 +295,15 @@ export declare const PluginEntityProperties: z.ZodObject<{
         floor: "floor";
         wall: "wall";
         ceiling: "ceiling";
-        space: "space";
         door: "door";
         window: "window";
+        furniture: "furniture";
+        space: "space";
         slab: "slab";
         roof: "roof";
         column: "column";
         beam: "beam";
         staircase: "staircase";
-        furniture: "furniture";
         referenceLine: "referenceLine";
         curtainWall: "curtainWall";
         mullion: "mullion";
@@ -330,6 +332,7 @@ export declare const PluginEntityProperties: z.ZodObject<{
         EXCLUDED: "EXCLUDED";
     }>>;
     departmentId: z.ZodOptional<z.ZodString>;
+    buildingType: z.ZodOptional<z.ZodString>;
     isLocked: z.ZodOptional<z.ZodBoolean>;
     isHidden: z.ZodOptional<z.ZodBoolean>;
     isSelected: z.ZodOptional<z.ZodBoolean>;
@@ -357,17 +360,28 @@ export type PluginEntityProperties = z.infer<typeof PluginEntityProperties>;
  * entity's type computes them (area: floors/masses/slabs/roofs/beams/columns;
  * volume: all; length: walls/beams).
  *
+ * `thickness` and `height` are the Object Properties panel's dimension reads
+ * (the same engine source `design.update.wall` / `design.update.slab` etc.
+ * write through), in engine units. `thickness`: walls (the plan thickness —
+ * present only for straight orthogonal walls, exactly when the panel shows it)
+ * and slabs/floors/roofs/ceilings (the vertical extent the panel calls
+ * Thickness). `height`: walls only.
+ *
  * | Property | Type | Description |
  * |---|---|---|
  * | `area` | `number`? | Bottom-face area |
  * | `volume` | `number`? | Solid volume |
  * | `length` | `number`? | Running length (linear elements) |
+ * | `thickness` | `number`? | Panel Thickness — walls (straight orthogonal only) and the slab family |
+ * | `height` | `number`? | Panel Height — walls only |
  * | `boundingBox` | {@linkcode BBoxComponents} | World-space AABB (always present) |
  */
 export declare const PluginEntityMeasurements: z.ZodObject<{
     area: z.ZodOptional<z.ZodNumber>;
     volume: z.ZodOptional<z.ZodNumber>;
     length: z.ZodOptional<z.ZodNumber>;
+    thickness: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
     boundingBox: z.ZodObject<{
         min: z.ZodObject<{
             x: z.ZodNumber;
@@ -382,6 +396,89 @@ export declare const PluginEntityMeasurements: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type PluginEntityMeasurements = z.infer<typeof PluginEntityMeasurements>;
+/**
+ * The parametric properties of a staircase — the same editable fields the
+ * staircase properties panel exposes. Returned by
+ * {@linkcode PluginDesignQueryApi.getStaircaseParams}; the write side is
+ * `design.update.staircase`. Engine internals (block schema, min well size,
+ * square-well padding) are deliberately excluded.
+ *
+ * All dimensions are in **engine units** (the same convention as
+ * `design.doors.getWidth`); `steps` is a unitless count. The invariant
+ * `staircaseHeight = steps × riser` is governed by the two lock booleans — see
+ * `design.update.staircase`. Type-specific fields (`wellSize`, `landingWidth`,
+ * `flightStartDistAfterTurn`) are present only when the preset uses them.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `staircaseType` | {@linkcode PluginStaircasePreset} | Base staircase type |
+ * | `staircasePreset` | {@linkcode PluginStaircasePreset} | Named parametric preset |
+ * | `staircaseHeight` | `number` | Total rise (engine units) |
+ * | `steps` | `number` | Step count (unitless) |
+ * | `riser` | `number` | Riser height (engine units) |
+ * | `tread` | `number` | Tread depth (engine units) |
+ * | `width` | `number` | Flight width (engine units) |
+ * | `depth` | `number` | Slab/waist thickness (engine units) |
+ * | `wellSize` | `number`? | Stairwell gap (dogLegged / openWell / square) |
+ * | `landingWidth` | `number`? | Landing depth (straight / dogLegged) |
+ * | `flightStartDistAfterTurn` | `number`? | Flight offset after a turn (dogLegged / lShaped / square) |
+ * | `baseOffset` | `number` | Vertical offset from the storey base (engine units) |
+ * | `isStoreyHeightUnlocked` | `boolean` | When `false`, height is tied to the storey height |
+ * | `isStaircaseHeightUnlocked` | `boolean` | When `false`, height recomputes from steps × riser |
+ * | `storey` | `number` | Storey/floor level the staircase sits on |
+ */
+export declare const PluginStaircaseParams: z.ZodObject<{
+    staircaseType: z.ZodEnum<{
+        custom: "custom";
+        straight: "straight";
+        straightWoLanding: "straightWoLanding";
+        straightFlightWoMidLanding: "straightFlightWoMidLanding";
+        dogLegged: "dogLegged";
+        openWell: "openWell";
+        lShaped: "lShaped";
+        "3StepLShaped": "3StepLShaped";
+        square: "square";
+        singleStep: "singleStep";
+        plinthLevel: "plinthLevel";
+        amphitheatre: "amphitheatre";
+        connectingStepsToAmphitheatre: "connectingStepsToAmphitheatre";
+        mezzanineFloorStraight: "mezzanineFloorStraight";
+        mezzanineFloorDogLegged: "mezzanineFloorDogLegged";
+        mezzanineFloorLShaped: "mezzanineFloorLShaped";
+    }>;
+    staircasePreset: z.ZodEnum<{
+        custom: "custom";
+        straight: "straight";
+        straightWoLanding: "straightWoLanding";
+        straightFlightWoMidLanding: "straightFlightWoMidLanding";
+        dogLegged: "dogLegged";
+        openWell: "openWell";
+        lShaped: "lShaped";
+        "3StepLShaped": "3StepLShaped";
+        square: "square";
+        singleStep: "singleStep";
+        plinthLevel: "plinthLevel";
+        amphitheatre: "amphitheatre";
+        connectingStepsToAmphitheatre: "connectingStepsToAmphitheatre";
+        mezzanineFloorStraight: "mezzanineFloorStraight";
+        mezzanineFloorDogLegged: "mezzanineFloorDogLegged";
+        mezzanineFloorLShaped: "mezzanineFloorLShaped";
+    }>;
+    staircaseHeight: z.ZodNumber;
+    steps: z.ZodNumber;
+    riser: z.ZodNumber;
+    tread: z.ZodNumber;
+    width: z.ZodNumber;
+    depth: z.ZodNumber;
+    wellSize: z.ZodOptional<z.ZodNumber>;
+    landingWidth: z.ZodOptional<z.ZodNumber>;
+    flightStartDistAfterTurn: z.ZodOptional<z.ZodNumber>;
+    baseOffset: z.ZodNumber;
+    isStoreyHeightUnlocked: z.ZodBoolean;
+    isStaircaseHeightUnlocked: z.ZodBoolean;
+    storey: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginStaircaseParams = z.infer<typeof PluginStaircaseParams>;
 /**
  * `design.query.*` — read-only enumeration + inspection of scene-committed BIM
  * entities (all-handle model, §11). No query mutates the scene.
@@ -400,6 +497,8 @@ export declare abstract class PluginDesignQueryApi {
     abstract geometry: PluginDesignQueryGeometryApi;
     /** Space-specific reads (footprint, …). See {@linkcode PluginDesignQuerySpacesApi}. */
     abstract spaces: PluginDesignQuerySpacesApi;
+    /** Reference-line-specific reads. See {@linkcode PluginDesignQueryReferenceLinesApi}. */
+    abstract referenceLines: PluginDesignQueryReferenceLinesApi;
     constructor();
     /**
      * List **all** BIM entities in the project matching the filter.
@@ -928,13 +1027,16 @@ export declare abstract class PluginDesignQueryApi {
      * Read an entity's common properties as a {@linkcode PluginEntityProperties}
      * record (only applicable fields are present). For spaces/masses this includes
      * `adjacency` — the per-entity adjacency read (bulk form:
-     * `program.adjacency.getMatrix`).
+     * `program.adjacency.getMatrix`). For walls and the slab family (slab / floor
+     * / roof / ceiling) this includes `buildingType` — the assigned building type
+     * NAME the panel's type dropdown shows, matching `design.types.list(kind)`.
      *
      * @param component - the entity's {@linkcode ComponentHandle}
      * @returns the property record
      *
      * @examplePrompt Show me all the details of the selected object
      * @examplePrompt What storey is this wall on?
+     * @examplePrompt Which wall type is assigned to this wall?
      * @examplePrompt Which department does this room belong to?
      * @examplePrompt Is this element locked or hidden?
      * @examplePrompt Get the adjacencies of this space
@@ -961,11 +1063,20 @@ export declare abstract class PluginDesignQueryApi {
      * Measure an entity — read its area, volume, and/or running length (whichever
      * its type supports) together with its world-space bounding box in one call.
      *
+     * For walls and the slab family this also carries the Object Properties
+     * panel's dimension reads in engine units: `thickness` (walls — straight
+     * orthogonal only, exactly when the panel shows it; slabs / floors / roofs /
+     * ceilings — the vertical extent the panel calls Thickness) and `height`
+     * (walls). These are the read side of `design.update.wall` /
+     * `design.update.slab` / `.floor` / `.roof` / `.ceiling`.
+     *
      * @param component - the entity's {@linkcode ComponentHandle}
      * @returns a {@linkcode PluginEntityMeasurements}, or `null` if the entity is gone
      *
      * @examplePrompt What's the area of this room?
      * @examplePrompt How long is the selected wall?
+     * @examplePrompt How thick is this wall?
+     * @examplePrompt Get the thickness of the slab on level 2
      * @examplePrompt Get the volume of this mass
      * @examplePrompt Give me the dimensions of the selected element
      * @examplePrompt What's the floor area of the kitchen?
@@ -975,9 +1086,41 @@ export declare abstract class PluginDesignQueryApi {
      * const [space] = await snaptrude.design.query.listSpaces()
      * const m = await snaptrude.design.query.measure(space)
      * console.log(m?.area, m?.volume)
+     *
+     * // wall dimensions — the panel's Thickness / Height, in engine units
+     * const [wall] = await snaptrude.design.query.listWalls()
+     * const wm = await snaptrude.design.query.measure(wall)
+     * console.log(wm?.thickness, wm?.height)
      * ```
      */
     abstract measure(component: ComponentHandle): PluginApiReturn<PluginEntityMeasurements | null>;
+    /**
+     * Read a staircase's parametric properties — its preset, dimensions, step
+     * count, base offset, and height-lock state — as a
+     * {@linkcode PluginStaircaseParams} record. The paired write is
+     * `design.update.staircase`.
+     *
+     * All dimensions are in **engine units** (the same convention as
+     * `design.doors.getWidth`); `steps` is a unitless count. A read — never
+     * throws: returns `null` for a handle that is not a staircase or no longer
+     * resolves.
+     *
+     * @param staircase - the staircase's {@linkcode ComponentHandle}
+     * @returns the {@linkcode PluginStaircaseParams} record, or `null`
+     *
+     * @examplePrompt What's the riser height of this staircase?
+     * @examplePrompt How many steps does the selected stair have?
+     * @examplePrompt Show me the tread and width of this staircase
+     * @examplePrompt Read all the parameters of the stairs on level 1
+     *
+     * # Example
+     * ```ts
+     * const [stair] = await snaptrude.design.query.listStaircases({ isSelected: true })
+     * const params = stair ? await snaptrude.design.query.getStaircaseParams(stair) : null
+     * if (params) console.log(params.steps, params.riser, params.tread)
+     * ```
+     */
+    abstract getStaircaseParams(staircase: ComponentHandle): PluginApiReturn<PluginStaircaseParams | null>;
     /**
      * Get the **union** axis-aligned bounding box enclosing a set of entities.
      *
@@ -1005,7 +1148,135 @@ export declare abstract class PluginDesignQueryApi {
      * ```
      */
     abstract getBoundingBox(components: ComponentHandle[]): PluginApiReturn<BBoxComponents | null>;
+    /**
+     * Compute the plan **outline of what is built on a storey** — the union of
+     * the storey's wall (by default) footprints as polygons-with-holes. This is
+     * the footprint-from-the-built-model query: by the time slabs are needed the
+     * walls exist, and the engine's own solids (snapped, joined and mitred at
+     * creation) are the cleanest wall network available — no CAD re-tracing.
+     *
+     * Semantics: the union of wall solids is the wall *material* — a ring-shaped
+     * polygon. The **outer ring is the OUTSIDE wall face** (the slab boundary);
+     * every enclosed region — rooms AND courtyards — appears as a hole. When the
+     * largest hole is ~zero the walls don't enclose anything: the footprint
+     * reports `enclosed: false` (an open wall network), never a garbage outline.
+     * Detached buildings come back as separate footprints.
+     *
+     * A read — nothing is created. Feed a footprint's `outline` to
+     * `core.geom.create.profileFromLinePoints` → `design.create.slab` to build
+     * the floor/roof plate. Coordinates are world-space plan (x, z) in Snaptrude
+     * internal units; `areaSq` values are in squared internal units.
+     *
+     * @param options - storey / included kinds / debris filter; see
+     *   {@linkcode PluginStoreyOutlineOptions}.
+     * @returns the storey's footprints (possibly several for detached buildings)
+     *   plus pieces discarded by `minArea` (`footprints: []` when nothing matches).
+     *
+     * @examplePrompt What is the building footprint on the ground floor?
+     * @examplePrompt Create a floor slab covering the whole storey
+     * @examplePrompt Get the outline of the walls on storey 1
+     * @examplePrompt How much area do the ground-floor walls enclose?
+     *
+     * # Example
+     * ```ts
+     * const r = await snaptrude.design.query.storeyOutline({ storey: 1 })
+     * const main = r.footprints.find((f) => f.enclosed)
+     * if (main) {
+     *   const profile = await snaptrude.core.geom.create.profileFromLinePoints(
+     *     main.outline.map((p) => ({ x: p.x, y: 0, z: p.z })),
+     *   )
+     *   // → design.create.slab with the profile's contour
+     * }
+     * ```
+     */
+    abstract storeyOutline(options?: PluginStoreyOutlineOptions): PluginApiReturn<PluginStoreyOutlineResult>;
 }
+/** A point in the world-space plan (x, z) projection, Snaptrude internal units. */
+export declare const PluginOutlinePlanPoint: z.ZodObject<{
+    x: z.ZodNumber;
+    z: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginOutlinePlanPoint = z.infer<typeof PluginOutlinePlanPoint>;
+/**
+ * Options for {@link PluginDesignQueryApi.storeyOutline}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `storey` | `number`? | Only components on this storey (default: all storeys) |
+ * | `include` | {@link PluginEntityType}`[]`? | Component kinds to union (default `["wall"]`) |
+ * | `minArea` | `number`? | Drop union pieces below this plan area, squared internal units (default `1`) |
+ */
+export declare const PluginStoreyOutlineOptions: z.ZodObject<{
+    storey: z.ZodOptional<z.ZodNumber>;
+    include: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        mass: "mass";
+        floor: "floor";
+        wall: "wall";
+        ceiling: "ceiling";
+        door: "door";
+        window: "window";
+        furniture: "furniture";
+        space: "space";
+        slab: "slab";
+        roof: "roof";
+        column: "column";
+        beam: "beam";
+        staircase: "staircase";
+        referenceLine: "referenceLine";
+        curtainWall: "curtainWall";
+        mullion: "mullion";
+        panel: "panel";
+    }>>>;
+    minArea: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type PluginStoreyOutlineOptions = z.input<typeof PluginStoreyOutlineOptions>;
+/**
+ * One connected footprint from {@link PluginDesignQueryApi.storeyOutline}.
+ * `outline` traces the OUTSIDE wall face; `holes` are the enclosed regions
+ * (rooms and courtyards). `enclosed` is `false` when the wall network does not
+ * close around any region (open C-shape) — don't slab an unenclosed outline
+ * without checking it.
+ */
+export declare const PluginStoreyFootprint: z.ZodObject<{
+    outline: z.ZodArray<z.ZodObject<{
+        x: z.ZodNumber;
+        z: z.ZodNumber;
+    }, z.core.$strip>>;
+    holes: z.ZodArray<z.ZodObject<{
+        ring: z.ZodArray<z.ZodObject<{
+            x: z.ZodNumber;
+            z: z.ZodNumber;
+        }, z.core.$strip>>;
+        areaSq: z.ZodNumber;
+    }, z.core.$strip>>;
+    areaSq: z.ZodNumber;
+    enclosed: z.ZodBoolean;
+}, z.core.$strip>;
+export type PluginStoreyFootprint = z.infer<typeof PluginStoreyFootprint>;
+/** Result of {@link PluginDesignQueryApi.storeyOutline}. */
+export declare const PluginStoreyOutlineResult: z.ZodObject<{
+    footprints: z.ZodArray<z.ZodObject<{
+        outline: z.ZodArray<z.ZodObject<{
+            x: z.ZodNumber;
+            z: z.ZodNumber;
+        }, z.core.$strip>>;
+        holes: z.ZodArray<z.ZodObject<{
+            ring: z.ZodArray<z.ZodObject<{
+                x: z.ZodNumber;
+                z: z.ZodNumber;
+            }, z.core.$strip>>;
+            areaSq: z.ZodNumber;
+        }, z.core.$strip>>;
+        areaSq: z.ZodNumber;
+        enclosed: z.ZodBoolean;
+    }, z.core.$strip>>;
+    discarded: z.ZodArray<z.ZodObject<{
+        areaSq: z.ZodNumber;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type PluginStoreyOutlineResult = z.infer<typeof PluginStoreyOutlineResult>;
 export * from "./geometry";
 export * from "./spaces";
+export * from "./referenceLines";
 //# sourceMappingURL=index.d.ts.map

package/dist/api/design/query/index.d.ts.map

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

package/dist/api/design/query/referenceLines.d.ts

@@ -0,0 +1,45 @@
+import * as z from "zod";
+import { PluginApiReturn } from "../../../types";
+import { PluginReferenceLineGetProperty, PluginReferenceLineGetResult } from "../../entity/referenceLine";
+/**
+ * `design.query.referenceLines.*` — reference-line-specific reads.
+ *
+ * A **reference line** is a 2D guide line (or arc) in the scene, typically used
+ * for grid lines and alignment guides. Enumerate reference lines with
+ * `design.query.listReferenceLines`; read an individual line's properties here.
+ * This is the canonical home of the read formerly at `entity.referenceLine.get`
+ * (now deprecated).
+ *
+ * Accessed via `snaptrude.design.query.referenceLines`.
+ */
+export declare abstract class PluginDesignQueryReferenceLinesApi {
+    constructor();
+    /**
+     * Get properties of a reference line by its ID.
+     *
+     * Only the properties listed in `properties` are returned — unlisted
+     * properties will be `undefined` in the result.
+     *
+     * @param referenceLineId - The unique reference line ID
+     * @param properties - Array of property names to retrieve. See
+     *   {@linkcode PluginReferenceLineGetProperty}.
+     * @returns A partial {@linkcode PluginReferenceLineGetResult} containing only the
+     *   requested properties
+     * @throws If the reference line does not exist
+     *
+     * @examplePrompt Get the curve geometry of this reference line
+     * @examplePrompt Where does this grid line run?
+     * @examplePrompt Read the geometry of a guide line by its id
+     * @examplePrompt Look up the curve of the selected reference line
+     *
+     * # Example
+     * ```ts
+     * const [refLine] = await snaptrude.design.query.listReferenceLines()
+     * const result = await snaptrude.design.query.referenceLines.get(refLine, ["curve"])
+     * // result.curve is an opaque CurveHandle; read its coordinates via
+     * // `snaptrude.core.geom.curve`.
+     * ```
+     */
+    abstract get(referenceLineId: string, properties: z.infer<typeof PluginReferenceLineGetProperty>[]): PluginApiReturn<PluginReferenceLineGetResult>;
+}
+//# sourceMappingURL=referenceLines.d.ts.map

package/dist/api/design/query/referenceLines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"referenceLines.d.ts","sourceRoot":"","sources":["../../../../src/api/design/query/referenceLines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC7B,MAAM,4BAA4B,CAAA;AAEnC;;;;;;;;;;GAUG;AACH,8BAAsB,kCAAkC;;IAGtD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;aACa,GAAG,CACjB,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,EAAE,GAC3D,eAAe,CAAC,4BAA4B,CAAC;CACjD"}