@mlightcad/cad-simple-viewer 1.4.12 → 1.5.0

package/lib/editor/view/AcEdSelectionAction.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Describes how a new selection result should be applied to the current
+ * selection set.
+ *
+ * - `'replace'`: clear the current selection set, then add the new ids.
+ * - `'add'`: keep the current selection set and append any new ids.
+ * - `'remove'`: remove matching ids from the current selection set.
+ *
+ * This type is used by the view layer to unify click selection, box
+ * selection, and command-driven selection behavior.
+ */
+export type AcEdSelectionAction = 'replace' | 'add' | 'remove';
+/**
+ * Minimal modifier-key snapshot needed to resolve selection behavior from a
+ * mouse or pointer event.
+ *
+ * The full DOM {@link MouseEvent} object is intentionally not required here so
+ * the resolver can stay lightweight, reusable, and easy to test in isolation.
+ */
+export interface AcEdSelectionModifierState {
+    /**
+     * Whether the Shift key was pressed when the selection event occurred.
+     *
+     * In this viewer, Shift has the highest priority and maps to
+     * {@link AcEdSelectionAction | `'remove'`}.
+     */
+    shiftKey: boolean;
+    /**
+     * Whether the Control key was pressed when the selection event occurred.
+     *
+     * When `true` and {@link shiftKey} is `false`, the selection resolves to
+     * {@link AcEdSelectionAction | `'add'`}.
+     */
+    ctrlKey: boolean;
+    /**
+     * Whether the Meta/Command key was pressed when the selection event
+     * occurred.
+     *
+     * This provides macOS-friendly additive selection behavior equivalent to
+     * {@link ctrlKey}.
+     */
+    metaKey: boolean;
+}
+/**
+ * Resolves the selection action implied by the current modifier-key state.
+ *
+ * Precedence is evaluated in the following order:
+ * 1. `Shift` returns `'remove'`.
+ * 2. `Ctrl` or `Meta` returns `'add'`.
+ * 3. If no modifier is active, `defaultAction` is returned.
+ *
+ * This lets different call sites share the same modifier semantics while still
+ * choosing their own non-modified default, such as `'replace'` for generic
+ * selection flows or `'add'` for pointer interactions that should preserve the
+ * existing selection set.
+ *
+ * @param e - Modifier-key state captured from the triggering input event.
+ * @param defaultAction - Action to use when no supported modifier key is
+ * active. Defaults to `'replace'`.
+ * @returns The normalized selection action to apply.
+ *
+ * @example
+ * ```ts
+ * resolveSelectionActionFromEvent(
+ *   { shiftKey: false, ctrlKey: false, metaKey: false },
+ *   'replace'
+ * )
+ * // => 'replace'
+ * ```
+ *
+ * @example
+ * ```ts
+ * resolveSelectionActionFromEvent({
+ *   shiftKey: true,
+ *   ctrlKey: false,
+ *   metaKey: false
+ * })
+ * // => 'remove'
+ * ```
+ */
+export declare function resolveSelectionActionFromEvent(e: AcEdSelectionModifierState, defaultAction?: AcEdSelectionAction): AcEdSelectionAction;
+/**
+ * Resolves the default action for direct pointer-based selection in the 2D
+ * viewer.
+ *
+ * Unlike the generic resolver, pointer selection without modifiers defaults to
+ * `'add'` so repeated clicks or drag selections preserve the existing
+ * selection set instead of replacing it.
+ *
+ * Modifier precedence remains the same as
+ * {@link resolveSelectionActionFromEvent}:
+ * `Shift` removes, while `Ctrl`/`Meta` adds.
+ *
+ * @param e - Modifier-key state captured from the pointer event.
+ * @returns The selection action that should be used for pointer selection.
+ *
+ * @example
+ * ```ts
+ * resolvePointerSelectionAction({
+ *   shiftKey: false,
+ *   ctrlKey: false,
+ *   metaKey: false
+ * })
+ * // => 'add'
+ * ```
+ */
+export declare function resolvePointerSelectionAction(e: AcEdSelectionModifierState): AcEdSelectionAction;
+//# sourceMappingURL=AcEdSelectionAction.d.ts.map

