shape-text 0.2.1 → 0.3.0

package/README.md

@@ -21,7 +21,7 @@ bun add shape-text
 
 ## Published consumer example
 
-A small React consumer app lives at [examples/react-published-package-consumer](./examples/react-published-package-consumer/). Inside this repo it resolves `shape-text` to the current package surface so it can validate unreleased API additions before the next publish.
+A small React consumer app lives at [examples/react-published-package-consumer](./examples/react-published-package-consumer/). It now renders a minimal ICT `HH:mm:SS` clock screen plus a reaching-hand SVG-mask fill example below it, all driven by the package exports. Inside this repo it installs `shape-text` through a local file dependency instead of aliasing source files, so the app validates the real packaged surface of the current tree.
 
 ## Ship readiness
 
@@ -93,12 +93,42 @@ const svg = renderLayoutToSvg(layout, {
 
 ## Shape sources
 
-`shape-text` currently ships two first-class ways to provide the shape paragraph surface:
-
-- Geometry input: pass explicit polygon points
-- Value-derived input: pass a `text-mask` shape derived from text and font
-
-The low-level API term stays `text-mask`, but the product framing is `value-derived shape`.
+`shape-text` currently ships three first-class ways to provide the shape paragraph surface:
+
+- Geometry input: pass explicit polygon points
+- Value-derived input: pass a `text-mask` shape derived from text and font
+- SVG mask input: pass a silhouette path and viewBox through `svg-mask`
+
+The low-level API term stays `text-mask`, but the product framing is `value-derived shape`.
+
+## SVG mask example
+
+```ts
+const layout = layoutTextInShape({
+  text: 'Shape paragraph can also fill an authored SVG silhouette.',
+  textStyle: {
+    family: '"Ubuntu", sans-serif',
+    size: 12,
+    weight: 400,
+    color: '#ffffff',
+  },
+  lineHeight: 14,
+  autoFill: true,
+  shape: {
+    kind: 'svg-mask',
+    path: 'M 0 0 L 160 0 L 160 40 L 0 40 Z',
+    viewBox: {
+      width: 160,
+      height: 40,
+    },
+    size: {
+      mode: 'fit-content',
+      padding: 4,
+    },
+  },
+  measurer,
+})
+```
 
 ## Value-derived example
 
@@ -184,6 +214,7 @@ const customFillText = createRandomFillText({
 - `createCanvasTextMeasurer()`
 - `createRandomFillText()`
 - `compileShapeForLayout()`
+- `clearTextMaskShapeCache()`
 - `getRandomFillPreset()`
 - `normalizeTextStyleToFont()`
 - `prepareTextForLayout()`
@@ -201,6 +232,7 @@ const customFillText = createRandomFillText({
 - The project takes inspiration from `pretext` for the `prepare -> layout` split and streaming line iteration, but owns its geometry, slot policy, and public API.
 - Geometry and value-derived shapes both compile into reusable line bands before layout.
 - `text-mask` shapes are raster-compiled into reusable line bands. This is the default value-derived path for browser fonts such as `Arial`, and it is designed so callers can precompile `0-9` and `:` for clock-like UIs.
+- `svg-mask` shapes are raster-compiled from a local SVG path silhouette plus viewBox. V1 intentionally accepts path geometry, not arbitrary raw SVG markup or remote assets.
 - `autoFill: true` now means one thing: max-fill stream layout that sweeps every usable interval in reading order.
 - Max fill keeps spaces as normal graphemes instead of stripping them, and it does not fall back to smaller text for leftover pockets.
 - Random fill helpers are content utilities only; they generate source text but do not change layout rules.

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { CompiledShapeBand, CompiledShapeBands, CompiledShapeRegion, CompileShapeForLayoutOptions, Interval, LayoutCursor, LayoutLineRange, LayoutTextInCompiledShapeOptions, LayoutTextInShapeOptions, PolygonShape, PreparedLayoutText, PreparedLayoutToken, RenderLayoutToSvgOptions, ResolvedShapeShadow, ResolvedShapeStyle, ResolvedTextStyle, ShapeInput, ShapeBounds, ShapeShadowInput, ShapeStyleInput, ShapeTextLayout, ShapeTextLine, ShapeTextPoint, TextMaskShape, TextMaskShapeFixedSize, TextMaskShapeFitContentSize, TextMaskShapeSize, TextMaskShapeSizeMode, TextMaskShapeTextMode, TextStyleInput, TextMeasurer, } from './types.js';
+export type { CompiledShapeBand, CompiledShapeBands, CompiledShapeRegion, CompileShapeForLayoutOptions, Interval, LayoutCursor, LayoutLineRange, LayoutTextInCompiledShapeOptions, LayoutTextInShapeOptions, PolygonShape, PreparedLayoutText, PreparedLayoutToken, RenderLayoutToSvgOptions, ResolvedShapeShadow, ResolvedShapeStyle, ResolvedTextStyle, ShapeInput, ShapeBounds, ShapeShadowInput, ShapeStyleInput, ShapeTextLayout, ShapeTextLine, ShapeTextPoint, SvgMaskShape, SvgMaskShapeFixedSize, SvgMaskShapeFitContentSize, SvgMaskShapeSize, SvgMaskShapeViewBox, TextMaskShape, TextMaskShapeFixedSize, TextMaskShapeFitContentSize, TextMaskShapeSize, TextMaskShapeSizeMode, TextMaskShapeTextMode, TextStyleInput, TextMeasurer, } from './types.js';
 export type { CreateRandomFillTextOptions, RandomIntSelector, } from './random-fill/create-random-fill-text.js';
 export type { RandomFillPreset, RandomFillPresetId, } from './random-fill/random-fill-presets.js';
 export { createCanvasTextMeasurer } from './text/create-canvas-text-measurer.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0CA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAChF,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAA;AACzG,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAA;AAC9F,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAA;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAA;AAC/E,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAC7F,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAA;AAC3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAA;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAA;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA+CA,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAChF,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAA;AACzG,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAA;AAC9F,OAAO,EAAE,8BAA8B,EAAE,MAAM,+CAA+C,CAAA;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAA;AAC/E,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAA;AAC7F,OAAO,EAAE,2BAA2B,EAAE,MAAM,+CAA+C,CAAA;AAC3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAA;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAA;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA"}

package/dist/render/render-layout-to-svg.js

@@ -25,6 +25,9 @@ function renderShapeAttributes(debugView, options) {
     if (debugView.kind === 'polygon') {
         return `<polygon points="${renderPoints(debugView.points)}" fill="${fill}" stroke="${stroke}" stroke-width="${options.strokeWidth}"${filter} />`;
     }
+    if (debugView.kind === 'path') {
+        return `<path d="${escapeXmlText(debugView.path)}" transform="translate(${debugView.x} ${debugView.y}) scale(${debugView.scaleX} ${debugView.scaleY})" fill="${fill}" stroke="${stroke}" stroke-width="${options.strokeWidth}"${filter} />`;
+    }
     return `<text x="${debugView.x}" y="${debugView.baseline}" fill="${fill}" stroke="${stroke}" stroke-width="${options.strokeWidth}"${filter} style="font:${escapeXmlText(debugView.font)};">${escapeXmlText(debugView.text)}</text>`;
 }
 export function renderLayoutToSvg(layout, options = {}) {

package/dist/render/render-layout-to-svg.js.map

@@ -1 +1 @@
-{"version":3,"file":"render-layout-to-svg.js","sourceRoot":"","sources":["../../src/render/render-layout-to-svg.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"render-layout-to-svg.js","sourceRoot":"","sources":["../../src/render/render-layout-to-svg.ts"],"names":[],"mappings":"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"}

package/dist/shape/compile-shape-for-layout.js

@@ -1,4 +1,5 @@
 import { compilePolygonShapeForLayout } from './compile-polygon-shape-for-layout.js';
+import { compileSvgMaskShapeForLayout } from './compile-svg-mask-shape-for-layout.js';
 import { compileTextMaskShapeForLayout } from './compile-text-mask-shape-for-layout.js';
 export function compileShapeForLayout(options) {
     if (!Number.isFinite(options.lineHeight) || options.lineHeight <= 0) {
@@ -11,6 +12,8 @@ export function compileShapeForLayout(options) {
     switch (options.shape.kind) {
         case 'polygon':
             return compilePolygonShapeForLayout(options.shape, options.lineHeight, minSlotWidth);
+        case 'svg-mask':
+            return compileSvgMaskShapeForLayout(options.shape, options.lineHeight, minSlotWidth);
         case 'text-mask':
             return compileTextMaskShapeForLayout(options.shape, options.lineHeight, minSlotWidth);
     }

package/dist/shape/compile-shape-for-layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"compile-shape-for-layout.js","sourceRoot":"","sources":["../../src/shape/compile-shape-for-layout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAA;AACpF,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAA;AAEvF,MAAM,UAAU,qBAAqB,CACnC,OAAqC;IAErC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAChE,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,CAAA;IACnF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;IAED,QAAQ,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC3B,KAAK,SAAS;YACZ,OAAO,4BAA4B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;QAEtF,KAAK,WAAW;YACd,OAAO,6BAA6B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IACzF,CAAC;AACH,CAAC"}
+{"version":3,"file":"compile-shape-for-layout.js","sourceRoot":"","sources":["../../src/shape/compile-shape-for-layout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAA;AACpF,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAA;AACrF,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAA;AAEvF,MAAM,UAAU,qBAAqB,CACnC,OAAqC;IAErC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAChE,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC,CAAA;IACnF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;IAED,QAAQ,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC3B,KAAK,SAAS;YACZ,OAAO,4BAA4B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;QAEtF,KAAK,UAAU;YACb,OAAO,4BAA4B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;QAEtF,KAAK,WAAW;YACd,OAAO,6BAA6B,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;IACzF,CAAC;AACH,CAAC"}

package/dist/shape/compile-svg-mask-shape-for-layout.d.ts

@@ -0,0 +1,2 @@
+import type { CompiledShapeBands, SvgMaskShape } from '../types.js';
+export declare function compileSvgMaskShapeForLayout(shape: SvgMaskShape, lineHeight: number, minSlotWidth: number): CompiledShapeBands;

package/dist/shape/compile-svg-mask-shape-for-layout.js

@@ -0,0 +1,109 @@
+import { buildTextMaskBandsFromAlpha } from './build-text-mask-bands-from-alpha.js';
+import { getSvgMaskPlacement, renderSvgMaskRaster, } from './render-svg-mask-raster.js';
+import { resolveSvgMaskShapeSize, resolveSvgMaskViewBox, } from './resolve-svg-mask-shape-size.js';
+const MAX_MASK_PIXELS = 4_000_000;
+const MAX_CACHE_SIZE = 64;
+const compiledShapeCache = new Map();
+function cacheSet(key, value) {
+    if (compiledShapeCache.has(key)) {
+        compiledShapeCache.delete(key);
+    }
+    else if (compiledShapeCache.size >= MAX_CACHE_SIZE) {
+        const oldestKey = compiledShapeCache.keys().next().value;
+        if (oldestKey !== undefined) {
+            compiledShapeCache.delete(oldestKey);
+        }
+    }
+    compiledShapeCache.set(key, value);
+}
+function validateSvgMaskShape(shape, size) {
+    if (shape.path.trim().length === 0) {
+        throw new Error('svg-mask shape needs a non-empty path value');
+    }
+    resolveSvgMaskViewBox(shape.viewBox);
+    const maskScale = shape.maskScale ?? 2;
+    if (!Number.isFinite(maskScale) || maskScale <= 0) {
+        throw new Error('svg-mask maskScale must be a finite positive number');
+    }
+    const pixelWidth = Math.max(1, Math.ceil(size.width * maskScale));
+    const pixelHeight = Math.max(1, Math.ceil(size.height * maskScale));
+    if (pixelWidth * pixelHeight > MAX_MASK_PIXELS) {
+        throw new Error('svg-mask raster request is too large');
+    }
+    const alphaThreshold = shape.alphaThreshold ?? 16;
+    if (!Number.isFinite(alphaThreshold) || alphaThreshold < 0 || alphaThreshold > 255) {
+        throw new Error('svg-mask alphaThreshold must be between 0 and 255');
+    }
+}
+function buildCacheKey(shape, size, lineHeight, minSlotWidth) {
+    return JSON.stringify({
+        kind: shape.kind,
+        path: shape.path,
+        viewBox: resolveSvgMaskViewBox(shape.viewBox),
+        sizeMode: size.mode,
+        width: size.width,
+        height: size.height,
+        padding: size.padding,
+        maskScale: shape.maskScale ?? 2,
+        alphaThreshold: shape.alphaThreshold ?? 16,
+        lineHeight,
+        minSlotWidth,
+    });
+}
+function freezeCompiledShape(compiledShape) {
+    for (let bandIndex = 0; bandIndex < compiledShape.bands.length; bandIndex++) {
+        const band = compiledShape.bands[bandIndex];
+        for (let intervalIndex = 0; intervalIndex < band.intervals.length; intervalIndex++) {
+            Object.freeze(band.intervals[intervalIndex]);
+        }
+        Object.freeze(band.intervals);
+        Object.freeze(band);
+    }
+    Object.freeze(compiledShape.bounds);
+    Object.freeze(compiledShape.source);
+    Object.freeze(compiledShape.debugView);
+    Object.freeze(compiledShape.bands);
+    return Object.freeze(compiledShape);
+}
+export function compileSvgMaskShapeForLayout(shape, lineHeight, minSlotWidth) {
+    const size = resolveSvgMaskShapeSize(shape);
+    validateSvgMaskShape(shape, size);
+    const cacheKey = buildCacheKey(shape, size, lineHeight, minSlotWidth);
+    const cachedShape = compiledShapeCache.get(cacheKey);
+    if (cachedShape !== undefined) {
+        compiledShapeCache.delete(cacheKey);
+        compiledShapeCache.set(cacheKey, cachedShape);
+        return cachedShape;
+    }
+    const viewBox = resolveSvgMaskViewBox(shape.viewBox);
+    const placement = getSvgMaskPlacement(shape, size);
+    const { imageData } = renderSvgMaskRaster(shape, size, placement);
+    const compiledShape = {
+        kind: shape.kind,
+        source: shape,
+        bounds: { left: 0, top: 0, right: size.width, bottom: size.height },
+        bandHeight: lineHeight,
+        minSlotWidth,
+        bands: buildTextMaskBandsFromAlpha({
+            width: size.width,
+            height: size.height,
+            maskScale: shape.maskScale ?? 2,
+            alphaThreshold: shape.alphaThreshold ?? 16,
+        }, imageData.data, lineHeight, minSlotWidth),
+        debugView: {
+            kind: 'path',
+            path: shape.path,
+            x: placement.x - viewBox.x * placement.scaleX,
+            y: placement.y - viewBox.y * placement.scaleY,
+            scaleX: placement.scaleX,
+            scaleY: placement.scaleY,
+        },
+    };
+    if (compiledShape.bands.every(band => band.intervals.length === 0)) {
+        throw new Error('svg-mask shape produced no visible fill area');
+    }
+    const frozenShape = freezeCompiledShape(compiledShape);
+    cacheSet(cacheKey, frozenShape);
+    return frozenShape;
+}
+//# sourceMappingURL=compile-svg-mask-shape-for-layout.js.map

package/dist/shape/compile-svg-mask-shape-for-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-svg-mask-shape-for-layout.js","sourceRoot":"","sources":["../../src/shape/compile-svg-mask-shape-for-layout.ts"],"names":[],"mappings":"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"}

package/dist/shape/render-svg-mask-raster.d.ts

@@ -0,0 +1,17 @@
+import type { SvgMaskShape } from '../types.js';
+import { createBrowserCanvas2DContext } from '../text/create-browser-canvas-2d-context.js';
+import { type ResolvedSvgMaskShapeSize } from './resolve-svg-mask-shape-size.js';
+export type SvgMaskPlacement = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    scaleX: number;
+    scaleY: number;
+};
+export type SvgMaskCanvas = {
+    context: ReturnType<typeof createBrowserCanvas2DContext>;
+    imageData: ImageData;
+};
+export declare function getSvgMaskPlacement(shape: SvgMaskShape, size: ResolvedSvgMaskShapeSize): SvgMaskPlacement;
+export declare function renderSvgMaskRaster(shape: SvgMaskShape, size: ResolvedSvgMaskShapeSize, placement?: SvgMaskPlacement): SvgMaskCanvas;

package/dist/shape/render-svg-mask-raster.js

@@ -0,0 +1,35 @@
+import { createBrowserCanvas2DContext } from '../text/create-browser-canvas-2d-context.js';
+import { resolveSvgMaskViewBox, } from './resolve-svg-mask-shape-size.js';
+export function getSvgMaskPlacement(shape, size) {
+    const viewBox = resolveSvgMaskViewBox(shape.viewBox);
+    const innerWidth = Math.max(0, size.width - size.padding * 2);
+    const innerHeight = Math.max(0, size.height - size.padding * 2);
+    const scale = Math.min(innerWidth / viewBox.width, innerHeight / viewBox.height);
+    const width = viewBox.width * scale;
+    const height = viewBox.height * scale;
+    return {
+        x: size.padding + Math.max(0, (innerWidth - width) / 2),
+        y: size.padding + Math.max(0, (innerHeight - height) / 2),
+        width,
+        height,
+        scaleX: scale,
+        scaleY: scale,
+    };
+}
+export function renderSvgMaskRaster(shape, size, placement = getSvgMaskPlacement(shape, size)) {
+    const maskScale = shape.maskScale ?? 2;
+    const pixelWidth = Math.max(1, Math.ceil(size.width * maskScale));
+    const pixelHeight = Math.max(1, Math.ceil(size.height * maskScale));
+    const context = createBrowserCanvas2DContext(pixelWidth, pixelHeight);
+    const viewBox = resolveSvgMaskViewBox(shape.viewBox);
+    context.setTransform(1, 0, 0, 1, 0, 0);
+    context.clearRect(0, 0, pixelWidth, pixelHeight);
+    context.setTransform(placement.scaleX * maskScale, 0, 0, placement.scaleY * maskScale, (placement.x - viewBox.x * placement.scaleX) * maskScale, (placement.y - viewBox.y * placement.scaleY) * maskScale);
+    context.fillStyle = '#000000';
+    context.fill(new Path2D(shape.path));
+    return {
+        context,
+        imageData: context.getImageData(0, 0, pixelWidth, pixelHeight),
+    };
+}
+//# sourceMappingURL=render-svg-mask-raster.js.map

package/dist/shape/render-svg-mask-raster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-svg-mask-raster.js","sourceRoot":"","sources":["../../src/shape/render-svg-mask-raster.ts"],"names":[],"mappings":"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"}

package/dist/shape/resolve-svg-mask-shape-size.d.ts

@@ -0,0 +1,9 @@
+import type { SvgMaskShape, SvgMaskShapeViewBox } from '../types.js';
+export type ResolvedSvgMaskShapeSize = {
+    mode: 'fit-content' | 'fixed';
+    width: number;
+    height: number;
+    padding: number;
+};
+export declare function resolveSvgMaskViewBox(viewBox: SvgMaskShapeViewBox): Required<SvgMaskShapeViewBox>;
+export declare function resolveSvgMaskShapeSize(shape: SvgMaskShape): ResolvedSvgMaskShapeSize;

package/dist/shape/resolve-svg-mask-shape-size.js

@@ -0,0 +1,51 @@
+function assertFiniteNumber(value, label) {
+    if (!Number.isFinite(value)) {
+        throw new Error(`${label} must be a finite number`);
+    }
+    return value;
+}
+function assertPositiveFiniteNumber(value, label) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`${label} must be a finite positive number`);
+    }
+    return value;
+}
+export function resolveSvgMaskViewBox(viewBox) {
+    return {
+        x: viewBox.x === undefined ? 0 : assertFiniteNumber(viewBox.x, 'svg-mask viewBox.x'),
+        y: viewBox.y === undefined ? 0 : assertFiniteNumber(viewBox.y, 'svg-mask viewBox.y'),
+        width: assertPositiveFiniteNumber(viewBox.width, 'svg-mask viewBox.width'),
+        height: assertPositiveFiniteNumber(viewBox.height, 'svg-mask viewBox.height'),
+    };
+}
+export function resolveSvgMaskShapeSize(shape) {
+    if (shape.size !== undefined && (shape.size === null || typeof shape.size !== 'object')) {
+        throw new Error('svg-mask size must be an object');
+    }
+    const viewBox = resolveSvgMaskViewBox(shape.viewBox);
+    const size = shape.size ?? {};
+    const mode = size.mode ?? 'fit-content';
+    if (mode !== 'fit-content' && mode !== 'fixed') {
+        throw new Error('svg-mask size.mode must be fit-content or fixed');
+    }
+    const padding = size.padding === undefined ? 0 : assertFiniteNumber(size.padding, 'svg-mask padding');
+    if (padding < 0) {
+        throw new Error('svg-mask padding must be a finite non-negative number');
+    }
+    if (mode === 'fixed') {
+        const fixedSize = size;
+        return {
+            mode,
+            width: assertPositiveFiniteNumber(fixedSize.width, 'svg-mask fixed width'),
+            height: assertPositiveFiniteNumber(fixedSize.height, 'svg-mask fixed height'),
+            padding,
+        };
+    }
+    return {
+        mode,
+        width: Math.max(1, viewBox.width + padding * 2),
+        height: Math.max(1, viewBox.height + padding * 2),
+        padding,
+    };
+}
+//# sourceMappingURL=resolve-svg-mask-shape-size.js.map

package/dist/shape/resolve-svg-mask-shape-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-svg-mask-shape-size.js","sourceRoot":"","sources":["../../src/shape/resolve-svg-mask-shape-size.ts"],"names":[],"mappings":"AASA,SAAS,kBAAkB,CAAC,KAAa,EAAE,KAAa;IACtD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,0BAA0B,CAAC,CAAA;IACrD,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAa,EAAE,KAAa;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mCAAmC,CAAC,CAAA;IAC9D,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IAChE,OAAO;QACL,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,EAAE,oBAAoB,CAAC;QACpF,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,EAAE,oBAAoB,CAAC;QACpF,KAAK,EAAE,0BAA0B,CAAC,OAAO,CAAC,KAAK,EAAE,wBAAwB,CAAC;QAC1E,MAAM,EAAE,0BAA0B,CAAC,OAAO,CAAC,MAAM,EAAE,yBAAyB,CAAC;KAC9E,CAAA;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAmB;IACzD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QACxF,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IACpD,CAAC;IAED,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAA;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,aAAa,CAAA;IACvC,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;IACrG,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IAC1E,CAAC;IAED,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,IAAyC,CAAA;QAE3D,OAAO;YACL,IAAI;YACJ,KAAK,EAAE,0BAA0B,CAAC,SAAS,CAAC,KAAK,EAAE,sBAAsB,CAAC;YAC1E,MAAM,EAAE,0BAA0B,CAAC,SAAS,CAAC,MAAM,EAAE,uBAAuB,CAAC;YAC7E,OAAO;SACR,CAAA;IACH,CAAC;IAED,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC;QAC/C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,OAAO,GAAG,CAAC,CAAC;QACjD,OAAO;KACR,CAAA;AACH,CAAC"}

package/dist/types.d.ts

@@ -23,6 +23,31 @@ export type PolygonShape = {
     kind: 'polygon';
     points: ShapeTextPoint[];
 };
+export type SvgMaskShapeFitContentSize = {
+    mode?: 'fit-content';
+    padding?: number;
+};
+export type SvgMaskShapeFixedSize = {
+    mode: 'fixed';
+    width: number;
+    height: number;
+    padding?: number;
+};
+export type SvgMaskShapeSize = SvgMaskShapeFitContentSize | SvgMaskShapeFixedSize;
+export type SvgMaskShapeViewBox = {
+    x?: number;
+    y?: number;
+    width: number;
+    height: number;
+};
+export type SvgMaskShape = {
+    kind: 'svg-mask';
+    path: string;
+    viewBox: SvgMaskShapeViewBox;
+    size?: SvgMaskShapeSize;
+    maskScale?: number;
+    alphaThreshold?: number;
+};
 export type TextMaskShape = {
     kind: 'text-mask';
     text: string;
@@ -32,7 +57,7 @@ export type TextMaskShape = {
     maskScale?: number;
     alphaThreshold?: number;
 };
-export type ShapeInput = PolygonShape | TextMaskShape;
+export type ShapeInput = PolygonShape | SvgMaskShape | TextMaskShape;
 export type TextMeasurer = {
     measureText(text: string, font: string): number;
 };
@@ -119,6 +144,13 @@ export type CompiledShapeBand = {
 export type CompiledShapeDebugView = {
     kind: 'polygon';
     points: ShapeTextPoint[];
+} | {
+    kind: 'path';
+    path: string;
+    x: number;
+    y: number;
+    scaleX: number;
+    scaleY: number;
 } | {
     kind: 'text';
     text: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shape-text",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Browser-first TypeScript library for shape-paragraph layout inside geometry and value-derived shapes, rendered to SVG.",
   "type": "module",
   "main": "./dist/index.js",