@rslsp1/fa-app-tools 0.1.13 → 0.1.14

package/dist/index.d.mts

@@ -65,6 +65,12 @@ declare function exportProjectToZip(nodes: any[], edges: any[], history: any[],
 }>;
 declare function importProjectFromZip(file: File): Promise<any>;
 
+declare function buildGenerationPrompt(hierarchyText: string, mode?: 'literal' | 'creative'): string;
+declare function buildFallbackPrompt(hierarchyText: string): string;
+declare function cleanAiResponse(text: string): string;
+declare function buildImageGenerationOptions(prompt: string, aspectRatio: string, model: string, referenceMediaId?: string): Record<string, any>;
+declare function interpretSdkError(err: any): Error;
+
 interface ExtractedCharacter {
     name: string;
     prompts: {
@@ -183,4 +189,4 @@ interface AvatarArchitectAppProps {
 }
 declare function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onSelectMedia }: AvatarArchitectAppProps): react_jsx_runtime.JSX.Element;
 
-export { AvatarArchitectApp, type AvatarArchitectAppProps, CompactDropdown, type ExtractedCharacter, FaToolsBadge, GLOBAL_STYLES, type Generation, HistoryPanel, InspectPanel, ListView, type MediaItem, MediaLibrary, PillButton, type ProjectSettings, SectionLabel, SetupPanel, type WorkspaceTags, exportProjectToZip, formatTreeToMarkdown, getFormattedTimestamp, importProjectFromZip, injectXMPMetadata, parsePromptFile, useKeyboardNavigation, useOnClickOutside };
+export { AvatarArchitectApp, type AvatarArchitectAppProps, CompactDropdown, type ExtractedCharacter, FaToolsBadge, GLOBAL_STYLES, type Generation, HistoryPanel, InspectPanel, ListView, type MediaItem, MediaLibrary, PillButton, type ProjectSettings, SectionLabel, SetupPanel, type WorkspaceTags, buildFallbackPrompt, buildGenerationPrompt, buildImageGenerationOptions, cleanAiResponse, exportProjectToZip, formatTreeToMarkdown, getFormattedTimestamp, importProjectFromZip, injectXMPMetadata, interpretSdkError, parsePromptFile, useKeyboardNavigation, useOnClickOutside };

package/dist/index.d.ts

@@ -65,6 +65,12 @@ declare function exportProjectToZip(nodes: any[], edges: any[], history: any[],
 }>;
 declare function importProjectFromZip(file: File): Promise<any>;
 
+declare function buildGenerationPrompt(hierarchyText: string, mode?: 'literal' | 'creative'): string;
+declare function buildFallbackPrompt(hierarchyText: string): string;
+declare function cleanAiResponse(text: string): string;
+declare function buildImageGenerationOptions(prompt: string, aspectRatio: string, model: string, referenceMediaId?: string): Record<string, any>;
+declare function interpretSdkError(err: any): Error;
+
 interface ExtractedCharacter {
     name: string;
     prompts: {
@@ -183,4 +189,4 @@ interface AvatarArchitectAppProps {
 }
 declare function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onSelectMedia }: AvatarArchitectAppProps): react_jsx_runtime.JSX.Element;
 
-export { AvatarArchitectApp, type AvatarArchitectAppProps, CompactDropdown, type ExtractedCharacter, FaToolsBadge, GLOBAL_STYLES, type Generation, HistoryPanel, InspectPanel, ListView, type MediaItem, MediaLibrary, PillButton, type ProjectSettings, SectionLabel, SetupPanel, type WorkspaceTags, exportProjectToZip, formatTreeToMarkdown, getFormattedTimestamp, importProjectFromZip, injectXMPMetadata, parsePromptFile, useKeyboardNavigation, useOnClickOutside };
+export { AvatarArchitectApp, type AvatarArchitectAppProps, CompactDropdown, type ExtractedCharacter, FaToolsBadge, GLOBAL_STYLES, type Generation, HistoryPanel, InspectPanel, ListView, type MediaItem, MediaLibrary, PillButton, type ProjectSettings, SectionLabel, SetupPanel, type WorkspaceTags, buildFallbackPrompt, buildGenerationPrompt, buildImageGenerationOptions, cleanAiResponse, exportProjectToZip, formatTreeToMarkdown, getFormattedTimestamp, importProjectFromZip, injectXMPMetadata, interpretSdkError, parsePromptFile, useKeyboardNavigation, useOnClickOutside };

package/dist/index.js

