@vectojs/core 0.1.0 → 0.2.0

package/dist/{text.d.ts → text/MSDFFont.d.ts}

@@ -1,5 +1,3 @@
-import { E as Entity, I as IRenderer } from './Entity-D-rfAFCf.js';
-
 /**
  * MSDF (Multi-channel Signed Distance Field) font support.
  *
@@ -14,7 +12,7 @@ import { E as Entity, I as IRenderer } from './Entity-D-rfAFCf.js';
  * Y-flip, the same as `setTexture`/`addSprite`).
  */
 /** Atlas section of an `msdf-atlas-gen` JSON file. */
-interface MSDFAtlasInfo {
+export interface MSDFAtlasInfo {
     /** Field type, e.g. `'msdf'` | `'mtsdf'` | `'sdf'`. */
     type: string;
     /** Distance field range in atlas pixels — drives the shader's edge sharpness. */
@@ -29,7 +27,7 @@ interface MSDFAtlasInfo {
     yOrigin: 'bottom' | 'top';
 }
 /** Font-wide metrics in em units. */
-interface MSDFMetrics {
+export interface MSDFMetrics {
     emSize: number;
     /** Line advance in em (multiply by font size for px). */
     lineHeight: number;
@@ -41,14 +39,14 @@ interface MSDFMetrics {
     underlineThickness?: number;
 }
 /** Em-unit / atlas-pixel rectangle as emitted by `msdf-atlas-gen`. */
-interface MSDFBounds {
+export interface MSDFBounds {
     left: number;
     bottom: number;
     right: number;
     top: number;
 }
 /** One glyph's metrics. Whitespace has `advance` but no plane/atlas bounds. */
-interface MSDFGlyphDef {
+export interface MSDFGlyphDef {
     unicode: number;
     /** Horizontal advance in em units. */
     advance: number;
@@ -58,20 +56,20 @@ interface MSDFGlyphDef {
     atlasBounds?: MSDFBounds;
 }
 /** Kerning pair adjustment in em units. */
-interface MSDFKerning {
+export interface MSDFKerning {
     unicode1: number;
     unicode2: number;
     advance: number;
 }
 /** A parsed `msdf-atlas-gen` JSON document. */
-interface MSDFFontData {
+export 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 {
+export interface PositionedGlyph {
     /** Source character (may be a surrogate-pair astral codepoint). */
     char: string;
     /** Quad top-left in local CSS pixels (y-down). */
@@ -87,7 +85,7 @@ interface PositionedGlyph {
     v1: number;
 }
 /** Result of {@link MSDFFont.layout}. */
-interface MSDFLayoutResult {
+export interface MSDFLayoutResult {
     glyphs: PositionedGlyph[];
     /** Total pen advance of the widest line in CSS pixels. */
     width: number;
@@ -95,7 +93,7 @@ interface MSDFLayoutResult {
     height: number;
 }
 /** Options for {@link MSDFFont.layout}. */
-interface MSDFLayoutOptions {
+export 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. */
@@ -107,7 +105,7 @@ interface MSDFLayoutOptions {
  * 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 {
+export declare class MSDFFont {
     private static idCounter;
     readonly id: string;
     readonly data: MSDFFontData;
@@ -129,73 +127,3 @@ declare class MSDFFont {
      */
     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/MSDFTextEntity.d.ts

@@ -0,0 +1,30 @@
+import { Entity } from '../tree/Entity';
+import { MSDFFont } from './MSDFFont';
+export interface MSDFTextEntityOptions {
+    font: MSDFFont;
+    texture: TexImageSource;
+    fallbackFont?: string;
+    fontSize?: number;
+    color?: string;
+    lineHeight?: number;
+    letterSpacing?: number;
+}
+export 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;
+}

package/dist/text/SVGEntity.d.ts

@@ -0,0 +1,22 @@
+import { Entity } from '../tree/Entity';
+import { IRenderer } from '../renderer/IRenderer';
+export 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;
+}

package/dist/text/index.d.ts

@@ -0,0 +1,5 @@
+export * from './ArabicShaper';
+export * from './BidiResolver';
+export * from './MSDFFont';
+export * from './MSDFTextEntity';
+export * from './SVGEntity';

package/dist/text.js

@@ -2,7 +2,7 @@
 
 
 
-var _chunk53DAQC3Ujs = require('./chunk-53DAQC3U.js');
+var _chunkW3SFIVXOjs = require('./chunk-W3SFIVXO.js');
 
 
 
@@ -13,4 +13,4 @@ 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;
+exports.ArabicShaper = _chunkRW6NC4RBjs.ArabicShaper; exports.BidiResolver = _chunkRW6NC4RBjs.BidiResolver; exports.MSDFFont = _chunkW3SFIVXOjs.MSDFFont; exports.MSDFTextEntity = _chunkW3SFIVXOjs.MSDFTextEntity; exports.SVGEntity = _chunkW3SFIVXOjs.SVGEntity;

package/dist/text.mjs

@@ -2,7 +2,7 @@ import {
   MSDFFont,
   MSDFTextEntity,
   SVGEntity
-} from "./chunk-M2IZPGOL.mjs";
+} from "./chunk-Y2N7TGEH.mjs";
 import {
   ArabicShaper,
   BidiResolver

package/dist/tree/ComputeParticleEntity.d.ts

@@ -0,0 +1,118 @@
+import { Entity } from './Entity';
+import { IRenderer } from '../renderer/IRenderer';
+/**
+ * Options for configuring a {@link ComputeParticleEntity}.
+ */
+export interface ComputeParticleOptions {
+    /** Maximum number of particles to simulate. Defaults to 10000. */
+    maxParticles?: number;
+    /** Spring stiffness coefficient for returning to origin. Defaults to 0.05. */
+    springK?: number;
+    /** Velocity damping factor in `[0, 1]`. Defaults to 0.95. */
+    damping?: number;
+    /** Bounce damping factor for boundary collisions in `[0, 1]`. Defaults to 0.5. */
+    bounceDamping?: number;
+    /** Speed limit for particles. Defaults to 500.0. */
+    maxVelocity?: number;
+    /** Base particle size in pixels. Defaults to 4. */
+    size?: number;
+    /** CSS color string for the particles. Defaults to '#00f0ff'. */
+    color?: string;
+    /** Whether the particle layer captures pointer/hit events. Defaults to false. */
+    pointerEvents?: boolean;
+}
+export declare const PARTICLE_STRIDE_FLOATS = 8;
+export declare const PARTICLE_OFFSET_POSITION_X = 0;
+export declare const PARTICLE_OFFSET_POSITION_Y = 1;
+export declare const PARTICLE_OFFSET_VELOCITY_X = 2;
+export declare const PARTICLE_OFFSET_VELOCITY_Y = 3;
+export declare const PARTICLE_OFFSET_ORIGIN_X = 4;
+export declare const PARTICLE_OFFSET_ORIGIN_Y = 5;
+export declare const PARTICLE_OFFSET_SIZE = 6;
+export declare const PARTICLE_OFFSET_LIFE = 7;
+/**
+ * An entity representing a high-performance WebGPU/CPU particle simulation layer.
+ */
+export declare class ComputeParticleEntity extends Entity {
+    maxParticles: number;
+    springK: number;
+    damping: number;
+    bounceDamping: number;
+    maxVelocity: number;
+    size: number;
+    baseColor: string;
+    pointerEvents: boolean;
+    /** Flat array containing layout of all particles: position, velocity, origin, size, life. */
+    particleData: Float32Array;
+    /** Flag indicating whether the particle coordinates need to be initialized. */
+    needsInit: boolean;
+    /** Active explosion impulse to apply in the next simulation step. */
+    pendingExplosion: {
+        x: number;
+        y: number;
+        force: number;
+    } | null;
+    /** WebGPU storage buffer containing particle states. */
+    gpuStorageBuffer: any;
+    /** WebGPU uniform buffer containing simulation parameters. */
+    gpuUniformBuffer: any;
+    /** WebGPU bind group for the compute shader pass. */
+    computeBindGroup: any;
+    /** WebGPU bind group for the render pass (usually same as compute). */
+    renderBindGroup: any;
+    constructor(options?: ComputeParticleOptions);
+    /**
+     * Disperses all particles randomly across the specified screen bounds.
+     * Sets initial positions, velocities, origins, and sizes.
+     *
+     * @param width - Simulation zone width.
+     * @param height - Simulation zone height.
+     */
+    initRandomParticles(width: number, height: number): void;
+    /**
+     * Sets the origins (ox, oy) for a subset or all particles.
+     * Also sets position to origin if requestPositionReset is true.
+     *
+     * @param points - Flat Float32Array containing [x0, y0, x1, y1, ...]
+     * @param requestPositionReset - Whether to set current positions to the new origins. Defaults to true.
+     */
+    setOrigins(points: Float32Array | number[], requestPositionReset?: boolean): void;
+    /**
+     * Sets the current positions (x, y) for a subset or all particles.
+     *
+     * @param positions - Flat Float32Array containing [x0, y0, x1, y1, ...]
+     */
+    setPositions(positions: Float32Array | number[]): void;
+    /**
+     * Sets the current velocities (vx, vy) for a subset or all particles.
+     *
+     * @param velocities - Flat Float32Array containing [vx0, vy0, vx1, vy1, ...]
+     */
+    setVelocities(velocities: Float32Array | number[]): void;
+    /**
+     * Triggers an explosion force center.
+     *
+     * @param x - Explosion center x-coordinate.
+     * @param y - Explosion center y-coordinate.
+     * @param force - Magnitude force scalar.
+     */
+    triggerExplosion(x: number, y: number, force: number): void;
+    isPointInside(_x: number, _y: number): boolean;
+    render(_r: IRenderer): void;
+    /**
+     * Updates particle simulation on the CPU.
+     * Handles spring forces, mouse repulsion, explosion impulses, velocity capping, and bounds bouncing/clamping.
+     *
+     * @param dt - Delta time in seconds.
+     * @param mouseX - Mouse x-coordinate, or a value below -9000 if inactive.
+     * @param mouseY - Mouse y-coordinate, or a value below -9000 if inactive.
+     * @param width - Boundary width.
+     * @param height - Boundary height.
+     */
+    updateCPU(dt: number, mouseX: number, mouseY: number, width: number, height: number): void;
+    destroy(): void;
+    /**
+     * Frees all GPU resources allocated for WebGPU simulation.
+     */
+    destroyGPUResources(): void;
+}

package/dist/tree/DOMPortalEntity.d.ts

@@ -0,0 +1,18 @@
+import { Entity } from './Entity';
+export declare class DOMPortalEntity extends Entity {
+    domElement: HTMLElement;
+    isDOMPortal: boolean;
+    private domListeners;
+    private resizeObserver;
+    cachedWidth: number;
+    cachedHeight: number;
+    lastWidth: string;
+    lastHeight: string;
+    lastTransform: string;
+    lastZIndex: string;
+    constructor(domElement: HTMLElement, width?: number, height?: number, id?: string);
+    isPointInside(globalX: number, globalY: number): boolean;
+    add(child: Entity): this;
+    render(): void;
+    destroy(): void;
+}