text-shaper 0.0.1

package/dist/font/tables/sfnt.d.ts

@@ -0,0 +1,20 @@
+import type { TableRecord, Tag } from "../../types.ts";
+import type { Reader } from "../binary/reader.ts";
+/** Font directory containing table records */
+export interface FontDirectory {
+    sfntVersion: number;
+    numTables: number;
+    searchRange: number;
+    entrySelector: number;
+    rangeShift: number;
+    tables: Map<Tag, TableRecord>;
+}
+/**
+ * Parse the sfnt font directory (table of contents).
+ * This is the first thing read from any TrueType/OpenType font.
+ */
+export declare function parseFontDirectory(reader: Reader): FontDirectory;
+/** Check if this is a TrueType font (vs CFF) */
+export declare function isTrueType(directory: FontDirectory): boolean;
+/** Check if this is a CFF font */
+export declare function isCFF(directory: FontDirectory): boolean;

package/dist/font/tables/stat.d.ts

@@ -0,0 +1,115 @@
+import type { Tag, uint16 } from "../../types.ts";
+import type { Reader } from "../binary/reader.ts";
+/**
+ * Style Attributes table (STAT)
+ * Provides style information for variable fonts
+ * Used for font selection and naming
+ */
+export interface StatTable {
+    majorVersion: uint16;
+    minorVersion: uint16;
+    designAxisCount: uint16;
+    designAxes: AxisRecord[];
+    axisValueCount: uint16;
+    axisValues: AxisValue[];
+    elidedFallbackNameID?: uint16;
+}
+/**
+ * Design axis record
+ */
+export interface AxisRecord {
+    axisTag: Tag;
+    axisNameID: uint16;
+    axisOrdering: uint16;
+}
+/**
+ * Axis value flags
+ */
+export declare const AxisValueFlags: {
+    readonly OlderSiblingFontAttribute: 1;
+    readonly ElidableAxisValueName: 2;
+};
+/**
+ * Base axis value
+ */
+export interface AxisValueBase {
+    format: number;
+    axisIndex: uint16;
+    flags: uint16;
+    valueNameID: uint16;
+}
+/**
+ * Format 1: Single axis value
+ */
+export interface AxisValueFormat1 extends AxisValueBase {
+    format: 1;
+    value: number;
+}
+/**
+ * Format 2: Axis value range
+ */
+export interface AxisValueFormat2 extends AxisValueBase {
+    format: 2;
+    nominalValue: number;
+    rangeMinValue: number;
+    rangeMaxValue: number;
+}
+/**
+ * Format 3: Linked axis value
+ */
+export interface AxisValueFormat3 extends AxisValueBase {
+    format: 3;
+    value: number;
+    linkedValue: number;
+}
+/**
+ * Format 4: Multiple axis values
+ */
+export interface AxisValueFormat4 {
+    format: 4;
+    axisCount: uint16;
+    flags: uint16;
+    valueNameID: uint16;
+    axisValues: {
+        axisIndex: uint16;
+        value: number;
+    }[];
+}
+export type AxisValue = AxisValueFormat1 | AxisValueFormat2 | AxisValueFormat3 | AxisValueFormat4;
+/**
+ * Parse STAT table
+ */
+export declare function parseStat(reader: Reader): StatTable;
+/**
+ * Get axis record by tag
+ */
+export declare function getAxisRecord(stat: StatTable, axisTag: Tag): AxisRecord | null;
+/**
+ * Get axis index by tag
+ */
+export declare function getAxisIndex(stat: StatTable, axisTag: Tag): number;
+/**
+ * Get axis values for a specific axis
+ */
+export declare function getAxisValuesForAxis(stat: StatTable, axisIndex: number): AxisValue[];
+/**
+ * Find axis value by name ID
+ */
+export declare function findAxisValueByNameId(stat: StatTable, nameId: uint16): AxisValue | null;
+/**
+ * Check if axis value is elidable
+ */
+export declare function isElidableAxisValue(axisValue: AxisValue): boolean;
+/**
+ * Check if axis value represents an older sibling font
+ */
+export declare function isOlderSiblingFont(axisValue: AxisValue): boolean;
+/**
+ * Get the value for a format 1-3 axis value
+ */
+export declare function getAxisValueNumber(axisValue: AxisValue): number | null;
+/**
+ * Match axis value to coordinates
+ * Returns true if the axis value matches the given coordinates
+ */
+export declare function matchAxisValue(axisValue: AxisValue, coords: Map<number, number>): boolean;

