@json-to-office/jto 2.4.0 → 3.0.0

package/dist/cli.js

@@ -2914,14 +2914,79 @@ var init_browser_plugin_schema = __esm({
   }
 });
 
+// src/server/services/block-references.ts
+import { readFile } from "fs/promises";
+import { PluginDiscoveryService as PluginDiscoveryService2 } from "@json-to-office/jto-cli";
+import {
+  blockReferencesFromDocument,
+  blockSlotFacts
+} from "@json-to-office/shared";
+async function discoverBlockReferences(format) {
+  const cached = cache.get(format);
+  if (cached && Date.now() - cached.at < TTL_MS) return cached.references;
+  const discovery = new PluginDiscoveryService2({
+    maxDepth: 10,
+    includeNodeModules: false,
+    verbose: false
+  });
+  const documents = await discovery.discoverDocuments(format);
+  const references = [];
+  for (const document of documents) {
+    try {
+      references.push(
+        ...blockReferencesFromDocument(
+          JSON.parse(await readFile(document.path, "utf-8")),
+          { template: document.name, format }
+        )
+      );
+    } catch {
+    }
+  }
+  cache.set(format, { at: Date.now(), references });
+  return references;
+}
+function blockReferencesPrompt(references) {
+  if (!references.length)
+    return "_No reference blocks are available on this server; define the blocks the deck needs yourself._";
+  return references.map((reference) => {
+    const slots = Object.entries(reference.definition.slots).map(
+      ([name, slot]) => `- \`${name}\` \u2014 ${[slot.type, ...blockSlotFacts(slot)].join(", ")}${slot.description ? `: ${slot.description}` : ""}`
+    );
+    const dependencies = reference.dependencies.length ? `
+Also copy: ${reference.dependencies.map((name) => `\`${name}\``).join(", ")} (invoked by this definition).` : "";
+    return [
+      `### \`${reference.name}\` (from ${reference.template})`,
+      reference.description,
+      slots.length ? slots.join("\n") : "_No slots._",
+      `Definition to copy into \`props.blocks\`:${dependencies}`,
+      "```json",
+      JSON.stringify({ [reference.name]: reference.definition }, null, 2),
+      "```",
+      "Invocation:",
+      "```json",
+      JSON.stringify(reference.example, null, 2),
+      "```"
+    ].filter(Boolean).join("\n\n");
+  }).join("\n\n");
+}
+var TTL_MS, cache;
+var init_block_references = __esm({
+  "src/server/services/block-references.ts"() {
+    "use strict";
+    init_esm_shims();
+    TTL_MS = 1e4;
+    cache = /* @__PURE__ */ new Map();
+  }
+});
+
 // src/server/routes/discovery.ts
 import { Hono as Hono3 } from "hono";
 import { HTTPException as HTTPException5 } from "hono/http-exception";
 import { bodyLimit as bodyLimit3 } from "hono/body-limit";
 import { Type as Type3 } from "@sinclair/typebox";
-import { readFile, stat } from "fs/promises";
+import { readFile as readFile2, stat } from "fs/promises";
 import {
-  PluginDiscoveryService as PluginDiscoveryService2,
+  PluginDiscoveryService as PluginDiscoveryService3,
   PluginRegistry as PluginRegistry3
 } from "@json-to-office/jto-cli";
 import { latestVersion } from "@json-to-office/shared";
