@docyrus/ui-pro-ai-assistant 0.0.1

package/src/internal/plate-editor/i18n/locales/sl.json

@@ -0,0 +1,57 @@
+{
+  "toolbar": {
+    "bold": "Krepko",
+    "italic": "Ležeče",
+    "underline": "Podčrtano",
+    "strikethrough": "Prečrtano",
+    "code": "Koda",
+    "heading1": "Naslov 1",
+    "heading2": "Naslov 2",
+    "heading3": "Naslov 3",
+    "bulletList": "Seznam z oznakami",
+    "numberedList": "Oštevilčen seznam",
+    "todoList": "Seznam opravil",
+    "blockquote": "Citat",
+    "codeBlock": "Blok kode",
+    "table": "Tabela",
+    "image": "Slika",
+    "link": "Povezava",
+    "align_left": "Poravnaj levo",
+    "align_center": "Na sredino",
+    "align_right": "Poravnaj desno",
+    "undo": "Razveljavi",
+    "redo": "Uveljavi"
+  },
+  "slash": {
+    "placeholder": "Vnesite ukaz...",
+    "noResults": "Ni rezultatov",
+    "groups": {
+      "basic": "Osnovni bloki",
+      "media": "Mediji",
+      "advanced": "Napredno"
+    }
+  },
+  "ai": {
+    "placeholder": "Prosite AI, da uredi ali ustvari...",
+    "generating": "Ustvarjanje...",
+    "improve": "Izboljšaj pisanje",
+    "simplify": "Poenostavi",
+    "expand": "Podaljšaj",
+    "summarize": "Povzemi",
+    "translate": "Prevedi",
+    "fixGrammar": "Popravi slovnico"
+  },
+  "media": {
+    "upload": "Naloži",
+    "embedLink": "Vdelaj povezavo",
+    "maxSize": "Največja velikost datoteke: 5MB",
+    "uploadImage": "Naloži sliko",
+    "uploadVideo": "Naloži video",
+    "uploadAudio": "Naloži zvok",
+    "uploadFile": "Naloži datoteko"
+  },
+  "placeholder": {
+    "paragraph": "Vnesite '/' za ukaze...",
+    "heading": "Naslov"
+  }
+}

package/src/internal/plate-editor/i18n/locales/tr.json

@@ -0,0 +1,57 @@
+{
+  "toolbar": {
+    "bold": "Kalın",
+    "italic": "İtalik",
+    "underline": "Altı Çizili",
+    "strikethrough": "Üstü Çizili",
+    "code": "Kod",
+    "heading1": "Başlık 1",
+    "heading2": "Başlık 2",
+    "heading3": "Başlık 3",
+    "bulletList": "Madde İşareti Listesi",
+    "numberedList": "Numaralı Liste",
+    "todoList": "Yapılacaklar Listesi",
+    "blockquote": "Alıntı",
+    "codeBlock": "Kod Bloğu",
+    "table": "Tablo",
+    "image": "Resim",
+    "link": "Bağlantı",
+    "align_left": "Sola Hizala",
+    "align_center": "Ortala",
+    "align_right": "Sağa Hizala",
+    "undo": "Geri Al",
+    "redo": "Yinele"
+  },
+  "slash": {
+    "placeholder": "Komut yazın...",
+    "noResults": "Sonuç yok",
+    "groups": {
+      "basic": "Temel Bloklar",
+      "media": "Medya",
+      "advanced": "Gelişmiş"
+    }
+  },
+  "ai": {
+    "placeholder": "AI'dan düzenlemesini veya oluşturmasını isteyin...",
+    "generating": "Oluşturuluyor...",
+    "improve": "Yazımı iyileştir",
+    "simplify": "Sadeleştir",
+    "expand": "Uzat",
+    "summarize": "Özetle",
+    "translate": "Çevir",
+    "fixGrammar": "Dil bilgisini düzelt"
+  },
+  "media": {
+    "upload": "Yükle",
+    "embedLink": "Bağlantı göm",
+    "maxSize": "Dosya başına maksimum boyut 5MB",
+    "uploadImage": "Resim yükle",
+    "uploadVideo": "Video yükle",
+    "uploadAudio": "Ses yükle",
+    "uploadFile": "Dosya yükle"
+  },
+  "placeholder": {
+    "paragraph": "Komutlar için '/' yazın...",
+    "heading": "Başlık"
+  }
+}

package/src/internal/plate-editor/i18n/types.ts