package/dist/font/tables/svg.d.ts

@@ -0,0 +1,40 @@
+import type { GlyphId, uint16 } from "../../types.ts";
+import type { Reader } from "../binary/reader.ts";
+/**
+ * SVG table
+ * Contains SVG documents for color glyph rendering
+ */
+export interface SvgTable {
+    version: uint16;
+    documentRecords: SvgDocumentRecord[];
+}
+/**
+ * SVG document record
+ * Maps a range of glyphs to an SVG document
+ */
+export interface SvgDocumentRecord {
+    startGlyphID: GlyphId;
+    endGlyphID: GlyphId;
+    svgDoc: string;
+}
+/**
+ * Parse SVG table
+ */
+export declare function parseSvg(reader: Reader): SvgTable;
+/**
+ * Get SVG document for a glyph
+ * Returns null if no SVG exists for this glyph
+ */
+export declare function getSvgDocument(svg: SvgTable, glyphId: GlyphId): string | null;
+/**
+ * Check if a glyph has an SVG representation
+ */
+export declare function hasSvgGlyph(svg: SvgTable, glyphId: GlyphId): boolean;
+/**
+ * Get all glyph IDs that have SVG representations
+ */
+export declare function getSvgGlyphIds(svg: SvgTable): GlyphId[];
+/**
+ * Async version of gzip decompression
+ */
+export declare function decompressSvgDocument(data: Uint8Array): Promise<string>;

package/dist/font/tables/trak.d.ts

@@ -0,0 +1,43 @@
+import type { int16, uint16, uint32 } from "../../types.ts";
+import type { Reader } from "../binary/reader.ts";
+/**
+ * Tracking table (trak)
+ * Apple Advanced Typography tracking
+ */
+export interface TrakTable {
+    version: number;
+    format: uint16;
+    horizData: TrackData | null;
+    vertData: TrackData | null;
+}
+/**
+ * Track data for one direction
+ */
+export interface TrackData {
+    nTracks: uint16;
+    nSizes: uint16;
+    sizeTableOffset: uint32;
+    trackTable: TrackTableEntry[];
+    sizeTable: number[];
+}
+/**
+ * Track table entry
+ */
+export interface TrackTableEntry {
+    track: number;
+    nameIndex: uint16;
+    offset: uint16;
+    perSizeTracking: int16[];
+}
+/**
+ * Parse trak table
+ */
+export declare function parseTrak(reader: Reader): TrakTable;
+/**
+ * Get tracking value for a given track and point size
+ */
+export declare function getTrackingValue(trackData: TrackData, track: number, pointSize: number): number;
+/**
+ * Apply tracking to advance widths
+ */
+export declare function applyTracking(trak: TrakTable, advances: number[], pointSize: number, track?: number, vertical?: boolean): void;

package/dist/font/tables/vhea.d.ts