@@ -3085,6 +3150,7 @@ var init_discovery = __esm({
     init_auth();
     init_config();
     init_browser_plugin_schema();
+    init_block_references();
     discoveryRouter = new Hono3();
     BrowserPluginVersionSchema = Type3.Object(
       {
@@ -3124,7 +3190,7 @@ var init_discovery = __esm({
     discoveryRouter.get("/all", async (c) => {
       try {
         const format = Container.getAdapter().name;
-        const discovery = new PluginDiscoveryService2({
+        const discovery = new PluginDiscoveryService3({
           maxDepth: 10,
           includeNodeModules: false,
           verbose: false
@@ -3159,7 +3225,7 @@ var init_discovery = __esm({
         const includeSchemas = c.req.query("schemas") === "true";
         const includeExamples = c.req.query("examples") === "true";
         const format = Container.getAdapter().name;
-        const discovery = new PluginDiscoveryService2({
+        const discovery = new PluginDiscoveryService3({
           maxDepth: 10,
           includeNodeModules: false,
           verbose: false
@@ -3191,7 +3257,7 @@ var init_discovery = __esm({
     discoveryRouter.get("/documents", async (c) => {
       try {
         const format = Container.getAdapter().name;
-        const discovery = new PluginDiscoveryService2({
+        const discovery = new PluginDiscoveryService3({
           maxDepth: 10,
           includeNodeModules: false,
           verbose: false
@@ -3203,10 +3269,24 @@ var init_discovery = __esm({
         return c.json({ success: false, error: error.message }, 500);
       }
     });
+    discoveryRouter.get("/blocks", async (c) => {
+      try {
+        const format = Container.getAdapter().name;
+        const references = await discoverBlockReferences(format);
+        return c.json({
+          success: true,
+          data: references,
+          count: references.length
+        });
+      } catch (error) {
+        logger.error("Block discovery failed", { error: error.message });
+        return c.json({ success: false, error: error.message }, 500);
+      }
+    });
     discoveryRouter.get("/themes", async (c) => {
       try {
         const format = Container.getAdapter().name;
-        const discovery = new PluginDiscoveryService2({
+        const discovery = new PluginDiscoveryService3({
           maxDepth: 10,
           includeNodeModules: false,
           verbose: false
@@ -3241,7 +3321,7 @@ var init_discovery = __esm({
       try {
         const pluginName = c.req.param("name");
         const format = Container.getAdapter().name;
-        const discovery = new PluginDiscoveryService2({
+        const discovery = new PluginDiscoveryService3({
           maxDepth: 10,
           includeNodeModules: false,
           verbose: false
@@ -3261,7 +3341,7 @@ var init_discovery = __esm({
             413
           );
         }
-        return c.text(await readFile(plugin.filePath, "utf-8"));
+        return c.text(await readFile2(plugin.filePath, "utf-8"));
       } catch (error) {
         logger.error("Plugin source read failed", { error: error.message });
         return c.json({ success: false, error: error.message }, 500);
@@ -3271,7 +3351,7 @@ var init_discovery = __esm({
       try {
         const pluginName = c.req.param("name");
         const format = Container.getAdapter().name;
-        const discovery = new PluginDiscoveryService2({
+        const discovery = new PluginDiscoveryService3({
           maxDepth: 10,
           includeNodeModules: false,
           verbose: false
@@ -3306,7 +3386,7 @@ var init_discovery = __esm({
       try {
         const name = c.req.param("name");
         const format = Container.getAdapter().name;
-        const discovery = new PluginDiscoveryService2({
+        const discovery = new PluginDiscoveryService3({
           maxDepth: 10,
           includeNodeModules: false,
           verbose: false
@@ -3322,7 +3402,7 @@ var init_discovery = __esm({
       try {
         const name = c.req.param("name");
         const format = Container.getAdapter().name;
-        const discovery = new PluginDiscoveryService2({
+        const discovery = new PluginDiscoveryService3({
           maxDepth: 10,
           includeNodeModules: false,
           verbose: false
@@ -3507,10 +3587,10 @@ function resolvePromptsDir() {
   return candidates[0];
 }
 function readPromptFile(name) {
-  if (cache.has(name)) return cache.get(name);
+  if (cache2.has(name)) return cache2.get(name);
   const filePath = join(PROMPTS_DIR, name);
   const content = readFileSync(filePath, "utf-8");
-  cache.set(name, content);
+  cache2.set(name, content);
   return content;
 }
 function loadPrompt(name, vars = {}) {
@@ -3520,14 +3600,14 @@ function loadPrompt(name, vars = {}) {
   }
   return content;
 }
-var __dirname2, PROMPTS_DIR, cache;
+var __dirname2, PROMPTS_DIR, cache2;
 var init_prompt_loader = __esm({
   "src/server/services/prompt-loader.ts"() {
     "use strict";
     init_esm_shims();
     __dirname2 = dirname2(fileURLToPath2(import.meta.url));
     PROMPTS_DIR = resolvePromptsDir();
-    cache = /* @__PURE__ */ new Map();
+    cache2 = /* @__PURE__ */ new Map();
   }
 });
 
@@ -3536,6 +3616,7 @@ import { Hono as Hono4 } from "hono";
 import { streamText, convertToModelMessages } from "ai";
 import { claudeCode } from "ai-sdk-provider-claude-code";
 import { extractText as extractPdfText } from "unpdf";
+import { blockSlotFacts as blockSlotFacts2 } from "@json-to-office/shared";
 function sanitizeFilename(name) {
   return name.replace(/[[\]\n\r]/g, "_");
 }
@@ -3688,7 +3769,11 @@ function createAiRouter() {
         const hasActiveDoc = !hasSelection && activeDocument?.text;
         const isGenerate = !hasSelection && !hasActiveDoc;
         if (!isTheme && format === "pptx" && !hasSelection) {
-          systemPrompt += "\n\n" + loadPrompt("pptx-design.md");
+          systemPrompt += "\n\n" + loadPrompt("pptx-design.md", {
+            referenceBlocks: blockReferencesPrompt(
+              await discoverBlockReferences("pptx")
+            )
+          });
         }
         if (hasSelection) {
           const ctx = context[0];
@@ -3699,7 +3784,7 @@ function createAiRouter() {
             selectedText: ctx.selectedText
           });
         } else if (hasActiveDoc) {
-          const pptxScope = format === "pptx" && !isTheme && (scope === "slides" || scope === "templates");
+          const pptxScope = format === "pptx" && !isTheme && (scope === "slides" || scope === "blocks");
           let parsedDoc = null;
           if (pptxScope) {
             try {
@@ -3709,38 +3794,36 @@ function createAiRouter() {
           }
           if (pptxScope && parsedDoc) {
             const doc = parsedDoc;
+            const blocks = doc.props?.blocks || {};
+            const invoked = (slide) => (slide.children || []).filter((child) => child?.name === "block").map((child) => String(child.props?.ref ?? "?"));
             if (scope === "slides") {
-              const templatesSummary = (doc.props?.templates || []).map((m) => {
-                const phs = (m.placeholders || []).map((p) => {
-                  const d = p.defaults ? ` \u2192 defaults: ${JSON.stringify(p.defaults)}` : "";
-                  return `  - \`${p.name}\`${d}`;
+              const blocksSummary = Object.entries(blocks).map(([name, definition]) => {
+                const slots = Object.entries(definition.slots || {}).map(([slot, spec]) => {
+                  const facts = [spec.type, ...blockSlotFacts2(spec)];
+                  const description2 = spec.description ? `: ${spec.description}` : "";
+                  return `  - \`${slot}\` \u2014 ${facts.join(", ")}${description2}`;
                 }).join("\n");
-                return `**${m.name}**
-${phs}`;
+                const description = definition.description ? ` \u2014 ${definition.description}` : "";
+                return `**${name}**${description}
+${slots || "  _No slots._"}`;
               }).join("\n\n");
               const slidesText = JSON.stringify(doc.children || [], null, 2);
               systemPrompt += "\n\n" + loadPrompt("instructions-edit-document-pptx-slides.md", {
                 documentName: activeDocument.name || "untitled",
-                templatesSummary,
+                blocksSummary: blocksSummary || "_No blocks defined yet._",
                 slidesText
               });
             } else {
-              const templatesText = JSON.stringify(
-                doc.props?.templates || [],
-                null,
-                2
-              );
-              const slidesSummary = (doc.children || []).map((s, i) => {
-                const template = s.props?.template || "(none)";
-                const phs = Object.keys(s.props?.placeholders || {}).join(
-                  ", "
-                );
-                return `  ${i}: template=${template}, placeholders=[${phs}]`;
+              const blocksText = JSON.stringify(blocks, null, 2);
+              const slidesSummary = (doc.children || []).map((slide, index) => {
+                const title = slide.props?.meta?.title ? ` "${slide.props.meta.title}"` : "";
+                const refs = invoked(slide);
+                return `  ${index}:${title} blocks=[${refs.join(", ")}]`;
               }).join("\n");
-              systemPrompt += "\n\n" + loadPrompt("instructions-edit-document-pptx-templates.md", {
+              systemPrompt += "\n\n" + loadPrompt("instructions-edit-document-pptx-blocks.md", {
                 documentName: activeDocument.name || "untitled",
-                templatesText,
-                slidesSummary
+                blocksText,
+                slidesSummary: slidesSummary || "  _No slides yet._"
               });
             }
           } else {
@@ -3860,6 +3943,7 @@ var init_ai = __esm({
     init_esm_shims();
     init_ai_schema();
     init_prompt_loader();
+    init_block_references();
     init_logger();
     init_rate_limit();
     init_config();
@@ -4735,7 +4819,7 @@ function createDevCommand(adapter) {
 }
 
 // src/cli.ts
-var PACKAGE_VERSION = true ? "2.4.0" : "dev-mode";
+var PACKAGE_VERSION = true ? "3.0.0" : "dev-mode";
 var program = new Command2();
 program.name("jto").description("JSON to Office CLI - Generate .docx and .pptx from JSON").version(PACKAGE_VERSION);
 registerCoreCommands(program, {