pa_font 0.1.2 → 0.2.0

package/paFont.d.ts

@@ -34,6 +34,21 @@ export interface PointOptions extends ShapeOptions {
   includeHoles?: boolean;
 }
 
+export interface ParagraphOptions extends TextOptions {
+  width: number;
+  lineHeight?: number;
+  align?: "left" | "center" | "right" | "justify";
+  whiteSpace?: "normal" | "pre-wrap" | "nowrap";
+  overflowWrap?: "normal" | "break-word" | "anywhere";
+  maxLines?: number;
+  ellipsis?: string | false;
+  fontFamily?: string;
+  fontWeight?: string | number;
+  fontStyle?: "normal" | "italic" | "oblique";
+  font?: string;
+  engine?: "pretext" | "native";
+}
+
 export interface Metrics {
   width: number;
   bbox: Rect;
@@ -63,6 +78,43 @@ export interface ShapeMetrics {
   bbox: Rect;
 }
 
+export interface ParagraphLine {
+  index: number;
+  text: string;
+  start: number;
+  end: number;
+  x: number;
+  y: number;
+  width: number;
+  baseline: number;
+  height: number;
+  bbox: Rect;
+}
+
+export interface ParagraphMetrics {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  lineCount: number;
+  bbox: Rect;
+}
+
+export interface ParagraphShapeOptions extends ShapeOptions {
+  layout?: "current" | "pretext" | "native";
+}
+
+export interface ParagraphPointOptions extends PointOptions {
+  layout?: "current" | "pretext" | "native";
+}
+
+export interface DrawTextOptions {
+  fillStyle?: string | CanvasGradient | CanvasPattern;
+  strokeStyle?: string | CanvasGradient | CanvasPattern;
+  fill?: boolean;
+  stroke?: boolean;
+}
+
 export class PAShape implements Iterable<Region> {
   text: string;
   bbox: Rect;
@@ -81,7 +133,21 @@ export class PAShape implements Iterable<Region> {
   toPoints(options?: PointOptions): PointSample[];
 }
 
-export class PAFont {
+export class paParagraph {
+  text: string;
+  lines: ParagraphLine[];
+  metrics: ParagraphMetrics;
+  options: ParagraphOptions;
+
+  relayout(next?: Partial<ParagraphOptions>): paParagraph;
+  line(index: number): ParagraphLine | undefined;
+  drawText(ctx: CanvasRenderingContext2D, options?: DrawTextOptions): void;
+  toShape(options?: ParagraphShapeOptions): PAShape;
+  toRegions(options?: ParagraphShapeOptions): Region[];
+  toPoints(options?: ParagraphPointOptions): PointSample[];
+}
+
+export class paFont {
   constructor(font: unknown);
 
   font: unknown;
@@ -90,11 +156,12 @@ export class PAFont {
   static load(
     source: string | URL | ArrayBuffer | ArrayBufferView,
     options?: LoadOptions,
-  ): Promise<PAFont>;
+  ): Promise<paFont>;
 
   text(value: string, options?: TextOptions): PAShape;
   glyph(value: string, options?: TextOptions): PAShape;
   metrics(value: string, options?: TextOptions): Metrics;
+  paragraph(value: string, options: ParagraphOptions): paParagraph;
 }
 
-export default PAFont;
+export default paFont;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pa_font",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Generate polygon and point geometry from OpenType fonts.",
   "keywords": [
     "font",
@@ -40,6 +40,7 @@
     "vite": "^8.0.1"
   },
   "dependencies": {
+    "@chenglou/pretext": "^0.0.4",
     "opentype.js": "^1.3.4"
   }
 }