@@ -0,0 +1,41 @@
+import type { FWord, int16, uint16 } from "../../types.ts";
+import type { Reader } from "../binary/reader.ts";
+/**
+ * Vertical Header table (vhea)
+ * Contains information for vertical layout
+ */
+export interface VheaTable {
+    /** Table version (1.0 or 1.1) */
+    version: {
+        major: number;
+        minor: number;
+    };
+    /** Typographic ascent (vertical) */
+    ascender: FWord;
+    /** Typographic descent (vertical) */
+    descender: FWord;
+    /** Typographic line gap (vertical) */
+    lineGap: FWord;
+    /** Maximum advance height */
+    advanceHeightMax: uint16;
+    /** Minimum top side bearing */
+    minTopSideBearing: FWord;
+    /** Minimum bottom side bearing */
+    minBottomSideBearing: FWord;
+    /** Maximum y extent (yMax - yMin) */
+    yMaxExtent: FWord;
+    /** Caret slope rise (for vertical text) */
+    caretSlopeRise: int16;
+    /** Caret slope run */
+    caretSlopeRun: int16;
+    /** Caret offset */
+    caretOffset: int16;
+    /** Metric data format (0 for current) */
+    metricDataFormat: int16;
+    /** Number of vertical metrics in vmtx */
+    numberOfVMetrics: uint16;
+}
+/**
+ * Parse vhea table
+ */
+export declare function parseVhea(reader: Reader): VheaTable;

package/dist/font/tables/vmtx.d.ts

@@ -0,0 +1,35 @@
+import type { GlyphId, int16, uint16 } from "../../types.ts";
+import type { Reader } from "../binary/reader.ts";
+/**
+ * Vertical Metrics table (vmtx)
+ * Contains vertical metrics for each glyph
+ */
+export interface VmtxTable {
+    /** Vertical metrics (advance height + top side bearing) */
+    vMetrics: VerticalMetric[];
+    /** Top side bearings for remaining glyphs */
+    topSideBearings: int16[];
+}
+/**
+ * Vertical metric record
+ */
+export interface VerticalMetric {
+    /** Advance height in font units */
+    advanceHeight: uint16;
+    /** Top side bearing in font units */
+    topSideBearing: int16;
+}
+/**
+ * Parse vmtx table
+ * @param reader Binary reader
+ * @param numberOfVMetrics From vhea table
+ * @param numGlyphs Total number of glyphs
+ */
+export declare function parseVmtx(reader: Reader, numberOfVMetrics: number, numGlyphs: number): VmtxTable;
+/**
+ * Get vertical metrics for a glyph
+ */
+export declare function getVerticalMetrics(vmtx: VmtxTable, glyphId: GlyphId): {
+    advanceHeight: number;
+    topSideBearing: number;
+};

package/dist/font/tables/vorg.d.ts

@@ -0,0 +1,33 @@
+import type { GlyphId, int16, uint16 } from "../../types.ts";
+import type { Reader } from "../binary/reader.ts";
+/**
+ * Vertical Origin table (VORG)
+ * Provides y-coordinate of vertical origin for CFF fonts
+ * Used for proper vertical text layout in CJK fonts
+ */
+export interface VorgTable {
+    majorVersion: uint16;
+    minorVersion: uint16;
+    defaultVertOriginY: int16;
+    vertOriginYMetrics: VertOriginYMetric[];
+}
+/**
+ * Vertical origin metric for a specific glyph
+ */
+export interface VertOriginYMetric {
+    glyphIndex: GlyphId;
+    vertOriginY: int16;
+}
+/**
+ * Parse VORG table
+ */
+export declare function parseVorg(reader: Reader): VorgTable;
+/**
+ * Get vertical origin Y coordinate for a glyph
+ * Returns the y-coordinate of the glyph's vertical origin
+ */
+export declare function getVertOriginY(vorg: VorgTable, glyphId: GlyphId): int16;
+/**
+ * Check if a glyph has a specific vertical origin entry
+ */
+export declare function hasVertOriginY(vorg: VorgTable, glyphId: GlyphId): boolean;

package/dist/font/tables/vvar.d.ts