@@ -0,0 +1,59 @@
+export type Locale = 'de' | 'el' | 'en' | 'es' | 'fr' | 'it' | 'pt' | 'sl' | 'tr';
+
+export interface PlateEditorTranslations {
+  toolbar: {
+    bold: string;
+    italic: string;
+    underline: string;
+    strikethrough: string;
+    code: string;
+    heading1: string;
+    heading2: string;
+    heading3: string;
+    bulletList: string;
+    numberedList: string;
+    todoList: string;
+    blockquote: string;
+    codeBlock: string;
+    table: string;
+    image: string;
+    link: string;
+    align_left: string;
+    align_center: string;
+    align_right: string;
+    undo: string;
+    redo: string;
+  };
+  slash: {
+    placeholder: string;
+    noResults: string;
+    groups: {
+      basic: string;
+      media: string;
+      advanced: string;
+    };
+  };
+  ai: {
+    placeholder: string;
+    generating: string;
+    improve: string;
+    simplify: string;
+    expand: string;
+    summarize: string;
+    translate: string;
+    fixGrammar: string;
+  };
+  media: {
+    upload: string;
+    embedLink: string;
+    maxSize: string;
+    uploadImage: string;
+    uploadVideo: string;
+    uploadAudio: string;
+    uploadFile: string;
+  };
+  placeholder: {
+    paragraph: string;
+    heading: string;
+  };
+}

package/src/internal/plate-editor/i18n/use-translation.ts

@@ -0,0 +1,22 @@
+import { usePlateEditorI18n } from './context';
+
+export function usePlateEditorTranslation() {
+  const { translations, locale } = usePlateEditorI18n();
+
+  const t = (key: string): string => {
+    const keys = key.split('.');
+    let value: unknown = translations;
+
+    for (const k of keys) {
+      if (value && typeof value === 'object' && k in value) {
+        value = (value as Record<string, unknown>)[k];
+      } else {
+        return key; // Fallback to key
+      }
+    }
+
+    return typeof value === 'string' ? value : key;
+  };
+
+  return { t, locale };
+}

package/src/internal/plate-editor/index.ts

@@ -0,0 +1,39 @@
+// Core editor
+export { PlateEditor } from './editor/plate-editor';
+export type { PlateEditorProps, PlateEditorHandle } from './editor/plate-editor';
+export { EditorKit, useEditor } from './editor/editor-kit';
+export type { MyEditor } from './editor/editor-kit';
+
+// Transforms
+export { insertBlock, setBlockType, getBlockType } from './editor/transforms';
+
+// Re-export platejs core types for consumers
+export type { Value } from 'platejs';
+
+// Types
+export type {
+  MyBlockElement,
+  MyBlockquoteElement,
+  MyCodeBlockElement,
+  MyCodeLineElement,
+  MyH1Element,
+  MyH2Element,
+  MyH3Element,
+  MyHrElement,
+  MyImageElement,
+  MyLinkElement,
+  MyMentionElement,
+  MyNestableBlock,
+  MyParagraphElement,
+  MyTableCellElement,
+  MyTableElement,
+  MyTableRowElement,
+  MyTextBlockElement,
+  MyToggleElement,
+  MyValue,
+  RichText
+} from './editor/plate-types';
+
+// UI Components
+export { Editor, EditorContainer } from './plate-ui/editor';
+export type { EditorProps } from './plate-ui/editor';

package/src/internal/plate-editor/lib/ai-output-converter.ts

