@thanh01.pmt/presentation-kit 0.2.17 → 0.3.0

package/dist/skills/index.cjs

@@ -1,52 +1,56 @@
 'use strict';
 
-var chunk6R6L6KSC_cjs = require('../chunk-6R6L6KSC.cjs');
+var chunkHSVXH7DD_cjs = require('../chunk-HSVXH7DD.cjs');
 
 
 
 Object.defineProperty(exports, "FRONTEND_SLIDES_CORE_RULES", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.FRONTEND_SLIDES_CORE_RULES; }
+  get: function () { return chunkHSVXH7DD_cjs.FRONTEND_SLIDES_CORE_RULES; }
 });
 Object.defineProperty(exports, "STYLE_PRESETS", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.STYLE_PRESETS; }
+  get: function () { return chunkHSVXH7DD_cjs.STYLE_PRESETS; }
 });
 Object.defineProperty(exports, "TEMPLATES_CATALOG", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.TEMPLATES_CATALOG; }
+  get: function () { return chunkHSVXH7DD_cjs.TEMPLATES_CATALOG; }
 });
 Object.defineProperty(exports, "VIEWPORT_BASE_CSS", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.VIEWPORT_BASE_CSS; }
+  get: function () { return chunkHSVXH7DD_cjs.VIEWPORT_BASE_CSS; }
 });
 Object.defineProperty(exports, "frontendSlidesTools", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.frontendSlidesTools; }
+  get: function () { return chunkHSVXH7DD_cjs.frontendSlidesTools; }
 });
 Object.defineProperty(exports, "getFrontendSlidesSkillPrompt", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.getFrontendSlidesSkillPrompt; }
+  get: function () { return chunkHSVXH7DD_cjs.getFrontendSlidesSkillPrompt; }
 });
 Object.defineProperty(exports, "getSlideStylePresetSchema", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.getSlideStylePresetSchema; }
+  get: function () { return chunkHSVXH7DD_cjs.getSlideStylePresetSchema; }
 });
 Object.defineProperty(exports, "getStylePreset", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.getStylePreset; }
+  get: function () { return chunkHSVXH7DD_cjs.getStylePreset; }
+});
+Object.defineProperty(exports, "getStylePresetById", {
+  enumerable: true,
+  get: function () { return chunkHSVXH7DD_cjs.getStylePresetById; }
 });
 Object.defineProperty(exports, "getTemplatesCatalog", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.getTemplatesCatalog; }
+  get: function () { return chunkHSVXH7DD_cjs.getTemplatesCatalog; }
 });
 Object.defineProperty(exports, "querySlideTemplatesSchema", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.querySlideTemplatesSchema; }