@@ -0,0 +1,36 @@
+import type { GlyphId } from "../../types.ts";
+import type { Reader } from "../binary/reader.ts";
+import { type DeltaSetIndexMap, type ItemVariationStore } from "./hvar.ts";
+/**
+ * Vertical Metrics Variations table (VVAR)
+ * Provides variations for vertical advance heights and side bearings
+ */
+export interface VvarTable {
+    majorVersion: number;
+    minorVersion: number;
+    itemVariationStore: ItemVariationStore;
+    advanceHeightMapping: DeltaSetIndexMap | null;
+    tsbMapping: DeltaSetIndexMap | null;
+    bsbMapping: DeltaSetIndexMap | null;
+    vOrgMapping: DeltaSetIndexMap | null;
+}
+/**
+ * Parse VVAR table
+ */
+export declare function parseVvar(reader: Reader): VvarTable;
+/**
+ * Get advance height delta for a glyph at given variation coordinates
+ */
+export declare function getAdvanceHeightDelta(vvar: VvarTable, glyphId: GlyphId, coords: number[]): number;
+/**
+ * Get top side bearing delta for a glyph at given variation coordinates
+ */
+export declare function getTsbDelta(vvar: VvarTable, glyphId: GlyphId, coords: number[]): number;
+/**
+ * Get bottom side bearing delta for a glyph at given variation coordinates
+ */
+export declare function getBsbDelta(vvar: VvarTable, glyphId: GlyphId, coords: number[]): number;
+/**
+ * Get vertical origin delta for a glyph at given variation coordinates
+ */
+export declare function getVorgDelta(vvar: VvarTable, glyphId: GlyphId, coords: number[]): number;

package/dist/index.d.ts

