pagyra-js 0.0.1

package/.eslintrc.json

@@ -0,0 +1,30 @@
+{
+  "env": {
+    "browser": true,
+    "node": true,
+    "es2021": true,
+    "jest": true
+  },
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module"
+  },
+  "plugins": [
+    "@typescript-eslint"
+  ],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "rules": {
+    "no-undef": "off",
+    "@typescript-eslint/no-unused-vars": [
+      "error",
+      {
+        "argsIgnorePattern": "^_"
+      }
+    ],
+    "@typescript-eslint/no-explicit-any": "warn"
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## Unreleased
+
+### Added
+- Full `overflow-wrap` / `word-wrap` parsing, inheritance, and layout support so long tokens wrap deterministically in PDF output.
+- Support for resolving `em`/`rem` units (font-size, spacing, borders, shadows, grids) using inherited/root font sizes to keep layout deterministic.
+- `text-transform` parsing plus layout/PDF rendering so uppercase/lowercase/capitalize behave deterministically across the pipeline.
+- Support for SVG `stroke-dasharray` and `stroke-dashoffset` attributes for dashed line rendering.
+- Support for CSS custom properties (variables) with inheritance, fallback values, and `var()` function resolution.
+
+### Fixed
+- Apply justified spacing consistently across all inline fragments by marking the last line during inline layout and reusing it in PDF text-run generation.

package/README.md

@@ -0,0 +1,275 @@
+# Pagyra-js
+
+A TypeScript-based HTML to PDF converter library with comprehensive CSS support and advanced layout capabilities.
+
+## Features
+
+### Core Capabilities
+- **HTML to PDF Conversion**: Convert HTML content to PDF with precise layout control
+- **Comprehensive CSS Support**: Full CSS parsing, inheritance, and layout support
+- **Advanced Text Handling**: Complete text layout with overflow wrapping, justification, and text transformation
+- **Font Management**: Built-in font support with custom font embedding via `@font-face`
+- **Cross-Platform**: Works in both Node.js and browser environments
+
+### Recent Additions (from CHANGELOG)
+- **Overflow Wrapping**: Full `overflow-wrap` / `word-wrap` parsing and layout support
+- **Relative Units**: Support for `em`/`rem` units using inherited/root font sizes
+- **Text Transformation**: `text-transform` parsing and rendering (uppercase/lowercase/capitalize)
+- **SVG Stroke Support**: `stroke-dasharray` and `stroke-dashoffset` for dashed line rendering
+- **CSS Variables**: Custom properties with inheritance and `var()` function resolution
+- **Justified Text**: Consistent justified spacing across all inline fragments
+
+## Installation
+
+```bash
+npm install pagyra-js
+```
+
+## Usage
+
+### Minimal Example (HTML only)
+
+```typescript
+import { renderHtmlToPdf } from 'pagyra-js';
+
+// Minimal usage - only HTML is required
+// Other parameters will use sensible defaults (A4 size, standard margins)
+const pdfBytes = await renderHtmlToPdf({
+  html: '<h1>Hello World</h1><p>This is a PDF generated from HTML!</p>'
+});
+```
+
+### Basic Example with Full Control
+
+```typescript
+import { renderHtmlToPdf } from 'pagyra-js';
+
+const pdfBytes = await renderHtmlToPdf({
+  html: '<h1>Hello World</h1><p>This is a PDF generated from HTML!</p>',
+  css: 'body { font-family: Arial; } h1 { color: blue; }',
+  viewportWidth: 800,
+  viewportHeight: 600,
+  pageWidth: 800,
+  pageHeight: 1100,
+  margins: { top: 20, right: 20, bottom: 20, left: 20 }
+});
+
+// Save or use the PDF bytes
+fs.writeFileSync('output.pdf', Buffer.from(pdfBytes));
+```
+
+### Advanced Example with Custom Fonts
+
+```typescript
+import { renderHtmlToPdf } from 'pagyra-js';
+
+const pdfBytes = await renderHtmlToPdf({
+  html: `
+    <div class="container">
+      <h1>Advanced PDF Example</h1>
+      <p class="justified">This text will be justified and use custom fonts.</p>
+      <div class="box">Styled box with border-radius</div>
+    </div>
+  `,
+  css: `
+    @font-face {
+      font-family: 'CustomFont';
+      src: url('/path/to/font.woff2') format('woff2');
+      font-weight: normal;
+    }
+    body {
+      font-family: 'CustomFont', Arial;
+      font-size: 14px;
+    }
+    .justified {
+      text-align: justify;
+      overflow-wrap: break-word;
+    }
+    .box {
+      width: 200px;
+      height: 100px;
+      background-color: #f0f0f0;
+      border-radius: 8px;
+      border: 1px solid #ccc;
+    }
+  `,
+  viewportWidth: 1000,
+  viewportHeight: 800,
+  pageWidth: 1000,
+  pageHeight: 1400,
+  margins: { top: 30, right: 30, bottom: 30, left: 30 },
+  fontConfig: {
+    fontFaceDefs: [
+      {
+        name: 'CustomFont',
+        family: 'CustomFont',
+        src: '/path/to/font.woff2',
+        weight: 400,
+        style: 'normal'
+      }
+    ]
+  }
+});
+```
+
+## API Reference
+
+### Main Functions
+
+#### `renderHtmlToPdf(options: RenderHtmlOptions): Promise<Uint8Array>`
+
+Converts HTML to PDF and returns the PDF as a Uint8Array.
+
+**Parameters:**
+
+**Mandatory Parameters:**
+- `html`: HTML content string (the only truly required parameter)
+
+**Optional Parameters (with sensible defaults available):**
+- `css`: CSS styles string (defaults to empty string)
+- `viewportWidth`: Viewport width in pixels (can be calculated from page size)
+- `viewportHeight`: Viewport height in pixels (can be calculated from page size)
+- `pageWidth`: Page width in pixels (defaults to A4 width: ~595pt/8.27in)
+- `pageHeight`: Page height in pixels (defaults to A4 height: ~841pt/11.69in)
+- `margins`: Page margins in pixels (defaults to standard A4 margins: ~36pt/0.5in all sides)
+- `debug`: Enable debug logging (optional, defaults to false)
+- `debugLevel`: Debug log level (optional)
+- `debugCats`: Debug categories (optional)
+- `fontConfig`: Font configuration (optional, loads built-in fonts by default)
+- `resourceBaseDir`: Base directory for resource resolution (optional)
+- `assetRootDir`: Asset root directory (optional)
+- `headerFooter`: Header/footer configuration (optional)
+- `environment`: Environment abstraction (Node/browser, optional - defaults to Node environment)
+
+**Note:** While the TypeScript interface requires all parameters, in practice only `html` is truly mandatory. The playground server demonstrates how to compute reasonable defaults for other parameters using helper functions like `sanitizeDimension()` and `resolvePageMarginsPx()`.
+
+#### `prepareHtmlRender(options: RenderHtmlOptions): Promise<PreparedRender>`
+
+Prepares HTML for rendering without generating the final PDF. Useful for debugging layout.
+
+**Returns:**
+- `layoutRoot`: Root layout node
+- `renderTree`: Render tree structure
+- `pageSize`: Page dimensions in points
+- `margins`: Applied margins
+
+### CSS Support
+
+Pagyra-js supports a comprehensive set of CSS properties:
+
+- **Layout**: `display`, `position`, `float`, `clear`, `z-index`
+- **Box Model**: `width`, `height`, `margin`, `padding`, `border`, `box-sizing`
+- **Flexbox**: `flex-direction`, `flex-wrap`, `justify-content`, `align-items`, etc.
+- **Grid**: `grid-template`, `grid-gap`, `grid-auto-flow`
+- **Text**: `font-family`, `font-size`, `font-weight`, `line-height`, `text-align`, `text-transform`, `overflow-wrap`
+- **Colors**: `color`, `background-color`, `opacity`
+- **Spacing**: `gap`, `margin-block`, `margin-inline`
+- **Units**: `px`, `em`, `rem`, `pt`, `mm`, `cm`, `in`, `%`
+- **Custom Properties**: CSS variables with `var()`
+
+### Font Configuration
+
+```typescript
+interface FontConfig {
+  fontFaceDefs: Array<{
+    name: string;
+    family: string;
+    src: string;
+    data?: ArrayBuffer; // Font data (required for browser environment)
+    weight: number;
+    style: 'normal' | 'italic';
+  }>;
+}
+```
+
+## Development
+
+### Project Structure
+
+```
+src/
+├── core.ts                  # Core exports and types
+├── html-to-pdf.ts           # Main HTML to PDF conversion logic
+├── index.ts                 # Main entry point
+├── browser-entry.ts         # Browser-specific entry point
+├── css/                     # CSS parsing and styling
+├── dom/                     # DOM node handling
+├── html/                    # HTML parsing and conversion
+├── layout/                  # Layout calculation engine
+├── pdf/                     # PDF generation and rendering
+├── svg/                     # SVG support
+├── units/                   # Unit conversion utilities
+└── ... (other modules)
+```
+
+### Build Process
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+
+# Run linter
+npm run lint
+
+# Run playground (Node environment)
+npm run playground
+
+# Run browser playground
+npm run playground:browser
+```
+
+### Development Scripts
+
+- `npm run build`: Compile TypeScript to JavaScript
+- `npm run clean`: Remove build artifacts
+- `npm run test`: Run test suite
+- `npm run lint`: Run ESLint
+- `npm run playground`: Interactive development environment
+- `npm run playground:browser`: Browser-based playground
+- `npm run build:browser`: Build browser bundle
+
+## Browser Support
+
+Pagyra-js can run in browser environments with some configuration:
+
+```typescript
+import { renderHtmlToPdfBrowser } from 'pagyra-js/browser-entry';
+
+// Use the browser-specific entry point
+const pdfBytes = await renderHtmlToPdfBrowser({
+  html: '<p>Browser PDF generation</p>',
+  css: 'body { font-family: Arial; }',
+  // ... other options
+  environment: new BrowserEnvironment() // Provide browser environment
+});
+```
+
+## Examples
+
+Check the `playground/public/examples/` directory for various usage examples:
+- Basic HTML to PDF conversion
+- CSS layout demonstrations
+- SVG rendering examples
+- Advanced text formatting
+- Custom font usage
+
+## Contributing
+
+Contributions are welcome! Please follow these guidelines:
+
+1. Fork the repository
+2. Create a feature branch
+3. Implement your changes
+4. Add tests for new functionality
+5. Run `npm run lint` and `npm test`
+6. Submit a pull request
+
+## License
+
+MIT License

package/UA_Styles_Chromium.md

@@ -0,0 +1,93 @@
+# UA styles do Chromium/Blink — Tabelas Markdown
+
+## Blocos básicos
+| Seletor | display | margin (block) | margin (inline) | Outros |
+|---|---|---:|---:|---|
+| `html` | block | – | – | – |
+| `body` | block | `8px` (todas as direções) | – | – |
+| `p` | block | `1em` topo/baixo | `0` esq/dir | – |
+| `div` | block | – | – | – |
+| `blockquote` | block | `1em` top/`1em` bottom | `40px` esq/dir | – |
+| `figure` | block | `1em` top/`1em` bottom | `40px` esq/dir | – |
+| `hr` | block | `0.5em` top/bottom | auto | `border: 1px inset; color: gray; overflow: hidden` |
+
+## Cabeçalhos
+| Seletor | display | font-size | margin-block | font-weight | Notas |
+|---|---|---|---|---|---|
+| `h1` | block | `2em` | `0.67em` / `0.67em` | bold | – |
+| `h2` | block | `1.5em` | `0.83em` / `0.83em` | bold | – |
+| `h3` | block | `1.17em` | `1em` / `1em` | bold | – |
+| `h4` | block | `1em` aprox. | `1.33em` / `1.33em` | bold | – |
+| `h5` | block | `.83em` | `1.67em` / `1.67em` | bold | – |
+| `h6` | block | `.67em` | `2.33em` / `2.33em` | bold | – |
+
+## Listas
+| Seletor | display | list-style | margin-block | padding-inline-start |
+|---|---|---|---|---|
+| `ul, menu, dir` | block | disc | `1em` / `1em` | `40px` |
+| `ol` | block | decimal | `1em` / `1em` | `40px` |
+| `li` | list-item | – | – | `text-align: match-parent` |
+| `dl` | block | – | `1em` / `1em` | – |
+| `dt` | block | – | – | – |
+| `dd` | block | – | – | `margin-inline-start: 40px` |
+
+## Tabelas
+| Seletor | display | border | spacing | vertical-align | Outros |
+|---|---|---|---|---|---|
+| `table` | table | `border-collapse: separate` | `2px` | – | `box-sizing: border-box; text-indent: initial; border-color: gray` |
+| `thead` | table-header-group | – | – | middle | – |
+| `tbody` | table-row-group | – | – | middle | – |
+| `tfoot` | table-footer-group | – | – | middle | – |
+| `tr` | table-row | – | – | inherit | – |
+| `td, th` | table-cell | – | – | inherit | `padding: 1px` |
+| `th` | table-cell | – | – | inherit | `font-weight: bold; text-align: center` |
+| `caption` | table-caption | – | – | – | `text-align: center` |
+
+## Links
+| Seletor | Cor | Decoração | Cursor | Foco |
+|---|---|---|---|---|
+| `a:-webkit-any-link` | `-webkit-link` | underline | pointer | `:focus-visible { outline-offset: 1px }` |
+| `a:-webkit-any-link:active` | `-webkit-activelink` | – | – | – |
+| `a:-webkit-any-link:read-write` | – | – | text | – |
+
+## Formulários (núcleo)
+| Seletor | display | margin | font | Outros |
+|---|---|---|---|---|
+| `form` | block | `margin-top: 0` | – | – |
+| `fieldset` | block | `margin-inline: 2px` | – | `border: groove 2px ThreeDFace; padding-block: .35em .625em; padding-inline: .75em; min-inline-size: min-content` |
+| `legend` | block | – | – | `padding-inline: 2px` |
+| `input, textarea, select, button` | inline-block | `0` | `-webkit-small-control` | `text-align: start` |
+
+## Mídia e conteúdo substituído
+| Seletor | display/overflow | Dimensões | Outros |
+|---|---|---|---|
+| `audio:not([controls])` | `display: none !important` | – | – |
+| `audio` | – | `width: 300px; height: 54px` | – |
+| `video, canvas, img` | `overflow: clip` | – | `overflow-clip-margin: content-box` |
+| `video` | – | – | `object-fit: contain` |
+
+## Ruby
+| Seletor | display | font-size | alinhamento |
+|---|---|---|---|
+| `ruby` | ruby | – | – |
+| `ruby > rt` | ruby-text | 50% | `text-align: start` |
+
+## Dialog & Popover
+| Seletor | display/posicionamento | caixa | Cores |
+|---|---|---|---|
+| `dialog` | `position: absolute; inset-inline-start:0; inset-inline-end:0; margin:auto` | `width/height: fit-content; border: solid; padding: 1em` | `background: Canvas; color: CanvasText` |
+| `dialog:not([open])`, `[popover]:not(:popover-open)` | `display: none` | – | – |
+| `dialog[open]`, `[popover]:popover-open` | `display: block` | – | – |
+
+## Quirks Mode (diferenças comuns)
+| Item | Efeito |
+|---|---|
+| `img[align=left|right]` | margens laterais `3px` |
+| `table` | reseta `white-space`, `line-height`, `font-*`, `color`, `text-align` |
+| `input` (exceto `type=image`) e `textarea` | `box-sizing: border-box` |
+| `form` | `margin-block-end: 1em` |
+| `li` | `list-style-position: inside` |
+
+> Observações
+> - O UA pode variar por SO e por *quirks mode*.
+> - Em resets, costuma-se zerar `body { margin: 8px }` e ajustar listas/tabelas conforme o design.

package/_ext/woff2_conversion/brotli-decode.d.ts

@@ -0,0 +1,139 @@
+import type { BrotliAllocFunc, BrotliFreeFunc, BrotliBool } from "./brotli-types";
+import type { BrotliSharedDictionaryType } from "./brotli-shared-dictionary";
+
+export interface BrotliDecoderState {} // opaque
+
+export enum BrotliDecoderResult {
+  BROTLI_DECODER_RESULT_ERROR = 0,
+  BROTLI_DECODER_RESULT_SUCCESS = 1,
+  BROTLI_DECODER_RESULT_NEEDS_MORE_INPUT = 2,
+  BROTLI_DECODER_RESULT_NEEDS_MORE_OUTPUT = 3,
+}
+
+export enum BrotliDecoderErrorCode {
+  BROTLI_DECODER_NO_ERROR = 0,
+  BROTLI_DECODER_SUCCESS = 1,
+  BROTLI_DECODER_NEEDS_MORE_INPUT = 2,
+  BROTLI_DECODER_NEEDS_MORE_OUTPUT = 3,
+
+  BROTLI_DECODER_ERROR_FORMAT_EXUBERANT_NIBBLE = -1,
+  BROTLI_DECODER_ERROR_FORMAT_RESERVED = -2,
+  BROTLI_DECODER_ERROR_FORMAT_EXUBERANT_META_NIBBLE = -3,
+  BROTLI_DECODER_ERROR_FORMAT_SIMPLE_HUFFMAN_ALPHABET = -4,
+  BROTLI_DECODER_ERROR_FORMAT_SIMPLE_HUFFMAN_SAME = -5,
+  BROTLI_DECODER_ERROR_FORMAT_CL_SPACE = -6,
+  BROTLI_DECODER_ERROR_FORMAT_HUFFMAN_SPACE = -7,
+  BROTLI_DECODER_ERROR_FORMAT_CONTEXT_MAP_REPEAT = -8,
+  BROTLI_DECODER_ERROR_FORMAT_BLOCK_LENGTH_1 = -9,
+  BROTLI_DECODER_ERROR_FORMAT_BLOCK_LENGTH_2 = -10,
+  BROTLI_DECODER_ERROR_FORMAT_TRANSFORM = -11,
+  BROTLI_DECODER_ERROR_FORMAT_DICTIONARY = -12,
+  BROTLI_DECODER_ERROR_FORMAT_WINDOW_BITS = -13,
+  BROTLI_DECODER_ERROR_FORMAT_PADDING_1 = -14,
+  BROTLI_DECODER_ERROR_FORMAT_PADDING_2 = -15,
+  BROTLI_DECODER_ERROR_FORMAT_DISTANCE = -16,
+
+  BROTLI_DECODER_ERROR_COMPOUND_DICTIONARY = -18,
+  BROTLI_DECODER_ERROR_DICTIONARY_NOT_SET = -19,
+  BROTLI_DECODER_ERROR_INVALID_ARGUMENTS = -20,
+
+  BROTLI_DECODER_ERROR_ALLOC_CONTEXT_MODES = -21,
+  BROTLI_DECODER_ERROR_ALLOC_TREE_GROUPS = -22,
+  BROTLI_DECODER_ERROR_ALLOC_CONTEXT_MAP = -25,
+  BROTLI_DECODER_ERROR_ALLOC_RING_BUFFER_1 = -26,
+  BROTLI_DECODER_ERROR_ALLOC_RING_BUFFER_2 = -27,
+  BROTLI_DECODER_ERROR_ALLOC_BLOCK_TYPE_TREES = -30,
+
+  BROTLI_DECODER_ERROR_UNREACHABLE = -31,
+}
+
+export const BROTLI_LAST_ERROR_CODE: BrotliDecoderErrorCode;
+
+export enum BrotliDecoderParameter {
+  BROTLI_DECODER_PARAM_DISABLE_RING_BUFFER_REALLOCATION = 0,
+  BROTLI_DECODER_PARAM_LARGE_WINDOW = 1,
+}
+
+export declare function BrotliDecoderSetParameter(
+  state: BrotliDecoderState,
+  param: BrotliDecoderParameter,
+  value: number,
+): BrotliBool;
+
+export declare function BrotliDecoderAttachDictionary(
+  state: BrotliDecoderState,
+  type: BrotliSharedDictionaryType,
+  dataSize: number,
+  data: Uint8Array,
+): BrotliBool;
+
+export declare function BrotliDecoderCreateInstance(
+  allocFunc: BrotliAllocFunc | null,
+  freeFunc: BrotliFreeFunc | null,
+  opaque: unknown,
+): BrotliDecoderState;
+
+export declare function BrotliDecoderDestroyInstance(
+  state: BrotliDecoderState | null,
+): void;
+
+export declare function BrotliDecoderDecompress(
+  encodedSize: number,
+  encodedBuffer: Uint8Array,
+  decodedSizeRef: { value: number },
+  decodedBuffer: Uint8Array,
+): BrotliDecoderResult;
+
+export declare function BrotliDecoderDecompressStream(
+  state: BrotliDecoderState,
+  availableIn: { value: number },
+  nextIn: { value: Uint8Array | null },
+  availableOut: { value: number },
+  nextOut: { value: Uint8Array | null },
+  totalOut: { value: number },
+): BrotliDecoderResult;
+
+export declare function BrotliDecoderHasMoreOutput(
+  state: BrotliDecoderState,
+): BrotliBool;
+
+export declare function BrotliDecoderTakeOutput(
+  state: BrotliDecoderState,
+  sizeOut: { value: number },
+): Uint8Array | null;
+
+export declare function BrotliDecoderIsUsed(
+  state: BrotliDecoderState,
+): BrotliBool;
+
+export declare function BrotliDecoderIsFinished(
+  state: BrotliDecoderState,
+): BrotliBool;
+
+export declare function BrotliDecoderGetErrorCode(
+  state: BrotliDecoderState,
+): BrotliDecoderErrorCode;
+
+export declare function BrotliDecoderErrorString(
+  code: BrotliDecoderErrorCode,
+): string;
+
+export declare function BrotliDecoderVersion(): number;
+
+export type BrotliDecoderMetadataStartFunc = (
+  opaque: unknown,
+  size: number,
+) => void;
+
+export type BrotliDecoderMetadataChunkFunc = (
+  opaque: unknown,
+  data: Uint8Array,
+  size: number,
+) => void;
+
+export declare function BrotliDecoderSetMetadataCallbacks(
+  state: BrotliDecoderState,
+  startFunc: BrotliDecoderMetadataStartFunc | null,
+  chunkFunc: BrotliDecoderMetadataChunkFunc | null,
+  opaque: unknown,
+): void;

package/_ext/woff2_conversion/brotli-encode.d.ts

@@ -0,0 +1,129 @@
+import type { BrotliAllocFunc, BrotliFreeFunc, BrotliBool } from "./brotli-types";
+import type { BrotliSharedDictionaryType } from "./brotli-shared-dictionary";
+
+export const BROTLI_MIN_WINDOW_BITS = 10;
+export const BROTLI_MAX_WINDOW_BITS = 24;
+export const BROTLI_LARGE_MAX_WINDOW_BITS = 30;
+
+export const BROTLI_MIN_INPUT_BLOCK_BITS = 16;
+export const BROTLI_MAX_INPUT_BLOCK_BITS = 24;
+
+export const BROTLI_MIN_QUALITY = 0;
+export const BROTLI_MAX_QUALITY = 11;
+
+export enum BrotliEncoderMode {
+  BROTLI_MODE_GENERIC = 0,
+  BROTLI_MODE_TEXT = 1,
+  BROTLI_MODE_FONT = 2,
+}
+
+export const BROTLI_DEFAULT_QUALITY: number;
+export const BROTLI_DEFAULT_WINDOW: number;
+export const BROTLI_DEFAULT_MODE: BrotliEncoderMode;
+
+export enum BrotliEncoderOperation {
+  BROTLI_OPERATION_PROCESS = 0,
+  BROTLI_OPERATION_FLUSH = 1,
+  BROTLI_OPERATION_FINISH = 2,
+  BROTLI_OPERATION_EMIT_METADATA = 3,
+}
+
+export enum BrotliEncoderParameter {
+  BROTLI_PARAM_MODE = 0,
+  BROTLI_PARAM_QUALITY = 1,
+  BROTLI_PARAM_LGWIN = 2,
+  BROTLI_PARAM_LGBLOCK = 3,
+  BROTLI_PARAM_DISABLE_LITERAL_CONTEXT_MODELING = 4,
+  BROTLI_PARAM_SIZE_HINT = 5,
+  BROTLI_PARAM_LARGE_WINDOW = 6,
+  BROTLI_PARAM_NPOSTFIX = 7,
+  BROTLI_PARAM_NDIRECT = 8,
+  BROTLI_PARAM_STREAM_OFFSET = 9,
+}
+
+export interface BrotliEncoderState {} // opaque
+export interface BrotliEncoderPreparedDictionary {} // opaque
+
+export declare function BrotliEncoderSetParameter(
+  state: BrotliEncoderState,
+  param: BrotliEncoderParameter,
+  value: number,
+): BrotliBool;
+
+export declare function BrotliEncoderCreateInstance(
+  allocFunc: BrotliAllocFunc | null,
+  freeFunc: BrotliFreeFunc | null,
+  opaque: unknown,
+): BrotliEncoderState;
+
+export declare function BrotliEncoderDestroyInstance(
+  state: BrotliEncoderState | null,
+): void;
+
+export declare function BrotliEncoderPrepareDictionary(
+  type: BrotliSharedDictionaryType,
+  dataSize: number,
+  data: Uint8Array,
+  quality: number,
+  allocFunc: BrotliAllocFunc | null,
+  freeFunc: BrotliFreeFunc | null,
+  opaque: unknown,
+): BrotliEncoderPreparedDictionary | null;
+
+export declare function BrotliEncoderDestroyPreparedDictionary(
+  dict: BrotliEncoderPreparedDictionary | null,
+): void;
+
+export declare function BrotliEncoderAttachPreparedDictionary(
+  state: BrotliEncoderState,
+  dict: BrotliEncoderPreparedDictionary,
+): BrotliBool;
+
+export declare function BrotliEncoderMaxCompressedSize(
+  inputSize: number,
+): number;
+
+export declare function BrotliEncoderCompress(
+  quality: number,
+  lgwin: number,
+  mode: BrotliEncoderMode,
+  inputSize: number,
+  inputBuffer: Uint8Array,
+  encodedSizeRef: { value: number },
+  encodedBuffer: Uint8Array,
+): BrotliBool;
+
+export declare function BrotliEncoderCompressStream(
+  state: BrotliEncoderState,
+  op: BrotliEncoderOperation,
+  availableIn: { value: number },
+  nextIn: { value: Uint8Array | null },
+  availableOut: { value: number },
+  nextOut: { value: Uint8Array | null },
+  totalOut: { value: number },
+): BrotliBool;
+
+export declare function BrotliEncoderIsFinished(
+  state: BrotliEncoderState,
+): BrotliBool;
+
+export declare function BrotliEncoderHasMoreOutput(
+  state: BrotliEncoderState,
+): BrotliBool;
+
+export declare function BrotliEncoderTakeOutput(
+  state: BrotliEncoderState,
+  sizeOut: { value: number },
+): Uint8Array | null;
+
+export declare function BrotliEncoderEstimatePeakMemoryUsage(
+  quality: number,
+  lgwin: number,
+  inputSize: number,
+): number;
+
+export declare function BrotliEncoderGetPreparedDictionarySize(
+  dict: BrotliEncoderPreparedDictionary,
+): number;
+
+export declare function BrotliEncoderVersion(): number;

package/_ext/woff2_conversion/brotli-port.d.ts

@@ -0,0 +1,12 @@
+/** Build version number used by Brotli (major*1e6 + minor*1e3 + revision). */
+export function BROTLI_MAKE_VERSION(
+  major: number,
+  minor: number,
+  revision: number,
+): number;
+
+/** Visibility / attribute markers; no effect in TS, kept for parity. */
+export const BROTLI_COMMON_API: string;
+export const BROTLI_DEC_API: string;
+export const BROTLI_ENC_API: string;
+export const BROTLI_ENC_EXTRA_API: string;