@ccpc/math 0.1.0

package/dist/intersections/types.d.ts

@@ -0,0 +1,11 @@
+import type { Vec2 } from '../core/vec2';
+import type { Interval } from '../curves/interval';
+export type CurveXInfo = {
+    point: Vec2;
+    u1: number;
+    u2: number;
+    isOverlap: boolean;
+    range1?: Interval;
+    range2?: Interval;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/intersections/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/intersections/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAElD,MAAM,MAAM,UAAU,GAAG;IACrB,KAAK,EAAE,IAAI,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,MAAM,CAAC,EAAE,QAAQ,CAAA;CACpB,CAAA"}

package/dist/intersections/types.js

@@ -0,0 +1 @@
+export {};

package/dist/serialize/dump_types.d.ts

@@ -0,0 +1,101 @@
+import { EN_GEO_TYPE } from '../constants/geom_type';
+import type { Num3x3 } from '../types/type_guard';
+export type IDB = {
+    type: EN_GEO_TYPE;
+};
+export type IDBVec2 = IDB & {
+    type: EN_GEO_TYPE.Vec2;
+    x: number;
+    y: number;
+};
+export type IDBMat3 = IDB & {
+    type: EN_GEO_TYPE.Mat3;
+    elements: Num3x3;
+};
+export type IDBBox2 = IDB & {
+    type: EN_GEO_TYPE.Box2;
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+};
+export type IDBCoord2D = IDB & {
+    type: EN_GEO_TYPE.Coord2D;
+    origin: {
+        x: number;
+        y: number;
+    };
+    xAxis: {
+        x: number;
+        y: number;
+    };
+    yAxis: {
+        x: number;
+        y: number;
+    };
+};
+export type IDBLine2 = IDB & {
+    type: EN_GEO_TYPE.Line2;
+    start: {
+        x: number;
+        y: number;
+    };
+    end: {
+        x: number;
+        y: number;
+    };
+};
+export type IDBCircle2 = IDB & {
+    type: EN_GEO_TYPE.Circle2;
+    center: {
+        x: number;
+        y: number;
+    };
+    radius: number;
+};
+export type IDBArc2 = IDB & {
+    type: EN_GEO_TYPE.Arc2;
+    center: {
+        x: number;
+        y: number;
+    };
+    radius: number;
+    startAngle: number;
+    endAngle: number;
+    clockwise: boolean;
+};
+export type IDBEllipse2 = IDB & {
+    type: EN_GEO_TYPE.Ellipse2;
+    center: {
+        x: number;
+        y: number;
+    };
+    rx: number;
+    ry: number;
+    rotation: number;
+};
+export type IDBEllipseArc2 = IDB & {
+    type: EN_GEO_TYPE.EllipseArc2;
+    center: {
+        x: number;
+        y: number;
+    };
+    rx: number;
+    ry: number;
+    rotation: number;
+    startAngle: number;
+    endAngle: number;
+    clockwise: boolean;
+};
+export type IDBBSpline2 = IDB & {
+    type: EN_GEO_TYPE.BSpline2;
+    controlPoints: Array<{
+        x: number;
+        y: number;
+    }>;
+    degree: number;
+    expandedKnots: number[];
+    weights?: number[];
+    isPeriodic?: boolean;
+};
+//# sourceMappingURL=dump_types.d.ts.map

package/dist/serialize/dump_types.d.ts.map

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

package/dist/serialize/dump_types.js

@@ -0,0 +1,5 @@
+/*
+ * Linea Math - Serialize
+ * 序列化结构类型定义
+ */
+export {};

package/dist/serialize/geom_mgr.d.ts

@@ -0,0 +1,24 @@
+import type { Ctor } from '../types/type_guard';
+import type { IDB } from './dump_types';
+/** 实例侧 dump 协议 */
+export interface IDumpable<TDump extends IDB = IDB> {
+    dump(): TDump;
+}
+/** 静态侧 load 协议 */
+export interface ILoadable<TDump extends IDB, T> {
+    readonly type: string;
+    load(data: TDump): T;
+}
+/** 几何类型管理器 */
+export declare class GeomMgr {
+    private readonly map;
+    /** 注册可加载类型构造器 */
+    register<TDump extends IDB, T>(ctor: ILoadable<TDump, T>): this;
+    /** 统一加载入口 */
+    load<T>(data: IDB & Record<string, unknown>): T;
+}
+/** 全局注册中心 */
+export declare const geomMgr: GeomMgr;
+/** 自动注册装饰器 */
+export declare function RegisterGeom<T extends Ctor & ILoadable<IDB, unknown>>(Ctor: T): void;
+//# sourceMappingURL=geom_mgr.d.ts.map

package/dist/serialize/geom_mgr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geom_mgr.d.ts","sourceRoot":"","sources":["../../src/serialize/geom_mgr.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAE/C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAEvC,kBAAkB;AAClB,MAAM,WAAW,SAAS,CAAC,KAAK,SAAS,GAAG,GAAG,GAAG;IAC9C,IAAI,IAAI,KAAK,CAAA;CAChB;AAED,kBAAkB;AAClB,MAAM,WAAW,SAAS,CAAC,KAAK,SAAS,GAAG,EAAE,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAA;CACvB;AAED,cAAc;AACd,qBAAa,OAAO;IAChB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6C;IAEjE,iBAAiB;IACV,QAAQ,CAAC,KAAK,SAAS,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;IAK/D,aAAa;IACN,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAKpB,CAAC;CAElC;AAED,aAAa;AACb,eAAO,MAAM,OAAO,SAAgB,CAAA;AAEpC,cAAc;AACd,wBAAgB,YAAY,CAAC,CAAC,SAAS,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,QAE7E"}

package/dist/serialize/geom_mgr.js

@@ -0,0 +1,30 @@
+/*
+ * Linea Math - Serialize
+ * 统一的 dump/load 注册中心
+ */
+import { MathError } from '../utils/math_error';
+/** 几何类型管理器 */
+export class GeomMgr {
+    constructor() {
+        this.map = new Map();
+    }
+    /** 注册可加载类型构造器 */
+    register(ctor) {
+        this.map.set(ctor.type, ctor);
+        return this;
+    }
+    /** 统一加载入口 */
+    load(data) {
+        const ctor = this.map.get(data.type);
+        if (!ctor) {
+            MathError.throw(`GeomMgr.load: unknown type ${data.type}`);
+        }
+        return ctor.load(data);
+    }
+}
+/** 全局注册中心 */
+export const geomMgr = new GeomMgr();
+/** 自动注册装饰器 */
+export function RegisterGeom(Ctor) {
+    geomMgr.register(Ctor);
+}

package/dist/types/type_define.d.ts

@@ -0,0 +1,29 @@
+import type { Num3x3 } from './type_guard';
+/** 二维向量类型 */
+export interface IVec2 {
+    x: number;
+    y: number;
+}
+/** 二维带权点（可用于齐次坐标或加权几何计算） */
+export interface IWeightedPoint2 extends IVec2 {
+    w: number;
+}
+/** 二维坐标轴枚举 */
+export declare enum Axis2D {
+    X = "x",
+    Y = "y"
+}
+/** 3x3 矩阵类型（对外行主序） */
+export interface IMat3 {
+    elements: Num3x3;
+}
+/** 曲线最近点查询结果 */
+export interface IClosestPointResult {
+    /** 最近点坐标 */
+    point: IVec2;
+    /** 最近点对应参数 */
+    param: number;
+    /** 查询点到曲线的距离 */
+    distance: number;
+}
+//# sourceMappingURL=type_define.d.ts.map

package/dist/types/type_define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type_define.d.ts","sourceRoot":"","sources":["../../src/types/type_define.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C,aAAa;AACb,MAAM,WAAW,KAAK;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,4BAA4B;AAC5B,MAAM,WAAW,eAAgB,SAAQ,KAAK;IAC1C,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,cAAc;AACd,oBAAY,MAAM;IACd,CAAC,MAAM;IACP,CAAC,MAAM;CACV;AAED,sBAAsB;AACtB,MAAM,WAAW,KAAK;IAClB,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,gBAAgB;AAChB,MAAM,WAAW,mBAAmB;IAChC,YAAY;IACZ,KAAK,EAAE,KAAK,CAAA;IACZ,cAAc;IACd,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAA;CACnB"}

package/dist/types/type_define.js

@@ -0,0 +1,10 @@
+/*
+ * Linea Math - Types
+ * 数学库相关的通用类型定义
+ */
+/** 二维坐标轴枚举 */
+export var Axis2D;
+(function (Axis2D) {
+    Axis2D["X"] = "x";
+    Axis2D["Y"] = "y";
+})(Axis2D || (Axis2D = {}));

package/dist/types/type_guard.d.ts

@@ -0,0 +1,46 @@
+export type Ctor<T = unknown> = abstract new (...args: any[]) => T;
+/** 2D 向量元组 */
+export type Num2 = readonly [number, number];
+/** 3D 向量元组 */
+export type Num3 = readonly [number, number, number];
+/** 4D 向量元组 */
+export type Num4 = readonly [number, number, number, number];
+/** 2x2 矩阵行主序数组 */
+export type Num2x2 = readonly [
+    number,
+    number,
+    number,
+    number
+];
+/** 3x3 矩阵行主序数组 */
+export type Num3x3 = readonly [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];
+/** 4x4 矩阵行主序数组 */
+export type Num4x4 = readonly [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];
+//# sourceMappingURL=type_guard.d.ts.map

package/dist/types/type_guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type_guard.d.ts","sourceRoot":"","sources":["../../src/types/type_guard.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,IAAI,CAAC,CAAC,GAAG,OAAO,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAElE,cAAc;AACd,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAE5C,cAAc;AACd,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAEpD,cAAc;AACd,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE5D,kBAAkB;AAClB,MAAM,MAAM,MAAM,GAAG,SAAS;IAC1B,MAAM;IAAE,MAAM;IACd,MAAM;IAAE,MAAM;CACjB,CAAA;AAED,kBAAkB;AAClB,MAAM,MAAM,MAAM,GAAG,SAAS;IAC1B,MAAM;IAAE,MAAM;IAAE,MAAM;IACtB,MAAM;IAAE,MAAM;IAAE,MAAM;IACtB,MAAM;IAAE,MAAM;IAAE,MAAM;CACzB,CAAA;AAED,kBAAkB;AAClB,MAAM,MAAM,MAAM,GAAG,SAAS;IAC1B,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAC9B,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAC9B,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAC9B,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;CACjC,CAAA"}

package/dist/types/type_guard.js

@@ -0,0 +1,5 @@
+/*
+ * Linea Math - Types
+ * 类型安全相关的辅助定义
+ */
+export {};

package/dist/utils/math_error.d.ts

@@ -0,0 +1,16 @@
+export declare class MathError extends Error {
+    constructor(message: string);
+    /**
+     * 直接抛出 MathError，用于显式失败场景
+     */
+    static throw(message: string): never;
+    /**
+     * 条件不满足时抛出 MathError，用于参数校验或逻辑保护
+     */
+    static assert(condition: unknown, message: string): asserts condition;
+    /**
+     * 仅警告，不抛异常；用于数值退化或可容忍的异常情形
+     */
+    static warn(message: string): void;
+}
+//# sourceMappingURL=math_error.d.ts.map

package/dist/utils/math_error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math_error.d.ts","sourceRoot":"","sources":["../../src/utils/math_error.ts"],"names":[],"mappings":"AAUA,qBAAa,SAAU,SAAQ,KAAK;gBACpB,OAAO,EAAE,MAAM;IAK3B;;OAEG;WACW,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAI3C;;OAEG;WACW,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS;IAM5E;;OAEG;WACW,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG5C"}

package/dist/utils/math_error.js

@@ -0,0 +1,35 @@
+/*
+ * Linea Math - Utils
+ * MathError: 统一异常处理入口
+ *
+ * 用法示例：
+ * - MathError.throw('参数超出范围')
+ * - MathError.assert(radius > 0, '半径必须为正')
+ * - MathError.warn('数值迭代未收敛')
+ */
+export class MathError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'MathError';
+    }
+    /**
+     * 直接抛出 MathError，用于显式失败场景
+     */
+    static throw(message) {
+        throw new MathError(message);
+    }
+    /**
+     * 条件不满足时抛出 MathError，用于参数校验或逻辑保护
+     */
+    static assert(condition, message) {
+        if (!condition) {
+            MathError.throw(message);
+        }
+    }
+    /**
+     * 仅警告，不抛异常；用于数值退化或可容忍的异常情形
+     */
+    static warn(message) {
+        console.warn(`[MathError] ${message}`);
+    }
+}

