text-shaper 0.0.1

package/dist/shaper/features.d.ts

@@ -0,0 +1,189 @@
+import type { ShapeFeature } from "./shape-plan.ts";
+/**
+ * Feature helper utilities
+ * Provides convenient APIs for enabling OpenType features
+ */
+/**
+ * Create a ShapeFeature for a stylistic set (ss01-ss20)
+ */
+export declare function stylisticSet(setNumber: number, enabled?: boolean): ShapeFeature;
+/**
+ * Create ShapeFeatures for multiple stylistic sets
+ */
+export declare function stylisticSets(setNumbers: number[], enabled?: boolean): ShapeFeature[];
+/**
+ * Create a ShapeFeature for a character variant (cv01-cv99)
+ */
+export declare function characterVariant(variantNumber: number, enabled?: boolean): ShapeFeature;
+/**
+ * Create ShapeFeatures for multiple character variants
+ */
+export declare function characterVariants(variantNumbers: number[], enabled?: boolean): ShapeFeature[];
+/**
+ * Standard ligatures (liga)
+ */
+export declare function standardLigatures(enabled?: boolean): ShapeFeature;
+/**
+ * Discretionary ligatures (dlig)
+ */
+export declare function discretionaryLigatures(enabled?: boolean): ShapeFeature;
+/**
+ * Historical ligatures (hlig)
+ */
+export declare function historicalLigatures(enabled?: boolean): ShapeFeature;
+/**
+ * Contextual alternates (calt)
+ */
+export declare function contextualAlternates(enabled?: boolean): ShapeFeature;
+/**
+ * Stylistic alternates (salt)
+ */
+export declare function stylisticAlternates(enabled?: boolean): ShapeFeature;
+/**
+ * Swash (swsh)
+ */
+export declare function swash(enabled?: boolean): ShapeFeature;
+/**
+ * Small capitals (smcp)
+ */
+export declare function smallCaps(enabled?: boolean): ShapeFeature;
+/**
+ * Capitals to small capitals (c2sc)
+ */
+export declare function capsToSmallCaps(enabled?: boolean): ShapeFeature;
+/**
+ * Petite capitals (pcap)
+ */
+export declare function petiteCaps(enabled?: boolean): ShapeFeature;
+/**
+ * All small capitals (both smcp and c2sc)
+ */
+export declare function allSmallCaps(enabled?: boolean): ShapeFeature[];
+/**
+ * Oldstyle figures (onum)
+ */
+export declare function oldstyleFigures(enabled?: boolean): ShapeFeature;
+/**
+ * Lining figures (lnum)
+ */
+export declare function liningFigures(enabled?: boolean): ShapeFeature;
+/**
+ * Proportional figures (pnum)
+ */
+export declare function proportionalFigures(enabled?: boolean): ShapeFeature;
+/**
+ * Tabular figures (tnum)
+ */
+export declare function tabularFigures(enabled?: boolean): ShapeFeature;
+/**
+ * Fractions (frac)
+ */
+export declare function fractions(enabled?: boolean): ShapeFeature;
+/**
+ * Ordinals (ordn)
+ */
+export declare function ordinals(enabled?: boolean): ShapeFeature;
+/**
+ * Slashed zero (zero)
+ */
+export declare function slashedZero(enabled?: boolean): ShapeFeature;
+/**
+ * Superscript (sups)
+ */
+export declare function superscript(enabled?: boolean): ShapeFeature;
+/**
+ * Subscript (subs)
+ */
+export declare function subscript(enabled?: boolean): ShapeFeature;
+/**
+ * Scientific inferiors (sinf)
+ */
+export declare function scientificInferiors(enabled?: boolean): ShapeFeature;
+/**
+ * Case-sensitive forms (case)
+ */
+export declare function caseSensitiveForms(enabled?: boolean): ShapeFeature;
+/**
+ * Capital spacing (cpsp)
+ */
+export declare function capitalSpacing(enabled?: boolean): ShapeFeature;
+/**
+ * Kerning (kern)
+ */
+export declare function kerning(enabled?: boolean): ShapeFeature;
+/**
+ * Vertical forms (vert) - for vertical text layout
+ */
+export declare function verticalForms(enabled?: boolean): ShapeFeature;
+/**
+ * Vertical alternates and rotation (vrt2) - for vertical text layout
+ */
+export declare function verticalAlternatesRotation(enabled?: boolean): ShapeFeature;
+/**
+ * Vertical Kana alternates (vkna) - for Japanese vertical text
+ */
+export declare function verticalKanaAlternates(enabled?: boolean): ShapeFeature;
+/**
+ * All vertical layout features
+ */
+export declare function verticalLayoutFeatures(enabled?: boolean): ShapeFeature[];
+/**
+ * Ruby notation forms (ruby)
+ */
+export declare function ruby(enabled?: boolean): ShapeFeature;
+/**
+ * Half-width forms (hwid)
+ */
+export declare function halfWidthForms(enabled?: boolean): ShapeFeature;
+/**
+ * Full-width forms (fwid)
+ */
+export declare function fullWidthForms(enabled?: boolean): ShapeFeature;
+/**
+ * Proportional-width forms (pwid)
+ */
+export declare function proportionalWidthForms(enabled?: boolean): ShapeFeature;
+/**
+ * Quarter-width forms (qwid)
+ */
+export declare function quarterWidthForms(enabled?: boolean): ShapeFeature;
+/**
+ * Third-width forms (twid)
+ */
+export declare function thirdWidthForms(enabled?: boolean): ShapeFeature;
+/**
+ * JIS78 forms (jp78) - Japanese
+ */
+export declare function jis78Forms(enabled?: boolean): ShapeFeature;
+/**
+ * JIS83 forms (jp83) - Japanese
+ */
+export declare function jis83Forms(enabled?: boolean): ShapeFeature;
+/**
+ * JIS90 forms (jp90) - Japanese
+ */
+export declare function jis90Forms(enabled?: boolean): ShapeFeature;
+/**
+ * JIS2004 forms (jp04) - Japanese
+ */
+export declare function jis2004Forms(enabled?: boolean): ShapeFeature;
+/**
+ * Simplified forms (smpl) - Chinese
+ */
+export declare function simplifiedForms(enabled?: boolean): ShapeFeature;
+/**
+ * Traditional forms (trad) - Chinese
+ */
+export declare function traditionalForms(enabled?: boolean): ShapeFeature;
+/**
+ * Create a feature from a 4-character tag string
+ */
+export declare function feature(tagStr: string, enabled?: boolean): ShapeFeature;
+/**
+ * Create multiple features from tag strings
+ */
+export declare function features(tagStrs: string[], enabled?: boolean): ShapeFeature[];
+/**
+ * Combine multiple feature sets
+ */
+export declare function combineFeatures(...featureSets: (ShapeFeature | ShapeFeature[])[]): ShapeFeature[];

