@vectojs/core 0.1.0

package/dist/renderer.js

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+var _chunkLIX7DJTIjs = require('./chunk-LIX7DJTI.js');
+
+
+
+
+
+
+exports.CanvasRenderer = _chunkLIX7DJTIjs.CanvasRenderer; exports.SVGRenderer = _chunkLIX7DJTIjs.SVGRenderer; exports.WebGPUParticleSystemManager = _chunkLIX7DJTIjs.WebGPUParticleSystemManager; exports.createWebGLPointRenderer = _chunkLIX7DJTIjs.createWebGLPointRenderer; exports.parseColorToRGBA = _chunkLIX7DJTIjs.parseColorToRGBA;

package/dist/renderer.mjs

@@ -0,0 +1,14 @@
+import {
+  CanvasRenderer,
+  SVGRenderer,
+  WebGPUParticleSystemManager,
+  createWebGLPointRenderer,
+  parseColorToRGBA
+} from "./chunk-2Y45S4JK.mjs";
+export {
+  CanvasRenderer,
+  SVGRenderer,
+  WebGPUParticleSystemManager,
+  createWebGLPointRenderer,
+  parseColorToRGBA
+};

package/dist/text.d.mts

@@ -0,0 +1,201 @@
+import { E as Entity, I as IRenderer } from './Entity-D-rfAFCf.mjs';
+
+/**
+ * MSDF (Multi-channel Signed Distance Field) font support.
+ *
+ * Parses the `msdf-atlas-gen` JSON layout — the de-facto MSDF format produced by
+ * Chlumsky's `msdf-atlas-gen` / `msdfgen` — and lays a string out into textured
+ * quads positioned in CSS pixels with atlas UVs. Pair {@link MSDFFont.layout}
+ * with the WebGL backend's `setMSDFTexture` + `addGlyph` to render GPU text that
+ * stays crisp at any scale (and supports outline/glow in the shader).
+ *
+ * Geometry conventions match the renderer: local space is y-down, top-left
+ * origin; UVs use v=0 at the top of the atlas image (atlas uploaded without a
+ * Y-flip, the same as `setTexture`/`addSprite`).
+ */
+/** Atlas section of an `msdf-atlas-gen` JSON file. */
+interface MSDFAtlasInfo {
+    /** Field type, e.g. `'msdf'` | `'mtsdf'` | `'sdf'`. */
+    type: string;
+    /** Distance field range in atlas pixels — drives the shader's edge sharpness. */
+    distanceRange: number;
+    /** Glyph size the atlas was rasterized at (em → px), informational. */
+    size: number;
+    /** Atlas image width in pixels. */
+    width: number;
+    /** Atlas image height in pixels. */
+    height: number;
+    /** Whether `atlasBounds` are measured from the image bottom or top. */
+    yOrigin: 'bottom' | 'top';
+}
+/** Font-wide metrics in em units. */
+interface MSDFMetrics {
+    emSize: number;
+    /** Line advance in em (multiply by font size for px). */
+    lineHeight: number;
+    /** Distance from baseline to the top of the line in em (positive, up). */
+    ascender: number;
+    /** Distance from baseline to the bottom in em (negative, down). */
+    descender: number;
+    underlineY?: number;
+    underlineThickness?: number;
+}
+/** Em-unit / atlas-pixel rectangle as emitted by `msdf-atlas-gen`. */
+interface MSDFBounds {
+    left: number;
+    bottom: number;
+    right: number;
+    top: number;
+}
+/** One glyph's metrics. Whitespace has `advance` but no plane/atlas bounds. */
+interface MSDFGlyphDef {
+    unicode: number;
+    /** Horizontal advance in em units. */
+    advance: number;
+    /** Quad position relative to the baseline, em units, y-up. */
+    planeBounds?: MSDFBounds;
+    /** Source rectangle in the atlas, pixels. */
+    atlasBounds?: MSDFBounds;
+}
+/** Kerning pair adjustment in em units. */
+interface MSDFKerning {
+    unicode1: number;
+    unicode2: number;
+    advance: number;
+}
+/** A parsed `msdf-atlas-gen` JSON document. */
+interface MSDFFontData {
+    atlas: MSDFAtlasInfo;
+    metrics: MSDFMetrics;
+    glyphs: MSDFGlyphDef[];
+    kerning?: MSDFKerning[];
+}
+/** A glyph positioned for rendering: a CSS-pixel quad + atlas UVs (0..1). */
+interface PositionedGlyph {
+    /** Source character (may be a surrogate-pair astral codepoint). */
+    char: string;
+    /** Quad top-left in local CSS pixels (y-down). */
+    x: number;
+    y: number;
+    /** Quad size in CSS pixels. */
+    w: number;
+    h: number;
+    /** Atlas UVs: `(u0,v0)` top-left, `(u1,v1)` bottom-right; v=0 is the atlas top. */
+    u0: number;
+    v0: number;
+    u1: number;
+    v1: number;
+}
+/** Result of {@link MSDFFont.layout}. */
+interface MSDFLayoutResult {
+    glyphs: PositionedGlyph[];
+    /** Total pen advance of the widest line in CSS pixels. */
+    width: number;
+    /** `lineCount × lineHeight × fontSize` in CSS pixels. */
+    height: number;
+}
+/** Options for {@link MSDFFont.layout}. */
+interface MSDFLayoutOptions {
+    /** Pen origin x (left of the first glyph), CSS pixels. Default 0. */
+    x?: number;
+    /** Text-block top y (baseline of line 0 = `y + ascender×size`). Default 0. */
+    y?: number;
+    /** Extra advance added after every glyph, CSS pixels. Default 0. */
+    letterSpacing?: number;
+}
+/**
+ * A loaded MSDF font. Construct from parsed {@link MSDFFontData}, or use
+ * {@link MSDFFont.parse} to read the JSON string straight from `msdf-atlas-gen`.
+ */
+declare class MSDFFont {
+    private static idCounter;
+    readonly id: string;
+    readonly data: MSDFFontData;
+    private readonly byCode;
+    private readonly kern;
+    constructor(data: MSDFFontData);
+    /** Parse the `msdf-atlas-gen` JSON (string or already-parsed object). */
+    static parse(json: string | MSDFFontData): MSDFFont;
+    /** Get a glyph's definition by its unicode value in O(1) time. */
+    getGlyph(unicode: number): MSDFGlyphDef | undefined;
+    /** Distance field range in atlas pixels (for the shader's `u_distanceRange`). */
+    get distanceRange(): number;
+    get atlasWidth(): number;
+    get atlasHeight(): number;
+    /**
+     * Lay `text` out at `fontSizePx`. Returns positioned quads (skipping glyphs the
+     * font doesn't contain), the widest line's advance, and the total block height.
+     * Honors `\n`, kerning pairs, and `letterSpacing`.
+     */
+    layout(text: string, fontSizePx: number, opts?: MSDFLayoutOptions): MSDFLayoutResult;
+}
+
+interface MSDFTextEntityOptions {
+    font: MSDFFont;
+    texture: TexImageSource;
+    fallbackFont?: string;
+    fontSize?: number;
+    color?: string;
+    lineHeight?: number;
+    letterSpacing?: number;
+}
+declare class MSDFTextEntity extends Entity {
+    private font;
+    private texture;
+    private fallbackFont;
+    private fontSize;
+    color: string;
+    private letterSpacing;
+    private lineHeight?;
+    private text;
+    private lastRenderedSeqId;
+    private rgbColorCache;
+    private fontStringCache;
+    private layoutResult;
+    constructor(text: string, options: MSDFTextEntityOptions);
+    setText(text: string): void;
+    isPointInside(globalX: number, globalY: number): boolean;
+    render(renderer: any): void;
+    destroy(): void;
+}
+
+declare class SVGEntity extends Entity {
+    private svgSource;
+    private imageBitmap;
+    private imageElement;
+    private blobURL;
+    private currentImg;
+    private lodTimeout;
+    private cachedDoc;
+    private baseWidth;
+    private baseHeight;
+    private lastRasterizedScale;
+    private targetScale;
+    constructor(svgSource: string, id?: string);
+    setSVGSource(svgSource: string): void;
+    private parseSVGDimensions;
+    private triggerRasterization;
+    isPointInside(globalX: number, globalY: number): boolean;
+    render(r: IRenderer): void;
+    destroy(): void;
+}
+
+interface ShapedResult {
+    shapedText: string;
+    indexMap: Int32Array;
+}
+declare class ArabicShaper {
+    private static MAPPINGS;
+    private static isHarakat;
+    private static getJoiningType;
+    static shapeArabic(text: string): ShapedResult;
+}
+
+declare class BidiResolver {
+    private static getDirectionClass;
+    static getBaseLevel(text: string): number;
+    static resolveLevels(text: string): Uint8Array;
+    static reorderVisual(nodes: any[], baseLevel: number): void;
+}
+
+export { ArabicShaper, BidiResolver, type MSDFAtlasInfo, type MSDFBounds, MSDFFont, type MSDFFontData, type MSDFGlyphDef, type MSDFKerning, type MSDFLayoutOptions, type MSDFLayoutResult, type MSDFMetrics, MSDFTextEntity, type MSDFTextEntityOptions, type PositionedGlyph, SVGEntity, type ShapedResult };

