@weasel-js/labkit 0.7.1 → 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 orochi235
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/_dts/{DrawCommand-CEvS5AdV.d.ts → DrawCommand-DACv9lhe.d.ts}

@@ -172,51 +172,6 @@ interface History {
     resumeJournal(journal: Journal): void;
 }
 
-/**
- * Pose composition for hierarchical scene graphs.
- *
- * As of the nesting change, `getPose(id)` on adapters returns the
- * **local** pose — relative to the object's direct parent. Anything in the
- * kit that needs to draw, hit-test, snap, or otherwise reason about world
- * coordinates routes through `composeWorldPose`, which walks the parent
- * chain and folds local poses together via a consumer-supplied `compose`.
- *
- * Pose shape is generic, so the compose strategy is too. For the common
- * `{x, y, width, height}` axis-aligned rect, use `composeRectPose` —
- * translation only, child dimensions preserved. Custom pose shapes (paths,
- * matrix transforms) supply their own.
- *
- * The inverse — `rebaseLocalPose` — converts a world-space pose into a
- * local pose under a target parent. Used when reparenting so the visual
- * world position of a child is preserved across the parent change.
- */
-/**
- * Axis-aligned rectangle pose with optional rotation. The canonical pose
- * shape used by `composeRectPose` and the `unionBounds` helper. Rotation is
- * in radians, pivoted on the unrotated AABB center; absent === 0. Kit-side
- * code that consumes rotation already reads `pose.rotation ?? 0`
- * (`SceneCanvas.defaultDrawOne`, `rotate/handle.ts`, `pathInWorld.ts`), so
- * the slot exists on every default scene whether or not the consumer
- * populates it. Defined here in core/transforms so the compose helpers
- * don't depend on features.
- */
-interface RectPose {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    /** Rotation in radians around the unrotated AABB center. Absent === 0. */
-    rotation?: number;
-}
-/** Consumer's pose-composition strategy for hierarchical scenes. `compose`
- *  folds a child's pose (in parent's frame) up to the next frame; `decompose`
- *  is its inverse. Default is IDENTITY — an absolute-pose scene where every
- *  node already stores world coords (parent is grouping-only, no transform). */
-interface PoseComposition<TPose> {
-    compose: (parent: TPose, child: TPose) => TPose;
-    decompose: (parent: TPose, world: TPose) => TPose;
-}
-
 /** Fill rule used by polygon path hit-testing and `ctx.fill()`. */
 type PathFillRule = 'nonzero' | 'evenodd';
 /**
@@ -246,6 +201,23 @@ interface RectPath {
 /** Canonical path shape — either an axis-aligned rect (fast path) or a polygon command stream. */
 type Path = PolygonPath | RectPath;
 
+/**
+ * Axis-aligned rectangle pose with optional rotation. The canonical pose
+ * shape used by `composeRectPose` and the `unionBounds` helper. Rotation is
+ * in radians, pivoted on the unrotated AABB center; absent === 0. Kit-side
+ * code that consumes rotation already reads `pose.rotation ?? 0`
+ * (`SceneCanvas.defaultDrawOne`, `rotate/handle.ts`, `pathInWorld.ts`), so
+ * the slot exists on every default scene whether or not the consumer
+ * populates it.
+ */
+interface RectPose {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Rotation in radians around the unrotated AABB center. Absent === 0. */
+    rotation?: number;
+}
 /**
  * # SceneNode — the thing in the scene
  *
@@ -791,6 +763,19 @@ interface TextStyle {
     underline?: boolean;
     /** Default `false`. */
     strikethrough?: boolean;
+    /**
+     * Outline painted over the glyph fill. Omitted (the default) means no
+     * outline — there is no such thing as a default text stroke.
+     *
+     * Only glyphs on the outline tier are stroked: above
+     * `textOutlineMinScreenSize` a glyph is a real `PolygonPath`, so it gets
+     * the ordinary tessellated ribbon with real joins, caps and miters, in any
+     * paint. Below it a glyph is a sampled distance field with no geometry to
+     * stroke, and it renders unstroked rather than approximated. `width` is in
+     * world units, like every other stroke in the kit — it does not scale with
+     * `fontSize`.
+     */
+    stroke?: Stroke;
 }
 
 /**
@@ -818,6 +803,9 @@ interface ResolvedRun {
     fontWeight: number;
     fontStyle: 'normal' | 'italic';
     fill: FillStyle;
+    /** Outline over this run's glyphs, or absent for none. Painted only on the
+     *  outline tier — a distance field has no geometry to stroke. */
+    stroke?: Stroke;
     /** Extra advance added after each glyph of this run, in world units. */
     letterSpacing: number;
     /** Draw a rule below this run's baseline. Additive over the node style. */
@@ -968,4 +956,4 @@ interface ShaderDrawCommand {
     };
 }
 
-export type { Bounds as B, DrawCommand as D, History as H, Node as N, Op as O, PathDrawCommand as P, Scene as S, View as V, ViewportDims as a, NodeId as b, Path as c, PoseComposition as d };
+export type { Bounds as B, DrawCommand as D, History as H, Node as N, Op as O, PathDrawCommand as P, Scene as S, View as V, ViewportDims as a, NodeId as b, Path as c };