@faicad/faijs 0.13.0

package/dist/primitives/screw/screw-db.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Parameters describing a screw geometry.
+ *
+ * References a pre-defined spec from the screw database via specIdx; the
+ * pitch can be overridden with a custom value or disabled entirely. head
+ * selects a hex or socket-cap head, and nRad controls the radial resolution
+ * of the thread profile.
+ */
+export interface ScrewParams {
+    system: 'metric' | 'imperial';
+    specIdx: number;
+    thread: 'coarse' | 'fine' | 'custom' | 'none';
+    pitchCustom: number;
+    length: number;
+    head: 'hex' | 'chc' | 'none';
+    nRad: number;
+}
+/**
+ * One entry in the screw specification database.
+ *
+ * dia is always in mm (imperial values converted to mm); coarse and fine
+ * hold the pitch in mm for metric systems or the thread-per-inch (TPI)
+ * count for imperial systems.
+ */
+export interface ScrewSpec {
+    /** 公称直径 mm（metric 与 imperial 均已换算为 mm） */
+    dia: number;
+    /** metric: 粗牙螺距 mm ｜ imperial: 粗牙 TPI（每英寸牙数） */
+    coarse: number;
+    /** metric: 细牙螺距 mm ｜ imperial: 细牙 TPI */
+    fine: number;
+    /** 显示标签，如 "M6"、'1/4"'、'#4' */
+    label: string;
+}
+/** The available screw thread systems: metric (mm) or imperial (inch/TPI). */
+export type ScrewSystem = 'metric' | 'imperial';
+/**
+ * Shared screw head dimension constants — the single source of truth for the
+ * BREP and mesh paths.
+ *
+ * All factors are relative to the nominal diameter dia and match the
+ * standard screw specifications (consistent with the existing BREP
+ * implementation).
+ */
+export declare const SCREW_HEAD_DIMS: {
+    readonly hex: {
+        readonly radiusFactor: 0.9;
+        readonly heightFactor: 0.6;
+    };
+    readonly chc: {
+        readonly radiusFactor: 1;
+        readonly heightFactor: 0.5;
+    };
+};
+/**
+ * Get all specs for a given thread system.
+ *
+ * @param system - the thread system to look up.
+ * @returns the full list of specs for that system.
+ */
+export declare function getScrewSpecs(system: ScrewSystem): ScrewSpec[];
+/**
+ * Get a specific spec by system and index.
+ *
+ * The index is clamped to the valid range of that system's spec list.
+ *
+ * @param system - the thread system to look up.
+ * @param specIdx - the index into the system's spec list.
+ * @returns the selected screw spec.
+ */
+export declare function getScrewSpec(system: ScrewSystem, specIdx: number): ScrewSpec;
+/**
+ * Convert a thread type to the actual pitch in mm.
+ *
+ * For imperial systems the TPI value is converted to mm via 25.4 / tpi.
+ * 'none' returns 0; 'custom' returns pitchCustom (falling back to the
+ * coarse pitch when pitchCustom is omitted).
+ *
+ * @param system - the thread system of the spec.
+ * @param spec - the screw spec whose pitch is resolved.
+ * @param thread - the thread type to convert.
+ * @param pitchCustom - the custom pitch in mm, used when thread is 'custom'.
+ * @returns the thread pitch in mm.
+ */
+export declare function threadToPitchMm(system: ScrewSystem, spec: ScrewSpec, thread: 'coarse' | 'fine' | 'custom' | 'none', pitchCustom?: number): number;
+//# sourceMappingURL=screw-db.d.ts.map

package/dist/primitives/screw/screw-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screw-db.d.ts","sourceRoot":"","sources":["../../../src/primitives/screw/screw-db.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC7C,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IAC5B,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAA;CACd;AAED,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAA;AAE/C;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAA;AAoCV;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAI5E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,EAC7C,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAKR"}

package/dist/primitives/screw/screw-db.js

