@sliiu/present-themes 0.0.0-stage → 0.1.0

package/dist/types/builtin-ids.d.ts

@@ -0,0 +1,3 @@
+/** 内置主题 id — 须与 `THEMES` keys 保持一致。 */
+export declare const BUILTIN_THEME_IDS: readonly ["business", "academic", "creative", "minimal", "dark", "tech", "nature", "warm", "editorial", "terminal", "pastel", "luxe", "ink"];
+export type BuiltinThemeId = (typeof BUILTIN_THEME_IDS)[number];

package/dist/types/decorations.d.ts

@@ -0,0 +1,18 @@
+import type { Shape, SlideSize } from "@sliiu/present-core";
+import type { ThemeDecoration, ThemePalette } from "./themes.js";
+export interface DecorationContext {
+    palette: ThemePalette;
+    size: SlideSize;
+    locked: boolean;
+    /** id 唯一性前缀（调用方传 stamp / 前缀字串）。 */
+    idPrefix: string;
+    /**
+     * 页面角色（缺省 "feature" = 完整装饰，向后兼容）：
+     *   - feature：封面/章节/结尾/hero/stat/quote 等全出血戏剧页 → 完整装饰；
+     *   - content：要点/表格/卡片等信息密度高的页 → 静默版。大面积氛围元素
+     *     （aurora 的光幕、organic-blobs 的山脊等）会被滤掉，只保留细线、角标、
+     *     散点等结构性小元素 —— 否则同一组氛围块每页重复，呆板且抢内容。
+     */
+    role?: "feature" | "content";
+}
+export declare function buildDecorationShapesShared(dec: ThemeDecoration, ctx: DecorationContext): Shape[];

package/dist/types/fonts/inject.d.ts

@@ -0,0 +1,27 @@
+export declare function isFontInjected(family: string): boolean;
+/**
+ * 注入一份 Google Fonts CSS（或任意公开 CSS）到当前 document。
+ *
+ * @param cssUrl  Google Fonts CSS v2 url（如 'https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap'）
+ *                也可以是任何指向 @font-face 规则的 CSS url。
+ * @param family  CSS font-family 名（用于 dedup 缓存 + DOM 标记）。
+ */
+export declare function injectFontCss(cssUrl: string, family: string): void;
+/**
+ * 一组手工策划的 Google Fonts，AI 生成主题时从这里挑（保证可商用 + 浏览器可加载）。
+ * 与 stock-fonts MCP 的 FONT_PRESETS 共用一套词汇，避免风格漂移。
+ *
+ * 每条都带 cssUrl，theme generator 调用 injectFontCss 立即生效。
+ */
+export interface ThemeFontPreset {
+    family: string;
+    /** CSS font stack：family + 系统 fallback，给 SVG/HTML 用。 */
+    stack: string;
+    category: "sans-serif" | "serif" | "display" | "handwriting" | "monospace";
+    language: "latin" | "cjk" | "both";
+    cssUrl: string;
+    tags: string[];
+}
+export declare const THEME_FONT_POOL: ThemeFontPreset[];
+/** 按 family 找 preset；找不到返回 null，调用方应回退到默认栈。 */
+export declare function findFontPreset(family: string): ThemeFontPreset | null;

package/dist/types/gallery-order.d.ts

@@ -0,0 +1,3 @@
+/** Design / Console 主题画廊展示顺序（与 template-store 内置模板顺序一致）。 */
+export declare const THEME_GALLERY_ORDER: readonly ["dark", "tech", "terminal", "creative", "luxe", "business", "editorial", "warm", "pastel", "academic", "ink", "nature", "minimal"];
+export type ThemeGalleryId = (typeof THEME_GALLERY_ORDER)[number];

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export { BUILTIN_THEME_IDS, type BuiltinThemeId } from "./builtin-ids.js";
+export { THEME_GALLERY_ORDER, type ThemeGalleryId } from "./gallery-order.js";
+export { THEMES, THEME_IDS, THEME_OUTLINE_HINTS, THEME_STYLE_SEEDS, THEME_FONT_FAMILIES, GeneratedThemeSpecSchema, getTheme, injectThemeFonts, realizeGeneratedTheme, type ThemeDef, type ThemePalette, type ThemeFonts, type ThemeFontSizes, type ThemeMetrics, type ThemeDecoration, type ThemeWordArt, type GeneratedThemeSpec, type TemplateLayoutId, } from "./themes.js";
+export { buildDecorationShapesShared, type DecorationContext } from "./decorations.js";
+export { THEME_FONT_POOL, findFontPreset, injectFontCss, type ThemeFontPreset } from "./fonts/inject.js";
+export { buildCoreThemeFromSpec, buildMastersFromThemeDef, findLayoutRefByType, resolveLayoutTypeForSlide, stripSlideThemeDecorations, themeSpecFromThemeDef, } from "./template-masters.js";
+export { ApplyCustomThemeCmd, ApplyThemeCmd, type ApplyCustomThemeOpts, type ApplyThemeOpts, } from "./theme-commands.js";