package/dist/shaper/shape-plan.d.ts

@@ -0,0 +1,29 @@
+import type { Font } from "../font/font.ts";
+import type { AnyGposLookup } from "../font/tables/gpos.ts";
+import type { AnyGsubLookup } from "../font/tables/gsub.ts";
+import type { Tag } from "../types.ts";
+/** Feature with optional value */
+export interface ShapeFeature {
+    tag: Tag;
+    enabled: boolean;
+}
+/** Collected lookups for shaping */
+export interface ShapePlan {
+    script: Tag;
+    language: Tag | null;
+    direction: "ltr" | "rtl";
+    /** GSUB lookups to apply, in order */
+    gsubLookups: Array<{
+        index: number;
+        lookup: AnyGsubLookup;
+    }>;
+    /** GPOS lookups to apply, in order */
+    gposLookups: Array<{
+        index: number;
+        lookup: AnyGposLookup;
+    }>;
+}
+/** Get or create a cached shape plan */
+export declare function getOrCreateShapePlan(font: Font, script: string, language: string | null, direction: "ltr" | "rtl", userFeatures?: ShapeFeature[], axisCoords?: number[] | null): ShapePlan;
+/** Create a shape plan for the given font and settings */
+export declare function createShapePlan(font: Font, script: string, language: string | null, direction: "ltr" | "rtl", userFeatures?: ShapeFeature[], axisCoords?: number[] | null): ShapePlan;

package/dist/shaper/shaper.d.ts

@@ -0,0 +1,18 @@
+import { GlyphBuffer } from "../buffer/glyph-buffer.ts";
+import type { UnicodeBuffer } from "../buffer/unicode-buffer.ts";
+import { Face } from "../font/face.ts";
+import type { Font } from "../font/font.ts";
+import { type ShapeFeature } from "./shape-plan.ts";
+export interface ShapeOptions {
+    script?: string;
+    language?: string | null;
+    direction?: "ltr" | "rtl";
+    features?: ShapeFeature[];
+}
+/** Font or Face - accepted by shape function */
+export type FontLike = Font | Face;
+/**
+ * Shape text using OpenType features.
+ * Accepts Font or Face (for variable fonts).
+ */
+export declare function shape(fontLike: FontLike, buffer: UnicodeBuffer, options?: ShapeOptions): GlyphBuffer;