package/dist/utils/math_utils.d.ts

@@ -0,0 +1,9 @@
+export declare class MathUtils {
+    /** 将数值限制在 [min, max] 区间内 */
+    static clamp(x: number, min: number, max: number): number;
+    /** 线性插值 */
+    static lerp(a: number, b: number, t: number): number;
+    /** 近似相等判断（Precision.equal 包装） */
+    static almostEqual(a: number, b: number, eps?: number): boolean;
+}
+//# sourceMappingURL=math_utils.d.ts.map

package/dist/utils/math_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math_utils.d.ts","sourceRoot":"","sources":["../../src/utils/math_utils.ts"],"names":[],"mappings":"AAQA,qBAAa,SAAS;IAClB,4BAA4B;WACd,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAOvD,WAAW;WACG,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAIlD,iCAAiC;WACnB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,SAAgB;CAGtE"}

package/dist/utils/math_utils.js

@@ -0,0 +1,25 @@
+/*
+ * Linea Math - Utils
+ * MathUtils: 通用标量工具
+ */
+import { MathError } from './math_error';
+import { Precision } from './precision';
+export class MathUtils {
+    /** 将数值限制在 [min, max] 区间内 */
+    static clamp(x, min, max) {
+        MathError.assert(min <= max, 'MathUtils.clamp: min must be <= max');
+        if (x < min)
+            return min;
+        if (x > max)
+            return max;
+        return x;
+    }
+    /** 线性插值 */
+    static lerp(a, b, t) {
+        return a + (b - a) * t;
+    }
+    /** 近似相等判断（Precision.equal 包装） */
+    static almostEqual(a, b, eps = Precision.EPS) {
+        return Precision.equal(a, b, eps);
+    }
+}