package/dist/types/qa/color.d.ts

@@ -0,0 +1,27 @@
+export interface Rgb {
+    r: number;
+    g: number;
+    b: number;
+}
+/** 解析 #rgb / #rrggbb（大小写均可）。无法解析返回 null。 */
+export declare function parseHex(input: string | undefined): Rgb | null;
+/** Rgb → #rrggbb（小写）。 */
+export declare function toHex(rgb: Rgb): string;
+/** WCAG 相对亮度 0..1。 */
+export declare function relativeLuminance(rgb: Rgb): number;
+/** WCAG 对比度 1..21。 */
+export declare function contrastRatio(a: Rgb, b: Rgb): number;
+export declare const SAFE_TEXT_DARK = "#0f172a";
+export declare const SAFE_TEXT_LIGHT = "#f8fafc";
+export declare const WCAG_LARGE_TEXT_CONTRAST = 3;
+export declare const WCAG_BODY_TEXT_CONTRAST = 4.5;
+/** 根据底色亮度选一个高对比度的兜底文字色。 */
+export declare function readableTextColor(bg: Rgb): string;
+/** 线性插值两色，t=0 → a，t=1 → b。 */
+export declare function mixRgb(a: Rgb, b: Rgb, t: number): Rgb;
+/**
+ * 把 `color` 朝 `target` 方向逐步靠拢，直到相对 `bg` 的对比度 ≥ `min`。
+ * 用于把「对底色太浅」的次要文字色拉到达标，同时尽量保留原色调（小步逼近）。
+ * 若走到 target 仍不达标（几乎不可能，target 应是高对比色），返回 target。
+ */
+export declare function ensureContrast(color: Rgb, bg: Rgb, target: Rgb, min: number): Rgb;

package/dist/types/template-masters.d.ts

@@ -0,0 +1,18 @@
+import { type Slide, type SlideMaster, type SlideSize, type Theme } from "@sliiu/present-core";
+import type { GeneratedThemeSpec, ThemeDef } from "./themes.js";
+/** ThemeDef → GeneratedThemeSpec（无 LLM，供母版构建与模板合成共用）。 */
+export declare function themeSpecFromThemeDef(theme: ThemeDef, spec?: GeneratedThemeSpec): GeneratedThemeSpec;
+export declare function buildCoreThemeFromSpec(spec: GeneratedThemeSpec, theme: ThemeDef, themeId: string): Theme;
+/** 从 ThemeDef 构建完整母版 + 版式（与 template picker / 新建 deck 同源）。 */
+export declare function buildMastersFromThemeDef(theme: ThemeDef, size: SlideSize, baseId: string, spec?: GeneratedThemeSpec): {
+    masters: SlideMaster[];
+    coreTheme: Theme;
+};
+/** 套用主题后按版式 type 为 slide 重绑 layoutRef。 */
+export declare function resolveLayoutTypeForSlide(slide: Slide, index: number, prevMasters?: SlideMaster[]): string;
+export declare function findLayoutRefByType(masters: SlideMaster[], layoutType: string): {
+    masterId: string;
+    layoutId: string;
+} | undefined;
+/** 清除 slide 层遗留的 dec_*（母版路径下装饰改由 compose 合成）。 */
+export declare function stripSlideThemeDecorations(slide: Slide): void;

package/dist/types/theme-commands.d.ts