@@ -0,0 +1,80 @@
+export { processContextual, processInsertion, processLigature, processRearrangement, } from "./aat/state-machine.ts";
+export { GlyphBuffer } from "./buffer/glyph-buffer.ts";
+export { UnicodeBuffer } from "./buffer/unicode-buffer.ts";
+export { Reader } from "./font/binary/reader.ts";
+export { createFace, Face } from "./font/face.ts";
+export { Font, type FontLoadOptions } from "./font/font.ts";
+export type { AvarTable, AxisSegmentMap } from "./font/tables/avar.ts";
+export { applyAvar, applyAvarMapping } from "./font/tables/avar.ts";
+export type { BitmapGlyph, BitmapSize, CbdtTable, CblcTable, GlyphBitmapMetrics, IndexSubTable, SbitLineMetrics, } from "./font/tables/cbdt.ts";
+export { CbdtImageFormat, getBitmapGlyph, getColorBitmapSizes, hasColorBitmap, } from "./font/tables/cbdt.ts";
+export { executeCff2CharString, executeCffCharString, getCffGlyphWidth, } from "./font/tables/cff-charstring.ts";
+export type { CmapTable } from "./font/tables/cmap.ts";
+export type { FvarTable, NamedInstance, VariationAxis, } from "./font/tables/fvar.ts";
+export { normalizeAxisValue } from "./font/tables/fvar.ts";
+export type { GdefTable } from "./font/tables/gdef.ts";
+export type { CompositeGlyph, Contour, Glyph, GlyphPoint, SimpleGlyph, } from "./font/tables/glyf.ts";
+export type { GposTable } from "./font/tables/gpos.ts";
+export type { GsubTable } from "./font/tables/gsub.ts";
+export type { GlyphVariationData, GvarTable, TupleVariationHeader, } from "./font/tables/gvar.ts";
+export { calculateTupleScalar, getGlyphDelta } from "./font/tables/gvar.ts";
+export type { HeadTable } from "./font/tables/head.ts";
+export type { HheaTable } from "./font/tables/hhea.ts";
+export type { HmtxTable } from "./font/tables/hmtx.ts";
+export type { HvarTable } from "./font/tables/hvar.ts";
+export { getAdvanceWidthDelta } from "./font/tables/hvar.ts";
+export type { KernSubtable, KernTable } from "./font/tables/kern.ts";
+export { getKernValue } from "./font/tables/kern.ts";
+export type { KerxSubtable, KerxTable } from "./font/tables/kerx.ts";
+export { getKerxValue } from "./font/tables/kerx.ts";
+export type { LocaTable } from "./font/tables/loca.ts";
+export { getGlyphLocation, hasGlyphOutline } from "./font/tables/loca.ts";
+export type { MaxpTable } from "./font/tables/maxp.ts";
+export type { MorxChain, MorxSubtable, MorxTable } from "./font/tables/morx.ts";
+export { applyNonContextual, MorxSubtableType } from "./font/tables/morx.ts";
+export type { FeatTable, FeatureRecord, FeatureSetting, } from "./font/tables/feat.ts";
+export { aatToOpenTypeTag, CaseSensitiveLayoutSetting, CharacterShapeSetting, ContextualAlternativesSetting, DiacriticsSetting, FeatureFlags, FeatureType, FractionsSetting, getAllFeatures, getDefaultSetting, getFeature, getSettingByValue, hasSettingValue, isExclusiveFeature, LigatureSetting, LowerCaseSetting, NumberCaseSetting, NumberSpacingSetting, openTypeTagToAat, parseFeat, SmartSwashSetting, StylisticAlternativesSetting, UpperCaseSetting, VerticalPositionSetting, } from "./font/tables/feat.ts";
+export type { MvarTable, MvarValueRecord } from "./font/tables/mvar.ts";
+export { getCapHeightDelta, getHAscenderDelta, getHDescenderDelta, getMetricDelta, getXHeightDelta, MvarTags, } from "./font/tables/mvar.ts";
+export type { SbixGlyph, SbixStrike, SbixTable } from "./font/tables/sbix.ts";
+export { getAvailablePpemSizes, getGlyphBitmap as getSbixGlyphBitmap, getStrikeForPpem, hasGlyphBitmap, resolveDupeGlyph, SbixGraphicType, } from "./font/tables/sbix.ts";
+export type { AxisRecord, AxisValue, AxisValueFormat1, AxisValueFormat2, AxisValueFormat3, AxisValueFormat4, StatTable, } from "./font/tables/stat.ts";
+export { AxisValueFlags, findAxisValueByNameId, getAxisIndex, getAxisRecord, getAxisValueNumber, getAxisValuesForAxis, isElidableAxisValue, isOlderSiblingFont, matchAxisValue, } from "./font/tables/stat.ts";
+export type { Affine2x3, BaseGlyphPaintRecord, BaseGlyphRecord, ClipBox, ClipRecord, ColorLine, ColorStop, ColrTable, ItemVariationData, ItemVariationStore, LayerRecord, Paint, PaintColrGlyph, PaintColrLayers, PaintComposite, PaintGlyph, PaintLinearGradient, PaintRadialGradient, PaintRotate, PaintScale, PaintSkew, PaintSolid, PaintSweepGradient, PaintTransform, PaintTranslate, RegionAxisCoordinates, VarColorLine, VarColorStop, VariationRegion, } from "./font/tables/colr.ts";
+export { CompositeMode, Extend, getClipBox, getColorLayers, getColorPaint, getColorVariationDelta, getLayerPaint, hasColorGlyph, isColrV1, PaintFormat, parseColr, } from "./font/tables/colr.ts";
+export type { Color, ColorPalette, CpalTable } from "./font/tables/cpal.ts";
+export { colorToHex, colorToRgba, getColor, PaletteType, parseCpal } from "./font/tables/cpal.ts";
+export type { SvgDocumentRecord, SvgTable } from "./font/tables/svg.ts";
+export { getSvgDocument, getSvgGlyphIds, hasSvgGlyph, } from "./font/tables/svg.ts";
+export type { TrackData, TrakTable } from "./font/tables/trak.ts";
+export { applyTracking, getTrackingValue } from "./font/tables/trak.ts";
+export type { VheaTable } from "./font/tables/vhea.ts";
+export type { VerticalMetric, VmtxTable } from "./font/tables/vmtx.ts";
+export { getVerticalMetrics } from "./font/tables/vmtx.ts";
+export type { VertOriginYMetric, VorgTable } from "./font/tables/vorg.ts";
+export { getVertOriginY, hasVertOriginY } from "./font/tables/vorg.ts";
+export type { VvarTable } from "./font/tables/vvar.ts";
+export { getAdvanceHeightDelta, getBsbDelta, getTsbDelta, getVorgDelta, } from "./font/tables/vvar.ts";
+export type { JustifyAdjustment, JustifyOptions, JustifyResult, LineBreakResult, } from "./layout/justify.ts";
+export { breakIntoLines, calculateLineWidth, JustifyMode, justify, justifyParagraph, } from "./layout/justify.ts";
+export type { ClassDef } from "./layout/structures/class-def.ts";
+export type { Coverage } from "./layout/structures/coverage.ts";
+export type { DeviceOrVariationIndex, DeviceTable, VariationIndexTable, } from "./layout/structures/device.ts";
+export { applyDeviceAdjustment, getDeviceDelta, isVariationIndexTable, } from "./layout/structures/device.ts";
+export type { Condition, ConditionSet, FeatureVariationRecord, FeatureVariations, } from "./layout/structures/feature-variations.ts";
+export { applyFeatureVariations, evaluateConditionSet, findMatchingFeatureVariation, getSubstitutedLookups, } from "./layout/structures/feature-variations.ts";
+export type { GlyphPath, PathCommand, ShapedGlyph } from "./render/path.ts";
+export { contourToPath, createPath2D, getGlyphPath, getGlyphPathWithVariation, getTextWidth, glyphBufferToShapedGlyphs, glyphToSVG, pathToCanvas, pathToSVG, renderShapedText, renderShapedTextWithVariation, shapedTextToSVG, shapedTextToSVGWithVariation, } from "./render/path.ts";
+export { applyFallbackKerning, applyFallbackMarkPositioning, } from "./shaper/fallback.ts";
+export { allSmallCaps, capitalSpacing, capsToSmallCaps, caseSensitiveForms, characterVariant, characterVariants, combineFeatures, contextualAlternates, discretionaryLigatures, feature, features, fractions, fullWidthForms, halfWidthForms, historicalLigatures, jis78Forms, jis83Forms, jis90Forms, jis2004Forms, kerning, liningFigures, oldstyleFigures, ordinals, petiteCaps, proportionalFigures, proportionalWidthForms, quarterWidthForms, ruby, scientificInferiors, simplifiedForms, slashedZero, smallCaps, standardLigatures, stylisticAlternates, stylisticSet, stylisticSets, subscript, superscript, swash, tabularFigures, thirdWidthForms, traditionalForms, verticalAlternatesRotation, verticalForms, verticalKanaAlternates, verticalLayoutFeatures, } from "./shaper/features.ts";
+export { createShapePlan, getOrCreateShapePlan, type ShapeFeature, type ShapePlan, } from "./shaper/shape-plan.ts";
+export { type FontLike, type ShapeOptions, shape } from "./shaper/shaper.ts";
+export * from "./types.ts";
+export { applyMirroring, type BidiParagraph, type BidiResult, BidiType, detectDirection, getCharType, getEmbeddings, getMirror, getVisualOrder, isLTR, isRTL, processBidi, reorderGlyphs, } from "./unicode/bidi.ts";
+export { decompose, getCombiningClass, NormalizationMode, normalize, reorderMarks, } from "./unicode/normalize.ts";
+export type { LineBreakAnalysis } from "./unicode/line-break.ts";
+export { BreakAction, BreakOpportunity, LineBreakClass, analyzeLineBreaks, analyzeLineBreaksForGlyphs, analyzeLineBreaksFromCodepoints, canBreakAt, findNextBreak, getAllBreakOpportunities, getLineBreakClass, mustBreakAt, } from "./unicode/line-break.ts";
+export type { GraphemeBoundaries, WordBoundaries } from "./unicode/segmentation.ts";
+export { GraphemeBreakProperty, WordBreakProperty, countGraphemes, findGraphemeBoundaries, findWordBoundaries, getGraphemeBreakProperty, getWordBreakProperty, splitGraphemes, splitWords, } from "./unicode/segmentation.ts";
+export type { ScriptRun } from "./unicode/script.ts";
+export { Script, detectScript, getScript, getScriptDirection, getScriptRuns, getScriptTag, getScripts, isComplexScript, isScript, } from "./unicode/script.ts";