@@ -0,0 +1,95 @@
+/**
+ * Shared screw head dimension constants — the single source of truth for the
+ * BREP and mesh paths.
+ *
+ * All factors are relative to the nominal diameter dia and match the
+ * standard screw specifications (consistent with the existing BREP
+ * implementation).
+ */
+export const SCREW_HEAD_DIMS = {
+    hex: {
+        radiusFactor: 0.9, // hex 头半径 = 0.9 × dia
+        heightFactor: 0.6, // hex 头高 = 0.6 × dia
+    },
+    chc: {
+        radiusFactor: 1.0, // chc 圆锥底半径 = 1.0 × dia
+        heightFactor: 0.5, // chc 头高 = 0.5 × dia
+    },
+};
+/** Metric screw specifications (M2–M24) */
+const METRIC_SPECS = [
+    { dia: 2.0, coarse: 0.40, fine: 0.25, label: 'M2' },
+    { dia: 2.5, coarse: 0.45, fine: 0.35, label: 'M2.5' },
+    { dia: 3.0, coarse: 0.50, fine: 0.35, label: 'M3' },
+    { dia: 4.0, coarse: 0.70, fine: 0.50, label: 'M4' },
+    { dia: 5.0, coarse: 0.80, fine: 0.50, label: 'M5' },
+    { dia: 6.0, coarse: 1.00, fine: 0.75, label: 'M6' },
+    { dia: 8.0, coarse: 1.25, fine: 1.00, label: 'M8' },
+    { dia: 10.0, coarse: 1.50, fine: 1.25, label: 'M10' },
+    { dia: 12.0, coarse: 1.75, fine: 1.25, label: 'M12' },
+    { dia: 14.0, coarse: 2.00, fine: 1.50, label: 'M14' },
+    { dia: 16.0, coarse: 2.00, fine: 1.50, label: 'M16' },
+    { dia: 20.0, coarse: 2.50, fine: 2.00, label: 'M20' },
+    { dia: 24.0, coarse: 3.00, fine: 2.00, label: 'M24' },
+];
+/** Imperial screw specifications (#4–1") */
+const IMPERIAL_SPECS = [
+    { dia: 2.844, coarse: 40, fine: 48, label: '#4' },
+    { dia: 3.454, coarse: 32, fine: 40, label: '#6' },
+    { dia: 4.166, coarse: 32, fine: 36, label: '#8' },
+    { dia: 4.826, coarse: 24, fine: 32, label: '#10' },
+    { dia: 6.350, coarse: 20, fine: 28, label: '1/4"' },
+    { dia: 7.938, coarse: 18, fine: 24, label: '5/16"' },
+    { dia: 9.525, coarse: 16, fine: 24, label: '3/8"' },
+    { dia: 11.113, coarse: 14, fine: 20, label: '7/16"' },
+    { dia: 12.700, coarse: 13, fine: 20, label: '1/2"' },
+    { dia: 15.875, coarse: 11, fine: 18, label: '5/8"' },
+    { dia: 19.050, coarse: 10, fine: 16, label: '3/4"' },
+    { dia: 22.225, coarse: 9, fine: 14, label: '7/8"' },
+    { dia: 25.400, coarse: 8, fine: 12, label: '1"' },
+];
+/**
+ * Get all specs for a given thread system.
+ *
+ * @param system - the thread system to look up.
+ * @returns the full list of specs for that system.
+ */
+export function getScrewSpecs(system) {
+    return system === 'metric' ? METRIC_SPECS : IMPERIAL_SPECS;
+}
+/**
+ * Get a specific spec by system and index.
+ *
+ * The index is clamped to the valid range of that system's spec list.
+ *
+ * @param system - the thread system to look up.
+ * @param specIdx - the index into the system's spec list.
+ * @returns the selected screw spec.
+ */
+export function getScrewSpec(system, specIdx) {
+    const specs = getScrewSpecs(system);
+    const idx = Math.max(0, Math.min(specIdx, specs.length - 1));
+    return specs[idx];
+}
+/**
+ * Convert a thread type to the actual pitch in mm.
+ *
+ * For imperial systems the TPI value is converted to mm via 25.4 / tpi.
+ * 'none' returns 0; 'custom' returns pitchCustom (falling back to the
+ * coarse pitch when pitchCustom is omitted).
+ *
+ * @param system - the thread system of the spec.
+ * @param spec - the screw spec whose pitch is resolved.
+ * @param thread - the thread type to convert.
+ * @param pitchCustom - the custom pitch in mm, used when thread is 'custom'.
+ * @returns the thread pitch in mm.
+ */
+export function threadToPitchMm(system, spec, thread, pitchCustom) {
+    if (thread === 'none')
+        return 0;
+    if (thread === 'custom')
+        return pitchCustom ?? spec.coarse;
+    const val = thread === 'fine' ? spec.fine : spec.coarse;
+    return system === 'metric' ? val : 25.4 / val;
+}
+//# sourceMappingURL=screw-db.js.map