@@ -0,0 +1,153 @@
+/**
+ * AI Output to Plate.js Value Converter
+ *
+ * Converts AI structured output (conforming to plate-editor-openai-schema.json)
+ * to Plate.js document format (Value array).
+ *
+ * Since the AI schema is designed to directly match Plate.js element structure,
+ * the conversion is primarily validation and pass-through with cleanup of null values.
+ */
+
+/** AI structured output root shape */
+export interface AIDocumentOutput {
+  title: string;
+  description: string;
+  assumptions?: string[] | null;
+  warnings?: string[] | null;
+  document: PlateBlockElement[];
+}
+
+/** Supported block element types */
+type PlateBlockType
+  = | 'p'
+    | 'h1'
+    | 'h2'
+    | 'h3'
+    | 'blockquote'
+    | 'code_block'
+    | 'table'
+    | 'callout'
+    | 'toggle'
+    | 'column_group'
+    | 'img'
+    | 'video'
+    | 'audio'
+    | 'media_embed'
+    | 'equation'
+    | 'hr'
+    | 'toc';
+
+/** Generic block element from AI output */
+interface PlateBlockElement {
+  type: PlateBlockType;
+  children: unknown[];
+  [key: string]: unknown;
+}
+
+/**
+ * Convert AI structured output to Plate.js Value (document array).
+ *
+ * The AI output document array already matches Plate.js format, so this
+ * function validates the structure and cleans up null/undefined values
+ * that the AI might produce from optional schema fields.
+ *
+ * @param output - AI structured output conforming to the schema
+ * @returns Plate.js Value array ready to be used as editor content
+ */
+export function aiOutputToPlate(output: AIDocumentOutput): unknown[] {
+  if (!output?.document || !Array.isArray(output.document)) {
+    // Fallback: create a minimal document from title/description
+    return [
+      {
+        type: 'h1',
+        children: [{ text: output?.title || 'Untitled' }]
+      },
+      {
+        type: 'p',
+        children: [{ text: output?.description || '' }]
+      }
+    ];
+  }
+
+  // Clean null values from each element recursively
+  return output.document.map(element => cleanElement(element));
+}
+
+/**
+ * Recursively clean null/undefined optional properties from an element.
+ * OpenAI structured output may include explicit null for optional fields.
+ */
+function cleanElement(element: unknown): unknown {
+  if (element === null || element === undefined) return element;
+  if (typeof element !== 'object') return element;
+
+  if (Array.isArray(element)) {
+    return element.map(item => cleanElement(item));
+  }
+
+  const obj = element as Record<string, unknown>;
+  const cleaned: Record<string, unknown> = {};
+
+  for (const [key, value] of Object.entries(obj)) {
+    // Skip null optional properties to keep Plate.js objects clean
+    if (value === null || value === undefined) continue;
+
+    if (key === 'children' && Array.isArray(value)) {
+      cleaned[key] = value.map(child => cleanElement(child));
+    } else if (typeof value === 'object' && !Array.isArray(value)) {
+      cleaned[key] = cleanElement(value);
+    } else if (Array.isArray(value)) {
+      cleaned[key] = value.map(item => cleanElement(item));
+    } else {
+      cleaned[key] = value;
+    }
+  }
+
+  return cleaned;
+}
+
+/**
+ * Validate that an unknown value conforms to the AIDocumentOutput structure.
+ *
+ * @param output - Unknown value to validate
+ * @returns Type predicate indicating valid AIDocumentOutput
+ */
+export function isValidPlateOutput(output: unknown): output is AIDocumentOutput {
+  if (!output || typeof output !== 'object') return false;
+
+  const doc = output as Record<string, unknown>;
+
+  if (typeof doc.title !== 'string') return false;
+  if (typeof doc.description !== 'string') return false;
+  if (!Array.isArray(doc.document)) return false;
+
+  // Validate each top-level element has type and children
+  return doc.document.every((element: unknown) => {
+    if (!element || typeof element !== 'object') return false;
+
+    const el = element as Record<string, unknown>;
+
+    return typeof el.type === 'string' && Array.isArray(el.children);
+  });
+}
+
+/**
+ * Extract metadata from AI output (title, description, assumptions, warnings).
+ * Useful for displaying document info in the UI without parsing the full document.
+ *
+ * @param output - AI structured output
+ * @returns Metadata object
+ */
+export function extractMetadata(output: AIDocumentOutput): {
+  title: string;
+  description: string;
+  assumptions: string[];
+  warnings: string[];
+} {
+  return {
+    title: output.title || 'Untitled',
+    description: output.description || '',
+    assumptions: output.assumptions ?? [],
+    warnings: output.warnings ?? []
+  };
+}

package/src/internal/plate-editor/lib/download-file.ts

@@ -0,0 +1,17 @@
+export const downloadFile = async (url: string, filename: string) => {
+  const response = await fetch(url);
+
+  const blob = await response.blob();
+  const blobUrl = window.URL.createObjectURL(blob);
+
+  const link = document.createElement('a');
+
+  link.href = blobUrl;
+  link.download = filename;
+  document.body.append(link);
+  link.click();
+  link.remove();
+
+  // Clean up the blob URL
+  window.URL.revokeObjectURL(blobUrl);
+};

package/src/internal/plate-editor/plate-ui/ai-chat-editor.tsx

@@ -0,0 +1,26 @@
+'use client';
+
+import { memo } from 'react';
+
+import * as React from 'react';
+
+import { useAIChatEditor } from '@platejs/ai/react';
+import { usePlateEditor } from 'platejs/react';
+
+import { EditorStatic } from './editor-static';
+
+import { EditorKit } from '../editor/editor-kit';
+
+export const AIChatEditor = memo(({
+  content
+}: {
+  content: string;
+}) => {
+  const aiEditor = usePlateEditor({
+    plugins: EditorKit
+  });
+
+  const value = useAIChatEditor(aiEditor, content);
+
+  return <EditorStatic editor={aiEditor} value={value} variant="aiChat" />;
+});