text-shaper 0.1.12 → 0.1.13

package/dist/fluent/bitmap-builder.d.ts

@@ -5,6 +5,7 @@
  */
 import { type Gradient } from "../raster/gradient.ts";
 import { type Bitmap, PixelMode, type RasterizedGlyph } from "../raster/types.ts";
+import type { Matrix2D, Matrix3x3 } from "../render/outline-transform.ts";
 /**
  * BitmapBuilder provides a fluent interface for bitmap manipulations
  */
@@ -58,6 +59,38 @@ export declare class BitmapBuilder {
      * Embolden (dilate) bitmap
      */
     embolden(xStrength: number, yStrength?: number): BitmapBuilder;
+    /**
+     * Embolden bitmap and update bearing to avoid clipping
+     */
+    emboldenWithBearing(xStrength: number, yStrength?: number): BitmapBuilder;
+    /**
+     * Apply 2D affine transform to bitmap (bearing-aware)
+     */
+    transform2D(matrix: Matrix2D, options?: {
+        offsetX26?: number;
+        offsetY26?: number;
+    }): BitmapBuilder;
+    /**
+     * Apply 3D perspective transform to bitmap (bearing-aware)
+     */
+    transform3D(matrix: Matrix3x3, options?: {
+        offsetX26?: number;
+        offsetY26?: number;
+    }): BitmapBuilder;
+    /**
+     * Shear bitmap horizontally (synthetic italic)
+     */
+    shearX(amount: number, options?: {
+        offsetX26?: number;
+        offsetY26?: number;
+    }): BitmapBuilder;
+    /**
+     * Shear bitmap vertically
+     */
+    shearY(amount: number, options?: {
+        offsetX26?: number;
+        offsetY26?: number;
+    }): BitmapBuilder;
     /**
      * Shift bitmap position
      */
@@ -75,6 +108,45 @@ export declare class BitmapBuilder {
      */
     pad(left: number, top: number, right: number, bottom: number): BitmapBuilder;
     pad(all: number): BitmapBuilder;
+    /**
+     * Measure ascent/descent from bitmap coverage
+     */
+    measure(): {
+        ascent: number;
+        descent: number;
+    };
+    /**
+     * Get raster metrics for this bitmap (includes ascent/descent)
+     */
+    metrics(): {
+        width: number;
+        height: number;
+        bearingX: number;
+        bearingY: number;
+        ascent: number;
+        descent: number;
+    };
+    /**
+     * Expand raster metrics for blur/border/shadow padding
+     */
+    expandMetrics(options: {
+        blur?: number;
+        be?: number;
+        border?: number;
+        shadowX?: number;
+        shadowY?: number;
+    }): {
+        width: number;
+        height: number;
+        bearingX: number;
+        bearingY: number;
+        ascent: number;
+        descent: number;
+        padLeft: number;
+        padRight: number;
+        padTop: number;
+        padBottom: number;
+    };
     /**
      * Alpha blend another bitmap onto this one at position
      */

package/dist/fluent/index.d.ts

@@ -8,7 +8,7 @@
 import type { Font } from "../font/font.ts";
 import { atlasToAlpha, atlasToRGBA, buildAsciiAtlas, buildAtlas, buildStringAtlas, getGlyphUV } from "../raster/atlas.ts";
 import { buildMsdfAsciiAtlas, buildMsdfAtlas, buildMsdfStringAtlas, msdfAtlasToRGB, msdfAtlasToRGBA } from "../raster/msdf.ts";
-import { rasterizeGlyph, rasterizeText } from "../raster/rasterize.ts";
+import { rasterizeGlyph, rasterizeGlyphWithTransform, rasterizeText } from "../raster/rasterize.ts";
 import type { AtlasOptions, Bitmap, GlyphAtlas, MsdfAtlasOptions } from "../raster/types.ts";
 import type { GlyphPath } from "../render/path.ts";
 import { renderShapedText, renderShapedTextWithVariation, shapedTextToSVG, shapedTextToSVGWithVariation } from "../render/path.ts";
@@ -94,9 +94,9 @@ export declare function bitmap(b: Bitmap): BitmapBuilder;
  * ```
  */
 export declare function combine(...paths: PathBuilder[]): PathBuilder;
-export { adaptiveBlur, blur, boxBlur, cascadeBlur, clone, combinePaths, condensePath, convert, copy, embolden, emboldenPath, fastBlur, fromGlyph, italic, matrix, obliquePath, pad, perspective, pipe, rasterize, rasterizeAuto, rasterizeWithGradient, renderMsdf, renderSdf, resize, resizeBilinear, rotate, rotateDeg, scale, shear, shift, strokeAsymmetric, strokeAsymmetricCombined, strokePath, toGray, toRGBA, toSVG, translate, } from "./pipe.ts";
+export { adaptiveBlur, blur, boxBlur, cascadeBlur, clone, combinePaths, condensePath, convert, copy, embolden, emboldenGlyph, emboldenPath, fastBlur, fromGlyph, italic, matrix, obliquePath, pad, perspective, pipe, rasterize, rasterizeAuto, rasterizeWithGradient, renderMsdf, renderSdf, resize, resizeBilinear, rotate, rotateDeg, scale, shear, shearBitmapX, shearBitmapY, shearGlyphX, shearGlyphY, shift, strokeAsymmetric, strokeAsymmetricCombined, strokePath, toGray, toRGBA, toSVG, transformBitmap2D, transformBitmap3D, transformGlyph2D, transformGlyph3D, translate, } from "./pipe.ts";
 export { buildAtlas, buildAsciiAtlas, buildStringAtlas, atlasToRGBA, atlasToAlpha, getGlyphUV, };
 export { buildMsdfAtlas, buildMsdfAsciiAtlas, buildMsdfStringAtlas, msdfAtlasToRGB, msdfAtlasToRGBA, };
-export { rasterizeGlyph, rasterizeText };
+export { rasterizeGlyph, rasterizeGlyphWithTransform, rasterizeText };
 export { renderShapedText, shapedTextToSVG, renderShapedTextWithVariation, shapedTextToSVGWithVariation, };
 export type { AtlasOptions, GlyphAtlas, MsdfAtlasOptions };

package/dist/fluent/pipe.d.ts

@@ -10,7 +10,7 @@ import type { Gradient } from "../raster/gradient.ts";
 import { type MsdfOptions } from "../raster/msdf.ts";
 import { type SdfOptions } from "../raster/sdf.ts";
 import type { LineCap, LineJoin, StrokerOptions } from "../raster/stroker.ts";
-import type { Bitmap, PixelMode, RasterizeOptions } from "../raster/types.ts";
+import type { Bitmap, PixelMode, RasterizeOptions, RasterizedGlyph } from "../raster/types.ts";
 import type { Matrix2D, Matrix3x3 } from "../render/outline-transform.ts";
 import type { GlyphPath } from "../render/path.ts";
 import type { GlyphId } from "../types.ts";
@@ -158,6 +158,66 @@ export declare function fastBlur(radius: number): (bitmap: Bitmap) => Bitmap;
  * Embolden bitmap operator
  */
 export declare function embolden(xStrength: number, yStrength?: number): (bitmap: Bitmap) => Bitmap;
+/**
+ * Embolden bitmap and expand bearings (for rasterized glyphs)
+ */
+export declare function emboldenGlyph(xStrength: number, yStrength?: number): (glyph: RasterizedGlyph) => RasterizedGlyph;
+/**
+ * Transform bitmap with 2D matrix (origin at top-left)
+ */
+export declare function transformBitmap2D(matrix: Matrix2D, options?: {
+    offsetX26?: number;
+    offsetY26?: number;
+}): (bitmap: Bitmap) => Bitmap;
+/**
+ * Transform bitmap with 3D matrix (origin at top-left)
+ */
+export declare function transformBitmap3D(matrix: Matrix3x3, options?: {
+    offsetX26?: number;
+    offsetY26?: number;
+}): (bitmap: Bitmap) => Bitmap;
+/**
+ * Transform rasterized glyph with 2D matrix (bearing-aware)
+ */
+export declare function transformGlyph2D(matrix: Matrix2D, options?: {
+    offsetX26?: number;
+    offsetY26?: number;
+}): (glyph: RasterizedGlyph) => RasterizedGlyph;
+/**
+ * Transform rasterized glyph with 3D matrix (bearing-aware)
+ */
+export declare function transformGlyph3D(matrix: Matrix3x3, options?: {
+    offsetX26?: number;
+    offsetY26?: number;
+}): (glyph: RasterizedGlyph) => RasterizedGlyph;
+/**
+ * Shear bitmap horizontally (origin at top-left)
+ */
+export declare function shearBitmapX(amount: number, options?: {
+    offsetX26?: number;
+    offsetY26?: number;
+}): (bitmap: Bitmap) => Bitmap;
+/**
+ * Shear bitmap vertically (origin at top-left)
+ */
+export declare function shearBitmapY(amount: number, options?: {
+    offsetX26?: number;
+    offsetY26?: number;
+}): (bitmap: Bitmap) => Bitmap;
+/**
+ * Shear rasterized glyph horizontally (bearing-aware)
+ */
+export declare function shearGlyphX(amount: number, options?: {
+    offsetX26?: number;
+    offsetY26?: number;
+}): (glyph: RasterizedGlyph) => RasterizedGlyph;
+/**
+ * Shear rasterized glyph vertically (bearing-aware)
+ */
+export declare function shearGlyphY(amount: number, options?: {
+    offsetX26?: number;
+    offsetY26?: number;
+}): (glyph: RasterizedGlyph) => RasterizedGlyph;
 /**
  * Shift bitmap position
  */

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { processContextual, processInsertion, processLigature, processRearrangem
 export { execute, runCVTProgram, runFontProgram, runGlyphProgram, runProgram, setCodeRange, createHintingEngine, executeFontProgram, type GlyphOutline, type HintedGlyph, type HintingEngine, hintedToPixels, hintGlyph, loadCVTProgram, loadFontProgram, setSize, compensate, parseSuperRound, round, roundDownToGrid, roundOff, roundSuper, roundSuper45, roundToDoubleGrid, roundToGrid, roundToHalfGrid, roundUpToGrid, type CallRecord, CodeRange, createDefaultGraphicsState, createExecContext, createGlyphZone, type ExecContext, type F2Dot14, type F26Dot6, type FunctionDef, type GlyphZone, type GraphicsState, type InstructionDef, Opcode, type Point as HintingPoint, RoundMode, TouchFlag, type UnitVector, } from "./hinting/index.ts";
 export { GlyphBuffer } from "./buffer/glyph-buffer.ts";
 export { UnicodeBuffer } from "./buffer/unicode-buffer.ts";
-export { adaptiveBlur as $adaptiveBlur, BitmapBuilder, bitmap, blur as $blur, boxBlur as $boxBlur, cascadeBlur as $cascadeBlur, char, clone as $clone, combine, combinePaths as $combinePaths, condensePath as $condensePath, convert as $convert, copy as $copy, embolden as $embolden, emboldenPath as $emboldenPath, fastBlur as $fastBlur, fromGlyph as $fromGlyph, glyph, glyphVar, italic as $italic, matrix as $matrix, obliquePath as $obliquePath, PathBuilder, pad as $pad, path, perspective as $perspective, pipe, rasterize as $rasterize, rasterizeAuto as $rasterizeAuto, rasterizeWithGradient as $rasterizeWithGradient, renderMsdf as $renderMsdf, renderSdf as $renderSdf, resize as $resize, resizeBilinear as $resizeBilinear, rotate as $rotate, rotateDeg as $rotateDeg, scale as $scale, shear as $shear, shift as $shift, strokeAsymmetric as $strokeAsymmetric, strokeAsymmetricCombined as $strokeAsymmetricCombined, strokePath as $strokePath, toGray as $toGray, toRGBA as $toRGBA, toSVG as $toSVG, translate as $translate, } from "./fluent/index.ts";
+export { adaptiveBlur as $adaptiveBlur, BitmapBuilder, bitmap, blur as $blur, boxBlur as $boxBlur, cascadeBlur as $cascadeBlur, char, clone as $clone, combine, combinePaths as $combinePaths, condensePath as $condensePath, convert as $convert, copy as $copy, embolden as $embolden, emboldenGlyph as $emboldenGlyph, emboldenPath as $emboldenPath, fastBlur as $fastBlur, fromGlyph as $fromGlyph, glyph, glyphVar, italic as $italic, matrix as $matrix, obliquePath as $obliquePath, PathBuilder, pad as $pad, path, perspective as $perspective, pipe, rasterize as $rasterize, rasterizeAuto as $rasterizeAuto, rasterizeWithGradient as $rasterizeWithGradient, renderMsdf as $renderMsdf, renderSdf as $renderSdf, resize as $resize, resizeBilinear as $resizeBilinear, rotate as $rotate, rotateDeg as $rotateDeg, scale as $scale, shear as $shear, shearBitmapX as $shearBitmapX, shearBitmapY as $shearBitmapY, shearGlyphX as $shearGlyphX, shearGlyphY as $shearGlyphY, shift as $shift, strokeAsymmetric as $strokeAsymmetric, strokeAsymmetricCombined as $strokeAsymmetricCombined, strokePath as $strokePath, toGray as $toGray, toRGBA as $toRGBA, toSVG as $toSVG, transformBitmap2D as $transformBitmap2D, transformBitmap3D as $transformBitmap3D, transformGlyph2D as $transformGlyph2D, transformGlyph3D as $transformGlyph3D, translate as $translate, } from "./fluent/index.ts";
 export type { AutoRasterOptions, CanvasOptions, RasterOptions, SVGElementOptions, SVGOptions, TransformState, } from "./fluent/types.ts";
 export { Reader } from "./font/binary/reader.ts";
 export { createFace, Face } from "./font/face.ts";
@@ -99,17 +99,18 @@ export { getExactBounds } from "./raster/bbox.ts";
 export { abs, ceilPixel, clamp, divFix, downscale, f26Dot6ToFloat, F16DOT16_ONE, F16DOT16_SHIFT, F26DOT6_ONE, F26DOT6_SHIFT, floatToF26Dot6, floatToPixel, floorPixel, fracPixel, hypot, mulDiv, mulFix, normalizeVector, ONE_PIXEL, PIXEL_BITS, PIXEL_MASK, roundPixel, sign, truncPixel, upscale, vectorLength, } from "./raster/fixed-point.ts";
 export type { ValidationResult } from "./raster/outline-decompose.ts";
 export { decomposePath, getFillRuleFromFlags, getPathBounds, OutlineError, validateOutline, } from "./raster/outline-decompose.ts";
-export { addBitmaps, blendBitmap, compositeBitmaps, convertBitmap, copyBitmap, emboldenBitmap, expandToFit, fixOutline, maxBitmaps, mulBitmaps, padBitmap, resizeBitmap, resizeBitmapBilinear, shiftBitmap, subBitmaps, } from "./raster/bitmap-utils.ts";
+export { addBitmaps, blendBitmap, compositeBitmaps, convertBitmap, copyBitmap, emboldenBitmap, emboldenBitmapWithBearing, expandRasterMetrics, expandToFit, fixOutlineBitmap, fixOutline, maxBitmaps, mulBitmaps, padBitmap, resizeBitmap, resizeBitmapBilinear, shearBitmapX, shearBitmapY, shiftBitmap, subtractBitmap, subBitmaps, transformBitmap2D, transformBitmap3D, measureRasterGlyph, } from "./raster/bitmap-utils.ts";
 export { blurBitmap, boxBlur, createGaussianKernel, gaussianBlur, } from "./raster/blur.ts";
 export { adaptiveBlur, cascadeBlur, fastGaussianBlur, } from "./raster/cascade-blur.ts";
 export { type ColorStop as GradientColorStop, createGradientBitmap, type Gradient, interpolateGradient, type LinearGradient, type RadialGradient, rasterizePathWithGradient, } from "./raster/gradient.ts";
 export { LCD_FILTER_DEFAULT, LCD_FILTER_LEGACY, LCD_FILTER_LIGHT, lcdToRGBA, LcdMode, rasterizeLcd, } from "./raster/lcd-filter.ts";
 export { assignEdgeColors, buildMsdfAsciiAtlas, buildMsdfAtlas, buildMsdfStringAtlas, type MsdfEdge, type MsdfOptions, median, msdfAtlasToRGB, msdfAtlasToRGBA, type Point as MsdfPoint, renderMsdf, type SignedDistanceResult, signedDistanceToCubic, signedDistanceToLine, signedDistanceToQuadratic, } from "./raster/msdf.ts";
-export { bitmapToGray, bitmapToRGBA, rasterizeGlyph, rasterizePath, rasterizeText, } from "./raster/rasterize.ts";
+export { bitmapToGray, bitmapToRGBA, rasterizeGlyph, rasterizeGlyphWithTransform, rasterizePath, rasterizeText, } from "./raster/rasterize.ts";
 export { renderSdf, type SdfOptions } from "./raster/sdf.ts";
 export { type LineCap, type LineJoin, type StrokerOptions, strokePath, } from "./raster/stroker.ts";
 export { condensePath, emboldenPath, obliquePath } from "./raster/synth.ts";
 export type { Bitmap, GlyphAtlas, GlyphMetrics, MsdfAtlasOptions, RasterizedGlyph, RasterizeOptions, Span, } from "./raster/types.ts";
+export type { BitmapTransformOptions, RasterEffectOptions, RasterMetrics, } from "./raster/bitmap-utils.ts";
 export { clearBitmap, createBitmap, FillRule, PixelMode, } from "./raster/types.ts";
 export { type BoundingBox, type ControlBox, clonePath, combinePaths, computeControlBox, computeTightBounds, identity2D, identity3x3, italicizeOutline, type Matrix2D, type Matrix3x3, multiply2D, multiply3x3, perspectiveMatrix, rotate2D, rotateOutline, rotateOutline90, scale2D, scaleOutline, scaleOutlinePow2, shear2D, transformOutline2D, transformOutline3D, transformPoint2D, transformPoint3x3, translate2D, translateOutline, updateMinTransformedX, } from "./render/outline-transform.ts";
 export type { GlyphPath, PathCommand, ShapedGlyph } from "./render/path.ts";