+  get: function () { return chunkHSVXH7DD_cjs.querySlideTemplatesSchema; }
 });
 Object.defineProperty(exports, "searchTemplates", {
   enumerable: true,
-  get: function () { return chunk6R6L6KSC_cjs.searchTemplates; }
+  get: function () { return chunkHSVXH7DD_cjs.searchTemplates; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/skills/index.d.cts

@@ -8,7 +8,7 @@ interface TemplateCatalogItem {
     occasion: string[];
     tone: string[];
     formality: 'low' | 'medium-low' | 'medium' | 'medium-high' | 'high';
-    density: 'low' | 'medium' | 'high';
+    density: 'low' | 'medium' | 'medium-high' | 'high';
     scheme: 'light' | 'dark' | 'mixed';
     best_for: string;
     avoid_for: string;
@@ -54,16 +54,30 @@ interface FrontendSlidesSkillOptions {
 declare function getTemplatesCatalog(): TemplateCatalogItem[];
 /**
  * Searches templates by mood, scheme, or keywords.
+ *
+ * Scoring semantics (graceful, not hard-AND):
+ * - `scheme` and `mood` add weight when they match.
+ * - `query` matches against slug/name/tagline/best_for/occasion/tone/avoid_for.
+ * - Results are ranked by score and a minimum threshold applies; when NO
+ *   template clears the threshold the full catalog is returned so LLM agents
+ *   never dead-end on an over-constrained query.
  */
 declare function searchTemplates(filter?: string | {
     mood?: string;
-    scheme?: 'light' | 'dark';
+    scheme?: 'light' | 'dark' | 'mixed';
     query?: string;
 }): TemplateCatalogItem[];
 /**
- * Retrieves a style preset by its ID.
+ * Retrieves a style preset by its ID. Falls back to the first preset
+ * (electric-studio) when the ID is unknown — use `getStylePresetById`
+ * when a strict match is required (e.g. validating user-provided IDs).
  */
-declare function getStylePreset(id: string): StylePresetItem | undefined;
+declare function getStylePreset(id: string): StylePresetItem;
+/**
+ * Strict variant: returns the exact preset or `undefined` when unknown.
+ * Never falls back silently — callers can surface a proper error.
+ */
+declare function getStylePresetById(id: string): StylePresetItem | undefined;
 /**
  * Assembles a comprehensive, production-grade Vercel AI SDK system prompt
  * integrating the entire Frontend-Slides Skill, fixed 16:9 stage rules,
@@ -73,40 +87,41 @@ declare function getFrontendSlidesSkillPrompt(options?: FrontendSlidesSkillOptio
 
 declare const querySlideTemplatesSchema: z.ZodObject<{
     mood: z.ZodOptional<z.ZodString>;
-    scheme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+    scheme: z.ZodOptional<z.ZodEnum<["light", "dark", "mixed"]>>;
     query: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    scheme?: "dark" | "light" | undefined;
+    scheme?: "dark" | "light" | "mixed" | undefined;
     mood?: string | undefined;
     query?: string | undefined;
 }, {
-    scheme?: "dark" | "light" | undefined;
+    scheme?: "dark" | "light" | "mixed" | undefined;
     mood?: string | undefined;
     query?: string | undefined;
 }>;
 declare const getSlideStylePresetSchema: z.ZodObject<{
-    presetId: z.ZodEnum<["electric-studio", "blue-professional", "creative-voltage"]>;
+    presetId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    presetId: "blue-professional" | "electric-studio" | "creative-voltage";
+    presetId: string;
 }, {
-    presetId: "blue-professional" | "electric-studio" | "creative-voltage";
+    presetId: string;
 }>;
 /**
- * Tool definitions that can be directly passed to Vercel AI SDK's `tools` parameter.
+ * Tool definitions that can be directly passed to Vercel AI SDK v5+/v7's
+ * `tools` parameter (uses `inputSchema`, not the legacy v4 `parameters`).
  */
 declare const frontendSlidesTools: {
     querySlideTemplates: {
         description: string;
-        parameters: z.ZodObject<{
+        inputSchema: z.ZodObject<{
             mood: z.ZodOptional<z.ZodString>;
-            scheme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+            scheme: z.ZodOptional<z.ZodEnum<["light", "dark", "mixed"]>>;
             query: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            scheme?: "dark" | "light" | undefined;
+            scheme?: "dark" | "light" | "mixed" | undefined;
             mood?: string | undefined;
             query?: string | undefined;
         }, {
-            scheme?: "dark" | "light" | undefined;
+            scheme?: "dark" | "light" | "mixed" | undefined;
             mood?: string | undefined;
             query?: string | undefined;
         }>;
@@ -126,17 +141,18 @@ declare const frontendSlidesTools: {
     };
     getSlideStylePreset: {
         description: string;
-        parameters: z.ZodObject<{
-            presetId: z.ZodEnum<["electric-studio", "blue-professional", "creative-voltage"]>;
+        inputSchema: z.ZodObject<{
+            presetId: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            presetId: "blue-professional" | "electric-studio" | "creative-voltage";
+            presetId: string;
         }, {
-            presetId: "blue-professional" | "electric-studio" | "creative-voltage";
+            presetId: string;
         }>;
         execute: (args: z.infer<typeof getSlideStylePresetSchema>) => Promise<StylePresetItem | {
             error: string;
+            availablePresets: string[];
         }>;
     };
 };
 
-export { FRONTEND_SLIDES_CORE_RULES, type FrontendSlidesSkillOptions, STYLE_PRESETS, type StylePresetItem, TEMPLATES_CATALOG, type TemplateCatalogItem, VIEWPORT_BASE_CSS, frontendSlidesTools, getFrontendSlidesSkillPrompt, getSlideStylePresetSchema, getStylePreset, getTemplatesCatalog, querySlideTemplatesSchema, searchTemplates };
+export { FRONTEND_SLIDES_CORE_RULES, type FrontendSlidesSkillOptions, STYLE_PRESETS, type StylePresetItem, TEMPLATES_CATALOG, type TemplateCatalogItem, VIEWPORT_BASE_CSS, frontendSlidesTools, getFrontendSlidesSkillPrompt, getSlideStylePresetSchema, getStylePreset, getStylePresetById, getTemplatesCatalog, querySlideTemplatesSchema, searchTemplates };

package/dist/skills/index.d.ts

@@ -8,7 +8,7 @@ interface TemplateCatalogItem {
     occasion: string[];
     tone: string[];
     formality: 'low' | 'medium-low' | 'medium' | 'medium-high' | 'high';
-    density: 'low' | 'medium' | 'high';
+    density: 'low' | 'medium' | 'medium-high' | 'high';
     scheme: 'light' | 'dark' | 'mixed';
     best_for: string;
     avoid_for: string;
@@ -54,16 +54,30 @@ interface FrontendSlidesSkillOptions {
 declare function getTemplatesCatalog(): TemplateCatalogItem[];
 /**
  * Searches templates by mood, scheme, or keywords.
+ *
+ * Scoring semantics (graceful, not hard-AND):
+ * - `scheme` and `mood` add weight when they match.
+ * - `query` matches against slug/name/tagline/best_for/occasion/tone/avoid_for.
+ * - Results are ranked by score and a minimum threshold applies; when NO
+ *   template clears the threshold the full catalog is returned so LLM agents
+ *   never dead-end on an over-constrained query.
  */
 declare function searchTemplates(filter?: string | {
     mood?: string;
-    scheme?: 'light' | 'dark';
+    scheme?: 'light' | 'dark' | 'mixed';
     query?: string;
 }): TemplateCatalogItem[];
 /**
- * Retrieves a style preset by its ID.
+ * Retrieves a style preset by its ID. Falls back to the first preset
+ * (electric-studio) when the ID is unknown — use `getStylePresetById`
+ * when a strict match is required (e.g. validating user-provided IDs).
  */
-declare function getStylePreset(id: string): StylePresetItem | undefined;
+declare function getStylePreset(id: string): StylePresetItem;
+/**
+ * Strict variant: returns the exact preset or `undefined` when unknown.
+ * Never falls back silently — callers can surface a proper error.
+ */
+declare function getStylePresetById(id: string): StylePresetItem | undefined;
 /**
  * Assembles a comprehensive, production-grade Vercel AI SDK system prompt
  * integrating the entire Frontend-Slides Skill, fixed 16:9 stage rules,
@@ -73,40 +87,41 @@ declare function getFrontendSlidesSkillPrompt(options?: FrontendSlidesSkillOptio
 
 declare const querySlideTemplatesSchema: z.ZodObject<{
     mood: z.ZodOptional<z.ZodString>;
-    scheme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+    scheme: z.ZodOptional<z.ZodEnum<["light", "dark", "mixed"]>>;
     query: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    scheme?: "dark" | "light" | undefined;
+    scheme?: "dark" | "light" | "mixed" | undefined;
     mood?: string | undefined;
     query?: string | undefined;
 }, {
-    scheme?: "dark" | "light" | undefined;
+    scheme?: "dark" | "light" | "mixed" | undefined;
     mood?: string | undefined;
     query?: string | undefined;
 }>;
 declare const getSlideStylePresetSchema: z.ZodObject<{
-    presetId: z.ZodEnum<["electric-studio", "blue-professional", "creative-voltage"]>;
+    presetId: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    presetId: "blue-professional" | "electric-studio" | "creative-voltage";
+    presetId: string;
 }, {
-    presetId: "blue-professional" | "electric-studio" | "creative-voltage";
+    presetId: string;
 }>;
 /**
- * Tool definitions that can be directly passed to Vercel AI SDK's `tools` parameter.
+ * Tool definitions that can be directly passed to Vercel AI SDK v5+/v7's
+ * `tools` parameter (uses `inputSchema`, not the legacy v4 `parameters`).
  */
 declare const frontendSlidesTools: {
     querySlideTemplates: {
         description: string;
-        parameters: z.ZodObject<{
+        inputSchema: z.ZodObject<{
             mood: z.ZodOptional<z.ZodString>;
-            scheme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+            scheme: z.ZodOptional<z.ZodEnum<["light", "dark", "mixed"]>>;
             query: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            scheme?: "dark" | "light" | undefined;
+            scheme?: "dark" | "light" | "mixed" | undefined;
             mood?: string | undefined;
             query?: string | undefined;
         }, {
-            scheme?: "dark" | "light" | undefined;
+            scheme?: "dark" | "light" | "mixed" | undefined;
             mood?: string | undefined;
             query?: string | undefined;
         }>;
@@ -126,17 +141,18 @@ declare const frontendSlidesTools: {
     };
     getSlideStylePreset: {
         description: string;
-        parameters: z.ZodObject<{
-            presetId: z.ZodEnum<["electric-studio", "blue-professional", "creative-voltage"]>;
+        inputSchema: z.ZodObject<{
+            presetId: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            presetId: "blue-professional" | "electric-studio" | "creative-voltage";
+            presetId: string;
         }, {
-            presetId: "blue-professional" | "electric-studio" | "creative-voltage";
+            presetId: string;
         }>;
         execute: (args: z.infer<typeof getSlideStylePresetSchema>) => Promise<StylePresetItem | {
             error: string;
+            availablePresets: string[];
         }>;
     };
 };
 
-export { FRONTEND_SLIDES_CORE_RULES, type FrontendSlidesSkillOptions, STYLE_PRESETS, type StylePresetItem, TEMPLATES_CATALOG, type TemplateCatalogItem, VIEWPORT_BASE_CSS, frontendSlidesTools, getFrontendSlidesSkillPrompt, getSlideStylePresetSchema, getStylePreset, getTemplatesCatalog, querySlideTemplatesSchema, searchTemplates };
+export { FRONTEND_SLIDES_CORE_RULES, type FrontendSlidesSkillOptions, STYLE_PRESETS, type StylePresetItem, TEMPLATES_CATALOG, type TemplateCatalogItem, VIEWPORT_BASE_CSS, frontendSlidesTools, getFrontendSlidesSkillPrompt, getSlideStylePresetSchema, getStylePreset, getStylePresetById, getTemplatesCatalog, querySlideTemplatesSchema, searchTemplates };

package/dist/skills/index.js

@@ -1,3 +1,3 @@
-export { FRONTEND_SLIDES_CORE_RULES, STYLE_PRESETS, TEMPLATES_CATALOG, VIEWPORT_BASE_CSS, frontendSlidesTools, getFrontendSlidesSkillPrompt, getSlideStylePresetSchema, getStylePreset, getTemplatesCatalog, querySlideTemplatesSchema, searchTemplates } from '../chunk-BHJXQCVE.js';
+export { FRONTEND_SLIDES_CORE_RULES, STYLE_PRESETS, TEMPLATES_CATALOG, VIEWPORT_BASE_CSS, frontendSlidesTools, getFrontendSlidesSkillPrompt, getSlideStylePresetSchema, getStylePreset, getStylePresetById, getTemplatesCatalog, querySlideTemplatesSchema, searchTemplates } from '../chunk-VRXEXUHR.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{types-C3d04zzP.d.cts → types-CvxCxWus.d.cts}

@@ -151,70 +151,4 @@ interface SlideEngine {
     getThemeCss: (theme: BuiltInTheme | SlideTheme, containerId?: string) => string;
 }
 
-type HtmlThemeName = 'blue-professional' | 'editorial-forest' | 'cobalt-grid' | 'studio' | 'monochrome';
-interface HtmlDeckTheme {
-    id: HtmlThemeName;
-    name: string;
-    scheme: 'light' | 'dark';
-    palette: {
-        bg: string;
-        bgSecondary?: string;
-        primary: string;
-        accent?: string;
-        text: string;
-        textMuted: string;
-        border?: string;
-    };
-    typography: {
-        display: string;
-        body: string;
-        code?: string;
-    };
-    customCss?: string;
-}
-type HtmlLayoutPresetId = 'hero-cover' | 'split-concept-code' | 'two-columns-compare' | 'three-cards-grid' | 'timeline-steps' | 'metric-callout' | 'checkpoint-quiz' | 'summary-takeaways';
-interface HtmlSlotDefinition {
-    name: string;
-    label: string;
-    type: 'text' | 'multiline' | 'code' | 'list' | 'badge' | 'metric' | 'options';
-    description: string;
-    required?: boolean;
-    default?: any;
-}
-interface HtmlSlidePreset {
-    id: HtmlLayoutPresetId;
-    name: string;
-    category: 'cover' | 'content' | 'split' | 'grid' | 'timeline' | 'callout' | 'assessment';
-    description: string;
-    slots: HtmlSlotDefinition[];
-    template: (slots: Record<string, any>, theme: HtmlDeckTheme) => string;
-}
-interface HtmlSlideSlotData {
-    layoutId: HtmlLayoutPresetId;
-    slots: Record<string, any>;
-    notes?: string;
-    customClass?: string;
-}
-interface HtmlDeckData {
-    title: string;
-    subtitle?: string;
-    author?: string;
-    theme?: HtmlThemeName;
-    slides: HtmlSlideSlotData[];
-    aspectRatio?: '16:9' | '4:3';
-    metadata?: Record<string, any>;
-}
-interface HtmlCompileOptions {
-    themeOverride?: HtmlDeckTheme;
-    minify?: boolean;
-    inlineFonts?: boolean;
-    customHeadTags?: string;
-}
-interface CompiledHtmlDeckResult {
-    html: string;
-    slideCount: number;
-    theme: HtmlDeckTheme;
-    title: string;
-}
-
-export type { BuiltInTheme as B, CompiledHtmlDeckResult as C, HtmlLayoutPresetId as H, LayoutBoxConfig as L, MermaidBlock as M, SlideLayoutData as S, ThemeTokens as T, SlideRenderOptions as a, SlideRenderResult as b, SlideRenderAsyncResult as c, SlideTheme as d, HtmlDeckData as e, HtmlThemeName as f, HtmlSlideSlotData as g, SlideEngineConfig as h, SlideEngine as i, HtmlDeckTheme as j, HtmlSlidePreset as k, HtmlCompileOptions as l, HtmlSlotDefinition as m };
+export type { BuiltInTheme as B, LayoutBoxConfig as L, MermaidBlock as M, SlideLayoutData as S, ThemeTokens as T, SlideRenderOptions as a, SlideRenderResult as b, SlideRenderAsyncResult as c, SlideTheme as d, SlideEngineConfig as e, SlideEngine as f };

package/dist/{types-C3d04zzP.d.ts → types-CvxCxWus.d.ts}

@@ -151,70 +151,4 @@ interface SlideEngine {
     getThemeCss: (theme: BuiltInTheme | SlideTheme, containerId?: string) => string;
 }
 
-type HtmlThemeName = 'blue-professional' | 'editorial-forest' | 'cobalt-grid' | 'studio' | 'monochrome';
-interface HtmlDeckTheme {
-    id: HtmlThemeName;
-    name: string;
-    scheme: 'light' | 'dark';
-    palette: {
-        bg: string;
-        bgSecondary?: string;
-        primary: string;
-        accent?: string;
-        text: string;
-        textMuted: string;
-        border?: string;
-    };
-    typography: {
-        display: string;
-        body: string;
-        code?: string;
-    };
-    customCss?: string;
-}
-type HtmlLayoutPresetId = 'hero-cover' | 'split-concept-code' | 'two-columns-compare' | 'three-cards-grid' | 'timeline-steps' | 'metric-callout' | 'checkpoint-quiz' | 'summary-takeaways';
-interface HtmlSlotDefinition {
-    name: string;
-    label: string;
-    type: 'text' | 'multiline' | 'code' | 'list' | 'badge' | 'metric' | 'options';
-    description: string;
-    required?: boolean;
-    default?: any;
-}
-interface HtmlSlidePreset {
-    id: HtmlLayoutPresetId;
-    name: string;
-    category: 'cover' | 'content' | 'split' | 'grid' | 'timeline' | 'callout' | 'assessment';
-    description: string;
-    slots: HtmlSlotDefinition[];
-    template: (slots: Record<string, any>, theme: HtmlDeckTheme) => string;
-}
-interface HtmlSlideSlotData {
-    layoutId: HtmlLayoutPresetId;
-    slots: Record<string, any>;
-    notes?: string;
-    customClass?: string;
-}
-interface HtmlDeckData {
-    title: string;
-    subtitle?: string;
-    author?: string;
-    theme?: HtmlThemeName;
-    slides: HtmlSlideSlotData[];
-    aspectRatio?: '16:9' | '4:3';
-    metadata?: Record<string, any>;
-}
-interface HtmlCompileOptions {
-    themeOverride?: HtmlDeckTheme;
-    minify?: boolean;
-    inlineFonts?: boolean;
-    customHeadTags?: string;
-}
-interface CompiledHtmlDeckResult {
-    html: string;
-    slideCount: number;
-    theme: HtmlDeckTheme;
-    title: string;
-}
-
-export type { BuiltInTheme as B, CompiledHtmlDeckResult as C, HtmlLayoutPresetId as H, LayoutBoxConfig as L, MermaidBlock as M, SlideLayoutData as S, ThemeTokens as T, SlideRenderOptions as a, SlideRenderResult as b, SlideRenderAsyncResult as c, SlideTheme as d, HtmlDeckData as e, HtmlThemeName as f, HtmlSlideSlotData as g, SlideEngineConfig as h, SlideEngine as i, HtmlDeckTheme as j, HtmlSlidePreset as k, HtmlCompileOptions as l, HtmlSlotDefinition as m };
+export type { BuiltInTheme as B, LayoutBoxConfig as L, MermaidBlock as M, SlideLayoutData as S, ThemeTokens as T, SlideRenderOptions as a, SlideRenderResult as b, SlideRenderAsyncResult as c, SlideTheme as d, SlideEngineConfig as e, SlideEngine as f };

package/dist/types-k_eae8UV.d.cts

@@ -0,0 +1,74 @@
+type HtmlThemeName = 'blue-professional' | 'editorial-forest' | 'cobalt-grid' | 'studio' | 'monochrome';
+interface HtmlDeckTheme {
+    id: HtmlThemeName;
+    name: string;
+    scheme: 'light' | 'dark';
+    palette: {
+        bg: string;
+        bgSecondary?: string;
+        primary: string;
+        accent?: string;
+        text: string;
+        textMuted: string;
+        border?: string;
+    };
+    typography: {
+        display: string;
+        body: string;
+        code?: string;
+    };
+    customCss?: string;
+}
+type HtmlLayoutPresetId = 'hero-cover' | 'split-concept-code' | 'two-columns-compare' | 'three-cards-grid' | 'timeline-steps' | 'metric-callout' | 'checkpoint-quiz' | 'summary-takeaways';
+interface HtmlSlotDefinition {
+    name: string;
+    label: string;
+    type: 'text' | 'multiline' | 'code' | 'list' | 'badge' | 'metric' | 'options';
+    description: string;
+    required?: boolean;
+    default?: any;
+}
+interface HtmlSlidePreset {
+    id: HtmlLayoutPresetId;
+    name: string;
+    category: 'cover' | 'content' | 'split' | 'grid' | 'timeline' | 'callout' | 'assessment';
+    description: string;
+    slots: HtmlSlotDefinition[];
+    template: (slots: Record<string, any>, theme: HtmlDeckTheme) => string;
+}
+interface HtmlSlideSlotData {
+    layoutId: HtmlLayoutPresetId;
+    slots: Record<string, any>;
+    notes?: string;
+    customClass?: string;
+    /**
+     * Free-form slide markup (frontend-slides mode). When present the slide is
+     * compiled as authored instead of slot-filled into a layout preset — the
+     * model makes the design decisions, the compiler only sanitizes, wraps it in
+     * the fixed stage section, and validates it. `layoutId` is ignored.
+     */
+    html?: string;
+}
+interface HtmlDeckData {
+    title: string;
+    subtitle?: string;
+    author?: string;
+    theme?: HtmlThemeName;
+    slides: HtmlSlideSlotData[];
+    aspectRatio?: '16:9' | '4:3';
+    metadata?: Record<string, any>;
+}
+interface HtmlCompileOptions {
+    themeOverride?: HtmlDeckTheme;
+    minify?: boolean;
+    inlineFonts?: boolean;
+    customHeadTags?: string;
+}
+interface CompiledHtmlDeckResult {
+    html: string;
+    slideCount: number;
+    theme: HtmlDeckTheme;
+    title: string;
+}
+
+export type { CompiledHtmlDeckResult as C, HtmlCompileOptions as H, HtmlDeckData as a, HtmlLayoutPresetId as b, HtmlThemeName as c, HtmlSlideSlotData as d, HtmlDeckTheme as e, HtmlSlidePreset as f, HtmlSlotDefinition as g };

package/dist/types-k_eae8UV.d.ts

@@ -0,0 +1,74 @@
+type HtmlThemeName = 'blue-professional' | 'editorial-forest' | 'cobalt-grid' | 'studio' | 'monochrome';
+interface HtmlDeckTheme {
+    id: HtmlThemeName;
+    name: string;
+    scheme: 'light' | 'dark';
+    palette: {
+        bg: string;
+        bgSecondary?: string;
+        primary: string;
+        accent?: string;
+        text: string;
+        textMuted: string;
+        border?: string;
+    };
+    typography: {
+        display: string;
+        body: string;
+        code?: string;
+    };
+    customCss?: string;
+}
+type HtmlLayoutPresetId = 'hero-cover' | 'split-concept-code' | 'two-columns-compare' | 'three-cards-grid' | 'timeline-steps' | 'metric-callout' | 'checkpoint-quiz' | 'summary-takeaways';
+interface HtmlSlotDefinition {
+    name: string;
+    label: string;
+    type: 'text' | 'multiline' | 'code' | 'list' | 'badge' | 'metric' | 'options';
+    description: string;
+    required?: boolean;
+    default?: any;
+}
+interface HtmlSlidePreset {
+    id: HtmlLayoutPresetId;
+    name: string;
+    category: 'cover' | 'content' | 'split' | 'grid' | 'timeline' | 'callout' | 'assessment';
+    description: string;
+    slots: HtmlSlotDefinition[];
+    template: (slots: Record<string, any>, theme: HtmlDeckTheme) => string;
+}
+interface HtmlSlideSlotData {
+    layoutId: HtmlLayoutPresetId;
+    slots: Record<string, any>;
+    notes?: string;
+    customClass?: string;
+    /**
+     * Free-form slide markup (frontend-slides mode). When present the slide is
+     * compiled as authored instead of slot-filled into a layout preset — the
+     * model makes the design decisions, the compiler only sanitizes, wraps it in
+     * the fixed stage section, and validates it. `layoutId` is ignored.
+     */
+    html?: string;
+}
+interface HtmlDeckData {
+    title: string;
+    subtitle?: string;
+    author?: string;
+    theme?: HtmlThemeName;
+    slides: HtmlSlideSlotData[];
+    aspectRatio?: '16:9' | '4:3';
+    metadata?: Record<string, any>;
+}
+interface HtmlCompileOptions {
+    themeOverride?: HtmlDeckTheme;
+    minify?: boolean;
+    inlineFonts?: boolean;
+    customHeadTags?: string;
+}
+interface CompiledHtmlDeckResult {
+    html: string;
+    slideCount: number;
+    theme: HtmlDeckTheme;
+    title: string;
+}
+
+export type { CompiledHtmlDeckResult as C, HtmlCompileOptions as H, HtmlDeckData as a, HtmlLayoutPresetId as b, HtmlThemeName as c, HtmlSlideSlotData as d, HtmlDeckTheme as e, HtmlSlidePreset as f, HtmlSlotDefinition as g };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thanh01.pmt/presentation-kit",
-  "version": "0.2.17",
+  "version": "0.3.0",
   "description": "Standalone client-side slide rendering engine with Marp, Shiki syntax highlighting, Mermaid diagrams, custom themes, and AI slide authoring tools.",
   "author": "Thanh Pham <https://github.com/thanh01pmt>",
   "license": "MIT",
@@ -32,6 +32,12 @@
       "import": "./dist/skills/index.js",
       "require": "./dist/skills/index.cjs",
       "default": "./dist/skills/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js",
+      "require": "./dist/node/index.cjs",
+      "default": "./dist/node/index.js"
     }
   },
   "peerDependencies": {
@@ -54,7 +60,7 @@
   },
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "npm run clean && tsup",
+    "build": "npm run clean && tsup && node scripts/copy-assets.mjs",
     "dev": "tsup --watch",
     "test": "node --test test/*.test.mjs",
     "typecheck": "tsc --noEmit",