@@ -41,11 +41,16 @@ __export(index_exports, {
   PillButton: () => PillButton,
   SectionLabel: () => SectionLabel,
   SetupPanel: () => SetupPanel,
+  buildFallbackPrompt: () => buildFallbackPrompt,
+  buildGenerationPrompt: () => buildGenerationPrompt,
+  buildImageGenerationOptions: () => buildImageGenerationOptions,
+  cleanAiResponse: () => cleanAiResponse,
   exportProjectToZip: () => exportProjectToZip,
   formatTreeToMarkdown: () => formatTreeToMarkdown,
   getFormattedTimestamp: () => getFormattedTimestamp,
   importProjectFromZip: () => importProjectFromZip,
   injectXMPMetadata: () => injectXMPMetadata,
+  interpretSdkError: () => interpretSdkError,
   parsePromptFile: () => parsePromptFile,
   useKeyboardNavigation: () => useKeyboardNavigation,
   useOnClickOutside: () => useOnClickOutside
@@ -314,6 +319,50 @@ async function importProjectFromZip(file) {
   return data;
 }
 
+// src/lib/aiHelpers.ts
+function buildGenerationPrompt(hierarchyText, mode = "creative") {
+  const safe = hierarchyText.length > 2500 ? hierarchyText.slice(0, 2500) + "..." : hierarchyText;
+  if (mode === "literal") {
+    return `Translate this hierarchy into a literal image generation prompt. Output ONLY the raw prompt string. No chat.
+
+HIERARCHY:
+${safe}`;
+  }
+  return `Create a cinematic, high-quality image generation prompt based on this hierarchy. Translate everything to English. Output ONLY the prompt string. No chat.
+
+HIERARCHY:
+${safe}`;
+}
+function buildFallbackPrompt(hierarchyText) {
+  const lines = hierarchyText.split("\n");
+  const firstConcept = lines.find((l) => l.includes("-"))?.replace(/^[-\s]+/, "") || "character concept";
+  return `Cinematic professional photograph of ${firstConcept}, masterpiece, highly detailed, fine art style`;
+}
+function cleanAiResponse(text) {
+  return text.replace(/^["']|["']$/g, "").replace(/```/g, "").trim();
+}
+function buildImageGenerationOptions(prompt, aspectRatio, model, referenceMediaId) {
+  const options = {
+    prompt: prompt.replace(/\n/g, " ").trim().slice(0, 1500),
+    aspectRatio,
+    modelDisplayName: model
+  };
+  if (referenceMediaId && referenceMediaId.length > 5) {
+    options.referenceImageMediaIds = [referenceMediaId];
+  }
+  return options;
+}
+function interpretSdkError(err) {
+  const msg = err?.message || "Generierung fehlgeschlagen";
+  if (msg.includes("PUBLIC_ERROR_SOMETHING_WENT_WRONG")) {
+    return new Error("Plattform-Fehler: Die Anfrage wurde abgelehnt. M\xF6gliche Ursachen: Sicherheitsfilter (Prompt-Inhalt) oder tempor\xE4re \xDCberlastung. Versuche einen neutraleren Prompt.");
+  }
+  if (msg.includes("PUBLIC_ERROR")) {
+    return new Error(`Plattform-Fehler: ${msg}`);
+  }
+  return new Error(msg);
+}
+
 // src/lib/parserService.ts
 function parsePromptFile(text) {
   const characters = [];
@@ -1081,11 +1130,16 @@ function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onS
   PillButton,
   SectionLabel,
   SetupPanel,
+  buildFallbackPrompt,
+  buildGenerationPrompt,
+  buildImageGenerationOptions,
+  cleanAiResponse,
   exportProjectToZip,
   formatTreeToMarkdown,
   getFormattedTimestamp,
   importProjectFromZip,
   injectXMPMetadata,
+  interpretSdkError,
   parsePromptFile,
   useKeyboardNavigation,
   useOnClickOutside

package/dist/index.mjs

@@ -260,6 +260,50 @@ async function importProjectFromZip(file) {
   return data;
 }
 
+// src/lib/aiHelpers.ts
+function buildGenerationPrompt(hierarchyText, mode = "creative") {
+  const safe = hierarchyText.length > 2500 ? hierarchyText.slice(0, 2500) + "..." : hierarchyText;
+  if (mode === "literal") {
+    return `Translate this hierarchy into a literal image generation prompt. Output ONLY the raw prompt string. No chat.
+
+HIERARCHY:
+${safe}`;
+  }
+  return `Create a cinematic, high-quality image generation prompt based on this hierarchy. Translate everything to English. Output ONLY the prompt string. No chat.
+
+HIERARCHY:
+${safe}`;
+}
+function buildFallbackPrompt(hierarchyText) {
+  const lines = hierarchyText.split("\n");
+  const firstConcept = lines.find((l) => l.includes("-"))?.replace(/^[-\s]+/, "") || "character concept";
+  return `Cinematic professional photograph of ${firstConcept}, masterpiece, highly detailed, fine art style`;
+}
+function cleanAiResponse(text) {
+  return text.replace(/^["']|["']$/g, "").replace(/```/g, "").trim();
+}
+function buildImageGenerationOptions(prompt, aspectRatio, model, referenceMediaId) {
+  const options = {
+    prompt: prompt.replace(/\n/g, " ").trim().slice(0, 1500),
+    aspectRatio,
+    modelDisplayName: model
+  };
+  if (referenceMediaId && referenceMediaId.length > 5) {
+    options.referenceImageMediaIds = [referenceMediaId];
+  }
+  return options;
+}
+function interpretSdkError(err) {
+  const msg = err?.message || "Generierung fehlgeschlagen";
+  if (msg.includes("PUBLIC_ERROR_SOMETHING_WENT_WRONG")) {
+    return new Error("Plattform-Fehler: Die Anfrage wurde abgelehnt. M\xF6gliche Ursachen: Sicherheitsfilter (Prompt-Inhalt) oder tempor\xE4re \xDCberlastung. Versuche einen neutraleren Prompt.");
+  }
+  if (msg.includes("PUBLIC_ERROR")) {
+    return new Error(`Plattform-Fehler: ${msg}`);
+  }
+  return new Error(msg);
+}
+
 // src/lib/parserService.ts
 function parsePromptFile(text) {
   const characters = [];
@@ -1026,11 +1070,16 @@ export {
   PillButton,
   SectionLabel,
   SetupPanel,
+  buildFallbackPrompt,
+  buildGenerationPrompt,
+  buildImageGenerationOptions,
+  cleanAiResponse,
   exportProjectToZip,
   formatTreeToMarkdown,
   getFormattedTimestamp,
   importProjectFromZip,
   injectXMPMetadata,
+  interpretSdkError,
   parsePromptFile,
   useKeyboardNavigation,
   useOnClickOutside

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rslsp1/fa-app-tools",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "Shared tools and hooks for Fine Art flow apps",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",