@@ -0,0 +1,41 @@
+import { type EditCommand, type Presentation } from "@sliiu/present-core";
+import { type ThemeDef } from "./themes.js";
+/** 示例封面文案（由调用方注入，themes 包不持有 i18n）。 */
+export interface SampleCoverText {
+    title: string;
+    subtitle: string;
+}
+export interface ApplyCustomThemeOpts {
+    preserveImageBackgrounds?: boolean;
+    /**
+     * 首页无内容时铺一组示例主副标题，让用户立刻看到该主题的排印。
+     * 不传则完全不介入（AI 生成等已有内容的路径不需要）。
+     */
+    sampleCover?: SampleCoverText;
+}
+export declare class ApplyCustomThemeCmd implements EditCommand {
+    private theme;
+    private opts;
+    readonly label = "Apply custom theme";
+    private prev?;
+    private prevMasters?;
+    private prevThemeMeta?;
+    private prevTextColors?;
+    constructor(theme: ThemeDef, opts?: ApplyCustomThemeOpts);
+    apply(pres: Presentation): void;
+    revert(pres: Presentation): void;
+}
+export interface ApplyThemeOpts {
+    preserveImageBackgrounds?: boolean;
+}
+export declare class ApplyThemeCmd implements EditCommand {
+    private themeId;
+    private opts;
+    readonly label = "Apply theme";
+    private prev?;
+    private prevThemeMeta?;
+    private prevTextColors?;
+    constructor(themeId: string, opts?: ApplyThemeOpts);
+    apply(pres: Presentation): void;
+    revert(pres: Presentation): void;
+}

package/dist/types/themes.d.ts