package/dist/text.d.ts

@@ -0,0 +1,201 @@
+import { E as Entity, I as IRenderer } from './Entity-D-rfAFCf.js';
+
+/**
+ * MSDF (Multi-channel Signed Distance Field) font support.
+ *
+ * Parses the `msdf-atlas-gen` JSON layout — the de-facto MSDF format produced by
+ * Chlumsky's `msdf-atlas-gen` / `msdfgen` — and lays a string out into textured
+ * quads positioned in CSS pixels with atlas UVs. Pair {@link MSDFFont.layout}
+ * with the WebGL backend's `setMSDFTexture` + `addGlyph` to render GPU text that
+ * stays crisp at any scale (and supports outline/glow in the shader).
+ *
+ * Geometry conventions match the renderer: local space is y-down, top-left
+ * origin; UVs use v=0 at the top of the atlas image (atlas uploaded without a
+ * Y-flip, the same as `setTexture`/`addSprite`).
+ */
+/** Atlas section of an `msdf-atlas-gen` JSON file. */
+interface MSDFAtlasInfo {
+    /** Field type, e.g. `'msdf'` | `'mtsdf'` | `'sdf'`. */
+    type: string;
+    /** Distance field range in atlas pixels — drives the shader's edge sharpness. */
+    distanceRange: number;
+    /** Glyph size the atlas was rasterized at (em → px), informational. */
+    size: number;
+    /** Atlas image width in pixels. */
+    width: number;
+    /** Atlas image height in pixels. */
+    height: number;
+    /** Whether `atlasBounds` are measured from the image bottom or top. */
+    yOrigin: 'bottom' | 'top';
+}
+/** Font-wide metrics in em units. */
+interface MSDFMetrics {
+    emSize: number;
+    /** Line advance in em (multiply by font size for px). */
+    lineHeight: number;
+    /** Distance from baseline to the top of the line in em (positive, up). */
+    ascender: number;
+    /** Distance from baseline to the bottom in em (negative, down). */
+    descender: number;
+    underlineY?: number;
+    underlineThickness?: number;
+}
+/** Em-unit / atlas-pixel rectangle as emitted by `msdf-atlas-gen`. */
+interface MSDFBounds {
+    left: number;
+    bottom: number;
+    right: number;
+    top: number;
+}
+/** One glyph's metrics. Whitespace has `advance` but no plane/atlas bounds. */
+interface MSDFGlyphDef {
+    unicode: number;
+    /** Horizontal advance in em units. */
+    advance: number;
+    /** Quad position relative to the baseline, em units, y-up. */
+    planeBounds?: MSDFBounds;
+    /** Source rectangle in the atlas, pixels. */
+    atlasBounds?: MSDFBounds;
+}
+/** Kerning pair adjustment in em units. */
+interface MSDFKerning {
+    unicode1: number;
+    unicode2: number;
+    advance: number;
+}
+/** A parsed `msdf-atlas-gen` JSON document. */
+interface MSDFFontData {
+    atlas: MSDFAtlasInfo;
+    metrics: MSDFMetrics;
+    glyphs: MSDFGlyphDef[];
+    kerning?: MSDFKerning[];
+}
+/** A glyph positioned for rendering: a CSS-pixel quad + atlas UVs (0..1). */
+interface PositionedGlyph {
+    /** Source character (may be a surrogate-pair astral codepoint). */
+    char: string;
+    /** Quad top-left in local CSS pixels (y-down). */
+    x: number;
+    y: number;
+    /** Quad size in CSS pixels. */
+    w: number;
+    h: number;
+    /** Atlas UVs: `(u0,v0)` top-left, `(u1,v1)` bottom-right; v=0 is the atlas top. */
+    u0: number;
+    v0: number;
+    u1: number;
+    v1: number;
+}
+/** Result of {@link MSDFFont.layout}. */
+interface MSDFLayoutResult {
+    glyphs: PositionedGlyph[];
+    /** Total pen advance of the widest line in CSS pixels. */
+    width: number;
+    /** `lineCount × lineHeight × fontSize` in CSS pixels. */
+    height: number;
+}
+/** Options for {@link MSDFFont.layout}. */
+interface MSDFLayoutOptions {
+    /** Pen origin x (left of the first glyph), CSS pixels. Default 0. */
+    x?: number;
+    /** Text-block top y (baseline of line 0 = `y + ascender×size`). Default 0. */
+    y?: number;
+    /** Extra advance added after every glyph, CSS pixels. Default 0. */
+    letterSpacing?: number;
+}
+/**
+ * A loaded MSDF font. Construct from parsed {@link MSDFFontData}, or use
+ * {@link MSDFFont.parse} to read the JSON string straight from `msdf-atlas-gen`.
+ */
+declare class MSDFFont {
+    private static idCounter;
+    readonly id: string;
+    readonly data: MSDFFontData;
+    private readonly byCode;
+    private readonly kern;
+    constructor(data: MSDFFontData);
+    /** Parse the `msdf-atlas-gen` JSON (string or already-parsed object). */
+    static parse(json: string | MSDFFontData): MSDFFont;
+    /** Get a glyph's definition by its unicode value in O(1) time. */
+    getGlyph(unicode: number): MSDFGlyphDef | undefined;
+    /** Distance field range in atlas pixels (for the shader's `u_distanceRange`). */
+    get distanceRange(): number;
+    get atlasWidth(): number;
+    get atlasHeight(): number;
+    /**
+     * Lay `text` out at `fontSizePx`. Returns positioned quads (skipping glyphs the
+     * font doesn't contain), the widest line's advance, and the total block height.
+     * Honors `\n`, kerning pairs, and `letterSpacing`.
+     */
+    layout(text: string, fontSizePx: number, opts?: MSDFLayoutOptions): MSDFLayoutResult;
+}
+
+interface MSDFTextEntityOptions {
+    font: MSDFFont;
+    texture: TexImageSource;
+    fallbackFont?: string;
+    fontSize?: number;
+    color?: string;
+    lineHeight?: number;
+    letterSpacing?: number;
+}
+declare class MSDFTextEntity extends Entity {
+    private font;
+    private texture;
+    private fallbackFont;
+    private fontSize;
+    color: string;
+    private letterSpacing;
+    private lineHeight?;
+    private text;
+    private lastRenderedSeqId;
+    private rgbColorCache;
+    private fontStringCache;
+    private layoutResult;
+    constructor(text: string, options: MSDFTextEntityOptions);
+    setText(text: string): void;
+    isPointInside(globalX: number, globalY: number): boolean;
+    render(renderer: any): void;
+    destroy(): void;
+}
+
+declare class SVGEntity extends Entity {
+    private svgSource;
+    private imageBitmap;
+    private imageElement;
+    private blobURL;
+    private currentImg;
+    private lodTimeout;
+    private cachedDoc;
+    private baseWidth;
+    private baseHeight;
+    private lastRasterizedScale;
+    private targetScale;
+    constructor(svgSource: string, id?: string);
+    setSVGSource(svgSource: string): void;
+    private parseSVGDimensions;
+    private triggerRasterization;
+    isPointInside(globalX: number, globalY: number): boolean;
+    render(r: IRenderer): void;
+    destroy(): void;
+}
+
+interface ShapedResult {
+    shapedText: string;
+    indexMap: Int32Array;
+}
+declare class ArabicShaper {
+    private static MAPPINGS;
+    private static isHarakat;
+    private static getJoiningType;
+    static shapeArabic(text: string): ShapedResult;
+}
+
+declare class BidiResolver {
+    private static getDirectionClass;
+    static getBaseLevel(text: string): number;
+    static resolveLevels(text: string): Uint8Array;
+    static reorderVisual(nodes: any[], baseLevel: number): void;
+}
+
+export { ArabicShaper, BidiResolver, type MSDFAtlasInfo, type MSDFBounds, MSDFFont, type MSDFFontData, type MSDFGlyphDef, type MSDFKerning, type MSDFLayoutOptions, type MSDFLayoutResult, type MSDFMetrics, MSDFTextEntity, type MSDFTextEntityOptions, type PositionedGlyph, SVGEntity, type ShapedResult };