package/dist/utils/precision.d.ts

@@ -0,0 +1,29 @@
+export declare class Precision {
+    /** 通用数值容差 */
+    static EPS: number;
+    /** 长度与近零判断容差 */
+    static LEN_EPS: number;
+    /** 角度容差（弧度） */
+    static ANG_EPS: number;
+    /** 曲线参数域容差（求值与区间校验） */
+    static CURVE_PARAM_EPS: number;
+    /** 曲线长度/距离相关容差 */
+    static CURVE_LENGTH_EPS: number;
+    /** 曲线长度容差的平方 */
+    static CURVE_LENGTH_EPS_SQ: number;
+    /** 曲线牛顿迭代收敛容差 */
+    static CURVE_NEWTON_EPS: number;
+    /** 曲线求解最大迭代次数，避免死循环 */
+    static CURVE_MAX_ITER: number;
+    /** 自适应积分最大递归深度 */
+    static CURVE_INTEGRAL_MAX_DEPTH: number;
+    /** 近似相等判断：绝对误差 + 相对误差 */
+    static equal(a: number, b: number, eps?: number): boolean;
+    /** 近零判断 */
+    static nearlyZero(x: number, eps?: number): boolean;
+    /** 平方量近零判断（避免频繁开方） */
+    static nearlyZeroSq(x: number, eps?: number): boolean;
+    /** 角度近似相等判断（弧度） */
+    static angleEqual(a: number, b: number, eps?: number): boolean;
+}
+//# sourceMappingURL=precision.d.ts.map

