@cj-tech-master/excelts 9.4.1 → 9.4.2

package/dist/browser/modules/pdf/font/type3-glyphs.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Type3 fallback glyph definitions.
+ *
+ * Each glyph is a function that writes PDF content-stream operators into
+ * a 1000×1000 unit glyph coordinate system (matching a FontMatrix of
+ * [0.001 0 0 0.001 0 0]).
+ *
+ * The drawing callbacks receive a simple `GlyphPen` API so they don't
+ * depend on `PdfContentStream` directly — this keeps the module
+ * self-contained and easy to test.
+ *
+ * Coverage strategy:
+ *  1. Geometric Shapes          (U+25A0–U+25FF)
+ *  2. Miscellaneous Symbols     (U+2600–U+26FF)
+ *  3. Dingbats / checkmarks     (U+2700–U+27BF)
+ *  4. Arrows                    (U+2190–U+21FF)
+ *  5. Mathematical Operators    (U+2200–U+22FF)
+ *  6. Box Drawing               (U+2500–U+257F)
+ *  7. Block Elements            (U+2580–U+259F)
+ *  8. Misc Technical            (U+2300–U+23FF)
+ *  9. Enclosed Alphanumerics    (U+2460–U+24FF)
+ * 10. Misc Symbols & Arrows     (U+2B00–U+2BFF)
+ * 11. Ballot / checkbox symbols (U+2610–U+2612)
+ * 12. Supplemental Arrows       (U+27F0–U+27FF)
+ * 13. Braille Patterns          (U+2800–U+28FF)
+ * 14. Squared symbols etc.      (U+29C0–U+29FF)
+ *
+ * Characters not in this table get a generic .notdef glyph (open rectangle).
+ */
+/**
+ * Minimal drawing API used by glyph definitions.
+ * Lines are emitted as raw PDF content-stream operators.
+ */
+export interface GlyphPen {
+    /** Move to (x, y). */
+    M(x: number, y: number): void;
+    /** Line to (x, y). */
+    L(x: number, y: number): void;
+    /** Cubic Bezier curve. */
+    C(x1: number, y1: number, x2: number, y2: number, x3: number, y3: number): void;
+    /** Close path. */
+    Z(): void;
+    /** Rectangle (x, y, w, h). */
+    rect(x: number, y: number, w: number, h: number): void;
+    /** Circle at (cx, cy) with radius r using 4 Bezier arcs. */
+    circle(cx: number, cy: number, r: number): void;
+    /** Ellipse at (cx, cy) with radii (rx, ry). */
+    ellipse(cx: number, cy: number, rx: number, ry: number): void;
+    /** Stroke current path. */
+    stroke(): void;
+    /** Fill current path (non-zero winding). */
+    fill(): void;
+    /** Fill then stroke. */
+    fillStroke(): void;
+    /** Set line width. */
+    lineWidth(w: number): void;
+}
+/** A glyph definition: advance width + drawing callback. */
+export interface GlyphDef {
+    /** Advance width in glyph units (0–1000). */
+    width: number;
+    /** Draw the glyph outline using the pen. */
+    draw: (p: GlyphPen) => void;
+}
+/** .notdef: open rectangle — drawn for any character we don't have. */
+export declare const NOTDEF_GLYPH: GlyphDef;
+/**
+ * Look up a glyph definition for a Unicode code point.
+ * Returns the glyph def, or `undefined` if no specific drawing is available.
+ */
+export declare function lookupGlyph(codePoint: number): GlyphDef | undefined;
+/**
+ * Check whether a specific code point has a dedicated vector glyph.
+ */
+export declare function hasGlyph(codePoint: number): boolean;
+/**
+ * Return the total number of defined glyphs (for diagnostics / testing).
+ */
+export declare function glyphCount(): number;