@weasel-js/core 1.3.0 → 1.4.0-pre.0

package/dist/stroke-5pBwOm9s.d.ts

@@ -1,190 +0,0 @@
-import { M as Mat3 } from './DrawCommand-BnZyQaDc.js';
-import { P as Path } from './path-JEV2c5If.js';
-import { Stroke } from '@weasel-js/paint';
-
-/**
- * Minimal compile/link/lookup wrapper for a GL program. Throws
- * `ShaderCompileError` on compile or link failure with the GL info log
- * embedded in the error message — never returns a half-initialized program.
- *
- * Designed so test code can stub `getShaderParameter` / `getProgramParameter`
- * via the recorder Proxy without further special-casing.
- */
-type Stage = 'vertex' | 'fragment' | 'link';
-/** Thrown when a shader fails to compile or link, carrying which stage failed
- *  and the driver's log. */
-declare class ShaderCompileError extends Error {
-    readonly stage: Stage;
-    readonly log: string;
-    constructor(stage: Stage, log: string);
-}
-declare class ShaderProgram {
-    private readonly gl;
-    readonly handle: WebGLProgram;
-    private readonly uniforms;
-    private readonly attributes;
-    constructor(gl: WebGL2RenderingContext, vertSrc: string, fragSrc: string);
-    private compile;
-    lookupUniforms(names: readonly string[]): void;
-    lookupAttributes(names: readonly string[]): void;
-    uniform(name: string): WebGLUniformLocation | undefined;
-    attribute(name: string): number | undefined;
-}
-
-/**
- * A tessellated representation of a Path, ready to upload to GL.
- *
- * - `vertices` is interleaved x,y in path-local coordinates (`Float32Array`
- *   of length `2 * vertexCount`).
- * - `indices` are triangle indices into `vertices` (`Uint32Array`, length
- *   `3 * triangleCount`).
- * - `requiresStencil` is set for paths whose fillRule is `'evenodd'` and
- *   whose triangulation is a *naive* per-contour fan rather than a clean
- *   inside/outside triangulation. The renderer must use a stencil
- *   two-pass when this flag is true. Single-contour paths and `'nonzero'`
- *   multi-contour paths leave it false.
- * - `anchorA` / `anchorB` / `anchorT` parameterize each mesh vertex by
- *   the two consecutive path anchors it lies between and the arc-length
- *   fraction along that segment (0 = at A, 1 = at B). Vertices that fall
- *   exactly on an anchor set A === B and t = 0. Used at draw time when
- *   the DrawCommand supplies per-anchor colors so the renderer can lerp
- *   per mesh vertex. Optional — emitted by the path tessellators; absent
- *   on meshes built by other paths (e.g. text glyphs).
- */
-interface Mesh {
-    readonly vertices: Float32Array;
-    readonly indices: Uint32Array;
-    readonly requiresStencil?: boolean;
-    readonly anchorA?: Uint32Array;
-    readonly anchorB?: Uint32Array;
-    readonly anchorT?: Float32Array;
-}
-
-/**
- * GL texture upload cache for ImageBitmap objects.
- *
- * Key: ImageBitmap (or pattern source object) identity (WeakMap) — lets GC
- * reclaim unreferenced bitmaps. The GL textures are NOT freed when the source
- * is gc'd; deferred to v2.
- *
- * Wrapping is set once at upload time per the `repetition` parameter:
- *   - undefined / 'no-repeat' → CLAMP_TO_EDGE
- *   - 'repeat'   → REPEAT (both axes)
- *   - 'repeat-x' → REPEAT on S, CLAMP on T
- *   - 'repeat-y' → CLAMP on S, REPEAT on T
- *
- * Convention §2: texels stored straight; shader premultiplies.
- */
-type PatternRepetition = 'repeat' | 'repeat-x' | 'repeat-y' | 'no-repeat';
-/** MIN_FILTER strategy for uploaded textures. */
-type ImageMinification = 'linear' | 'mipmap';
-type TexSource = ImageBitmap | ImageData | HTMLCanvasElement | HTMLImageElement;
-declare class GLImageCache {
-    private readonly gl;
-    private readonly minification;
-    private readonly map;
-    /** `minification` selects the MIN_FILTER strategy for uploaded textures.
-     *  `'linear'` (default) is the screen path's existing behavior. `'mipmap'`
-     *  generates mipmaps and filters LINEAR_MIPMAP_LINEAR — required for
-     *  quality minification when a large source bitmap is drawn small (the
-     *  headless print/export path); bilinear-only minification undersamples
-     *  and produces moiré. */
-    constructor(gl: WebGL2RenderingContext, minification?: ImageMinification);
-    upload(key: object, source: TexSource, repetition?: PatternRepetition): WebGLTexture;
-    bind(key: object, unit: number): void;
-}
-
-/**
- * Uniform-grid sprite sheet layout — frame index to the source rect an
- * `ImageDrawCommand` samples. Pure arithmetic over the grid description; it
- * never touches the bitmap.
- */
-/** A sprite sheet's grid. `margin` and `spacing` follow the Tiled / Aseprite
- *  tileset convention, so a sheet exported from either describes itself here. */
-interface SpriteSheet {
-    frameWidth: number;
-    frameHeight: number;
-    columns: number;
-    /** Empty pixels around the whole grid. Default 0. */
-    margin?: number;
-    /** Empty pixels between adjacent cells — the gutter that keeps linear
-     *  sampling off the neighboring frame. Default 0. */
-    spacing?: number;
-}
-/**
- * Row-major source rect for frame `index`, counting from 0 at the top-left.
- *
- * `index` is not range-checked and does not wrap: past the last cell this
- * returns a rect below the sheet, which draws as an edge smear. Wrapping is
- * the animation's business (`frameRect(sheet, tick % count)`) — a sheet does
- * not know how many of its cells are filled.
- */
-declare function frameRect(sheet: SpriteSheet, index: number): {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-};
-
-/**
- * View → Mat3 helper for layer `draw` implementations on world-space layers.
- *
- * The kit's main package ships a `View` type at
- * `src/core/viewport/view.ts`; we re-declare a structurally compatible
- * shape here to avoid a runtime cross-package import. Exported as
- * `ViewLike` from the package barrel.
- */
-
-/** A weasel View — `{x, y, scale: {x, y}}`. Local type to avoid a cross-package import. */
-interface View {
-    x: number;
-    y: number;
-    scale: {
-        x: number;
-        y: number;
-    };
-}
-/**
- * Build the world→screen transform matrix for a `View`.
- * Use as the `transform` field of a `kind: 'group'` DrawCommand to wrap
- * world-space content emitted from a layer `draw` implementation.
- *
- * Mapping: `screen = (world − {view.x, view.y}) × {view.scale.x, view.scale.y}`.
- *
- * Column-major layout (matches `mat3.identity()`):
- * `[scale.x, 0, 0,  0, scale.y, 0,  -view.x*scale.x, -view.y*scale.y, 1]`.
- */
-declare function viewToMat3(view: View): Mat3;
-
-/** Options for stroke tessellation. */
-interface StrokeOptions {
-    flattenTolerance?: number;
-    /**
-     * Shorten each open subpath by this much at its start / end, in the same
-     * world units as the path. Stroke markers use this so a filled head is not
-     * speared by its own line; the caller resolves the distance, because this
-     * layer knows nothing about the marker registry.
-     */
-    startInset?: number;
-    endInset?: number;
-}
-/** Resolve a stroke width to world units. A number is already world units;
- *  `{ px }` is screen pixels divided by the accumulated scale, so it holds its
- *  on-screen thickness as the view zooms. */
-declare function resolveStrokeWidth(width: number | {
-    px: number;
-}, scale: number): number;
-/**
- * Build a triangle-mesh ribbon from a stroked Path.
- *
- * Supports:
- *   - cap: 'butt' | 'round' | 'square'
- *   - join: 'miter' | 'round' | 'bevel'
- *   - center alignment directly; RectPath inner/outer alignment via a
- *     pre-shifted rect; PolygonPath inner/outer alignment via stencil at the
- *     renderer level
- *   - dash splitting
- */
-declare function tessellateStroke(path: Path, stroke: Stroke, opts?: StrokeOptions): Mesh;
-
-export { GLImageCache as G, type ImageMinification as I, type Mesh as M, ShaderProgram as S, type View as V, ShaderCompileError as a, type SpriteSheet as b, type StrokeOptions as c, frameRect as f, resolveStrokeWidth as r, tessellateStroke as t, viewToMat3 as v };