package/dist/utils/precision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precision.d.ts","sourceRoot":"","sources":["../../src/utils/precision.ts"],"names":[],"mappings":"AAKA,qBAAa,SAAS;IAClB,aAAa;IACb,OAAc,GAAG,SAAO;IAExB,gBAAgB;IAChB,OAAc,OAAO,SAAQ;IAE7B,eAAe;IACf,OAAc,OAAO,SAAO;IAE5B,uBAAuB;IACvB,OAAc,eAAe,SAAO;IAEpC,kBAAkB;IAClB,OAAc,gBAAgB,SAAO;IAErC,gBAAgB;IAChB,OAAc,mBAAmB,SAA0D;IAE3F,iBAAiB;IACjB,OAAc,gBAAgB,SAAQ;IAEtC,uBAAuB;IACvB,OAAc,cAAc,SAAK;IAEjC,kBAAkB;IAClB,OAAc,wBAAwB,SAAK;IAE3C,yBAAyB;WACX,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,SAAgB;IAO7D,WAAW;WACG,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,SAAoB;IAI3D,sBAAsB;WACR,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,SAAoB;IAI7D,mBAAmB;WACL,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,SAAoB;CAGzE"}

package/dist/utils/precision.js

@@ -0,0 +1,44 @@
+/*
+ * Linea Math - Utils
+ * Precision: 集中定义数值容差与比较工具
+ */
+export class Precision {
+    /** 近似相等判断：绝对误差 + 相对误差 */
+    static equal(a, b, eps = Precision.EPS) {
+        const diff = Math.abs(a - b);
+        if (diff <= eps)
+            return true;
+        const max = Math.max(1, Math.abs(a), Math.abs(b));
+        return diff <= eps * max;
+    }
+    /** 近零判断 */
+    static nearlyZero(x, eps = Precision.LEN_EPS) {
+        return Math.abs(x) <= eps;
+    }
+    /** 平方量近零判断（避免频繁开方） */
+    static nearlyZeroSq(x, eps = Precision.LEN_EPS) {
+        return x <= eps * eps;
+    }
+    /** 角度近似相等判断（弧度） */
+    static angleEqual(a, b, eps = Precision.ANG_EPS) {
+        return Precision.equal(a, b, eps);
+    }
+}
+/** 通用数值容差 */
+Precision.EPS = 1e-9;
+/** 长度与近零判断容差 */
+Precision.LEN_EPS = 1e-12;
+/** 角度容差（弧度） */
+Precision.ANG_EPS = 1e-6;
+/** 曲线参数域容差（求值与区间校验） */
+Precision.CURVE_PARAM_EPS = 1e-9;
+/** 曲线长度/距离相关容差 */
+Precision.CURVE_LENGTH_EPS = 1e-8;
+/** 曲线长度容差的平方 */
+Precision.CURVE_LENGTH_EPS_SQ = Precision.CURVE_LENGTH_EPS * Precision.CURVE_LENGTH_EPS;
+/** 曲线牛顿迭代收敛容差 */
+Precision.CURVE_NEWTON_EPS = 1e-10;
+/** 曲线求解最大迭代次数，避免死循环 */
+Precision.CURVE_MAX_ITER = 50;
+/** 自适应积分最大递归深度 */
+Precision.CURVE_INTEGRAL_MAX_DEPTH = 12;

package/package.json

@@ -0,0 +1,38 @@
+{
+    "name": "@ccpc/math",
+    "version": "0.1.0",
+    "private": false,
+    "description": "2D geometry and curve math library",
+    "license": "MIT",
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+        "build": "tsc -p tsconfig.json",
+        "lint": "eslint . --ext .ts",
+        "lint:fix": "eslint . --ext .ts --fix",
+        "test": "vitest",
+        "test:run": "vitest run",
+        "test:coverage": "vitest run --coverage",
+        "prepublishOnly": "pnpm run build && pnpm run test:run"
+    },
+    "devDependencies": {
+        "@vitest/coverage-v8": "^4.0.18",
+        "vitest": "^4.0.18"
+    }
+}