package/dist/types.d.ts

@@ -0,0 +1,153 @@
+export type uint8 = number;
+export type int8 = number;
+export type uint16 = number;
+export type int16 = number;
+export type uint32 = number;
+export type int32 = number;
+export type Fixed = number;
+export type F2Dot14 = number;
+export type FWord = number;
+export type UFWord = number;
+export type Offset16 = number;
+export type Offset32 = number;
+export type GlyphId = number;
+/** 4-character ASCII tag (packed as uint32 for efficiency) */
+export type Tag = number;
+/** Text direction */
+export declare enum Direction {
+    Invalid = 0,
+    LTR = 4,
+    RTL = 5,
+    TTB = 6,
+    BTT = 7
+}
+/** Cluster level for glyph-character mapping */
+export declare enum ClusterLevel {
+    MonotoneGraphemes = 0,
+    MonotoneCharacters = 1,
+    Characters = 2
+}
+/** Buffer flags */
+export declare enum BufferFlags {
+    Default = 0,
+    BeginningOfText = 1,
+    EndOfText = 2,
+    PreserveDefaultIgnorables = 4,
+    RemoveDefaultIgnorables = 8,
+    DoNotInsertDottedCircle = 16
+}
+/** Glyph classification from GDEF */
+export declare enum GlyphClass {
+    Base = 1,
+    Ligature = 2,
+    Mark = 3,
+    Component = 4
+}
+/** Feature specification for shaping */
+export interface Feature {
+    tag: Tag;
+    value: number;
+    start: number;
+    end: number;
+}
+/** Variation axis value */
+export interface Variation {
+    tag: Tag;
+    value: number;
+}
+/** Glyph info during shaping */
+export interface GlyphInfo {
+    glyphId: GlyphId;
+    cluster: number;
+    mask: number;
+    /** Unicode codepoint (before shaping) */
+    codepoint: number;
+}
+/** Glyph position after shaping */
+export interface GlyphPosition {
+    xAdvance: number;
+    yAdvance: number;
+    xOffset: number;
+    yOffset: number;
+}
+/** Table record from font directory */
+export interface TableRecord {
+    tag: Tag;
+    checksum: uint32;
+    offset: Offset32;
+    length: uint32;
+}
+/** Lookup flags for controlling glyph matching */
+export interface LookupFlags {
+    rightToLeft: boolean;
+    ignoreBaseGlyphs: boolean;
+    ignoreLigatures: boolean;
+    ignoreMarks: boolean;
+    useMarkFilteringSet: boolean;
+    markAttachmentType: number;
+    markFilteringSet?: number;
+}
+export declare function tag(str: string): Tag;
+export declare function tagToString(t: Tag): string;
+export declare const Tags: {
+    readonly head: number;
+    readonly hhea: number;
+    readonly hmtx: number;
+    readonly maxp: number;
+    readonly cmap: number;
+    readonly loca: number;
+    readonly glyf: number;
+    readonly name: number;
+    readonly OS2: number;
+    readonly post: number;
+    readonly GDEF: number;
+    readonly GSUB: number;
+    readonly GPOS: number;
+    readonly BASE: number;
+    readonly JSTF: number;
+    readonly MATH: number;
+    readonly CFF: number;
+    readonly CFF2: number;
+    readonly fvar: number;
+    readonly gvar: number;
+    readonly avar: number;
+    readonly HVAR: number;
+    readonly VVAR: number;
+    readonly MVAR: number;
+    readonly morx: number;
+    readonly kerx: number;
+    readonly kern: number;
+    readonly trak: number;
+    readonly feat: number;
+    readonly COLR: number;
+    readonly CPAL: number;
+    readonly SVG: number;
+    readonly sbix: number;
+    readonly CBDT: number;
+    readonly CBLC: number;
+    readonly STAT: number;
+    readonly vhea: number;
+    readonly vmtx: number;
+    readonly VORG: number;
+};
+export declare const FeatureTags: {
+    readonly ccmp: number;
+    readonly locl: number;
+    readonly rlig: number;
+    readonly liga: number;
+    readonly clig: number;
+    readonly calt: number;
+    readonly rclt: number;
+    readonly dlig: number;
+    readonly smcp: number;
+    readonly c2sc: number;
+    readonly isol: number;
+    readonly init: number;
+    readonly medi: number;
+    readonly fina: number;
+    readonly kern: number;
+    readonly mark: number;
+    readonly mkmk: number;
+    readonly curs: number;
+    readonly dist: number;
+};