package/dist/text.js

@@ -0,0 +1,16 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+var _chunk53DAQC3Ujs = require('./chunk-53DAQC3U.js');
+
+
+
+var _chunkRW6NC4RBjs = require('./chunk-RW6NC4RB.js');
+
+
+
+
+
+
+exports.ArabicShaper = _chunkRW6NC4RBjs.ArabicShaper; exports.BidiResolver = _chunkRW6NC4RBjs.BidiResolver; exports.MSDFFont = _chunk53DAQC3Ujs.MSDFFont; exports.MSDFTextEntity = _chunk53DAQC3Ujs.MSDFTextEntity; exports.SVGEntity = _chunk53DAQC3Ujs.SVGEntity;

package/dist/text.mjs

@@ -0,0 +1,16 @@
+import {
+  MSDFFont,
+  MSDFTextEntity,
+  SVGEntity
+} from "./chunk-M2IZPGOL.mjs";
+import {
+  ArabicShaper,
+  BidiResolver
+} from "./chunk-YA2J5ZH7.mjs";
+export {
+  ArabicShaper,
+  BidiResolver,
+  MSDFFont,
+  MSDFTextEntity,
+  SVGEntity
+};

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@vectojs/core",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "A zero-DOM, Canvas 2D Entity Component System (ECS) rendering framework — 60 FPS with 100,000+ entities.",
+  "keywords": [
+    "canvas",
+    "ecs",
+    "fourier",
+    "spline",
+    "rendering",
+    "60fps",
+    "typescript",
+    "vectorization"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vectojs/vectojs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vectojs/vectojs/issues"
+  },
+  "homepage": "https://github.com/vectojs/vectojs#readme",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./layout": {
+      "types": "./dist/layout.d.ts",
+      "import": "./dist/layout.mjs",
+      "require": "./dist/layout.js"
+    },
+    "./renderer": {
+      "types": "./dist/renderer.d.ts",
+      "import": "./dist/renderer.mjs",
+      "require": "./dist/renderer.js"
+    },
+    "./text": {
+      "types": "./dist/text.d.ts",
+      "import": "./dist/text.mjs",
+      "require": "./dist/text.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "node scripts/build-worker.js && tsup",
+    "test": "vitest run"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.9",
+    "esbuild": "^0.21.5",
+    "jsdom": "^29.1.1",
+    "tsup": "^8.3.5",
+    "vitest": "^4.1.9"
+  }
+}