@wakastellar/ui 4.0.0-dev.0 → 4.0.1

package/dist/src/components/editor/waka-diff-viewer.d.ts

@@ -1,71 +0,0 @@
-import * as React from "react";
-type SlateNode = any;
-/** Statistics about the diff between two documents */
-export interface DiffStats {
-    /** Number of nodes added */
-    added: number;
-    /** Number of nodes removed */
-    removed: number;
-    /** Number of nodes modified */
-    modified: number;
-    /** Number of unchanged nodes */
-    unchanged: number;
-}
-export interface WakaDiffViewerProps {
-    /** Original (before) Slate document */
-    original: SlateNode[];
-    /** Modified (after) Slate document */
-    modified: SlateNode[];
-    /** Display mode */
-    mode?: "inline" | "side-by-side";
-    /** Label */
-    label?: string;
-    /** Description */
-    description?: string;
-    /** CSS class */
-    className?: string;
-    /** Editor area CSS class */
-    editorClassName?: string;
-    /** Minimum height in px */
-    minHeight?: number;
-    /** Show diff statistics header */
-    showStats?: boolean;
-    /** Label for the original document */
-    originalLabel?: string;
-    /** Label for the modified document */
-    modifiedLabel?: string;
-    /** Callback with diff stats when diff is computed */
-    onDiffComputed?: (stats: DiffStats) => void;
-}
-/**
- * WakaDiffViewer -- Visual diff between two document versions.
- *
- * Uses `@platejs/diff` to compute and render differences between
- * two Slate document trees. Supports inline (unified) and
- * side-by-side diff views.
- *
- * Rendering:
- * - Added text is highlighted in green
- * - Removed text is highlighted in red with strikethrough
- * - Modified blocks show both states
- *
- * Useful for:
- * - Specification version comparison (ws-serv-specs)
- * - Audit trail diff review (ws-serv-audit)
- * - Contract amendment review (WakaSign)
- * - Content editorial review (WakaPress)
- *
- * @example
- * ```tsx
- * <WakaDiffViewer
- *   original={previousVersion}
- *   modified={currentVersion}
- *   mode="side-by-side"
- *   showStats
- *   originalLabel="v1.2.0"
- *   modifiedLabel="v1.3.0"
- * />
- * ```
- */
-export declare const WakaDiffViewer: React.ForwardRefExoticComponent<WakaDiffViewerProps & React.RefAttributes<HTMLDivElement>>;
-export {};

package/dist/src/components/editor/waka-dnd-editor.d.ts

@@ -1,64 +0,0 @@
-import * as React from "react";
-type SlateNode = any;
-export interface WakaDnDEditorProps {
-    /** Initial Slate content */
-    value?: SlateNode[];
-    /** Change callback */
-    onChange?: (value: SlateNode[]) => void;
-    /** Read-only mode */
-    readOnly?: boolean;
-    /** Placeholder */
-    placeholder?: string;
-    /** CSS class */
-    className?: string;
-    /** Editor CSS class */
-    editorClassName?: string;
-    /** Minimum height in px */
-    minHeight?: number;
-    /** Label */
-    label?: string;
-    /** Description */
-    description?: string;
-    /** Error */
-    error?: string;
-    /**
-     * Show a drag handle gutter on the left side of each block.
-     * When false, DnD still works but handles are hidden.
-     */
-    showDragHandles?: boolean;
-    /**
-     * Show a drop line indicator when dragging blocks.
-     * Defaults to true.
-     */
-    showDropIndicator?: boolean;
-    /** Extra Plate plugins */
-    extraPlugins?: any[];
-    /** Ref to editor instance */
-    editorRef?: React.MutableRefObject<any>;
-}
-/**
- * WakaDnDEditor -- Plate editor with drag-and-drop block reordering.
- *
- * Users can grab any block by its drag handle and reorder it within
- * the document. Built on top of `@platejs/dnd` and `@dnd-kit`.
- *
- * Includes block selection via `@platejs/selection` so users can
- * select multiple blocks and drag them as a group.
- *
- * Useful for:
- * - Kanban-style content builders
- * - Form builders (WakaStart app wizard)
- * - Reorderable document sections
- * - Spec editor with rearrangeable requirements
- *
- * @example
- * ```tsx
- * <WakaDnDEditor
- *   value={blocks}
- *   onChange={setBlocks}
- *   showDragHandles
- * />
- * ```
- */
-export declare const WakaDnDEditor: React.ForwardRefExoticComponent<WakaDnDEditorProps & React.RefAttributes<HTMLDivElement>>;
-export {};