@@ -0,0 +1,276 @@
+import { type BuiltinThemeId } from "./builtin-ids.js";
+export interface ThemePalette {
+    bg: string;
+    bgAlt: string;
+    text: string;
+    textMuted: string;
+    accent1: string;
+    accent2: string;
+    accent3: string;
+    accent4: string;
+    divider: string;
+}
+export interface ThemeFonts {
+    title: string;
+    body: string;
+    mono: string;
+}
+export interface ThemeFontSizes {
+    coverTitle: number;
+    coverSubtitle: number;
+    sectionTitle: number;
+    pageTitle: number;
+    body: number;
+    small: number;
+    quote: number;
+}
+export interface ThemeMetrics {
+    marginX: number;
+    marginY: number;
+    titleBodyGap: number;
+    bulletLineHeight: number;
+}
+/**
+ * 装饰层定义（AI 生成主题 / 自定义主题用）：在 slide 背景上方、内容下方插入的
+ * 装饰图形。renderLayout 在 compile 时把它们追加成 shape，置于普通内容之前。
+ *
+ * 内置 8 套具体风格（每套产出多个 shape，形成独立视觉语言）：
+ * - `aurora`：极光光幕（深色系 / 发布会）—— 两道左右出血的横向光幕 + 底部细线
+ * - `tech-bracket`：科技L形 bracket（科技 / 工程）—— 左侧竖条 + 右下 L 角标
+ * - `neon-burst`：霓虹灯管（创意 / 夜场）—— 顶栏 + 贴边亮管柔光 + 散点
+ * - `authority`：权威双条（商务 / 严肃）—— 左侧纵条 + 底栏双色段
+ * - `manuscript`：手稿双线（学术 / 出版）—— 顶底横线 + 居中装饰点
+ * - `ink-thread`：墨线单划（极简 / 日式）—— 单条精准横线
+ * - `organic-blobs`：层叠远山（自然 / 生态）—— 两道出血扁平山脊 + 地平线
+ * - `sunrise-arc`：朝阳弧（暖色 / 活力）—— 底部半圆弧光 + 底栏
+ * - `masthead`：杂志报头（编辑 / 出版）—— 顶部粗实色报头条 + 细分隔线 + 左侧页边线 + 底部页码块
+ * - `terminal`：终端扫描线（极客 / 开发）—— 角落 L 形括号 + 左上光标块 + 横向扫描线 + 命令提示符
+ * - `confetti`：彩纸礼花（活泼 / 教育）—— 多彩散点圆 + 底部柔和色带
+ * - `gilded`：鎏金细框（高奢 / 品牌）—— 四边内嵌金色细线框 + 四角节点
+ * - `ink-wash`：水墨留白（国风 / 文艺）—— 下半部远山淡墨 + 朱红印章方块 + 竖向墨线
+ * - `corner-gradient-shape`：legacy 别名，渲染等同 `aurora`（AI 生成主题兼容）
+ * - `geometric-lines`：通用几何线（AI 生成主题兼容）
+ * - `bottom-accent-bar`：通用底栏（AI 生成主题兼容）
+ * - `dotted-grid`：通用点阵（AI 生成主题兼容）
+ * - `none`：无装饰
+ */
+export type ThemeDecoration = "none" | "aurora" | "tech-bracket" | "neon-burst" | "authority" | "manuscript" | "ink-thread" | "organic-blobs" | "sunrise-arc" | "masthead" | "terminal" | "confetti" | "gilded" | "ink-wash" | "corner-gradient-shape" | "geometric-lines" | "bottom-accent-bar" | "dotted-grid";
+/**
+ * 标题"艺术字"处理（WordArt）。
+ *
+ * ⚠ 渲染能力边界（见 packages/renderer/src/svg-backend.ts / canvas-backend.ts）：
+ *   - 已支持：纯色填充（run.color）、文字描边（run.textOutline）、字距（letterSpacing）、
+ *     字重/大小、全大写（caps）、形状级阴影（shape.shadow）、形状 transform 旋转/斜切。
+ *   - **不支持**：渐变文字填充（run.fill gradient 未被任何 backend 消费）、prstTxWarp 路径排字。
+ * 因此这里的"艺术字"是用 **色彩 + 描边 + 字距 + 阴影 + 轻微变形（旋转）** 组合出的标题
+ * 视觉强化，而不是真正的渐变 / 弯曲文字。模板层 (template.ts) 把这些字段烘焙进
+ * 标题占位符的 run / shape，用户输入标题即继承该风格。
+ */
+export interface ThemeWordArt {
+    /** 标题色（默认 palette.text）。 */
+    color?: string;
+    /** 文字描边色。 */
+    outlineColor?: string;
+    /** 描边宽度（px）。 */
+    outlineWidth?: number;
+    /** 字距（px，正=展开）。 */
+    letterSpacing?: number;
+    /** 字重（默认 800）。 */
+    weight?: number;
+    /** 是否全大写（仅影响拉丁字母；CJK 无视）。一般只用于 eyebrow/kicker。 */
+    caps?: boolean;
+    /** 标题阴影（形状级 drop shadow）。 */
+    shadow?: {
+        color: string;
+        alpha: number;
+        blur: number;
+        dx: number;
+        dy: number;
+    };
+    /** 封面标题/点缀的轻微变形角度（度，正=顺时针）。 */
+    rotation?: number;
+}
+/**
+ * 模板版式家族：决定 template.ts 生成 layout 时的几何骨架（标题对齐 / 封面锚点 /
+ * 分隔线 / 双栏比例 / 内容缩进 / 终端提示符等），让不同模板**结构**也不同，
+ * 而不只是换色换字。缺省 `classic` = 历史的左对齐版式。
+ *
+ * - `classic`：左对齐 kicker + 左标题 + 细分隔线（商务/学术/极简/科技…）
+ * - `centered`：居中 kicker + 居中标题，对称留白（创意/粉彩）
+ * - `editorial`：封面标题下沉 + 粗顶线 + 不对称宽左栏（杂志/高奢/国风）
+ * - `terminal`：标题前缀命令提示符 + 左侧 gutter，等宽气质（终端）
+ */
+export type TemplateLayoutId = "classic" | "centered" | "editorial" | "terminal";
+/**
+ * 封面主视觉母题：决定 title 版式上"标题周围那组装饰"的形状语言，以及标题块的
+ * 纵向偏移 / 左缩进 / 页脚处理。
+ *
+ * 为什么要和 TemplateLayoutId 分开：版式家族只有 4 个，13 套内置主题里 7 套都落在
+ * `classic`，封面因此长得一模一样（同一条斜杠 + 同一根短条 + 同样的标题位置），
+ * 只有配色不同。母题是**正交**维度，缺省从 `decoration` 推导 —— 主题的装饰语言本来
+ * 就各不相同，让封面呼应它，新主题（含 AI 生成）不用额外配置就自带差异。
+ * 见 template-masters.ts 的 `coverMotifFor` / `coverMotifShapes`。
+ */
+export type CoverMotifId = "slash" | "stack" | "rule-box" | "spine" | "bracket" | "halo" | "blob" | "arc" | "frame" | "burst" | "dots" | "wash" | "masthead" | "terminal-bar";
+export interface ThemeDef {
+    id: string;
+    name: string;
+    description: string;
+    palette: ThemePalette;
+    fonts: ThemeFonts;
+    fontSizes: ThemeFontSizes;
+    metrics: ThemeMetrics;
+    /** 版式骨架家族；缺省 classic（见 TemplateLayoutId）。 */
+    layout?: TemplateLayoutId;
+    /**
+     * 封面主视觉母题；缺省由 `decoration` 推导（见 CoverMotifId）。
+     * 只在"想让封面刻意偏离装饰语言"时才显式写，否则留空即可。
+     */
+    coverMotif?: CoverMotifId;
+    /**
+     * 封面是否显示 terminal 版式的命令提示符（默认 `~ $`）。
+     * 仅影响 title 版式；内容页仍走 layout 的 `prompt` 前缀。设为 `false` 可关掉。
+     */
+    coverPrompt?: boolean;
+    /**
+     * 可选：内容页正文区铺一层"内容卡片"底板（不依赖 terminal 版式）。
+     * 深色主题（tech/dark）开启后正文区多一层 bgAlt 卡片 → 在深底上更有层次/聚焦。
+     * 与 terminal 版式的代码块底板共用渲染，但只有 terminal 才画"红黄绿"窗口圆点。
+     */
+    contentPanel?: boolean;
+    /** 标题艺术字处理（可选）。 */
+    titleWordArt?: ThemeWordArt;
+    /**
+     * 可选：覆盖 slide.background。内置 5 套主题不设此字段，走 solid bg；
+     * AI 生成主题（generateTheme）通常会写 linear/radial gradient，让发布会风
+     * / 暗色主题立刻有"层次感"。
+     */
+    backgroundPaint?: import("@sliiu/present-core").Paint;
+    /** 装饰层：compile.ts 在 render 后追加到 layer.shapes 顶部（z 最低）。 */
+    decoration?: ThemeDecoration;
+    /**
+     * 字体 Google Fonts CSS link（注入 <head>，让 SVG 渲染时能解析到真正的字形）。
+     * 内置主题用系统 fallback 栈，无需 link。AI 生成主题会指定 1-3 条 link。
+     */
+    fontCssLinks?: Array<{
+        family: string;
+        cssUrl: string;
+    }>;
+}
+export declare const THEMES: Record<string, ThemeDef>;
+/**
+ * 把一份主题用到的 Google Fonts 注入当前 document（idempotent）。
+ * 内置模板在 playground 启动时调用，保证"用内置模板新建"时标题/正文字体真的加载，
+ * 而不是落到系统默认字形（这是之前"字体不随主题"的根因之一）。
+ * 非浏览器环境（SSR / 子进程）自动跳过。
+ */
+export declare function injectThemeFonts(theme: ThemeDef): void;
+export declare const THEME_IDS: string[];
+/**
+ * 每套主题的「适用场景」一句话（英文，喂给 outline 的 themeId 选择器）。
+ * 这是 outline prompt 里主题映射的**单一事实源** —— 新增主题时在这里补一行即可，
+ * prompt 会自动带上。
+ *
+ * 类型 `Record<BuiltinThemeId, string>` 强制覆盖 schema 里全部 builtin id：漏一个就编译报错。
+ * 加新主题的完整流程：THEMES 加条目 → BUILTIN_THEME_IDS 加 id → 这里加一行 hint。
+ */
+export declare const THEME_OUTLINE_HINTS: Record<BuiltinThemeId, string>;
+/**
+ * 每套内置主题的「AI 生成种子」—— 一句 **英文 styleHint**，喂给 `generateTheme` 让 AI 现场设计
+ * 一套贴合该风格系统、比静态 preset 更精致的主题。
+ *
+ * 设计要点（对应 `.cursor/skills/ppt-style-systems/SKILL.md` +
+ * `packages/ai/src/skills/builtin/ppt-style-systems.md`）：
+ *   - 每条种子把该风格系统的 **精确色锚 + 字体配对 + 版式纪律 + 装饰气质** 写死，
+ *     防止模型「自由发挥」乱配色（skill 明确要求 "pick one family, do not invent random hex"）。
+ *   - 色锚 / 字体沿用对应 preset 的 palette / fonts，让 AI 主题落在**用户认得出的 vibe** 附近，
+ *     但由模型重新做渐变 / 层次 / 对比，产出更耐看的成品。
+ *   - 这是外观步骤「按风格系统 AI 生成」的**单一事实源**：改风格语言只改这里。
+ *
+ * 类型 `Record<BuiltinThemeId, string>` 强制覆盖全部 builtin id（漏一个编译报错），与
+ * `THEME_OUTLINE_HINTS` 同源守护。
+ */
+export declare const THEME_STYLE_SEEDS: Record<BuiltinThemeId, string>;
+export declare function getTheme(id: string | undefined): ThemeDef;
+import { z } from "zod";
+/** AI 输出的"主题 spec"。compile 之前用 `realizeGeneratedTheme` 把它具象化为 ThemeDef。 */
+export declare const GeneratedThemeSpecSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    mode: z.ZodEnum<{
+        dark: "dark";
+        light: "light";
+    }>;
+    palette: z.ZodObject<{
+        bg: z.ZodString;
+        bgAlt: z.ZodString;
+        text: z.ZodString;
+        textMuted: z.ZodString;
+        accent1: z.ZodString;
+        accent2: z.ZodString;
+        accent3: z.ZodString;
+        accent4: z.ZodString;
+        divider: z.ZodString;
+    }, z.core.$strip>;
+    background: z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"solid">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"linear">;
+        angle: z.ZodNumber;
+        stops: z.ZodArray<z.ZodObject<{
+            offset: z.ZodNumber;
+            color: z.ZodString;
+            alpha: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"radial">;
+        stops: z.ZodArray<z.ZodObject<{
+            offset: z.ZodNumber;
+            color: z.ZodString;
+            alpha: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>;
+    fonts: z.ZodObject<{
+        title: z.ZodString;
+        body: z.ZodString;
+        mono: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    decoration: z.ZodEnum<{
+        aurora: "aurora";
+        authority: "authority";
+        confetti: "confetti";
+        gilded: "gilded";
+        "ink-thread": "ink-thread";
+        "ink-wash": "ink-wash";
+        manuscript: "manuscript";
+        masthead: "masthead";
+        "neon-burst": "neon-burst";
+        none: "none";
+        "organic-blobs": "organic-blobs";
+        "sunrise-arc": "sunrise-arc";
+        "tech-bracket": "tech-bracket";
+        terminal: "terminal";
+    }>;
+    layout: z.ZodOptional<z.ZodEnum<{
+        centered: "centered";
+        classic: "classic";
+        editorial: "editorial";
+        terminal: "terminal";
+    }>>;
+}, z.core.$strip>;
+export type GeneratedThemeSpec = z.infer<typeof GeneratedThemeSpecSchema>;
+/**
+ * 把 AI 输出的 spec 具象化为 ThemeDef：
+ *   - 字体：family → 查 THEME_FONT_POOL 拿 stack & cssUrl；找不到回退到默认栈。
+ *   - 背景：solid 时 backgroundPaint 留 undefined（compile 走 palette.bg）；
+ *           gradient 时构造 LinearGradientPaint / RadialGradientPaint。
+ *   - palette：源头对比度兜底（sanitizePaletteContrast），保证 text/textMuted 相对底色达 WCAG。
+ *   - 装饰：原样保留，compile 时翻译为 Shape。
+ *   - 浏览器内自动注入 Google Fonts CSS（subprocess / server-side 无 document 时跳过）。
+ */
+export declare function realizeGeneratedTheme(spec: GeneratedThemeSpec, opts?: {
+    autoInject?: boolean;
+    debug?: boolean;
+}): ThemeDef;
+/** 给 prompt / UI 用的字体 family 白名单（与 THEME_FONT_POOL 同步）。 */
+export declare const THEME_FONT_FAMILIES: string[];

package/package.json

@@ -1,6 +1,29 @@
 {
   "name": "@sliiu/present-themes",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "license": "AGPL-3.0-or-later",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "zod": "^4.6.5",
+    "@sliiu/present-core": "0.1.0"
+  },
+  "module": "./dist/esm/index.js",
+  "files": [
+    "dist",
+    "LICENSE",
+    "COPYRIGHT",
+    "THIRD-PARTY-NOTICES.md"
+  ]
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.