rough-emoji-draw 0.2.0 → 0.2.2

package/README.en.md

@@ -96,7 +96,12 @@ Load the IIFE bundle only; it automatically attaches `window.RoughEmoji`:
 </script>
 ```
 
-If the page includes the demo form DOM (`#rough-canvas`, `#emoji-form`, etc.), interaction and download handlers are wired up automatically.
+If the page includes the demo form DOM (`#rough-canvas`, `#emoji-form`, etc.), load the root-level `rough-emoji-app.js` to wire up interaction and download handlers:
+
+```html
+<script src="./dist/rough-emoji.js"></script>
+<script src="./rough-emoji-app.js"></script>
+```
 
 ## API
 
@@ -118,7 +123,7 @@ Converts arbitrary input into a drawable flag emoji. Only valid flag emojis are
 import type { RoughEmojiApi } from "rough-emoji-draw";
 ```
 
-You can also import `RoughOptions`, `Point`, `RoughCanvasLike`, and the demo page helper `RoughEmojiApp` as needed.
+You can also import `RoughOptions`, `Point`, and `RoughCanvasLike` as needed.
 
 ## Project Structure
 
@@ -128,11 +133,11 @@ You can also import `RoughOptions`, `Point`, `RoughCanvasLike`, and the demo pag
 │   ├── index.ts           # npm library entry; exports API and types
 │   ├── browser.ts         # browser IIFE entry; mounts window.RoughEmoji
 │   ├── rough-emoji.ts     # core drawing logic
-│   ├── rough-emoji-app.ts # single-page demo DOM bindings
 │   ├── flag-utils.ts      # flag emoji parsing and validation
 │   ├── render-context.ts  # canvas context switching
 │   ├── constant.ts        # static constants and template map
 │   └── types.ts           # public type declarations
+├── rough-emoji-app.js     # index.html demo DOM bindings (not in npm artifacts)
 ├── index.html             # batch visual QA page
 ├── rslib.config.ts        # Rslib multi-format build config
 ├── tsconfig.json          # TypeScript config

package/README.md

@@ -96,7 +96,12 @@ console.log(typeof RoughEmoji.draw); // "function"
 </script>
 ```
 
-若页面包含演示表单 DOM（`#rough-canvas`、`#emoji-form` 等），还会自动绑定交互与下载逻辑。
+若页面包含演示表单 DOM（`#rough-canvas`、`#emoji-form` 等），可额外加载根目录下的 `rough-emoji-app.js` 绑定交互与下载逻辑：
+
+```html
+<script src="./dist/rough-emoji.js"></script>
+<script src="./rough-emoji-app.js"></script>
+```
 
 ## API
 
@@ -118,7 +123,7 @@ console.log(typeof RoughEmoji.draw); // "function"
 import type { RoughEmojiApi } from "rough-emoji-draw";
 ```
 
-还可按需导入 `RoughOptions`、`Point`、`RoughCanvasLike`，以及演示页入口 `RoughEmojiApp`。
+还可按需导入 `RoughOptions`、`Point`、`RoughCanvasLike`。
 
 ## 项目结构
 
@@ -128,11 +133,11 @@ import type { RoughEmojiApi } from "rough-emoji-draw";
 │   ├── index.ts          # npm 库入口，导出 API 与类型
 │   ├── browser.ts        # 浏览器 IIFE 入口，挂载 window.RoughEmoji
 │   ├── rough-emoji.ts    # 核心绘制逻辑
-│   ├── rough-emoji-app.ts # 单页演示 DOM 绑定
 │   ├── flag-utils.ts     # 国旗 emoji 解析与校验
 │   ├── render-context.ts # Canvas 上下文切换
 │   ├── constant.ts       # 静态常量与模板映射
 │   └── types.ts          # 对外类型声明
+├── rough-emoji-app.js    # index.html 演示页 DOM 绑定（不进入 npm 产物）
 ├── index.html            # 批量视觉 QA 页面
 ├── rslib.config.ts       # Rslib 多格式构建配置
 ├── tsconfig.json         # TypeScript 配置

package/dist/constant.d.ts

@@ -1,16 +1,5 @@
-/** 单页演示入口使用的 DOM 选择器，QA 页面不存在这些节点时只暴露全局 API。 */
-export declare const ELEMENT_SELECTORS: {
-    readonly canvas: "#rough-canvas";
-    readonly form: "#emoji-form";
-    readonly input: "#emoji-input";
-    readonly downloadButton: "#download-button";
-};
-/** 默认绘制国旗，供首次打开页面、prompt 默认值和非法输入回退共用。 */
+/** 默认绘制国旗，供非法输入回退共用。 */
 export declare const DEFAULT_FLAG = "\uD83C\uDDE8\uD83C\uDDF3";
-/** 下载文件名前缀，最终文件名会追加当前绘制的国旗 emoji。 */
-export declare const DOWNLOAD_FILE_PREFIX = "rough-flag";
-/** 首次进入单页演示时提示用户输入国旗的文案。 */
-export declare const FLAG_PROMPT_MESSAGE = "\u8BF7\u8F93\u5165\u8981\u7ED8\u5236\u7684\u56FD\u65D7";
 /** 已有专门手写模板的国旗 emoji，避免绘制分支散落字面量。 */
 export declare const TEMPLATE_FLAGS: {
     readonly ad: "🇦🇩";

package/dist/flag-drawers.d.ts

@@ -0,0 +1,9 @@
+import { TEMPLATE_FLAGS } from "./constant";
+/** 专门模板绘制函数签名。 */
+export type FlagDrawer = () => void;
+/** 专门模板覆盖的国旗 emoji 联合类型。 */
+export type TemplateFlag = (typeof TEMPLATE_FLAGS)[keyof typeof TEMPLATE_FLAGS];
+/** 未覆盖输入的兜底绘制流程，保留较克制的细节数量以控制性能。 */
+export declare function drawGenericFlag(flagEmoji: string): void;
+/** 专门模板分发表：每个标准国旗都有独立绘制入口，避免大量 if 分支。 */
+export declare const templateDrawers: Record<TemplateFlag, FlagDrawer>;