package/dist/src/components/editor/waka-document-editor.d.ts

@@ -1,92 +0,0 @@
-import * as React from "react";
-type SlateNode = any;
-/** TOC entry extracted from headings */
-export interface TocEntry {
-    id: string;
-    text: string;
-    level: number;
-    depth: number;
-}
-export interface WakaDocumentEditorProps {
-    /** Initial Slate content */
-    value?: SlateNode[];
-    /** Change callback */
-    onChange?: (value: SlateNode[]) => void;
-    /** Read-only mode */
-    readOnly?: boolean;
-    /** Placeholder */
-    placeholder?: string;
-    /** CSS class for the root layout */
-    className?: string;
-    /** CSS class for the editor area */
-    editorClassName?: string;
-    /** Minimum height in px */
-    minHeight?: number;
-    /** Label */
-    label?: string;
-    /** Description */
-    description?: string;
-    /** Error message */
-    error?: string;
-    /** Document title (displayed in the header) */
-    title?: string;
-    /** Callback when title changes */
-    onTitleChange?: (title: string) => void;
-    /** Show TOC sidebar */
-    showTOC?: boolean;
-    /** Enable @mentions */
-    enableMentions?: boolean;
-    /** Mention search function. Returns matching users for a query string. */
-    onMentionSearch?: (query: string) => Promise<Array<{
-        key: string;
-        label: string;
-        avatar?: string;
-    }>>;
-    /** Enable slash commands */
-    enableSlashCommands?: boolean;
-    /** Enable AI features */
-    enableAI?: boolean;
-    /** AI endpoint for AI features */
-    aiEndpoint?: string;
-    /** System prompt for AI */
-    aiSystemPrompt?: string;
-    /** Enable DnD block reordering */
-    enableDnD?: boolean;
-    /** Enable markdown paste support */
-    enableMarkdown?: boolean;
-    /** Extra Plate plugins */
-    extraPlugins?: any[];
-    /** Ref to the editor instance */
-    editorRef?: React.MutableRefObject<any>;
-}
-/**
- * WakaDocumentEditor -- Google-Docs-style full document editor.
- *
- * Features:
- * - Fixed toolbar with formatting controls
- * - Optional TOC sidebar (auto-extracted from headings)
- * - @mentions with async user search
- * - Slash commands (/) for quick block insertion
- * - Drag-and-drop block reordering
- * - AI integration (optional)
- * - Markdown paste support
- *
- * Perfect for writing specifications, proposals, documentation,
- * or any long-form content within WakaStart apps.
- *
- * @example
- * ```tsx
- * <WakaDocumentEditor
- *   title="Architecture Specification"
- *   onTitleChange={setTitle}
- *   showTOC
- *   enableMentions
- *   enableSlashCommands
- *   enableDnD
- *   value={content}
- *   onChange={setContent}
- * />
- * ```
- */
-export declare const WakaDocumentEditor: React.ForwardRefExoticComponent<WakaDocumentEditorProps & React.RefAttributes<HTMLDivElement>>;
-export {};

package/dist/src/components/editor/waka-editor-elements.d.ts

