text-shaper 0.1.15 → 0.1.18

package/README.md

@@ -3,7 +3,7 @@
 [![GitHub](https://img.shields.io/badge/-GitHub-181717?style=flat-square&logo=github&logoColor=white)](https://github.com/wiedymi)
 [![Twitter](https://img.shields.io/badge/-Twitter-1DA1F2?style=flat-square&logo=twitter&logoColor=white)](https://x.com/wiedymi)
 [![Email](https://img.shields.io/badge/-Email-EA4335?style=flat-square&logo=gmail&logoColor=white)](mailto:contact@wiedymi.com)
-[![Discord](https://img.shields.io/badge/-Discord-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/eKW7GNesuS)
+[![Discord](https://img.shields.io/badge/-Discord-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/zemMZtrkSb)
 [![Support me](https://img.shields.io/badge/-Support%20me-ff69b4?style=flat-square&logo=githubsponsors&logoColor=white)](https://github.com/sponsors/vivy-company)
 
 Pure TypeScript text shaping engine with OpenType layout, TrueType hinting, and FreeType-style rasterization. Works in browsers and Bun/Node.js with zero dependencies.
@@ -92,6 +92,21 @@ for (const text of texts) {
 }
 ```
 
+### TTC Collections
+
+```typescript
+import { Font } from "text-shaper";
+
+const buffer = await fetch("fonts.ttc").then(r => r.arrayBuffer());
+const collection = Font.collection(buffer);
+
+if (collection) {
+  console.log(collection.count);
+  const names = collection.names();
+  const font = collection.get(0);
+}
+```
+
 ### With Features
 
 ```typescript

package/dist/font/font.d.ts

@@ -1,5 +1,6 @@
 import type { GlyphId, TableRecord, Tag } from "../types.ts";
 import { Reader } from "./binary/reader.ts";
+import { type TtcHeader } from "./ttc.ts";
 import { type AvarTable } from "./tables/avar.ts";
 import { type BaseTable } from "./tables/base.ts";
 import { type CbdtTable, type CblcTable } from "./tables/cbdt.ts";
@@ -44,6 +45,25 @@ import { type VvarTable } from "./tables/vvar.ts";
 export interface FontLoadOptions {
     /** Tables to parse eagerly (default: lazy) */
     eagerTables?: Tag[];
+    /** TTC collection index (default: 0 when loading a TTC) */
+    collectionIndex?: number;
+}
+export interface CollectionFaceName {
+    index: number;
+    fullName?: string;
+    family?: string;
+    subfamily?: string;
+    postScriptName?: string;
+}
+export declare class FontCollection {
+    private readonly buffer;
+    private readonly header;
+    private readonly loadFace;
+    private namesCache;
+    constructor(buffer: ArrayBuffer, header: TtcHeader, loadFace: (index: number, options?: FontLoadOptions) => Font);
+    get count(): number;
+    get(index: number, options?: FontLoadOptions): Font;
+    names(): CollectionFaceName[];
 }
 /**
  * Represents a loaded font file.
@@ -96,7 +116,7 @@ export declare class Font {
     private _cvt;
     private _gasp;
     private constructor();
-    /** Load font from ArrayBuffer (sync - does not support WOFF2) */
+    /** Load font from ArrayBuffer (sync - WOFF2 requires async loading) */
     static load(buffer: ArrayBuffer, options?: FontLoadOptions): Font;
     /** Load font from ArrayBuffer with WOFF2 support (async) */
     static loadAsync(buffer: ArrayBuffer, options?: FontLoadOptions): Promise<Font>;
@@ -104,6 +124,10 @@ export declare class Font {
     static fromURL(url: string, options?: FontLoadOptions): Promise<Font>;
     /** Load font from file path (Bun only, supports WOFF2) */
     static fromFile(path: string, options?: FontLoadOptions): Promise<Font>;
+    /** Create a TTC collection helper if buffer is a TrueType Collection */
+    static collection(buffer: ArrayBuffer): FontCollection | null;
+    private static loadFromBuffer;
+    private static loadFromTtc;
     /** Check if font has a specific table */
     hasTable(tag: Tag): boolean;
     /** Get table record */
@@ -163,6 +187,15 @@ export declare class Font {
     get descender(): number;
     /** Line gap (from hhea) */
     get lineGap(): number;
+    /** Line height (ascender - descender + lineGap for TrueType, ascender - descender for CFF) */
+    get height(): number;
+    /**
+     * Get scale factor for converting font units to pixels
+     * @param sizePx Target size in pixels
+     * @param mode Sizing mode: "em" (default) or "height"
+     * @returns Scale factor to multiply font units by
+     */
+    scaleForSize(sizePx: number, mode?: "em" | "height"): number;
     /** Is this a TrueType font (vs CFF)? */
     get isTrueType(): boolean;
     /** Is this a CFF font? */

package/dist/font/ttc.d.ts

@@ -0,0 +1,10 @@
+export interface TtcHeader {
+    version: number;
+    numFonts: number;
+    offsets: number[];
+    dsigTag?: number;
+    dsigOffset?: number;
+    dsigLength?: number;
+}
+export declare function isTtc(buffer: ArrayBuffer): boolean;
+export declare function parseTtcHeader(buffer: ArrayBuffer): TtcHeader;

package/dist/hinting/instructions/delta.d.ts

@@ -5,7 +5,7 @@
  * at specific pixel-per-em (ppem) sizes. This is useful for fixing
  * rendering issues that only appear at certain sizes.
  */
-import type { ExecContext } from "../types.ts";
+import { type ExecContext } from "../types.ts";
 /**
  * DELTAP1 - Delta exception point (ppem 0-15 + deltaBase)
  */

package/dist/hinting/programs.d.ts

@@ -66,6 +66,8 @@ export interface GlyphOutline {
     tsb?: number;
     /** Advance height in font units (for vertical phantom point) */
     advanceHeight?: number;
+    /** True if glyph is composite */
+    isComposite?: boolean;
 }
 /**
  * Hinted glyph result

package/dist/hinting/types.d.ts

@@ -46,6 +46,10 @@ export declare enum TouchFlag {
     Y = 32,
     Both = 48
 }
+/**
+ * Render mode used for GETINFO responses.
+ */
+export type HintRenderMode = "mono" | "gray" | "lcd" | "lcd_v";
 /**
  * Glyph zone - holds glyph points
  */
@@ -191,6 +195,10 @@ export interface ExecContext {
     scale: number;
     scaleFix: number;
     lightMode: boolean;
+    grayscale: boolean;
+    renderMode: HintRenderMode;
+    backwardCompatibility: number;
+    isComposite: boolean;
     error: string | null;
     instructionCount: number;
     maxInstructions: number;

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { adaptiveBlur as $adaptiveBlur, BitmapBuilder, bitmap, blur as $blur, bo
 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";
-export { Font, type FontLoadOptions } from "./font/font.ts";
+export { Font, FontCollection, type CollectionFaceName, 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 { AxisTable as BaseAxisTable, BaselineValue, BaseScriptRecord, BaseTable, BaseValues, FeatMinMaxRecord, MinMax, MinMaxRecord, } from "./font/tables/base.ts";