package/lib/editor/view/AcEdSelectionAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdSelectionAction.d.ts","sourceRoot":"","sources":["../../../src/editor/view/AcEdSelectionAction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAA;IAEjB;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAA;IAEhB;;;;;;OAMG;IACH,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,+BAA+B,CAC7C,CAAC,EAAE,0BAA0B,EAC7B,aAAa,GAAE,mBAA+B,GAC7C,mBAAmB,CAIrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,6BAA6B,CAC3C,CAAC,EAAE,0BAA0B,GAC5B,mBAAmB,CAErB"}

package/lib/editor/view/AcEdSelectionAction.js

@@ -0,0 +1,74 @@
+/**
+ * Resolves the selection action implied by the current modifier-key state.
+ *
+ * Precedence is evaluated in the following order:
+ * 1. `Shift` returns `'remove'`.
+ * 2. `Ctrl` or `Meta` returns `'add'`.
+ * 3. If no modifier is active, `defaultAction` is returned.
+ *
+ * This lets different call sites share the same modifier semantics while still
+ * choosing their own non-modified default, such as `'replace'` for generic
+ * selection flows or `'add'` for pointer interactions that should preserve the
+ * existing selection set.
+ *
+ * @param e - Modifier-key state captured from the triggering input event.
+ * @param defaultAction - Action to use when no supported modifier key is
+ * active. Defaults to `'replace'`.
+ * @returns The normalized selection action to apply.
+ *
+ * @example
+ * ```ts
+ * resolveSelectionActionFromEvent(
+ *   { shiftKey: false, ctrlKey: false, metaKey: false },
+ *   'replace'
+ * )
+ * // => 'replace'
+ * ```
+ *
+ * @example
+ * ```ts
+ * resolveSelectionActionFromEvent({
+ *   shiftKey: true,
+ *   ctrlKey: false,
+ *   metaKey: false
+ * })
+ * // => 'remove'
+ * ```
+ */
+export function resolveSelectionActionFromEvent(e, defaultAction) {
+    if (defaultAction === void 0) { defaultAction = 'replace'; }
+    if (e.shiftKey)
+        return 'remove';
+    if (e.ctrlKey || e.metaKey)
+        return 'add';
+    return defaultAction;
+}
+/**
+ * Resolves the default action for direct pointer-based selection in the 2D
+ * viewer.
+ *
+ * Unlike the generic resolver, pointer selection without modifiers defaults to
+ * `'add'` so repeated clicks or drag selections preserve the existing
+ * selection set instead of replacing it.
+ *
+ * Modifier precedence remains the same as
+ * {@link resolveSelectionActionFromEvent}:
+ * `Shift` removes, while `Ctrl`/`Meta` adds.
+ *
+ * @param e - Modifier-key state captured from the pointer event.
+ * @returns The selection action that should be used for pointer selection.
+ *
+ * @example
+ * ```ts
+ * resolvePointerSelectionAction({
+ *   shiftKey: false,
+ *   ctrlKey: false,
+ *   metaKey: false
+ * })
+ * // => 'add'
+ * ```
+ */
+export function resolvePointerSelectionAction(e) {
+    return resolveSelectionActionFromEvent(e, 'add');
+}
+//# sourceMappingURL=AcEdSelectionAction.js.map

package/lib/editor/view/AcEdSelectionAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdSelectionAction.js","sourceRoot":"","sources":["../../../src/editor/view/AcEdSelectionAction.ts"],"names":[],"mappings":"AA+CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,+BAA+B,CAC7C,CAA6B,EAC7B,aAA8C;IAA9C,8BAAA,EAAA,yBAA8C;IAE9C,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC/B,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IACxC,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,6BAA6B,CAC3C,CAA6B;IAE7B,OAAO,+BAA+B,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;AAClD,CAAC"}

package/lib/editor/view/index.d.ts

@@ -2,5 +2,6 @@ export * from './AcEdBaseView';
 export * from './AcEdHoverController';
 export * from './AcEdLayerInfo';
 export * from './AcEdOpenMode';
