text-shaper 0.0.1

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

@@ -0,0 +1,278 @@
+import type { GlyphId } from "../../types.ts";
+import type { Reader } from "../binary/reader.ts";
+/**
+ * COLR (Color) table parser
+ * Defines color glyph layers
+ */
+export interface ColrTable {
+    version: number;
+    baseGlyphRecords: BaseGlyphRecord[];
+    layerRecords: LayerRecord[];
+    baseGlyphPaintRecords?: BaseGlyphPaintRecord[];
+    layerList?: Paint[];
+    clipList?: ClipRecord[];
+    varIdxMap?: number[];
+    itemVariationStore?: ItemVariationStore;
+}
+export interface BaseGlyphRecord {
+    glyphId: GlyphId;
+    firstLayerIndex: number;
+    numLayers: number;
+}
+export interface LayerRecord {
+    glyphId: GlyphId;
+    paletteIndex: number;
+}
+export interface BaseGlyphPaintRecord {
+    glyphId: GlyphId;
+    paint: Paint;
+}
+export declare enum PaintFormat {
+    ColrLayers = 1,
+    Solid = 2,
+    VarSolid = 3,
+    LinearGradient = 4,
+    VarLinearGradient = 5,
+    RadialGradient = 6,
+    VarRadialGradient = 7,
+    SweepGradient = 8,
+    VarSweepGradient = 9,
+    Glyph = 10,
+    ColrGlyph = 11,
+    Transform = 12,
+    VarTransform = 13,
+    Translate = 14,
+    VarTranslate = 15,
+    Scale = 16,
+    VarScale = 17,
+    ScaleAroundCenter = 18,
+    VarScaleAroundCenter = 19,
+    ScaleUniform = 20,
+    VarScaleUniform = 21,
+    ScaleUniformAroundCenter = 22,
+    VarScaleUniformAroundCenter = 23,
+    Rotate = 24,
+    VarRotate = 25,
+    RotateAroundCenter = 26,
+    VarRotateAroundCenter = 27,
+    Skew = 28,
+    VarSkew = 29,
+    SkewAroundCenter = 30,
+    VarSkewAroundCenter = 31,
+    Composite = 32
+}
+export type Paint = PaintColrLayers | PaintSolid | PaintLinearGradient | PaintRadialGradient | PaintSweepGradient | PaintGlyph | PaintColrGlyph | PaintTransform | PaintTranslate | PaintScale | PaintRotate | PaintSkew | PaintComposite;
+export interface PaintColrLayers {
+    format: PaintFormat.ColrLayers;
+    numLayers: number;
+    firstLayerIndex: number;
+}
+export interface PaintSolid {
+    format: PaintFormat.Solid | PaintFormat.VarSolid;
+    paletteIndex: number;
+    alpha: number;
+    varIndexBase?: number;
+}
+export interface PaintLinearGradient {
+    format: PaintFormat.LinearGradient | PaintFormat.VarLinearGradient;
+    colorLine: ColorLine;
+    x0: number;
+    y0: number;
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+export interface PaintRadialGradient {
+    format: PaintFormat.RadialGradient | PaintFormat.VarRadialGradient;
+    colorLine: ColorLine;
+    x0: number;
+    y0: number;
+    radius0: number;
+    x1: number;
+    y1: number;
+    radius1: number;
+}
+export interface PaintSweepGradient {
+    format: PaintFormat.SweepGradient | PaintFormat.VarSweepGradient;
+    colorLine: ColorLine;
+    centerX: number;
+    centerY: number;
+    startAngle: number;
+    endAngle: number;
+}
+export interface PaintGlyph {
+    format: PaintFormat.Glyph;
+    paint: Paint;
+    glyphId: GlyphId;
+}
+export interface PaintColrGlyph {
+    format: PaintFormat.ColrGlyph;
+    glyphId: GlyphId;
+}
+export interface PaintTransform {
+    format: PaintFormat.Transform | PaintFormat.VarTransform;
+    paint: Paint;
+    transform: Affine2x3;
+}
+export interface PaintTranslate {
+    format: PaintFormat.Translate | PaintFormat.VarTranslate;
+    paint: Paint;
+    dx: number;
+    dy: number;
+}
+export interface PaintScale {
+    format: PaintFormat.Scale | PaintFormat.VarScale | PaintFormat.ScaleAroundCenter | PaintFormat.VarScaleAroundCenter | PaintFormat.ScaleUniform | PaintFormat.VarScaleUniform | PaintFormat.ScaleUniformAroundCenter | PaintFormat.VarScaleUniformAroundCenter;
+    paint: Paint;
+    scaleX: number;
+    scaleY: number;
+    centerX?: number;
+    centerY?: number;
+}
+export interface PaintRotate {
+    format: PaintFormat.Rotate | PaintFormat.VarRotate | PaintFormat.RotateAroundCenter | PaintFormat.VarRotateAroundCenter;
+    paint: Paint;
+    angle: number;
+    centerX?: number;
+    centerY?: number;
+}
+export interface PaintSkew {
+    format: PaintFormat.Skew | PaintFormat.VarSkew | PaintFormat.SkewAroundCenter | PaintFormat.VarSkewAroundCenter;
+    paint: Paint;
+    xSkewAngle: number;
+    ySkewAngle: number;
+    centerX?: number;
+    centerY?: number;
+}
+export interface PaintComposite {
+    format: PaintFormat.Composite;
+    sourcePaint: Paint;
+    compositeMode: CompositeMode;
+    backdropPaint: Paint;
+}
+export interface ColorLine {
+    extend: Extend;
+    colorStops: ColorStop[];
+}
+export interface ColorStop {
+    stopOffset: number;
+    paletteIndex: number;
+    alpha: number;
+}
+export declare enum Extend {
+    Pad = 0,
+    Repeat = 1,
+    Reflect = 2
+}
+export declare enum CompositeMode {
+    Clear = 0,
+    Src = 1,
+    Dest = 2,
+    SrcOver = 3,
+    DestOver = 4,
+    SrcIn = 5,
+    DestIn = 6,
+    SrcOut = 7,
+    DestOut = 8,
+    SrcAtop = 9,
+    DestAtop = 10,
+    Xor = 11,
+    Plus = 12,
+    Screen = 13,
+    Overlay = 14,
+    Darken = 15,
+    Lighten = 16,
+    ColorDodge = 17,
+    ColorBurn = 18,
+    HardLight = 19,
+    SoftLight = 20,
+    Difference = 21,
+    Exclusion = 22,
+    Multiply = 23,
+    Hue = 24,
+    Saturation = 25,
+    Color = 26,
+    Luminosity = 27
+}
+export interface Affine2x3 {
+    xx: number;
+    yx: number;
+    xy: number;
+    yy: number;
+    dx: number;
+    dy: number;
+}
+export interface ClipRecord {
+    startGlyphId: GlyphId;
+    endGlyphId: GlyphId;
+    clipBox: ClipBox;
+}
+export interface ClipBox {
+    format: number;
+    xMin: number;
+    yMin: number;
+    xMax: number;
+    yMax: number;
+    varIndexBase?: number;
+}
+export interface ItemVariationStore {
+    format: number;
+    variationRegionListOffset: number;
+    itemVariationDataCount: number;
+    itemVariationDataOffsets: number[];
+    variationRegions: VariationRegion[];
+    itemVariationData: ItemVariationData[];
+}
+export interface VariationRegion {
+    regionAxes: RegionAxisCoordinates[];
+}
+export interface RegionAxisCoordinates {
+    startCoord: number;
+    peakCoord: number;
+    endCoord: number;
+}
+export interface ItemVariationData {
+    itemCount: number;
+    wordDeltaCount: number;
+    regionIndexCount: number;
+    regionIndexes: number[];
+    deltaSets: number[][];
+}
+export interface VarColorLine extends ColorLine {
+    varIndexBase?: number;
+}
+export interface VarColorStop extends ColorStop {
+    varIndexBase?: number;
+}
+/**
+ * Parse COLR table
+ */
+export declare function parseColr(reader: Reader): ColrTable;
+/**
+ * Get color layers for a glyph (v0)
+ */
+export declare function getColorLayers(colr: ColrTable, glyphId: GlyphId): LayerRecord[] | null;
+/**
+ * Get paint for a glyph (v1)
+ */
+export declare function getColorPaint(colr: ColrTable, glyphId: GlyphId): Paint | null;
+/**
+ * Check if glyph has color data
+ */
+export declare function hasColorGlyph(colr: ColrTable, glyphId: GlyphId): boolean;
+/**
+ * Get clip box for a glyph
+ */
+export declare function getClipBox(colr: ColrTable, glyphId: GlyphId): ClipBox | null;
+/**
+ * Calculate variation delta for a paint value
+ */
+export declare function getColorVariationDelta(colr: ColrTable, varIndex: number, coords: number[]): number;
+/**
+ * Check if COLR table is version 1
+ */
+export declare function isColrV1(colr: ColrTable): boolean;
+/**
+ * Get the paint layer at a specific index from the layer list
+ */
+export declare function getLayerPaint(colr: ColrTable, index: number): Paint | null;

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

@@ -0,0 +1,46 @@
+import type { Reader } from "../binary/reader.ts";
+/**
+ * CPAL (Color Palette) table parser
+ * Provides color palettes for color fonts
+ */
+export interface CpalTable {
+    version: number;
+    numPalettes: number;
+    numPaletteEntries: number;
+    palettes: ColorPalette[];
+    paletteTypes?: number[];
+    paletteLabels?: number[];
+    paletteEntryLabels?: number[];
+}
+export interface ColorPalette {
+    colors: Color[];
+}
+export interface Color {
+    blue: number;
+    green: number;
+    red: number;
+    alpha: number;
+}
+/**
+ * Palette type flags
+ */
+export declare enum PaletteType {
+    UsableWithLightBackground = 1,
+    UsableWithDarkBackground = 2
+}
+/**
+ * Parse CPAL table
+ */
+export declare function parseCpal(reader: Reader): CpalTable;
+/**
+ * Get color from palette
+ */
+export declare function getColor(cpal: CpalTable, paletteIndex: number, colorIndex: number): Color | null;
+/**
+ * Convert color to CSS rgba string
+ */
+export declare function colorToRgba(color: Color): string;
+/**
+ * Convert color to CSS hex string
+ */
+export declare function colorToHex(color: Color): string;

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

@@ -0,0 +1,359 @@
+import type { uint16, uint32 } from "../../types.ts";
+import type { Reader } from "../binary/reader.ts";
+/**
+ * AAT Feature Name table (feat)
+ * https://developer.apple.com/fonts/TrueType-Reference-Manual/RM06/Chap6feat.html
+ *
+ * Defines the font's typographic features that can be controlled by the user.
+ * Each feature has a type and settings with human-readable names.
+ */
+export interface FeatTable {
+    version: number;
+    features: FeatureRecord[];
+}
+/**
+ * A single feature record
+ */
+export interface FeatureRecord {
+    /** Feature type (e.g., 1 = ligatures, 2 = cursive connection) */
+    featureType: uint16;
+    /** Number of settings for this feature */
+    nSettings: uint16;
+    /** Offset to setting name array */
+    settingTableOffset: uint32;
+    /** Feature flags */
+    featureFlags: uint16;
+    /** Default setting index */
+    defaultSettingIndex: uint16;
+    /** Name table ID for feature name */
+    nameId: uint16;
+    /** Parsed settings */
+    settings: FeatureSetting[];
+}
+/**
+ * A single feature setting
+ */
+export interface FeatureSetting {
+    /** Setting value to use in morx feature table */
+    settingValue: uint16;
+    /** Name table ID for setting name */
+    nameId: uint16;
+}
+/**
+ * Feature type constants (Apple-defined)
+ */
+export declare enum FeatureType {
+    /** All typographic features */
+    AllTypographicFeatures = 0,
+    /** Ligatures */
+    Ligatures = 1,
+    /** Cursive connection */
+    CursiveConnection = 2,
+    /** Letter case */
+    LetterCase = 3,
+    /** Vertical substitution */
+    VerticalSubstitution = 4,
+    /** Linguistic rearrangement */
+    LinguisticRearrangement = 5,
+    /** Number spacing */
+    NumberSpacing = 6,
+    /** Smart swashes */
+    SmartSwashes = 8,
+    /** Diacritics */
+    Diacritics = 9,
+    /** Vertical position */
+    VerticalPosition = 10,
+    /** Fractions */
+    Fractions = 11,
+    /** Overlapping characters */
+    OverlappingCharacters = 13,
+    /** Typographic extras */
+    TypographicExtras = 14,
+    /** Mathematical extras */
+    MathematicalExtras = 15,
+    /** Ornament sets */
+    OrnamentSets = 16,
+    /** Character alternatives */
+    CharacterAlternatives = 17,
+    /** Design complexity */
+    DesignComplexity = 18,
+    /** Style options */
+    StyleOptions = 19,
+    /** Character shape */
+    CharacterShape = 20,
+    /** Number case */
+    NumberCase = 21,
+    /** Text spacing */
+    TextSpacing = 22,
+    /** Transliteration */
+    Transliteration = 23,
+    /** Annotation */
+    Annotation = 24,
+    /** Kana spacing */
+    KanaSpacing = 25,
+    /** Ideographic spacing */
+    IdeographicSpacing = 26,
+    /** Unicode decomposition */
+    UnicodeDecomposition = 27,
+    /** Ruby kana */
+    RubyKana = 28,
+    /** CJK symbol alternatives */
+    CJKSymbolAlternatives = 29,
+    /** Ideographic alternatives */
+    IdeographicAlternatives = 30,
+    /** CJK vertical roman placement */
+    CJKVerticalRomanPlacement = 31,
+    /** Italic CJK roman */
+    ItalicCJKRoman = 32,
+    /** Case-sensitive layout */
+    CaseSensitiveLayout = 33,
+    /** Alternate kana */
+    AlternateKana = 34,
+    /** Stylistic alternatives */
+    StylisticAlternatives = 35,
+    /** Contextual alternatives */
+    ContextualAlternatives = 36,
+    /** Lower case */
+    LowerCase = 37,
+    /** Upper case */
+    UpperCase = 38,
+    /** Language tag */
+    LanguageTag = 39,
+    /** CJK roman spacing */
+    CJKRomanSpacing = 103
+}
+/**
+ * Common ligature settings
+ */
+export declare enum LigatureSetting {
+    RequiredLigaturesOn = 0,
+    RequiredLigaturesOff = 1,
+    CommonLigaturesOn = 2,
+    CommonLigaturesOff = 3,
+    RareLigaturesOn = 4,
+    RareLigaturesOff = 5,
+    LogosOn = 6,
+    LogosOff = 7,
+    RebusPicturesOn = 8,
+    RebusPicturesOff = 9,
+    DiphthongLigaturesOn = 10,
+    DiphthongLigaturesOff = 11,
+    SquaredLigaturesOn = 12,
+    SquaredLigaturesOff = 13,
+    AbbrevSquaredLigaturesOn = 14,
+    AbbrevSquaredLigaturesOff = 15,
+    SymbolLigaturesOn = 16,
+    SymbolLigaturesOff = 17,
+    ContextualLigaturesOn = 18,
+    ContextualLigaturesOff = 19,
+    HistoricalLigaturesOn = 20,
+    HistoricalLigaturesOff = 21
+}
+/**
+ * Vertical position settings
+ */
+export declare enum VerticalPositionSetting {
+    NormalPosition = 0,
+    Superiors = 1,
+    Inferiors = 2,
+    Ordinals = 3,
+    ScientificInferiors = 4
+}
+/**
+ * Number case settings
+ */
+export declare enum NumberCaseSetting {
+    LowerCaseNumbers = 0,
+    UpperCaseNumbers = 1
+}
+/**
+ * Number spacing settings
+ */
+export declare enum NumberSpacingSetting {
+    MonospacedNumbers = 0,
+    ProportionalNumbers = 1,
+    ThirdWidthNumbers = 2,
+    QuarterWidthNumbers = 3
+}
+/**
+ * Fractions settings
+ */
+export declare enum FractionsSetting {
+    NoFractions = 0,
+    VerticalFractions = 1,
+    DiagonalFractions = 2
+}
+/**
+ * Case-sensitive layout settings
+ */
+export declare enum CaseSensitiveLayoutSetting {
+    CaseSensitiveLayoutOn = 0,
+    CaseSensitiveLayoutOff = 1,
+    CaseSensitiveSpacingOn = 2,
+    CaseSensitiveSpacingOff = 3
+}
+/**
+ * Stylistic alternatives settings
+ */
+export declare enum StylisticAlternativesSetting {
+    NoStylisticAlternates = 0,
+    StylisticAltOneOn = 2,
+    StylisticAltOneOff = 3,
+    StylisticAltTwoOn = 4,
+    StylisticAltTwoOff = 5,
+    StylisticAltThreeOn = 6,
+    StylisticAltThreeOff = 7,
+    StylisticAltFourOn = 8,
+    StylisticAltFourOff = 9,
+    StylisticAltFiveOn = 10,
+    StylisticAltFiveOff = 11,
+    StylisticAltSixOn = 12,
+    StylisticAltSixOff = 13,
+    StylisticAltSevenOn = 14,
+    StylisticAltSevenOff = 15,
+    StylisticAltEightOn = 16,
+    StylisticAltEightOff = 17,
+    StylisticAltNineOn = 18,
+    StylisticAltNineOff = 19,
+    StylisticAltTenOn = 20,
+    StylisticAltTenOff = 21,
+    StylisticAltElevenOn = 22,
+    StylisticAltElevenOff = 23,
+    StylisticAltTwelveOn = 24,
+    StylisticAltTwelveOff = 25,
+    StylisticAltThirteenOn = 26,
+    StylisticAltThirteenOff = 27,
+    StylisticAltFourteenOn = 28,
+    StylisticAltFourteenOff = 29,
+    StylisticAltFifteenOn = 30,
+    StylisticAltFifteenOff = 31,
+    StylisticAltSixteenOn = 32,
+    StylisticAltSixteenOff = 33,
+    StylisticAltSeventeenOn = 34,
+    StylisticAltSeventeenOff = 35,
+    StylisticAltEighteenOn = 36,
+    StylisticAltEighteenOff = 37,
+    StylisticAltNineteenOn = 38,
+    StylisticAltNineteenOff = 39,
+    StylisticAltTwentyOn = 40,
+    StylisticAltTwentyOff = 41
+}
+/**
+ * Contextual alternatives settings
+ */
+export declare enum ContextualAlternativesSetting {
+    ContextualAlternatesOn = 0,
+    ContextualAlternatesOff = 1,
+    SwashAlternatesOn = 2,
+    SwashAlternatesOff = 3,
+    ContextualSwashAlternatesOn = 4,
+    ContextualSwashAlternatesOff = 5
+}
+/**
+ * Lower case settings
+ */
+export declare enum LowerCaseSetting {
+    DefaultLowerCase = 0,
+    LowerCaseSmallCaps = 1,
+    LowerCasePetiteCaps = 2
+}
+/**
+ * Upper case settings
+ */
+export declare enum UpperCaseSetting {
+    DefaultUpperCase = 0,
+    UpperCaseSmallCaps = 1,
+    UpperCasePetiteCaps = 2
+}
+/**
+ * Smart swash settings
+ */
+export declare enum SmartSwashSetting {
+    WordInitialSwashesOn = 0,
+    WordInitialSwashesOff = 1,
+    WordFinalSwashesOn = 2,
+    WordFinalSwashesOff = 3,
+    LineInitialSwashesOn = 4,
+    LineInitialSwashesOff = 5,
+    LineFinalSwashesOn = 6,
+    LineFinalSwashesOff = 7,
+    NonFinalSwashesOn = 8,
+    NonFinalSwashesOff = 9
+}
+/**
+ * Diacritics settings
+ */
+export declare enum DiacriticsSetting {
+    ShowDiacritics = 0,
+    HideDiacritics = 1,
+    DecomposeDiacritics = 2
+}
+/**
+ * Character shape settings (CJK)
+ */
+export declare enum CharacterShapeSetting {
+    TraditionalCharacters = 0,
+    SimplifiedCharacters = 1,
+    JIS1978Characters = 2,
+    JIS1983Characters = 3,
+    JIS1990Characters = 4,
+    TraditionalAltOne = 5,
+    TraditionalAltTwo = 6,
+    TraditionalAltThree = 7,
+    TraditionalAltFour = 8,
+    TraditionalAltFive = 9,
+    ExpertCharacters = 10,
+    NLCCharacters = 13,
+    JIS2004Characters = 11,
+    HojoCharacters = 12
+}
+/**
+ * Feature flag bits
+ */
+export declare enum FeatureFlags {
+    /** Feature settings are mutually exclusive */
+    Exclusive = 32768,
+    /** Use default setting index if not specified */
+    UseDefault = 16384
+}
+/**
+ * Parse feat table
+ */
+export declare function parseFeat(reader: Reader): FeatTable;
+/**
+ * Get a feature by type
+ */
+export declare function getFeature(table: FeatTable, featureType: FeatureType | uint16): FeatureRecord | undefined;
+/**
+ * Get all features of a given type
+ */
+export declare function getAllFeatures(table: FeatTable): FeatureRecord[];
+/**
+ * Check if a feature is exclusive (only one setting can be active)
+ */
+export declare function isExclusiveFeature(feature: FeatureRecord): boolean;
+/**
+ * Get the default setting for a feature
+ */
+export declare function getDefaultSetting(feature: FeatureRecord): FeatureSetting | undefined;
+/**
+ * Get a setting by value
+ */
+export declare function getSettingByValue(feature: FeatureRecord, settingValue: uint16): FeatureSetting | undefined;
+/**
+ * Check if a feature has a specific setting
+ */
+export declare function hasSettingValue(feature: FeatureRecord, settingValue: uint16): boolean;
+/**
+ * Convert AAT feature type/setting to OpenType feature tag
+ * This is a best-effort mapping as there's no 1:1 correspondence
+ */
+export declare function aatToOpenTypeTag(featureType: FeatureType | uint16, settingValue: uint16): string | null;
+/**
+ * Convert OpenType feature tag to AAT feature type/setting
+ * Returns null if no mapping exists
+ */
+export declare function openTypeTagToAat(tag: string): {
+    featureType: FeatureType;
+    settingValue: uint16;
+} | null;