@@ -1,79 +0,0 @@
-import * as React from "react";
-export interface PlateElementProps {
-    attributes?: Record<string, unknown>;
-    children?: React.ReactNode;
-    element?: Record<string, unknown>;
-    className?: string;
-}
-export declare function TableElement({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace TableElement {
-    var displayName: string;
-}
-export declare function TableRowElement({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace TableRowElement {
-    var displayName: string;
-}
-export declare function TableCellElement({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace TableCellElement {
-    var displayName: string;
-}
-export declare function TableCellHeaderElement({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace TableCellHeaderElement {
-    var displayName: string;
-}
-export declare function ColumnGroupElement({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace ColumnGroupElement {
-    var displayName: string;
-}
-export declare function ColumnElement({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace ColumnElement {
-    var displayName: string;
-}
-export declare function CalloutElement({ children, attributes, element, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace CalloutElement {
-    var displayName: string;
-}
-export declare function H1Element({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace H1Element {
-    var displayName: string;
-}
-export declare function H2Element({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace H2Element {
-    var displayName: string;
-}
-export declare function H3Element({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace H3Element {
-    var displayName: string;
-}
-export declare function H4Element({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace H4Element {
-    var displayName: string;
-}
-export declare function H5Element({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace H5Element {
-    var displayName: string;
-}
-export declare function H6Element({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace H6Element {
-    var displayName: string;
-}
-export declare function BlockquoteElement({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace BlockquoteElement {
-    var displayName: string;
-}
-export declare function ParagraphElement({ children, attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace ParagraphElement {
-    var displayName: string;
-}
-export declare function LinkElement({ children, attributes, element, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace LinkElement {
-    var displayName: string;
-}
-export declare function MentionElement({ children, attributes, element, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace MentionElement {
-    var displayName: string;
-}
-export declare function SeparatorElement({ attributes, className }: PlateElementProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace SeparatorElement {
-    var displayName: string;
-}

package/dist/src/components/editor/waka-editor-leaves.d.ts

@@ -1,39 +0,0 @@
-import * as React from "react";
-export interface PlateLeafProps {
-    attributes?: Record<string, unknown>;
-    children?: React.ReactNode;
-    leaf?: Record<string, unknown>;
-    className?: string;
-}
-export declare function BoldLeaf({ children, attributes, className }: PlateLeafProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace BoldLeaf {
-    var displayName: string;
-}
-export declare function ItalicLeaf({ children, attributes, className }: PlateLeafProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace ItalicLeaf {
-    var displayName: string;
-}
-export declare function UnderlineLeaf({ children, attributes, className }: PlateLeafProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace UnderlineLeaf {
-    var displayName: string;
-}
-export declare function StrikethroughLeaf({ children, attributes, className }: PlateLeafProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace StrikethroughLeaf {
-    var displayName: string;
-}
-export declare function CodeLeaf({ children, attributes, className }: PlateLeafProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace CodeLeaf {
-    var displayName: string;
-}
-export declare function HighlightLeaf({ children, attributes, className }: PlateLeafProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace HighlightLeaf {
-    var displayName: string;
-}
-export declare function SuperscriptLeaf({ children, attributes, className }: PlateLeafProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace SuperscriptLeaf {
-    var displayName: string;
-}
-export declare function SubscriptLeaf({ children, attributes, className }: PlateLeafProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace SubscriptLeaf {
-    var displayName: string;
-}

package/dist/src/components/editor/waka-editor-plugins.d.ts

@@ -1,41 +0,0 @@
-import { PlatePlugin } from 'platejs/react';
-/**
- * Dynamically loads the core formatting plugins (marks + block elements).
- * These are always included in the editor.
- */
-export declare function loadCorePlugins(): Promise<PlatePlugin[]>;
-/** Loads the link plugin */
-export declare function loadLinkPlugin(): Promise<PlatePlugin[]>;
-/** Loads media plugins (image, video, embed) */
-export declare function loadMediaPlugins(): Promise<PlatePlugin[]>;
-/** Loads mention plugins */
-export declare function loadMentionPlugins(): Promise<PlatePlugin[]>;
-/** Loads DnD (drag and drop) plugin */
-export declare function loadDndPlugin(): Promise<PlatePlugin[]>;
-/** Loads TOC (table of contents) plugin */
-export declare function loadTocPlugin(): Promise<PlatePlugin[]>;
-/** Loads indent plugin */
-export declare function loadIndentPlugin(): Promise<PlatePlugin[]>;
-/** Loads markdown serialization plugin */
-export declare function loadMarkdownPlugin(): Promise<PlatePlugin[]>;
-/** Loads selection plugin */
-export declare function loadSelectionPlugin(): Promise<PlatePlugin[]>;
-/** Loads AI plugins (AI menu + AI chat) */
-export declare function loadAIPlugins(options?: {
-    endpoint?: string;
-    systemPrompt?: string;
-    headers?: Record<string, string>;
-}): Promise<PlatePlugin[]>;
-/** Loads emoji plugin */
-export declare function loadEmojiPlugin(): Promise<PlatePlugin[]>;
-/** Loads floating toolbar plugin */
-export declare function loadFloatingPlugin(): Promise<PlatePlugin[]>;
-/** Loads diff plugin for document comparison */
-export declare function loadDiffPlugin(): Promise<PlatePlugin[]>;
-/** Loads combobox/slash-command plugins */
-export declare function loadComboboxPlugins(): Promise<PlatePlugin[]>;
-export type WakaEditorPreset = "minimal" | "standard" | "full";
-/**
- * Returns the list of optional plugin loaders based on a named preset.
- */
-export declare function getPresetLoaders(preset: WakaEditorPreset): (typeof loadLinkPlugin)[];

package/dist/src/components/editor/waka-editor-toolbar.d.ts

@@ -1,20 +0,0 @@
-export type ToolbarAction = "bold" | "italic" | "underline" | "strikethrough" | "code" | "highlight" | "h1" | "h2" | "h3" | "blockquote" | "callout" | "table" | "columns" | "link" | "image" | "separator" | "ai";
-/** A group of toolbar buttons rendered together with separators between groups */
-export type ToolbarGroup = ToolbarAction[];
-export interface WakaEditorToolbarProps {
-    /** Button groups to render */
-    groups?: ToolbarGroup[];
-    /** The Plate editor instance (typed as unknown to avoid tight coupling) */
-    editor: unknown;
-    /** Extra CSS class names */
-    className?: string;
-    /** Whether to show AI button */
-    enableAI?: boolean;
-    /** Callback when AI button is clicked */
-    onAIClick?: () => void;
-}
-export declare const DEFAULT_TOOLBAR_GROUPS: ToolbarGroup[];
-export declare function WakaEditorToolbar({ groups, editor, className, enableAI, onAIClick, }: WakaEditorToolbarProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace WakaEditorToolbar {
-    var displayName: string;
-}

package/dist/src/components/editor/waka-editor.d.ts

@@ -1,59 +0,0 @@
-import { ToolbarGroup } from './waka-editor-toolbar';
-import { WakaEditorPreset } from './waka-editor-plugins';
-import * as React from "react";
-/**
- * Slate/Plate node type. Using a generic type to avoid tight coupling
- * with Plate internals while remaining compatible.
- */
-export type SlateNode = any;
-export interface WakaEditorProps {
-    /** Initial content as Slate value */
-    value?: SlateNode[];
-    /** Change callback with updated Slate value */
-    onChange?: (value: SlateNode[]) => void;
-    /** Read-only mode */
-    readOnly?: boolean;
-    /** Placeholder text */
-    placeholder?: string;
-    /** Extra CSS class names on the root container */
-    className?: string;
-    /** Extra CSS class names on the editable area */
-    editorClassName?: string;
-    /** Minimum height of the editable area in px */
-    minHeight?: number;
-    /** Label displayed above the editor */
-    label?: string;
-    /** Description displayed below the label */
-    description?: string;
-    /** Error message */
-    error?: string;
-    /** Named preset: "minimal" | "standard" | "full" (default: "standard") */
-    preset?: WakaEditorPreset;
-    /** Show AI assistant button in toolbar */
-    enableAI?: boolean;
-    /** Enable Yjs collaboration (not yet implemented) */
-    enableCollaboration?: boolean;
-    /** Enable inline comments (not yet implemented) */
-    enableComments?: boolean;
-    /** Enable markdown import/export */
-    enableMarkdown?: boolean;
-    /** Enable image and video embeds */
-    enableMedia?: boolean;
-    /** Enable @mentions */
-    enableMentions?: boolean;
-    /** Enable drag-and-drop reordering */
-    enableDnD?: boolean;
-    /** Enable table of contents generation */
-    enableTOC?: boolean;
-    /** Custom toolbar groups (overrides preset defaults) */
-    toolbarGroups?: ToolbarGroup[];
-    /** Hide the toolbar entirely */
-    hideToolbar?: boolean;
-    /** Callback when AI button is clicked */
-    onAIClick?: () => void;
-    /** Extra Plate plugins to add on top of the preset */
-    extraPlugins?: any[];
-    /** Ref to the internal Plate editor instance */
-    editorRef?: React.MutableRefObject<any>;
-}
-export declare const WakaEditor: React.ForwardRefExoticComponent<WakaEditorProps & React.RefAttributes<HTMLDivElement>>;

package/dist/src/components/editor/waka-floating-toolbar.d.ts

@@ -1,53 +0,0 @@
-import { LucideIcon } from 'lucide-react';
-import * as React from "react";
-/** A button definition for the floating toolbar */
-export interface FloatingToolbarButton {
-    key: string;
-    icon: LucideIcon;
-    label: string;
-    shortcut?: string;
-    /** Execute the action on the editor */
-    action: (editor: any) => void;
-    /** Check if this mark/block is active */
-    isActive?: (editor: any) => boolean;
-}
-export interface WakaFloatingToolbarProps {
-    /** The Plate editor instance */
-    editor: unknown;
-    /** Additional buttons to display */
-    buttons?: FloatingToolbarButton[];
-    /** Whether to show the AI "Ask AI" button */
-    enableAI?: boolean;
-    /** Callback when AI button is clicked */
-    onAIClick?: () => void;
-    /** CSS class */
-    className?: string;
-    /** Whether to show in read-only mode */
-    showWhenReadOnly?: boolean;
-    /**
-     * Skip the runtime lazy-load of `@platejs/floating` and render a static
-     * (non-positioned) toolbar. Useful in stories/tests where no Plate editor
-     * is available and `useFloatingToolbar` would crash on the mock editor.
-     */
-    disableFloating?: boolean;
-}
-/** Default floating toolbar buttons */
-export declare const DEFAULT_FLOATING_BUTTONS: FloatingToolbarButton[];
-/**
- * WakaFloatingToolbar -- Floating contextual toolbar that appears on text selection.
- *
- * This component should be placed **inside** a `<Plate>` context. It uses
- * `@platejs/floating`'s `useFloatingToolbar` hook internally when available,
- * or falls back to a static inline toolbar.
- *
- * For the floating behavior to work, the app must install `@platejs/floating`.
- *
- * @example
- * ```tsx
- * <Plate editor={editor}>
- *   <WakaFloatingToolbar editor={editor} enableAI onAIClick={handleAI} />
- *   <PlateContent />
- * </Plate>
- * ```
- */
-export declare const WakaFloatingToolbar: React.ForwardRefExoticComponent<WakaFloatingToolbarProps & React.RefAttributes<HTMLDivElement>>;

package/dist/src/components/editor/waka-markdown-editor.d.ts

@@ -1,60 +0,0 @@
-import * as React from "react";
-type SlateNode = any;
-export type MarkdownEditorMode = "rich" | "markdown" | "split";
-export interface WakaMarkdownEditorProps {
-    /** Markdown string content */
-    markdownValue?: string;
-    /** Callback when markdown content changes */
-    onMarkdownChange?: (markdown: string) => void;
-    /** Slate value (for rich text mode) */
-    slateValue?: SlateNode[];
-    /** Callback when slate value changes */
-    onSlateChange?: (value: SlateNode[]) => void;
-    /** Initial view mode */
-    defaultMode?: MarkdownEditorMode;
-    /** Read-only mode */
-    readOnly?: boolean;
-    /** Placeholder */
-    placeholder?: string;
-    /** CSS class */
-    className?: string;
-    /** Editor area CSS class */
-    editorClassName?: string;
-    /** Minimum height in px */
-    minHeight?: number;
-    /** Label */
-    label?: string;
-    /** Description */
-    description?: string;
-    /** Error */
-    error?: string;
-    /** Extra Plate plugins */
-    extraPlugins?: any[];
-    /** Ref to editor instance */
-    editorRef?: React.MutableRefObject<any>;
-}
-/**
- * WakaMarkdownEditor -- Dual-mode rich text / Markdown editor.
- *
- * Transparently syncs content between Plate (rich text) and raw Markdown.
- * Supports three view modes:
- * - `rich`: WYSIWYG Plate editor (default)
- * - `markdown`: Raw Markdown textarea with monospace font
- * - `split`: Side-by-side Plate + Markdown preview
- *
- * Uses `@platejs/markdown` for serialization/deserialization.
- *
- * Perfect for developer documentation, README editors,
- * or any context where users need to switch between rich text and Markdown.
- *
- * @example
- * ```tsx
- * <WakaMarkdownEditor
- *   markdownValue={md}
- *   onMarkdownChange={setMd}
- *   defaultMode="split"
- * />
- * ```
- */
-export declare const WakaMarkdownEditor: React.ForwardRefExoticComponent<WakaMarkdownEditorProps & React.RefAttributes<HTMLDivElement>>;
-export {};