+export * from './AcEdSelectionAction';
 export * from './AcEdSpatialQueryResult';
 //# sourceMappingURL=index.d.ts.map

package/lib/editor/view/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/view/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/view/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA"}

package/lib/editor/view/index.js

@@ -2,5 +2,6 @@ export * from './AcEdBaseView';
 export * from './AcEdHoverController';
 export * from './AcEdLayerInfo';
 export * from './AcEdOpenMode';
+export * from './AcEdSelectionAction';
 export * from './AcEdSpatialQueryResult';
 //# sourceMappingURL=index.js.map

package/lib/editor/view/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/editor/view/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,0BAA0B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/editor/view/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,0BAA0B,CAAA"}

package/lib/i18n/en/command.d.ts

@@ -1,8 +1,17 @@
 declare const _default: {
     ACAD: {
+        '-hatch': {
+            description: string;
+        };
+        '-layer': {
+            description: string;
+        };
         arc: {
             description: string;
         };
+        cdxf: {
+            description: string;
+        };
         cecolor: {
             description: string;
         };
@@ -12,17 +21,27 @@ declare const _default: {
         celweight: {
             description: string;
         };
+        circle: {
+            description: string;
+        };
         clayer: {
             description: string;
         };
-        circle: {
+        cmleaderstyle: {
+            description: string;
+        };
+        cmlscale: {
+            description: string;
+        };
+        cmlstyle: {
             description: string;
         };
         colortheme: {
             description: string;
         };
-        cdxf: {
+        copy: {
             description: string;
+            prompt: string;
         };
         csvg: {
             description: string;
@@ -30,28 +49,125 @@ declare const _default: {
         dimlinear: {
             description: string;
         };
+        measurearea: {
+            description: string;
+        };
+        measureangle: {
+            description: string;
+        };
+        measurearc: {
+            description: string;
+        };
+        measuredistance: {
+            description: string;
+        };
+        measurementcolor: {
+            description: string;
+        };
+        ellipse: {
+            description: string;
+        };
         erase: {
             description: string;
             prompt: string;
         };
-        line: {
+        hatch: {
             description: string;
         };
-        lwdisplay: {
+        hpang: {
             description: string;
         };
-        pline: {
+        hpassoc: {
             description: string;
         };
-        spline: {
+        hpbackgroundcolor: {
             description: string;
         };
-        mtext: {
+        hpcolor: {
+            description: string;
+        };
+        hpdouble: {
+            description: string;
+        };
+        hpislanddetection: {
+            description: string;
+        };
+        hplayer: {
+            description: string;
+        };
+        hpname: {
+            description: string;
+        };
+        hpscale: {
+            description: string;
+        };
+        hpseparate: {
+            description: string;
+        };
+        hptransparency: {
+            description: string;
+        };
+        laycur: {
+            description: string;
+            prompt: string;
+        };
+        laydel: {
+            description: string;
+        };
+        layerclose: {
+            description: string;
+        };
+        layerp: {
+            description: string;
+        };
+        layfrz: {
+            description: string;
+            prompt: string;
+        };
+        layiso: {
+            description: string;
+            prompt: string;
+        };
+        laylck: {
+            description: string;
+            prompt: string;
+        };
+        layoff: {
+            description: string;
+            prompt: string;
+        };
+        layon: {
+            description: string;
+        };
+        laythw: {
+            description: string;
+        };
+        layulk: {
+            description: string;
+            prompt: string;
+        };
+        layuniso: {
+            description: string;
+        };
+        line: {
             description: string;
         };
         log: {
             description: string;
         };
+        lwdisplay: {
+            description: string;
+        };
+        mline: {
+            description: string;
+        };
+        move: {
+            description: string;
+            prompt: string;
+        };
+        mtext: {
+            description: string;
+        };
         open: {
             description: string;
         };
@@ -61,10 +177,25 @@ declare const _default: {
         pickbox: {
             description: string;
         };
+        pline: {
+            description: string;
+        };
+        pngout: {
+            description: string;
+        };
+        point: {
+            description: string;
+        };
+        polygon: {
+            description: string;
+        };
         qnew: {
             description: string;
         };
-        rectangle: {
+        ray: {
+            description: string;
+        };
+        rectang: {
             description: string;
         };
         regen: {
@@ -73,19 +204,26 @@ declare const _default: {
         revcloud: {
             description: string;
         };
+        rotate: {
+            description: string;
+            prompt: string;
+        };
         select: {
             description: string;
         };
         sketch: {
             description: string;
         };
+        spline: {
+            description: string;
+        };
         whitebkcolor: {
             description: string;
         };
-        zoom: {
+        xline: {
             description: string;
         };
-        zoomw: {
+        zoom: {
             description: string;
         };
     };

package/lib/i18n/en/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/i18n/en/command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAkGC"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/i18n/en/command.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBA4PC"}

package/lib/i18n/en/command.js

@@ -1,8 +1,17 @@
 export default {
     ACAD: {
+        '-hatch': {
+            description: 'Creates hatch fills through command-line options without the ribbon UI'
+        },
+        '-layer': {
+            description: 'Manages layers through command-line options'
+        },
         arc: {
             description: 'Creates an arc'
         },
+        cdxf: {
+            description: 'Exports current drawing to DXF'
+        },
         cecolor: {
             description: 'Sets the current default color for newly created objects'
         },
@@ -12,17 +21,27 @@ export default {
         celweight: {
             description: 'Sets the default lineweight for newly created objects'
         },
+        circle: {
+            description: 'Creates one circle by center and radius'
+        },
         clayer: {
             description: 'Sets the current layer for new objects and editing operations'
         },
-        circle: {
-            description: 'Creates one circle by center and radius'
+        cmleaderstyle: {
+            description: 'Sets the name of the current multileader style'
+        },
+        cmlscale: {
+            description: 'Controls the overall width of a multiline'
+        },
+        cmlstyle: {
+            description: 'Sets the name of the current multiline style'
         },
         colortheme: {
             description: 'Controls the color theme of the user interface (dark or light)'
         },
-        cdxf: {
-            description: 'Exports current drawing to DXF'
+        copy: {
+            description: 'Copies selected entities by cloning them to new positions',
+            prompt: 'Select entities'
         },
         csvg: {
             description: 'Converts current drawing to SVG'
@@ -30,28 +49,125 @@ export default {
         dimlinear: {
             description: 'Creates linear dimensions'
         },
+        measurearea: {
+            description: 'Calculates the area and perimeter of selected objects or points'
+        },
+        measureangle: {
+            description: 'Measures the angle between two lines or three points'
+        },
+        measurearc: {
+            description: 'Measures the length of an arc segment'
+        },
+        measuredistance: {
+            description: 'Measures the distance and delta values between two points'
+        },
+        measurementcolor: {
+            description: 'Sets the color used for measurement overlays'
+        },
+        ellipse: {
+            description: 'Creates an ellipse or elliptical arc by axis endpoints or center'
+        },
         erase: {
             description: 'Deletes selected entities from the drawing',
             prompt: 'Select entities'
         },
+        hatch: {
+            description: 'Fills an enclosed area or selected objects with a hatch pattern'
+        },
+        hpang: {
+            description: 'Sets the default angle, in radians, for newly created hatch patterns'
+        },
+        hpassoc: {
+            description: 'Controls whether newly created hatches are associative'
+        },
+        hpbackgroundcolor: {
+            description: 'Sets the default background color for newly created hatch patterns'
+        },
+        hpcolor: {
+            description: 'Sets the default color for newly created hatches'
+        },
+        hpdouble: {
+            description: 'Controls whether user-defined hatch patterns are doubled'
+        },
+        hpislanddetection: {
+            description: 'Controls how islands within newly created hatch boundaries are treated'
+        },
+        hplayer: {
+            description: 'Sets the default layer for newly created hatches and fills'
+        },
+        hpname: {
+            description: 'Sets the default pattern name for newly created hatches in this session'
+        },
+        hpscale: {
+            description: 'Sets the default scale factor for newly created hatch patterns'
+        },
+        hpseparate: {
+            description: 'Controls whether one or separate hatch objects are created for multiple boundaries'
+        },
+        hptransparency: {
+            description: 'Sets the default transparency for newly created hatches and fills'
+        },
+        laycur: {
+            description: 'Changes the layer property of selected objects to the current layer',
+            prompt: 'Select objects to be changed to the current layer'
+        },
+        laydel: {
+            description: 'Deletes a layer and all objects on that layer'
+        },
+        layerclose: {
+            description: 'Closes the Layer Properties Manager'
+        },
+        layerp: {
+            description: 'Undoes the last change or set of changes made to layer settings'
+        },
+        layfrz: {
+            description: 'Freezes the layer of selected objects',
+            prompt: 'Select object on layer to freeze'
+        },
+        layiso: {
+            description: 'Isolates the layers of selected objects',
+            prompt: 'Select objects on layers to isolate'
+        },
+        laylck: {
+            description: 'Locks the layer of selected objects',
+            prompt: 'Select object on layer to lock'
+        },
+        layoff: {
+            description: 'Turns off the layer of selected objects',
+            prompt: 'Select object on layer to turn off'
+        },
+        layon: {
+            description: 'Turns on all layers in the drawing'
+        },
+        laythw: {
+            description: 'Thaws all frozen layers in the drawing'
+        },
+        layulk: {
+            description: 'Unlocks the layer of selected objects',
+            prompt: 'Select object on layer to unlock'
+        },
+        layuniso: {
+            description: 'Restores layers hidden or locked by LAYISO'
+        },
         line: {
             description: 'Draws straight line segments between points'
         },
+        log: {
+            description: 'Logs debug information in console'
+        },
         lwdisplay: {
             description: 'Controls whether lineweights are displayed in the drawing'
         },
-        pline: {
-            description: 'Creates a polyline by specifying multiple points'
+        mline: {
+            description: 'Creates multiple parallel lines as one multiline object'
         },
-        spline: {
-            description: 'Creates a smooth spline curve by specifying control points'
+        move: {
+            description: 'Moves selected entities by a displacement vector',
+            prompt: 'Select entities'
         },
         mtext: {
             description: 'Creates one mtext entity'
         },
-        log: {
-            description: 'Logs debug information in console'
-        },
         open: {
             description: 'Opens an existing drawing file'
         },
@@ -61,10 +177,25 @@ export default {
         pickbox: {
             description: 'Sets the size (in pixels) of the selection box used to pick objects'
         },
+        pline: {
+            description: 'Creates a polyline by specifying multiple points'
+        },
+        pngout: {
+            description: 'Exports to PNG'
+        },
+        point: {
+            description: 'Creates points'
+        },
+        polygon: {
+            description: 'Creates a regular polygon by center/radius or by one polygon edge'
+        },
         qnew: {
             description: 'Starts a new drawing'
         },
-        rectangle: {
+        ray: {
+            description: 'Creates a ray that starts at a point and extends to infinity'
+        },
+        rectang: {
             description: 'Creates a rectangle by specifying two opposite corners'
         },
         regen: {
@@ -73,20 +204,27 @@ export default {
         revcloud: {
             description: 'Creates a revision cloud (cloud line) in rectangular shape'
         },
+        rotate: {
+            description: 'Rotates selected entities around a base point',
+            prompt: 'Select entities'
+        },
         select: {
             description: 'Selects entities'
         },
         sketch: {
             description: 'Creates a sketch line using polyline that tracks mouse movement'
         },
+        spline: {
+            description: 'Creates a smooth spline curve by specifying control points'
+        },
         whitebkcolor: {
             description: 'Toggles the drawing area background between white and black'
         },
+        xline: {
+            description: 'Creates a construction line that extends infinitely in both directions'
+        },
         zoom: {
             description: 'Zooms to display the maximum extents of all entities'
-        },
-        zoomw: {
-            description: 'Zooms to display an area specified by a rectangular window'
         }
     },
     USER: {}