@bitbybit-dev/base 0.21.1 → 1.0.0-rc.1

package/babel.config.cjs

@@ -1,3 +1,4 @@
+"use strict";
 module.exports = {
     presets: [
         [
@@ -11,4 +12,3 @@ module.exports = {
         '@babel/preset-typescript'
     ],
 };
-export {};

package/babel.config.d.cts

@@ -1,4 +1,4 @@
-export const presets: (string | (string | {
+export let presets: (string | (string | {
     targets: {
         node: string;
     };

package/lib/api/GlobalCDNProvider.js

@@ -1,3 +1,3 @@
 export class GlobalCDNProvider {
 }
-GlobalCDNProvider.BITBYBIT_CDN_URL = "https://cdn.jsdelivr.net/gh/bitbybit-dev/bitbybit-assets@0.21.1";
+GlobalCDNProvider.BITBYBIT_CDN_URL = "https://git-cdn.bitbybit.dev/v1.0.0-rc.1";

package/lib/api/index.d.ts

@@ -1,2 +1,4 @@
 export * from "./services";
 export * from "./GlobalCDNProvider";
+export * as Inputs from "./inputs";
+export { Base } from "./inputs/base-inputs";

package/lib/api/index.js

@@ -1,2 +1,4 @@
 export * from "./services";
 export * from "./GlobalCDNProvider";
+export * as Inputs from "./inputs";
+export { Base } from "./inputs/base-inputs";

package/lib/api/inputs/base-inputs.d.ts

@@ -1,3 +1,7 @@
+/**
+ * Base namespace containing foundational types and enums used across all bitbybit packages.
+ * This is the single source of truth - other packages extend this via module augmentation.
+ */
 export declare namespace Base {
     type Color = string;
     type ColorRGB = {
@@ -5,6 +9,12 @@ export declare namespace Base {
         g: number;
         b: number;
     };
+    type ColorRGBA = {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
     type Material = any;
     type Point2 = [number, number];
     type Vector2 = [number, number];
@@ -20,6 +30,7 @@ export declare namespace Base {
     };
     type Segment2 = [Point2, Point2];
     type Segment3 = [Point3, Point3];
+    /** Triangle plane is efficient definition described by a normal vector and d value (N dot X = d) */
     type TrianglePlane3 = {
         normal: Vector3;
         d: number;

package/lib/api/inputs/base-inputs.js

@@ -1,6 +1,13 @@
 /* eslint-disable @typescript-eslint/no-namespace */
+/**
+ * Base namespace containing foundational types and enums used across all bitbybit packages.
+ * This is the single source of truth - other packages extend this via module augmentation.
+ */
 export var Base;
 (function (Base) {
+    // ============================================================================
+    // Alignment Enums
+    // ============================================================================
     let horizontalAlignEnum;
     (function (horizontalAlignEnum) {
         horizontalAlignEnum["left"] = "left";

package/lib/api/inputs/color-inputs.d.ts

@@ -8,6 +8,156 @@ export declare namespace Color {
          */
         color: Base.Color;
     }
+    class Rgb255Dto {
+        constructor(colorRgb?: Base.ColorRGB);
+        /**
+         * Color rgb
+         * @default { "r": 0, "g": 0, "b": 255 }
+         * @min 0
+         * @max 255
+         */
+        colorRgb: Base.ColorRGB;
+    }
+    class Rgb1Dto {
+        constructor(colorRgb?: Base.ColorRGB);
+        /**
+         * Color rgb
+         * @default { "r": 0, "g": 0, "b": 1 }
+         * @min 0
+         * @max 1
+         */
+        colorRgb: Base.ColorRGB;
+    }
+    class Rgba255Dto {
+        constructor(colorRgba?: Base.ColorRGBA);
+        /**
+         * Color rgba
+         * @default { "r": 0, "g": 0, "b": 255, "a": 1 }
+         * @min 0
+         * @max 255
+         */
+        colorRgba: Base.ColorRGBA;
+    }
+    class Rgba1Dto {
+        constructor(colorRgba?: Base.ColorRGBA);
+        /**
+         * Color rgba
+         * @default { "r": 0, "g": 0, "b": 1, "a": 1 }
+         * @min 0
+         * @max 1
+         */
+        colorRgba: Base.ColorRGBA;
+    }
+    class RgbAttomic255Dto {
+        constructor(r?: number, g?: number, b?: number);
+        /**
+         * Red component
+         * @default 0
+         * @minimum 0
+         * @maximum 255
+         */
+        r: number;
+        /**
+         * Green component
+         * @default 0
+         * @minimum 0
+         * @maximum 255
+         */
+        g: number;
+        /**
+         * Blue component
+         * @default 255
+         * @minimum 0
+         * @maximum 255
+         */
+        b: number;
+    }
+    class RgbaAttomic255Dto {
+        constructor(r?: number, g?: number, b?: number, a?: number);
+        /**
+         * Red component
+         * @default 0
+         * @minimum 0
+         * @maximum 255
+         */
+        r: number;
+        /**
+         * Green component
+         * @default 0
+         * @minimum 0
+         * @maximum 255
+         */
+        g: number;
+        /**
+         * Blue component
+         * @default 255
+         * @minimum 0
+         * @maximum 255
+         */
+        b: number;
+        /**
+         * Alpha component
+         * @default 1
+         * @minimum 0
+         * @maximum 1
+         */
+        a: number;
+    }
+    class RgbAttomic1Dto {
+        constructor(r?: number, g?: number, b?: number);
+        /**
+         * Red component
+         * @default 0
+         * @minimum 0
+         * @maximum 1
+         */
+        r: number;
+        /**
+         * Green component
+         * @default 0
+         * @minimum 0
+         * @maximum 1
+         */
+        g: number;
+        /**
+         * Blue component
+         * @default 1
+         * @minimum 0
+         * @maximum 1
+         */
+        b: number;
+    }
+    class RgbaAttomic1Dto {
+        constructor(r?: number, g?: number, b?: number, a?: number);
+        /**
+         * Red component
+         * @default 0
+         * @minimum 0
+         * @maximum 1
+         */
+        r: number;
+        /**
+         * Green component
+         * @default 0
+         * @minimum 0
+         * @maximum 1
+         */
+        g: number;
+        /**
+         * Blue component
+         * @default 1
+         * @minimum 0
+         * @maximum 1
+         */
+        b: number;
+        /**
+         * Alpha component
+         * @default 1
+         * @minimum 0
+         * @maximum 1
+         */
+        a: number;
+    }
     class InvertHexDto {
         constructor(color?: Base.Color);
         /**

package/lib/api/inputs/color-inputs.js

@@ -14,6 +14,226 @@ export var Color;
         }
     }
     Color.HexDto = HexDto;
+    class Rgb255Dto {
+        constructor(colorRgb) {
+            /**
+             * Color rgb
+             * @default { "r": 0, "g": 0, "b": 255 }
+             * @min 0
+             * @max 255
+             */
+            this.colorRgb = { r: 0, g: 0, b: 255 };
+            if (colorRgb !== undefined) {
+                this.colorRgb = colorRgb;
+            }
+        }
+    }
+    Color.Rgb255Dto = Rgb255Dto;
+    class Rgb1Dto {
+        constructor(colorRgb) {
+            /**
+             * Color rgb
+             * @default { "r": 0, "g": 0, "b": 1 }
+             * @min 0
+             * @max 1
+             */
+            this.colorRgb = { r: 0, g: 0, b: 1 };
+            if (colorRgb !== undefined) {
+                this.colorRgb = colorRgb;
+            }
+        }
+    }
+    Color.Rgb1Dto = Rgb1Dto;
+    class Rgba255Dto {
+        constructor(colorRgba) {
+            /**
+             * Color rgba
+             * @default { "r": 0, "g": 0, "b": 255, "a": 1 }
+             * @min 0
+             * @max 255
+             */
+            this.colorRgba = { r: 0, g: 0, b: 255, a: 1 };
+            if (colorRgba !== undefined) {
+                this.colorRgba = colorRgba;
+            }
+        }
+    }
+    Color.Rgba255Dto = Rgba255Dto;
+    class Rgba1Dto {
+        constructor(colorRgba) {
+            /**
+             * Color rgba
+             * @default { "r": 0, "g": 0, "b": 1, "a": 1 }
+             * @min 0
+             * @max 1
+             */
+            this.colorRgba = { r: 0, g: 0, b: 1, a: 1 };
+            if (colorRgba !== undefined) {
+                this.colorRgba = colorRgba;
+            }
+        }
+    }
+    Color.Rgba1Dto = Rgba1Dto;
+    class RgbAttomic255Dto {
+        constructor(r, g, b) {
+            /**
+             * Red component
+             * @default 0
+             * @minimum 0
+             * @maximum 255
+             */
+            this.r = 0;
+            /**
+             * Green component
+             * @default 0
+             * @minimum 0
+             * @maximum 255
+             */
+            this.g = 0;
+            /**
+             * Blue component
+             * @default 255
+             * @minimum 0
+             * @maximum 255
+             */
+            this.b = 255;
+            if (r !== undefined) {
+                this.r = r;
+            }
+            if (g !== undefined) {
+                this.g = g;
+            }
+            if (b !== undefined) {
+                this.b = b;
+            }
+        }
+    }
+    Color.RgbAttomic255Dto = RgbAttomic255Dto;
+    class RgbaAttomic255Dto {
+        constructor(r, g, b, a) {
+            /**
+             * Red component
+             * @default 0
+             * @minimum 0
+             * @maximum 255
+             */
+            this.r = 0;
+            /**
+             * Green component
+             * @default 0
+             * @minimum 0
+             * @maximum 255
+             */
+            this.g = 0;
+            /**
+             * Blue component
+             * @default 255
+             * @minimum 0
+             * @maximum 255
+             */
+            this.b = 255;
+            /**
+             * Alpha component
+             * @default 1
+             * @minimum 0
+             * @maximum 1
+             */
+            this.a = 1;
+            if (r !== undefined) {
+                this.r = r;
+            }
+            if (g !== undefined) {
+                this.g = g;
+            }
+            if (b !== undefined) {
+                this.b = b;
+            }
+            if (a !== undefined) {
+                this.a = a;
+            }
+        }
+    }
+    Color.RgbaAttomic255Dto = RgbaAttomic255Dto;
+    class RgbAttomic1Dto {
+        constructor(r, g, b) {
+            /**
+             * Red component
+             * @default 0
+             * @minimum 0
+             * @maximum 1
+             */
+            this.r = 0;
+            /**
+             * Green component
+             * @default 0
+             * @minimum 0
+             * @maximum 1
+             */
+            this.g = 0;
+            /**
+             * Blue component
+             * @default 1
+             * @minimum 0
+             * @maximum 1
+             */
+            this.b = 1;
+            if (r !== undefined) {
+                this.r = r;
+            }
+            if (g !== undefined) {
+                this.g = g;
+            }
+            if (b !== undefined) {
+                this.b = b;
+            }
+        }
+    }
+    Color.RgbAttomic1Dto = RgbAttomic1Dto;
+    class RgbaAttomic1Dto {
+        constructor(r, g, b, a) {
+            /**
+             * Red component
+             * @default 0
+             * @minimum 0
+             * @maximum 1
+             */
+            this.r = 0;
+            /**
+             * Green component
+             * @default 0
+             * @minimum 0
+             * @maximum 1
+             */
+            this.g = 0;
+            /**
+             * Blue component
+             * @default 1
+             * @minimum 0
+             * @maximum 1
+             */
+            this.b = 1;
+            /**
+             * Alpha component
+             * @default 1
+             * @minimum 0
+             * @maximum 1
+             */
+            this.a = 1;
+            if (r !== undefined) {
+                this.r = r;
+            }
+            if (g !== undefined) {
+                this.g = g;
+            }
+            if (b !== undefined) {
+                this.b = b;
+            }
+            if (a !== undefined) {
+                this.a = a;
+            }
+        }
+    }
+    Color.RgbaAttomic1Dto = RgbaAttomic1Dto;
     class InvertHexDto {
         constructor(color) {
             /**

package/lib/api/inputs/inputs.d.ts

@@ -1,14 +1 @@
-export * from "./color-inputs";
-export * from "./lists-inputs";
-export * from "./logic-inputs";
-export * from "./math-inputs";
-export * from "./point-inputs";
-export * from "./text-inputs";
-export * from "./text-inputs";
-export * from "./vector-inputs";
-export * from "./transforms-inputs";
-export * from "./dates-inputs";
-export * from "./line-inputs";
-export * from "./polyline-inputs";
-export * from "./mesh-inputs";
-export * from "./io-inputs";
+export * from "./index";

package/lib/api/inputs/inputs.js

@@ -1,14 +1,2 @@
-export * from "./color-inputs";
-export * from "./lists-inputs";
-export * from "./logic-inputs";
-export * from "./math-inputs";
-export * from "./point-inputs";
-export * from "./text-inputs";
-export * from "./text-inputs";
-export * from "./vector-inputs";
-export * from "./transforms-inputs";
-export * from "./dates-inputs";
-export * from "./line-inputs";
-export * from "./polyline-inputs";
-export * from "./mesh-inputs";
-export * from "./io-inputs";
+// Re-export everything from index for backward compatibility
+export * from "./index";

package/lib/api/inputs/vector-inputs.d.ts

@@ -1,5 +1,5 @@
 import { Base } from "./base-inputs";
-import { Math } from "./inputs";
+import { Math } from "./math-inputs";
 export declare namespace Vector {
     class TwoVectorsDto {
         constructor(first?: number[], second?: number[]);

package/lib/api/inputs/vector-inputs.js

@@ -1,4 +1,4 @@
-import { Math } from "./inputs";
+import { Math } from "./math-inputs";
 export var Vector;
 (function (Vector) {
     class TwoVectorsDto {

package/lib/api/models/simplex.js

@@ -163,8 +163,8 @@ export const defaultsVectorParams = {
     input: "?",
     align: "left",
     font: simplex,
-    height: 21,
-    lineSpacing: 2.142857142857143,
+    height: 21, // == old vector_xxx simplex font height
+    lineSpacing: 2.142857142857143, // == 30/14 == old vector_xxx ratio
     letterSpacing: 1,
     extrudeOffset: 0
 };

package/lib/api/services/color.d.ts

@@ -9,10 +9,64 @@ export declare class Color {
      * @param inputs Color hex
      * @returns color string
      * @group create
-     * @shortname color
+     * @shortname color hex
      * @drawable false
      */
     hexColor(inputs: Inputs.Color.HexDto): Inputs.Base.Color;
+    /**
+     * Creates and returns rgb color object
+     * @param inputs Color rgb
+     * @returns color object
+     * @group create
+     * @shortname color rgb 0-255
+     * @drawable false
+     */
+    rgb255Color(inputs: Inputs.Color.Rgb255Dto): Inputs.Base.ColorRGB;
+    /**
+     * Creates and returns rgb color object
+     * @param inputs Color rgb
+     * @returns color object
+     * @group create
+     * @shortname color rgb 0-1
+     * @drawable false
+     */
+    rgb1Color(inputs: Inputs.Color.Rgb1Dto): Inputs.Base.ColorRGB;
+    /**
+     * Creates and returns rgba color object
+     * @param inputs Color rgba
+     * @returns color object
+     * @group create
+     * @shortname color rgba 0-255
+     * @drawable false
+     */
+    rgba255Color(inputs: Inputs.Color.Rgba255Dto): Inputs.Base.ColorRGBA;
+    /**
+     * Creates and returns rgba color object
+     * @param inputs Color rgba
+     * @returns color object
+     * @group create
+     * @shortname color rgba 0-1
+     * @drawable false
+     */
+    rgba1Color(inputs: Inputs.Color.Rgba1Dto): Inputs.Base.ColorRGBA;
+    /**
+     * Creates atomic rgb color object
+     * @param inputs Color rgb
+     * @returns color object
+     * @group create
+     * @shortname atomic color rgb 0-255
+     * @drawable false
+     */
+    rgbAtomic255Color(inputs: Inputs.Color.RgbAttomic255Dto): Inputs.Base.ColorRGB;
+    /**
+     * Creates atomic rgb color object
+     * @param inputs Color rgb
+     * @returns color object
+     * @group create
+     * @shortname atomic color rgb 0-1
+     * @drawable false
+     */
+    rgbAtomic1Color(inputs: Inputs.Color.RgbAttomic1Dto): Inputs.Base.ColorRGB;
     /**
      * Converts hex color to RGB object with r, g, b values (0-255 range).
      * Example: '#FF5733' → {r: 255, g: 87, b: 51}

package/lib/api/services/color.js

@@ -8,12 +8,78 @@ export class Color {
      * @param inputs Color hex
      * @returns color string
      * @group create
-     * @shortname color
+     * @shortname color hex
      * @drawable false
      */
     hexColor(inputs) {
         return inputs.color;
     }
+    /**
+     * Creates and returns rgb color object
+     * @param inputs Color rgb
+     * @returns color object
+     * @group create
+     * @shortname color rgb 0-255
+     * @drawable false
+     */
+    rgb255Color(inputs) {
+        return inputs.colorRgb;
+    }
+    /**
+     * Creates and returns rgb color object
+     * @param inputs Color rgb
+     * @returns color object
+     * @group create
+     * @shortname color rgb 0-1
+     * @drawable false
+     */
+    rgb1Color(inputs) {
+        return inputs.colorRgb;
+    }
+    /**
+     * Creates and returns rgba color object
+     * @param inputs Color rgba
+     * @returns color object
+     * @group create
+     * @shortname color rgba 0-255
+     * @drawable false
+     */
+    rgba255Color(inputs) {
+        return inputs.colorRgba;
+    }
+    /**
+     * Creates and returns rgba color object
+     * @param inputs Color rgba
+     * @returns color object
+     * @group create
+     * @shortname color rgba 0-1
+     * @drawable false
+     */
+    rgba1Color(inputs) {
+        return inputs.colorRgba;
+    }
+    /**
+     * Creates atomic rgb color object
+     * @param inputs Color rgb
+     * @returns color object
+     * @group create
+     * @shortname atomic color rgb 0-255
+     * @drawable false
+     */
+    rgbAtomic255Color(inputs) {
+        return Object.assign({}, inputs);
+    }
+    /**
+     * Creates atomic rgb color object
+     * @param inputs Color rgb
+     * @returns color object
+     * @group create
+     * @shortname atomic color rgb 0-1
+     * @drawable false
+     */
+    rgbAtomic1Color(inputs) {
+        return Object.assign({}, inputs);
+    }
     /**
      * Converts hex color to RGB object with r, g, b values (0-255 range).
      * Example: '#FF5733' → {r: 255, g: 87, b: 51}

package/lib/api/services/helpers/dxf/dxf-generator.js

@@ -133,7 +133,7 @@ export class DxfGenerator {
             "2",
             "VPORT",
             "70",
-            "2",
+            "2", // Number of viewports
             "0",
             "VPORT",
             "2",
@@ -606,7 +606,7 @@ export class DxfGenerator {
                     // Use 24-bit true color for full color spectrum (newer CAD software)
                     const trueColor = (r * 65536) + (g * 256) + b;
                     return [
-                        { code: "62", value: "256" },
+                        { code: "62", value: "256" }, // 256 = ByEntity
                         { code: "420", value: trueColor.toString() }
                     ];
                 }
@@ -627,14 +627,14 @@ export class DxfGenerator {
     rgbToAciColorIndex(r, g, b) {
         // ACI standard colors (simplified mapping)
         const aciColors = {
-            1: [255, 0, 0],
-            2: [255, 255, 0],
-            3: [0, 255, 0],
-            4: [0, 255, 255],
-            5: [0, 0, 255],
-            6: [255, 0, 255],
-            7: [255, 255, 255],
-            8: [128, 128, 128],
+            1: [255, 0, 0], // Red
+            2: [255, 255, 0], // Yellow
+            3: [0, 255, 0], // Green
+            4: [0, 255, 255], // Cyan
+            5: [0, 0, 255], // Blue
+            6: [255, 0, 255], // Magenta
+            7: [255, 255, 255], // White
+            8: [128, 128, 128], // Gray
             9: [192, 192, 192] // Light gray
         };
         // Special case for black or very dark colors

package/lib/api/services/point.js

@@ -450,7 +450,7 @@ export class Point {
             radiusHexagon: BASE_RADIUS,
             nrHexagonsX: nrHexagonsInWidth,
             nrHexagonsY: nrHexagonsInHeight,
-            orientOnCenter: false,
+            orientOnCenter: false, // Important: Do not center here
             pointsOnGround: false // Keep on XY plane for now
         });
         if (unscaledCenters.length === 0) {

package/lib/api/services/transforms.js

@@ -323,9 +323,9 @@ export class Transforms {
         // m41, m42, m43 = 0, m44 = 1
         // Assemble the 4x4 matrix in COLUMN-MAJOR order
         const m = [
-            m11, m21, m31, 0.0,
-            m12, m22, m32, 0.0,
-            m13, m23, m33, 0.0,
+            m11, m21, m31, 0.0, // Column 1
+            m12, m22, m32, 0.0, // Column 2
+            m13, m23, m33, 0.0, // Column 3
             0.0, 0.0, 0.0, 1.0 // Column 4
         ];
         return m;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitbybit-dev/base",
-  "version": "0.21.1",
+  "version": "1.0.0-rc.1",
   "description": "Bit By Bit Developers Base CAD Library to Program Geometry",
   "main": "index.js",
   "repository": {
@@ -60,19 +60,18 @@
   "dependencies": {},
   "devDependencies": {
     "shx":"0.4.0",
-    "sass": "1.57.1",
-    "@testing-library/jest-dom": "5.14.1",
-    "mvdir": "1.0.21",
-    "jest": "29.4.1",
-    "ts-node": "10.9.1",
-    "ts-jest": "29.0.0",
-    "typescript": "4.8.2",
-    "@types/jest": "29.0.0",
-    "babel-jest": "29.0.0",
-    "@babel/core": "7.16.0",
-    "@babel/preset-env": "7.16.0",
-    "@babel/preset-typescript": "7.16.0",
-    "jest-html-reporters": "3.0.11"
+    "@testing-library/jest-dom": "6.9.1",
+    "mvdir": "1.0.22",
+    "jest": "30.2.0",
+    "ts-node": "10.9.2",
+    "ts-jest": "29.4.6",
+    "typescript": "5.9.3",
+    "@types/jest": "30.0.0",
+    "babel-jest": "30.2.0",
+    "@babel/core": "7.28.6",
+    "@babel/preset-env": "7.28.6",
+    "@babel/preset-typescript": "7.28.5",
+    "jest-html-reporters": "3.1.7"
   },
   "jest": {
     "preset": "ts-jest",