package/dist/primitives/screw/screw-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screw-db.js","sourceRoot":"","sources":["../../../src/primitives/screw/screw-db.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Parameters describing a screw geometry.\n *\n * References a pre-defined spec from the screw database via specIdx; the\n * pitch can be overridden with a custom value or disabled entirely. head\n * selects a hex or socket-cap head, and nRad controls the radial resolution\n * of the thread profile.\n */\nexport interface ScrewParams {\n  system: 'metric' | 'imperial'\n  specIdx: number           // 规格 index，默认 4 → M5\n  thread: 'coarse' | 'fine' | 'custom' | 'none'\n  pitchCustom: number       // thread='custom' 时的螺距 mm\n  length: number            // 螺杆长度 mm\n  head: 'hex' | 'chc' | 'none'\n  nRad: number              // 径向分辨率 32 | 48 | 64 | 96\n}\n\n/**\n * One entry in the screw specification database.\n *\n * dia is always in mm (imperial values converted to mm); coarse and fine\n * hold the pitch in mm for metric systems or the thread-per-inch (TPI)\n * count for imperial systems.\n */\nexport interface ScrewSpec {\n  /** 公称直径 mm（metric 与 imperial 均已换算为 mm） */\n  dia: number\n  /** metric: 粗牙螺距 mm ｜ imperial: 粗牙 TPI（每英寸牙数） */\n  coarse: number\n  /** metric: 细牙螺距 mm ｜ imperial: 细牙 TPI */\n  fine: number\n  /** 显示标签，如 \"M6\"、'1/4\"'、'#4' */\n  label: string\n}\n\n/** The available screw thread systems: metric (mm) or imperial (inch/TPI). */\nexport type ScrewSystem = 'metric' | 'imperial'\n\n/**\n * Shared screw head dimension constants — the single source of truth for the\n * BREP and mesh paths.\n *\n * All factors are relative to the nominal diameter dia and match the\n * standard screw specifications (consistent with the existing BREP\n * implementation).\n */\nexport const SCREW_HEAD_DIMS = {\n  hex: {\n    radiusFactor: 0.9,     // hex 头半径 = 0.9 × dia\n    heightFactor: 0.6,     // hex 头高 = 0.6 × dia\n  },\n  chc: {\n    radiusFactor: 1.0,     // chc 圆锥底半径 = 1.0 × dia\n    heightFactor: 0.5,     // chc 头高 = 0.5 × dia\n  },\n} as const\n\n/** Metric screw specifications (M2–M24) */\nconst METRIC_SPECS: ScrewSpec[] = [\n  { dia: 2.0,   coarse: 0.40, fine: 0.25, label: 'M2' },\n  { dia: 2.5,   coarse: 0.45, fine: 0.35, label: 'M2.5' },\n  { dia: 3.0,   coarse: 0.50, fine: 0.35, label: 'M3' },\n  { dia: 4.0,   coarse: 0.70, fine: 0.50, label: 'M4' },\n  { dia: 5.0,   coarse: 0.80, fine: 0.50, label: 'M5' },\n  { dia: 6.0,   coarse: 1.00, fine: 0.75, label: 'M6' },\n  { dia: 8.0,   coarse: 1.25, fine: 1.00, label: 'M8' },\n  { dia: 10.0,  coarse: 1.50, fine: 1.25, label: 'M10' },\n  { dia: 12.0,  coarse: 1.75, fine: 1.25, label: 'M12' },\n  { dia: 14.0,  coarse: 2.00, fine: 1.50, label: 'M14' },\n  { dia: 16.0,  coarse: 2.00, fine: 1.50, label: 'M16' },\n  { dia: 20.0,  coarse: 2.50, fine: 2.00, label: 'M20' },\n  { dia: 24.0,  coarse: 3.00, fine: 2.00, label: 'M24' },\n]\n\n/** Imperial screw specifications (#4–1\") */\nconst IMPERIAL_SPECS: ScrewSpec[] = [\n  { dia: 2.844,  coarse: 40, fine: 48, label: '#4' },\n  { dia: 3.454,  coarse: 32, fine: 40, label: '#6' },\n  { dia: 4.166,  coarse: 32, fine: 36, label: '#8' },\n  { dia: 4.826,  coarse: 24, fine: 32, label: '#10' },\n  { dia: 6.350,  coarse: 20, fine: 28, label: '1/4\"' },\n  { dia: 7.938,  coarse: 18, fine: 24, label: '5/16\"' },\n  { dia: 9.525,  coarse: 16, fine: 24, label: '3/8\"' },\n  { dia: 11.113, coarse: 14, fine: 20, label: '7/16\"' },\n  { dia: 12.700, coarse: 13, fine: 20, label: '1/2\"' },\n  { dia: 15.875, coarse: 11, fine: 18, label: '5/8\"' },\n  { dia: 19.050, coarse: 10, fine: 16, label: '3/4\"' },\n  { dia: 22.225, coarse: 9,  fine: 14, label: '7/8\"' },\n  { dia: 25.400, coarse: 8,  fine: 12, label: '1\"' },\n]\n\n/**\n * Get all specs for a given thread system.\n *\n * @param system - the thread system to look up.\n * @returns the full list of specs for that system.\n */\nexport function getScrewSpecs(system: ScrewSystem): ScrewSpec[] {\n  return system === 'metric' ? METRIC_SPECS : IMPERIAL_SPECS\n}\n\n/**\n * Get a specific spec by system and index.\n *\n * The index is clamped to the valid range of that system's spec list.\n *\n * @param system - the thread system to look up.\n * @param specIdx - the index into the system's spec list.\n * @returns the selected screw spec.\n */\nexport function getScrewSpec(system: ScrewSystem, specIdx: number): ScrewSpec {\n  const specs = getScrewSpecs(system)\n  const idx = Math.max(0, Math.min(specIdx, specs.length - 1))\n  return specs[idx]\n}\n\n/**\n * Convert a thread type to the actual pitch in mm.\n *\n * For imperial systems the TPI value is converted to mm via 25.4 / tpi.\n * 'none' returns 0; 'custom' returns pitchCustom (falling back to the\n * coarse pitch when pitchCustom is omitted).\n *\n * @param system - the thread system of the spec.\n * @param spec - the screw spec whose pitch is resolved.\n * @param thread - the thread type to convert.\n * @param pitchCustom - the custom pitch in mm, used when thread is 'custom'.\n * @returns the thread pitch in mm.\n */\nexport function threadToPitchMm(\n  system: ScrewSystem,\n  spec: ScrewSpec,\n  thread: 'coarse' | 'fine' | 'custom' | 'none',\n  pitchCustom?: number,\n): number {\n  if (thread === 'none') return 0\n  if (thread === 'custom') return pitchCustom ?? spec.coarse\n  const val = thread === 'fine' ? spec.fine : spec.coarse\n  return system === 'metric' ? val : 25.4 / val\n}\n"]}

package/dist/primitives/screw/screw.d.ts

@@ -0,0 +1,13 @@
+import * as THREE from 'three';
+import type { ScrewParams } from './screw-db.js';
+/**
+ * Generate screw geometry from parameters.
+ * Internally Y-up (NASSCAD convention), then rotated to Z-up.
+ * Thread ridge follows a helix: at each axial position, the crest occurs
+ * at a specific angular phase; vertices near that phase get larger radius.
+ *
+ * @param params - the screw parameters (system, spec, thread, length, head, resolution).
+ * @returns a Z-up BufferGeometry of the screw.
+ */
+export declare function makeScrew(params: ScrewParams): THREE.BufferGeometry;
+//# sourceMappingURL=screw.d.ts.map

package/dist/primitives/screw/screw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screw.d.ts","sourceRoot":"","sources":["../../../src/primitives/screw/screw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AA4B7C;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAAC,cAAc,CA8KnE"}

package/dist/primitives/screw/screw.js

@@ -0,0 +1,176 @@
+import * as THREE from 'three';
+import { getScrewSpec, threadToPitchMm, SCREW_HEAD_DIMS } from './screw-db.js';
+/** Max axial rings */
+const N_AX_MAX = 3200;
+/** Rings per full turn */
+const N_PER_TURN = 32;
+/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */
+const ROT_Y_TO_Z = new THREE.Matrix4().makeRotationX(Math.PI / 2);
+/**
+ * Modulo that always returns a positive result.
+ */
+function modPos(a, b) {
+    return ((a % b) + b) % b;
+}
+/**
+ * Thread radial profile: returns radial factor [0..1] at a given angular offset
+ * from the thread peak. offset=0 → crest, offset=±π → root.
+ * Uses a sinusoidal profile.
+ */
+function threadProfileFactor(offset) {
+    return (1 + Math.cos(offset)) / 2;
+}
+/**
+ * Generate screw geometry from parameters.
+ * Internally Y-up (NASSCAD convention), then rotated to Z-up.
+ * Thread ridge follows a helix: at each axial position, the crest occurs
+ * at a specific angular phase; vertices near that phase get larger radius.
+ *
+ * @param params - the screw parameters (system, spec, thread, length, head, resolution).
+ * @returns a Z-up BufferGeometry of the screw.
+ */
+export function makeScrew(params) {
+    const { system, specIdx, thread, pitchCustom, length, head, nRad, } = params;
+    const spec = getScrewSpec(system, specIdx);
+    const pitch = threadToPitchMm(system, spec, thread, pitchCustom);
+    const rCrest = spec.dia / 2;
+    const rRoot = thread === 'none' ? rCrest : rCrest * 0.85;
+    // Number of axial rings
+    const nAxial = pitch > 0
+        ? Math.min(Math.round(length / pitch * N_PER_TURN), N_AX_MAX)
+        : 4;
+    const nAxialClamped = Math.max(3, nAxial);
+    // Fade region rings for lead-in/lead-out
+    const fadeRings = Math.min(N_PER_TURN, Math.max(2, Math.floor(nAxialClamped * 0.12)));
+    // Head geometry
+    const hasHead = head !== 'none';
+    const headRings = hasHead ? Math.max(4, Math.floor(nRad / 4)) : 0;
+    const totalRings = nAxialClamped + headRings;
+    // Head dimensions (shared with BREP path via SCREW_HEAD_DIMS)
+    const headHeight = hasHead
+        ? spec.dia * (head === 'hex' ? SCREW_HEAD_DIMS.hex.heightFactor : SCREW_HEAD_DIMS.chc.heightFactor)
+        : 0;
+    const headRadius = hasHead
+        ? spec.dia * (head === 'hex' ? SCREW_HEAD_DIMS.hex.radiusFactor : SCREW_HEAD_DIMS.chc.radiusFactor)
+        : 0;
+    const vPos = [];
+    const tris = [];
+    // ---- Generate body rings ----
+    // Shank is centered: Y from -length/2 to +length/2 (head at +length/2 end)
+    for (let i = 0; i < nAxialClamped; i++) {
+        const t = nAxialClamped > 1 ? i / (nAxialClamped - 1) : 0;
+        const axialPos = t * length - length / 2; // Y position (centered)
+        // Thread helix phase at this axial position
+        const threadPhase = pitch > 0 ? (axialPos / pitch) * 2 * Math.PI : 0;
+        // Fade factor: thread depth ramps up/down
+        let fade = 1;
+        if (i < fadeRings) {
+            fade = i / fadeRings;
+        }
+        else if (i > nAxialClamped - fadeRings) {
+            fade = (nAxialClamped - 1 - i) / (fadeRings - 1);
+        }
+        fade = Math.max(0, Math.min(1, fade));
+        for (let j = 0; j < nRad; j++) {
+            const phi = (j / nRad) * 2 * Math.PI;
+            let r;
+            if (thread === 'none') {
+                r = rCrest;
+            }
+            else {
+                // Angular offset from thread peak
+                const offset = modPos(phi - threadPhase + Math.PI, 2 * Math.PI) - Math.PI;
+                const profile = threadProfileFactor(offset);
+                r = rRoot + (rCrest - rRoot) * profile * fade;
+            }
+            const x = r * Math.cos(phi);
+            const z = r * Math.sin(phi);
+            vPos.push(x, axialPos, z);
+        }
+    }
+    // ---- Generate head rings ----
+    if (hasHead) {
+        for (let i = 0; i < headRings; i++) {
+            const t = headRings > 1 ? i / (headRings - 1) : 0;
+            const axialPos = length / 2 + t * headHeight;
+            for (let j = 0; j < nRad; j++) {
+                const phi = (j / nRad) * 2 * Math.PI;
+                // Head blends from body-top radius to larger head radius
+                const headR = headRadius;
+                const blend = Math.min(1, t * 2);
+                const r = rCrest + (headR - rCrest) * blend;
+                let rx = r * Math.cos(phi);
+                let rz = r * Math.sin(phi);
+                if (head === 'hex') {
+                    // Hex head: truncate to flat sides every 60°
+                    // Circumscribed circle r acts as the "corner-to-corner" radius;
+                    // the flat-to-flat distance is r * sqrt(3)
+                    const flatAngle = Math.PI / 3;
+                    const seg = Math.floor(phi / flatAngle);
+                    const angleInSeg = phi - seg * flatAngle;
+                    // Distance from center to flat side at this angle
+                    const cornerR = r;
+                    const flatDist = cornerR * Math.cos(Math.PI / 6); // flat-to-center distance
+                    const cosToFlat = Math.abs(Math.cos(angleInSeg - flatAngle / 2));
+                    const sideR = flatDist / Math.max(cosToFlat, 0.01);
+                    rx = sideR * Math.cos(phi);
+                    rz = sideR * Math.sin(phi);
+                }
+                vPos.push(rx, axialPos, rz);
+            }
+        }
+    }
+    // ---- Generate triangle indices ----
+    function ringVertex(ring, seg) {
+        return ring * nRad + seg;
+    }
+    // Connect adjacent rings
+    for (let i = 0; i < totalRings - 1; i++) {
+        for (let j = 0; j < nRad; j++) {
+            const jNext = (j + 1) % nRad;
+            const a = ringVertex(i, j);
+            const b = ringVertex(i, jNext);
+            const c = ringVertex(i + 1, j);
+            const d = ringVertex(i + 1, jNext);
+            // Reversed winding: (a,c,b) and (c,d,b) → outward normals
+            tris.push(a, c, b);
+            tris.push(c, d, b);
+        }
+    }
+    // Close top (cap) if no head
+    if (!hasHead && nAxialClamped > 1) {
+        const topRing = nAxialClamped - 1;
+        const centerIdx = vPos.length / 3;
+        vPos.push(0, length / 2, 0); // centered: top is at +length/2
+        for (let j = 0; j < nRad; j++) {
+            const jNext = (j + 1) % nRad;
+            tris.push(ringVertex(topRing, j), centerIdx, ringVertex(topRing, jNext));
+        }
+    }
+    // Close bottom (always cap)
+    if (nAxialClamped > 1) {
+        const centerIdx = vPos.length / 3;
+        vPos.push(0, -length / 2, 0); // centered: bottom is at -length/2
+        for (let j = 0; j < nRad; j++) {
+            const jNext = (j + 1) % nRad;
+            tris.push(ringVertex(0, jNext), centerIdx, ringVertex(0, j));
+        }
+    }
+    // Close head top
+    if (hasHead) {
+        const topRing = totalRings - 1;
+        const centerIdx = vPos.length / 3;
+        vPos.push(0, length / 2 + headHeight, 0); // centered: head top at length/2 + headHeight
+        for (let j = 0; j < nRad; j++) {
+            const jNext = (j + 1) % nRad;
+            tris.push(ringVertex(topRing, j), centerIdx, ringVertex(topRing, jNext));
+        }
+    }
+    // ---- Build BufferGeometry and rotate to Z-up ----
+    const geo = new THREE.BufferGeometry();
+    geo.setAttribute('position', new THREE.BufferAttribute(new Float32Array(vPos), 3));
+    geo.setIndex(new THREE.BufferAttribute(new Uint32Array(tris), 1));
+    geo.applyMatrix4(ROT_Y_TO_Z);
+    return geo;
+}
+//# sourceMappingURL=screw.js.map

package/dist/primitives/screw/screw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screw.js","sourceRoot":"","sources":["../../../src/primitives/screw/screw.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three'\nimport type { ScrewParams } from './screw-db'\nimport { getScrewSpec, threadToPitchMm, SCREW_HEAD_DIMS } from './screw-db'\n\n/** Max axial rings */\nconst N_AX_MAX = 3200\n\n/** Rings per full turn */\nconst N_PER_TURN = 32\n\n/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */\nconst ROT_Y_TO_Z = new THREE.Matrix4().makeRotationX(Math.PI / 2)\n\n/**\n * Modulo that always returns a positive result.\n */\nfunction modPos(a: number, b: number): number {\n  return ((a % b) + b) % b\n}\n\n/**\n * Thread radial profile: returns radial factor [0..1] at a given angular offset\n * from the thread peak. offset=0 → crest, offset=±π → root.\n * Uses a sinusoidal profile.\n */\nfunction threadProfileFactor(offset: number): number {\n  return (1 + Math.cos(offset)) / 2\n}\n\n/**\n * Generate screw geometry from parameters.\n * Internally Y-up (NASSCAD convention), then rotated to Z-up.\n * Thread ridge follows a helix: at each axial position, the crest occurs\n * at a specific angular phase; vertices near that phase get larger radius.\n *\n * @param params - the screw parameters (system, spec, thread, length, head, resolution).\n * @returns a Z-up BufferGeometry of the screw.\n */\nexport function makeScrew(params: ScrewParams): THREE.BufferGeometry {\n  const {\n    system,\n    specIdx,\n    thread,\n    pitchCustom,\n    length,\n    head,\n    nRad,\n  } = params\n\n  const spec = getScrewSpec(system, specIdx)\n  const pitch = threadToPitchMm(system, spec, thread, pitchCustom)\n  const rCrest = spec.dia / 2\n  const rRoot = thread === 'none' ? rCrest : rCrest * 0.85\n\n  // Number of axial rings\n  const nAxial = pitch > 0\n    ? Math.min(Math.round(length / pitch * N_PER_TURN), N_AX_MAX)\n    : 4\n  const nAxialClamped = Math.max(3, nAxial)\n\n  // Fade region rings for lead-in/lead-out\n  const fadeRings = Math.min(N_PER_TURN, Math.max(2, Math.floor(nAxialClamped * 0.12)))\n\n  // Head geometry\n  const hasHead = head !== 'none'\n  const headRings = hasHead ? Math.max(4, Math.floor(nRad / 4)) : 0\n  const totalRings = nAxialClamped + headRings\n\n  // Head dimensions (shared with BREP path via SCREW_HEAD_DIMS)\n  const headHeight = hasHead\n    ? spec.dia * (head === 'hex' ? SCREW_HEAD_DIMS.hex.heightFactor : SCREW_HEAD_DIMS.chc.heightFactor)\n    : 0\n  const headRadius = hasHead\n    ? spec.dia * (head === 'hex' ? SCREW_HEAD_DIMS.hex.radiusFactor : SCREW_HEAD_DIMS.chc.radiusFactor)\n    : 0\n\n  const vPos: number[] = []\n  const tris: number[] = []\n\n  // ---- Generate body rings ----\n  // Shank is centered: Y from -length/2 to +length/2 (head at +length/2 end)\n  for (let i = 0; i < nAxialClamped; i++) {\n    const t = nAxialClamped > 1 ? i / (nAxialClamped - 1) : 0\n    const axialPos = t * length - length / 2  // Y position (centered)\n\n    // Thread helix phase at this axial position\n    const threadPhase = pitch > 0 ? (axialPos / pitch) * 2 * Math.PI : 0\n\n    // Fade factor: thread depth ramps up/down\n    let fade = 1\n    if (i < fadeRings) {\n      fade = i / fadeRings\n    } else if (i > nAxialClamped - fadeRings) {\n      fade = (nAxialClamped - 1 - i) / (fadeRings - 1)\n    }\n    fade = Math.max(0, Math.min(1, fade))\n\n    for (let j = 0; j < nRad; j++) {\n      const phi = (j / nRad) * 2 * Math.PI\n\n      let r: number\n      if (thread === 'none') {\n        r = rCrest\n      } else {\n        // Angular offset from thread peak\n        const offset = modPos(phi - threadPhase + Math.PI, 2 * Math.PI) - Math.PI\n        const profile = threadProfileFactor(offset)\n        r = rRoot + (rCrest - rRoot) * profile * fade\n      }\n\n      const x = r * Math.cos(phi)\n      const z = r * Math.sin(phi)\n      vPos.push(x, axialPos, z)\n    }\n  }\n\n  // ---- Generate head rings ----\n  if (hasHead) {\n    for (let i = 0; i < headRings; i++) {\n      const t = headRings > 1 ? i / (headRings - 1) : 0\n      const axialPos = length / 2 + t * headHeight\n\n      for (let j = 0; j < nRad; j++) {\n        const phi = (j / nRad) * 2 * Math.PI\n\n        // Head blends from body-top radius to larger head radius\n        const headR = headRadius\n        const blend = Math.min(1, t * 2)\n        const r = rCrest + (headR - rCrest) * blend\n\n        let rx = r * Math.cos(phi)\n        let rz = r * Math.sin(phi)\n\n        if (head === 'hex') {\n          // Hex head: truncate to flat sides every 60°\n          // Circumscribed circle r acts as the \"corner-to-corner\" radius;\n          // the flat-to-flat distance is r * sqrt(3)\n          const flatAngle = Math.PI / 3\n          const seg = Math.floor(phi / flatAngle)\n          const angleInSeg = phi - seg * flatAngle\n          // Distance from center to flat side at this angle\n          const cornerR = r\n          const flatDist = cornerR * Math.cos(Math.PI / 6)  // flat-to-center distance\n          const cosToFlat = Math.abs(Math.cos(angleInSeg - flatAngle / 2))\n          const sideR = flatDist / Math.max(cosToFlat, 0.01)\n          rx = sideR * Math.cos(phi)\n          rz = sideR * Math.sin(phi)\n        }\n\n        vPos.push(rx, axialPos, rz)\n      }\n    }\n  }\n\n  // ---- Generate triangle indices ----\n  function ringVertex(ring: number, seg: number): number {\n    return ring * nRad + seg\n  }\n\n  // Connect adjacent rings\n  for (let i = 0; i < totalRings - 1; i++) {\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      const a = ringVertex(i, j)\n      const b = ringVertex(i, jNext)\n      const c = ringVertex(i + 1, j)\n      const d = ringVertex(i + 1, jNext)\n      // Reversed winding: (a,c,b) and (c,d,b) → outward normals\n      tris.push(a, c, b)\n      tris.push(c, d, b)\n    }\n  }\n\n  // Close top (cap) if no head\n  if (!hasHead && nAxialClamped > 1) {\n    const topRing = nAxialClamped - 1\n    const centerIdx = vPos.length / 3\n    vPos.push(0, length / 2, 0)  // centered: top is at +length/2\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      tris.push(ringVertex(topRing, j), centerIdx, ringVertex(topRing, jNext))\n    }\n  }\n\n  // Close bottom (always cap)\n  if (nAxialClamped > 1) {\n    const centerIdx = vPos.length / 3\n    vPos.push(0, -length / 2, 0)  // centered: bottom is at -length/2\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      tris.push(ringVertex(0, jNext), centerIdx, ringVertex(0, j))\n    }\n  }\n\n  // Close head top\n  if (hasHead) {\n    const topRing = totalRings - 1\n    const centerIdx = vPos.length / 3\n    vPos.push(0, length / 2 + headHeight, 0)  // centered: head top at length/2 + headHeight\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      tris.push(ringVertex(topRing, j), centerIdx, ringVertex(topRing, jNext))\n    }\n  }\n\n  // ---- Build BufferGeometry and rotate to Z-up ----\n  const geo = new THREE.BufferGeometry()\n  geo.setAttribute('position', new THREE.BufferAttribute(new Float32Array(vPos), 3))\n  geo.setIndex(new THREE.BufferAttribute(new Uint32Array(tris), 1))\n  geo.applyMatrix4(ROT_Y_TO_Z)\n\n  return geo\n}\n"]}

package/dist/primitives/svg-extrude.d.ts

@@ -0,0 +1,43 @@
+import * as THREE from 'three';
+/**
+ * Options controlling an SVG extrusion.
+ *
+ * targetLongSide maps the longer logical side of the SVG to this length in
+ * mm (the short side is scaled proportionally); naturalWidth/naturalHeight
+ * are the SVG's logical dimensions used to compute the scale factor.
+ */
+export interface SvgExtrudeOptions {
+    depth: number;
+    /** 长边目标长度（mm），短边按比例计算。默认 20 */
+    targetLongSide?: number;
+    /** SVG 原始逻辑尺寸，用于计算实际缩放比例 */
+    naturalWidth: number;
+    naturalHeight: number;
+}
+/**
+ * Parse SVG text into a list of THREE.Shape contours.
+ * Uses SVGLoader to convert the SVG paths into shapes usable by ExtrudeGeometry.
+ *
+ * @param svgText - the SVG source text.
+ * @returns the list of closed shapes found in the SVG.
+ * @throws when the SVG contains no closed contour.
+ */
+export declare function parseSvgShapes(svgText: string): THREE.Shape[];
+/**
+ * Extrude a list of shapes into a single merged BufferGeometry.
+ * The scale factor is computed from naturalWidth/naturalHeight and targetLongSide.
+ *
+ * @param shapes - the shapes to extrude.
+ * @param options - the extrusion options (depth and scale inputs).
+ * @returns the merged, scaled, centred BufferGeometry.
+ */
+export declare function extrudeShapes(shapes: THREE.Shape[], options: SvgExtrudeOptions): THREE.BufferGeometry;
+/**
+ * One-stop helper: SVG text → extruded BufferGeometry.
+ *
+ * @param svgText - the SVG source text.
+ * @param options - the extrusion options.
+ * @returns the extruded BufferGeometry.
+ */
+export declare function svgToExtrudedGeometry(svgText: string, options: SvgExtrudeOptions): THREE.BufferGeometry;
+//# sourceMappingURL=svg-extrude.d.ts.map

package/dist/primitives/svg-extrude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-extrude.d.ts","sourceRoot":"","sources":["../../src/primitives/svg-extrude.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAiB7D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,EACrB,OAAO,EAAE,iBAAiB,GACzB,KAAK,CAAC,cAAc,CAqCtB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,GACzB,KAAK,CAAC,cAAc,CAGtB"}

package/dist/primitives/svg-extrude.js

@@ -0,0 +1,78 @@
+import * as THREE from 'three';
+import { SVGLoader } from 'three/examples/jsm/loaders/SVGLoader.js';
+import { mergeBufferGeometries } from '../primitives/mesh-primitives.js';
+/**
+ * Parse SVG text into a list of THREE.Shape contours.
+ * Uses SVGLoader to convert the SVG paths into shapes usable by ExtrudeGeometry.
+ *
+ * @param svgText - the SVG source text.
+ * @returns the list of closed shapes found in the SVG.
+ * @throws when the SVG contains no closed contour.
+ */
+export function parseSvgShapes(svgText) {
+    const loader = new SVGLoader();
+    const svgData = loader.parse(svgText);
+    const allShapes = [];
+    for (const path of svgData.paths) {
+        const shapes = SVGLoader.createShapes(path);
+        for (const shape of shapes) {
+            allShapes.push(shape);
+        }
+    }
+    if (allShapes.length === 0) {
+        throw new Error('No closed contour found in SVG. Please check the file content.');
+    }
+    return allShapes;
+}
+/**
+ * Extrude a list of shapes into a single merged BufferGeometry.
+ * The scale factor is computed from naturalWidth/naturalHeight and targetLongSide.
+ *
+ * @param shapes - the shapes to extrude.
+ * @param options - the extrusion options (depth and scale inputs).
+ * @returns the merged, scaled, centred BufferGeometry.
+ */
+export function extrudeShapes(shapes, options) {
+    const { depth, naturalWidth, naturalHeight, targetLongSide = 20 } = options;
+    // 计算缩放比例：长边映射到 targetLongSide
+    const longSide = Math.max(naturalWidth, naturalHeight);
+    const scale = longSide > 0 ? targetLongSide / longSide : 1;
+    // 先挤出，再整体缩放几何体
+    const geometries = shapes.map((shape) => {
+        const geo = new THREE.ExtrudeGeometry(shape, {
+            depth,
+            bevelEnabled: false,
+        });
+        // 应用缩放
+        geo.scale(scale, scale, 1);
+        return geo;
+    });
+    // 合并所有几何体为一个
+    const merged = mergeBufferGeometries(geometries);
+    merged.computeVertexNormals();
+    // 居中处理：XY 居中，Z 底部对齐到 0（3D 打印放在热床上）
+    merged.computeBoundingBox();
+    if (merged.boundingBox) {
+        const cx = (merged.boundingBox.max.x + merged.boundingBox.min.x) / 2;
+        const cy = (merged.boundingBox.max.y + merged.boundingBox.min.y) / 2;
+        const cz = merged.boundingBox.min.z;
+        merged.translate(-cx, -cy, -cz);
+    }
+    // 清理临时 geometry
+    for (const g of geometries) {
+        g.dispose();
+    }
+    return merged;
+}
+/**
+ * One-stop helper: SVG text → extruded BufferGeometry.
+ *
+ * @param svgText - the SVG source text.
+ * @param options - the extrusion options.
+ * @returns the extruded BufferGeometry.
+ */
+export function svgToExtrudedGeometry(svgText, options) {
+    const shapes = parseSvgShapes(svgText);
+    return extrudeShapes(shapes, options);
+}
+//# sourceMappingURL=svg-extrude.js.map

package/dist/primitives/svg-extrude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-extrude.js","sourceRoot":"","sources":["../../src/primitives/svg-extrude.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three'\nimport { SVGLoader, type SVGResult } from 'three/examples/jsm/loaders/SVGLoader.js'\nimport { mergeBufferGeometries } from '../primitives/mesh-primitives'\n\n/**\n * Options controlling an SVG extrusion.\n *\n * targetLongSide maps the longer logical side of the SVG to this length in\n * mm (the short side is scaled proportionally); naturalWidth/naturalHeight\n * are the SVG's logical dimensions used to compute the scale factor.\n */\nexport interface SvgExtrudeOptions {\n  depth: number\n  /** 长边目标长度（mm），短边按比例计算。默认 20 */\n  targetLongSide?: number\n  /** SVG 原始逻辑尺寸，用于计算实际缩放比例 */\n  naturalWidth: number\n  naturalHeight: number\n}\n\n/**\n * Parse SVG text into a list of THREE.Shape contours.\n * Uses SVGLoader to convert the SVG paths into shapes usable by ExtrudeGeometry.\n *\n * @param svgText - the SVG source text.\n * @returns the list of closed shapes found in the SVG.\n * @throws when the SVG contains no closed contour.\n */\nexport function parseSvgShapes(svgText: string): THREE.Shape[] {\n  const loader = new SVGLoader()\n  const svgData: SVGResult = loader.parse(svgText)\n\n  const allShapes: THREE.Shape[] = []\n  for (const path of svgData.paths) {\n    const shapes = SVGLoader.createShapes(path)\n    for (const shape of shapes) {\n      allShapes.push(shape)\n    }\n  }\n\n  if (allShapes.length === 0) {\n    throw new Error('No closed contour found in SVG. Please check the file content.')\n  }\n\n  return allShapes\n}\n\n/**\n * Extrude a list of shapes into a single merged BufferGeometry.\n * The scale factor is computed from naturalWidth/naturalHeight and targetLongSide.\n *\n * @param shapes - the shapes to extrude.\n * @param options - the extrusion options (depth and scale inputs).\n * @returns the merged, scaled, centred BufferGeometry.\n */\nexport function extrudeShapes(\n  shapes: THREE.Shape[],\n  options: SvgExtrudeOptions,\n): THREE.BufferGeometry {\n  const { depth, naturalWidth, naturalHeight, targetLongSide = 20 } = options\n\n  // 计算缩放比例：长边映射到 targetLongSide\n  const longSide = Math.max(naturalWidth, naturalHeight)\n  const scale = longSide > 0 ? targetLongSide / longSide : 1\n\n  // 先挤出，再整体缩放几何体\n  const geometries = shapes.map((shape) => {\n    const geo = new THREE.ExtrudeGeometry(shape, {\n      depth,\n      bevelEnabled: false,\n    })\n    // 应用缩放\n    geo.scale(scale, scale, 1)\n    return geo\n  })\n\n  // 合并所有几何体为一个\n  const merged = mergeBufferGeometries(geometries)\n  merged.computeVertexNormals()\n\n  // 居中处理：XY 居中，Z 底部对齐到 0（3D 打印放在热床上）\n  merged.computeBoundingBox()\n  if (merged.boundingBox) {\n    const cx = (merged.boundingBox.max.x + merged.boundingBox.min.x) / 2\n    const cy = (merged.boundingBox.max.y + merged.boundingBox.min.y) / 2\n    const cz = merged.boundingBox.min.z\n    merged.translate(-cx, -cy, -cz)\n  }\n\n  // 清理临时 geometry\n  for (const g of geometries) {\n    g.dispose()\n  }\n\n  return merged\n}\n\n/**\n * One-stop helper: SVG text → extruded BufferGeometry.\n *\n * @param svgText - the SVG source text.\n * @param options - the extrusion options.\n * @returns the extruded BufferGeometry.\n */\nexport function svgToExtrudedGeometry(\n  svgText: string,\n  options: SvgExtrudeOptions,\n): THREE.BufferGeometry {\n  const shapes = parseSvgShapes(svgText)\n  return extrudeShapes(shapes, options)\n}"]}

package/dist/primitives/text/cjk.d.ts

@@ -0,0 +1,61 @@
+/**
+ * CJK (Chinese/Japanese/Korean) text geometry generation.
+ *
+ * Uses the Local Font Access API (window.queryLocalFonts) to load system CJK
+ * fonts, then parses glyph paths with opentype.js to create THREE.Shape →
+ * ExtrudeGeometry.
+ *
+ * When a CJK font is available, it is used for ALL characters (including Latin).
+ * When no CJK font is available, the default OpenSans Regular font (from
+ * fontRegistry) is used for all characters via opentype.js.
+ */
+import * as THREE from 'three';
+import * as opentype from 'opentype.js';
+import type { Font } from 'opentype.js';
+/**
+ * Check if a character is CJK (CJK Unified Ideographs + extensions).
+ *
+ * @param ch - the single character to test.
+ * @returns true when the character falls in a CJK code point range.
+ */
+export declare function isCjkChar(ch: string): boolean;
+/**
+ * Check if a text string contains any CJK characters.
+ *
+ * @param text - the text to scan.
+ * @returns true when at least one character is CJK.
+ */
+export declare function containsCjk(text: string): boolean;
+/** Result of loading a system CJK font. */
+export interface CjkFontResult {
+    font: opentype.Font;
+    family: string;
+}
+/**
+ * Load a CJK font from the system using the Local Font Access API.
+ * Returns null if unavailable (no permission, unsupported browser, or no CJK font found).
+ *
+ * @returns a promise resolving to the parsed CJK font and its family name,
+ *   or null when no usable system CJK font is available.
+ */
+export declare function loadSystemCjkFont(): Promise<CjkFontResult | null>;
+/**
+ * Generate geometry for mixed text (CJK + Latin).
+ *
+ * When cjkFont is available, it is used for ALL characters (including Latin),
+ * since CJK fonts typically contain Latin glyphs.
+ *
+ * When cjkFont is null, the default OpenSans Regular font (from fontRegistry)
+ * is used for all characters via opentype.js — this is the same font used by
+ * the BREP path, ensuring glyph consistency.
+ *
+ * @param text     Text string to render
+ * @param size     Font size in mm
+ * @param depth    Extrusion depth in mm
+ * @param cjkFont  CJK font from system (null = use default font only)
+ * @param defaultFont  Default opentype.js Font (OpenSans Regular from fontRegistry).
+ *                     If not provided, will be loaded via getOpentypeFont().
+ * @returns a promise resolving to the merged, centred geometry for the whole text.
+ */
+export declare function createMixedTextGeometry(text: string, size: number, depth: number, cjkFont: Font | null, defaultFont?: Font): Promise<THREE.BufferGeometry>;
+//# sourceMappingURL=cjk.d.ts.map

package/dist/primitives/text/cjk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cjk.d.ts","sourceRoot":"","sources":["../../../src/primitives/text/cjk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAIvC;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAS7C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjD;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAwCvE;AAsED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,IAAI,GAAG,IAAI,EACpB,WAAW,CAAC,EAAE,IAAI,GACjB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CA4D/B"}