import { IEngineConfig, IFontState, IncrementalEngine, LoadedChunk, SubsetProvider, createHttpProvider } from "./engine.js";
//#region src/css-mode.d.ts
/** 通用选项 */
interface IWebFontOptions {
  /** 字体文件名（如 '令东齐伋复刻体.ttf'），支持模糊匹配 */
  fontName: string;
  /** 服务基地址，默认当前 origin */
  baseUrl?: string;
  /** CSS font-family 名，默认去掉扩展名的字体名 */
  family?: string;
  /** 输出格式，默认 woff2 */
  outType?: 'woff2' | 'ttf';
}
interface ILoadFontOptions extends IWebFontOptions {
  /** DOM 选择器 */
  selector: string;
  /** 轮询间隔 ms，默认 1000 */
  interval?: number;
}
interface IObserveFontOptions extends IWebFontOptions {
  /** DOM 选择器 */
  selector: string;
  /** 防抖 ms，默认 50 */
  debounceMs?: number;
}
interface ILoadTextOptions extends IWebFontOptions {
  /** 初始文本 */
  text: string;
}
/** loadText 返回的手动加载器 */
interface ITextLoader {
  /** 追加文本（自动去重） */
  update(text: string): void;
  dispose(): void;
}
/** observeFont 返回的观察任务 */
interface IObserveTask {
  dispose(): void;
}
declare class WebFontCSSMode {
  private engine;
  /** 每个加载器注入的 <style> 元素（销毁时移除） */
  private injectedStyles;
  private pollTasks;
  private observeTasks;
  constructor(config?: {
    baseUrl?: string;
    maxConcurrent?: number;
    provider?: SubsetProvider | null;
  });
  /** 底层引擎（FontFace 模式共用场景） */
  getEngine(): IncrementalEngine;
  /** 注入自定义子集提供者（离线裁剪等），null 恢复 HTTP */
  setSubsetProvider(provider: SubsetProvider | null): void;
  setMaxConcurrent(n: number): void;
  private makeOnLoadChunk;
  /** 用 document.fonts.load 触发加载与就绪状态推进（无 API 时定时器兑底） */
  private waitFontLoaded;
  private resolveDefaults;
  loadFont(options: ILoadFontOptions): void;
  observeFont(options: IObserveFontOptions): IObserveTask;
  loadText(options: ILoadTextOptions): ITextLoader;
  /** 清理所有任务与注入样式（页面卸载时调用） */
  disposeAll(): void;
  /** 供 IIFE 全局导出对齐旧 API 名 */
  static createHttpProvider: typeof createHttpProvider;
}
//#endregion
//#region src/node-registry.d.ts
/** @napi-rs/canvas 的 GlobalFonts 最小接口（避免硬依赖，保持 optional peerDep） */
interface IGlobalFontsLike {
  register: (data: Uint8Array | ArrayBuffer, family: string) => unknown;
  remove: (key: unknown) => boolean;
}
/** Node 注册器状态 */
interface INodeRegistryEntry {
  /** chunk 索引（0 起） */
  index: number;
  /** 唯一 family 名（`${base}__${n}`） */
  family: string;
  /** register 返回的 FontKey（remove 用；woff2 注册时可能为 null） */
  fontKey: unknown;
  /** chunk 字符集（dispose 时无需用，仅调试） */
  chars: string[];
}
/** 一个逻辑字体（用户视角的 family）的 Node 端注册表 */
declare class NodeFontRegistry {
  /** 基础 family 名（用户设置的原始名，去后缀） */
  readonly base: string;
  /** 已注册 chunk 列表（顺序即 fontFamily 链顺序） */
  private entries;
  /** family 名 -> entry（快速查重） */
  private familyIndex;
  /** 注入的 GlobalFonts（浏览器环境为 null，构造后由 ensure 注入） */
  private globalFonts;
  constructor(base: string);
  /** 绑定 GlobalFonts（懒加载 @napi-rs/canvas 成功后调用） */
  bind(globalFonts: IGlobalFontsLike): void;
  /** 是否已绑定（未绑定时 registerChunk 会抛错） */
  get bound(): boolean;
  /**
   * 注册一个新 chunk：唯一 family 名 + 逗号链回退
   * @returns 新的 fontFamily 链（调用方把它设置到 Text 节点上）
   */
  registerChunk(chunk: LoadedChunk, buffer: Uint8Array): string;
  /**
   * 当前完整的 fontFamily 链（逗号分隔，带引号防中文名/特殊字符问题）：
   * `"base__0", "base__1", ...`
   * 最后追加原始 base 名（此时 base 未注册，仅作为语义占位/调试可读性）
   */
  fontChain(): string;
  /** 已注册 chunk 数（调试用） */
  get size(): number;
  /**
   * 卸载全部 chunk（dispose 用）。
   * FontKey 为 null 的（woff2 首注册返回 null 的场景）跳过 remove。
   */
  dispose(): void;
}
/** 动态加载 @napi-rs/canvas 的 GlobalFonts（未安装/非 Node 环境返回 null） */
declare function loadGlobalFonts(): Promise<IGlobalFontsLike | null>;
/** 当前是否 Node 环境（无 document 且有 node 进程标记，用于模式分支） */
declare function isNodeEnvironment(): boolean;
//#endregion
//#region src/fontface-mode.d.ts
interface IFontFaceOptions {
  /** 字体文件名（如 '令东齐伋复刻体.ttf'），支持模糊匹配 */
  fontName: string;
  /** 服务基地址 */
  baseUrl?: string;
  /** 注册用的 family 名，默认去掉扩展名 */
  family?: string;
  /** 输出格式，默认 woff2（Node 端自动降级 ttf，见 loadFontFace） */
  outType?: 'woff2' | 'ttf';
}
/** 单个 FontFace 字体的增量加载器（leafer 插件等持有） */
interface IFontFaceLoader {
  /** 提交文本（自动去重，只请求新字符） */
  update(text: string): void;
  /** 该字体是否有片段在请求中 */
  isPending(): boolean;
  /** 清除失败记录（重试场景） */
  retryFailed(): void;
  dispose(): void;
  /**
   * 当前生效的 fontFamily 链（仅 Node 模式有意义）。
   * Node 端每个 chunk 注册为唯一 family，Skia 链回退按字形匹配；
   * 新 chunk 就绪后链会变长，调用方需把它写回 Text 节点的 fontFamily。
   * 浏览器模式恒返回 null（FontFace unicodeRange 天然支持增量）。
   */
  fontFamilyChain(): string | null;
}
declare class WebFontFontFaceMode {
  private engine;
  /** 未显式传 baseUrl 时的默认服务地址 */
  private defaultBaseUrl;
  /** family -> 已注册的 FontFace（dispose 时从 document.fonts 删除；浏览器模式用） */
  private faces;
  /** family -> Node 注册表（Node 模式用；浏览器环境恒为空） */
  private nodeRegistries;
  /** Node 模式懒加载的 GlobalFonts（null = 未加载或加载失败） */
  private globalFonts;
  /** 是否 Node 环境（构造时探测一次，后续分支依据） */
  private readonly nodeEnv;
  constructor(config?: {
    baseUrl?: string;
    maxConcurrent?: number;
    provider?: SubsetProvider | null;
  });
  getEngine(): IncrementalEngine;
  setSubsetProvider(provider: SubsetProvider | null): void;
  /**
   * 创建（或复用）一个字体的 FontFace 增量加载器。
   * 自动按环境分支：浏览器走 FontFace(unicodeRange)；Node 走 @napi-rs/canvas
   * GlobalFonts（每 chunk 唯一 family，调用方需读 fontFamilyChain 写回节点）。
   *
   * @param options 字体选项
   * @param onChunk 单个片段注册完成后回调（调用方在此触发画布重绘 / 更新 fontFamily 链）
   */
  loadFontFace(options: IFontFaceOptions, onChunk?: (chunk: LoadedChunk) => void): IFontFaceLoader;
  /** 是否有片段在请求/注册中（导出图片前轮询用） */
  hasPending(): boolean;
  /** 等待所有 pending 片段就绪（导出图片前调用） */
  ready(): Promise<void>;
}
//#endregion
//#region src/index.d.ts
/**
 * CSS 模式默认实例 —— 与旧 webfont-sdk.js 的全局 WebFont 对象 API 兼容
 */
declare const WebFont: WebFontCSSMode;
/** FontFace 模式默认实例（Canvas 场景） */
declare const WebFontCanvas: WebFontFontFaceMode;
//#endregion
export { type IEngineConfig, type IFontFaceLoader, type IFontFaceOptions, type IFontState, type IGlobalFontsLike, type ILoadFontOptions, type ILoadTextOptions, type INodeRegistryEntry, type IObserveFontOptions, type IObserveTask, type ITextLoader, type IWebFontOptions, IncrementalEngine, type LoadedChunk, NodeFontRegistry, type SubsetProvider, WebFont, WebFontCSSMode, WebFontCanvas, WebFontFontFaceMode, createHttpProvider, isNodeEnvironment, loadGlobalFonts };