arxatec-ui 0.1.0 → 0.1.2

package/README.md

@@ -1,73 +1,136 @@
-# React + TypeScript + Vite
+# arxatec-ui
 
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+React component kit for **Arxatec** products: primitives built on **Radix UI**, styling with **Tailwind CSS v4**, animations, and ready-made pieces for forms, data, maps, and more.
 
-Currently, two official plugins are available:
+## Requirements
 
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Oxc](https://oxc.rs)
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/)
+- **React** 18 or 19 (`react` and `react-dom` are *peer dependencies*).
+- A bundler that supports **ESM** (recommended: **Vite**).
+- **Tailwind CSS v4** and the **`@tailwindcss/vite`** plugin (or an equivalent pipeline that processes the library stylesheet).
 
-## React Compiler
+## Installation
 
-The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+```bash
+npm install arxatec-ui
+```
 
-## Expanding the ESLint configuration
+Make sure React is installed in your app:
 
-If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:
+```bash
+npm install react react-dom
+```
 
-```js
-export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
+## Global styles
 
-      // Remove tseslint.configs.recommended and replace with this
-      tseslint.configs.recommendedTypeChecked,
-      // Alternatively, use this for stricter rules
-      tseslint.configs.strictTypeChecked,
-      // Optionally, add this for stylistic rules
-      tseslint.configs.stylisticTypeChecked,
+The package exposes a single stylesheet (theme tokens, Tailwind, shadcn-style utilities):
 
-      // Other configs...
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
-    },
-  },
-])
+```ts
+// e.g. in main.tsx or App.tsx
+import "arxatec-ui/styles.css";
 ```
 
-You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:
-
-```js
-// eslint.config.js
-import reactX from 'eslint-plugin-react-x'
-import reactDom from 'eslint-plugin-react-dom'
-
-export default defineConfig([
-  globalIgnores(['dist']),
-  {
-    files: ['**/*.{ts,tsx}'],
-    extends: [
-      // Other configs...
-      // Enable lint rules for React
-      reactX.configs['recommended-typescript'],
-      // Enable lint rules for React DOM
-      reactDom.configs.recommended,
-    ],
-    languageOptions: {
-      parserOptions: {
-        project: ['./tsconfig.node.json', './tsconfig.app.json'],
-        tsconfigRootDir: import.meta.dirname,
-      },
-      // other options...
-    },
-  },
-])
+That CSS uses Tailwind v4 features (`@import "tailwindcss"`, `@theme`, etc.). Your build **must process** it with Tailwind (serving the raw file without compiling is not enough).
+
+### Vite + Tailwind v4
+
+1. Install Tailwind and the official Vite plugin:
+
+   ```bash
+   npm install tailwindcss @tailwindcss/vite
+   ```
+
+2. In `vite.config.ts`:
+
+   ```ts
+   import tailwindcss from "@tailwindcss/vite";
+   import { defineConfig } from "vite";
+
+   export default defineConfig({
+     plugins: [tailwindcss()],
+   });
+   ```
+
+3. If production builds **drop classes** that only appear inside `node_modules/arxatec-ui`, point Tailwind at the library’s compiled JS, for example in your entry CSS (Tailwind v4):
+
+   ```css
+   @source "../../node_modules/arxatec-ui/dist/**/*.js";
+   ```
+
+   Adjust the path relative to your CSS file.
+
+### Dark mode
+
+The theme expects a **`.dark`** ancestor (e.g. `className="dark"` on `<html>`).
+
+## Basic usage
+
+```tsx
+import { Button, Card, CardHeader, CardTitle, CardContent } from "arxatec-ui";
+
+export function Example() {
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle>Hello</CardTitle>
+      </CardHeader>
+      <CardContent>
+        <Button>Action</Button>
+      </CardContent>
+    </Card>
+  );
+}
 ```
+
+Patterns follow **shadcn**-style APIs (compound components with named exports).
+
+## Package exports
+
+### Components (overview)
+
+- **Forms & text:** `Button`, `Input`, `Textarea`, `Label`, `Checkbox`, `RadioGroup`, `Select`, `Slider`, `Toggle`, `InputOTP`, `FileDropZone`, `LocationInput`, `DateRangePicker`, `Calendar`, `AsyncSelect`, and more.
+- **Surfaces & navigation:** `Card`, `Dialog`, `Sheet`, `Drawer`, `Popover`, `Tooltip`, `DropdownMenu`, `ContextMenu`, `Tabs`, `Breadcrumb`, `Pagination`, `PaginationController`, `Sidebar`, `Command`, `Collapsible`, and more.
+- **Data & feedback:** `Table`, `Badge`, `Skeleton`, `Progress`, `StatusMessage`, `AsyncBoundary`, `AsyncCommandList`, `Chart`, `Carousel`, and more.
+- **Maps:** `MapView`, `MapPicker`.
+- **Extras:** `Toaster` (Sonner), `IconPicker`, `EmojiPicker`, brand icons, animated icons, etc.
+
+The full list matches the `export *` entries in [`src/index.ts`](./src/index.ts).
+
+### Hooks
+
+- **`useDebounce`**
+
+### Types
+
+- **`PaginationState`**: `{ page, limit, total, total_pages }` (useful with `PaginationController`).
+
+### Utilities
+
+- **`cn`**: class merging (`clsx` + `tailwind-merge`).
+- Image crop helpers for `ImageCropDialog`.
+- **`classNameControl`**: optional **Storybook** control metadata.
+
+## Toasts (Sonner)
+
+Render **`Toaster`** once near the app root and call `toast(...)` per the **sonner** docs.
+
+## Maps (Leaflet)
+
+```ts
+import "leaflet/dist/leaflet.css";
+```
+
+## Developing this repo
+
+| Command | Description |
+|--------|-------------|
+| `npm run dev` | Vite playground (style guide). |
+| `npm run storybook` | Storybook on port 6006. |
+| `npm run build:lib` | Build `dist/` for npm. |
+| `npm run build` | Playground production build. |
+| `npm run lint` | ESLint. |
+
+Publishing to npm requires **2FA**; use `npm publish --otp=...` when prompted.
+
+## License
+
+MIT. See [LICENSE](./LICENSE).

package/dist/arxatec-ui.css

@@ -0,0 +1,2 @@
+:root{--editor-text-default:#09090b;--editor-text-gray:#71717a;--editor-text-brown:#f97415;--editor-text-orange:#f97015;--editor-text-yellow:#facc14;--editor-text-green:#21c45d;--editor-text-blue:#2463eb;--editor-text-purple:#d8b4fe;--editor-text-pink:#ea3e83;--editor-text-red:#ef4343;--editor-bg-default:#fff;--editor-bg-subtle:#fafafa;--editor-bg-muted:#f4f4f5;--editor-highlight-default:#fafafa;--editor-highlight-gray:#f4f4f5;--editor-highlight-brown:#fff9eb;--editor-highlight-orange:#fff6eb;--editor-highlight-yellow:#fffdeb;--editor-highlight-green:#eefcf3;--editor-highlight-blue:#ecf3fe;--editor-highlight-purple:#f4ebff;--editor-highlight-pink:#fdedf3;--editor-highlight-red:#fdecec;--editor-border-default:#dfdfe2;--editor-border-strong:#a1a1aa;--editor-spacing-1:.25rem;--editor-spacing-2:.5rem;--editor-spacing-3:.75rem;--editor-spacing-4:1rem;--editor-spacing-6:1.5rem;--editor-spacing-8:2rem;--editor-spacing-12:3rem;--editor-spacing-16:4rem;--editor-font-sans:system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;--editor-font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;--editor-font-serif:Georgia, Cambria, "Times New Roman", Times, serif;--editor-transition-fast:.15s cubic-bezier(.4, 0, .2, 1);--editor-transition-normal:.2s cubic-bezier(.4, 0, .2, 1);--editor-transition-slow:.3s cubic-bezier(.4, 0, .2, 1);--editor-shadow-sm:0 1px 2px 0 #0000000d;--editor-shadow-md:0 4px 6px -1px #0000001a, 0 2px 4px -2px #0000001a;--editor-shadow-lg:0 10px 15px -3px #0000001a, 0 4px 6px -4px #0000001a}.dark{--editor-text-default:#fafafa;--editor-text-gray:#a1a1aa;--editor-text-brown:#f97415;--editor-text-orange:#f97015;--editor-text-yellow:#facc14;--editor-text-green:#21c45d;--editor-text-blue:#2463eb;--editor-text-purple:#d8b4fe;--editor-text-pink:#ea3e83;--editor-text-red:#ef4343;--editor-bg-default:#09090b;--editor-bg-subtle:#27272a;--editor-bg-muted:#3f3f46;--editor-highlight-default:#27272a;--editor-highlight-gray:#3f3f46;--editor-highlight-brown:#322401;--editor-highlight-orange:#331c00;--editor-highlight-yellow:#332e00;--editor-highlight-green:#072c15;--editor-highlight-blue:#021431;--editor-highlight-purple:#190132;--editor-highlight-pink:#2e0515;--editor-highlight-red:#2f0404;--editor-border-default:#3f3f46;--editor-border-strong:#a1a1aa}.ProseMirror{caret-color:var(--editor-text-default);padding:var(--editor-spacing-16) var(--editor-spacing-8);max-width:90ch;font-family:var(--editor-font-sans);color:var(--editor-text-default);text-rendering:optimizelegibility;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;outline:none;min-height:100vh;margin:0 auto;position:relative}.is-expanded .ProseMirror{max-width:1050px}.ProseMirror:focus{box-shadow:none;outline:none}.ProseMirror .selection{background-color:var(--editor-highlight-blue)}.ProseMirror ::selection{background-color:var(--editor-highlight-blue)}.ProseMirror>.react-renderer{margin:var(--editor-spacing-12) 0;transition:all var(--editor-transition-normal)}.ProseMirror>.react-renderer:first-child{margin-top:0}.ProseMirror>.react-renderer:last-child{margin-bottom:0}.ProseMirror p{margin:var(--editor-spacing-4) 0;color:var(--editor-text-default);font-size:1.125rem;line-height:1.75}.ProseMirror>p{margin:var(--editor-spacing-6) 0}.ProseMirror h1,.ProseMirror h2,.ProseMirror h3,.ProseMirror h4{font-family:var(--editor-font-sans);letter-spacing:-.025em;color:var(--editor-text-default);scroll-margin-top:var(--editor-spacing-16);font-weight:700;line-height:1.2}.ProseMirror h1{margin:var(--editor-spacing-8) 0 var(--editor-spacing-4);font-size:2.5rem}.ProseMirror h2{margin:var(--editor-spacing-8) 0 var(--editor-spacing-4);font-size:2rem}.ProseMirror h3{margin:var(--editor-spacing-6) 0 var(--editor-spacing-3);font-size:1.5rem}.ProseMirror h4{margin:var(--editor-spacing-4) 0 var(--editor-spacing-2);font-size:1.25rem}.ProseMirror a{color:var(--editor-text-blue);cursor:pointer;text-underline-offset:.2em;transition:all var(--editor-transition-fast);text-decoration:underline;text-decoration-thickness:.1em}.ProseMirror a:hover{color:var(--editor-text-blue);text-decoration-thickness:.2em}.ProseMirror code{font-family:var(--editor-font-mono);background-color:var(--editor-bg-muted);color:var(--editor-text-default);border:1px solid var(--editor-border-default);border-radius:4px;padding:.2em .4em;font-size:.9em}.ProseMirror pre{margin:var(--editor-spacing-6) 0;padding:var(--editor-spacing-4);background-color:var(--editor-bg-subtle);border:1px solid var(--editor-border-default);border-radius:8px;overflow-x:auto}.ProseMirror pre code{color:var(--editor-text-default);background-color:#0000;border:none;padding:0;font-size:.875rem;line-height:1.7}.ProseMirror blockquote{margin:var(--editor-spacing-6) 0;padding:var(--editor-spacing-4) var(--editor-spacing-6);border-left:4px solid var(--editor-border-strong);color:var(--editor-text-gray);background-color:var(--editor-bg-subtle);border-radius:0 8px 8px 0;font-style:italic}.ProseMirror ul,.ProseMirror ol{margin:var(--editor-spacing-4) 0;padding-left:var(--editor-spacing-6)}.ProseMirror li{margin:var(--editor-spacing-2) 0;padding-left:var(--editor-spacing-2)}.ProseMirror ul{list-style-type:disc}.ProseMirror ul ul{list-style-type:circle}.ProseMirror ul ul ul{list-style-type:square}.ProseMirror ol{list-style-type:decimal}.ProseMirror ol ol{list-style-type:lower-alpha}.ProseMirror ol ol ol{list-style-type:lower-roman}.ProseMirror table{border-collapse:separate;border-spacing:0;width:100%;margin:var(--editor-spacing-6) 0;border:1px solid var(--editor-border-default);border-radius:8px;overflow:hidden}.ProseMirror th{background-color:var(--editor-bg-subtle);text-align:left;padding:var(--editor-spacing-3) var(--editor-spacing-4);border-bottom:2px solid var(--editor-border-default);font-weight:600}.ProseMirror td{padding:var(--editor-spacing-3) var(--editor-spacing-4);border-bottom:1px solid var(--editor-border-default);transition:background-color var(--editor-transition-fast)}.ProseMirror tr:last-child td{border-bottom:none}.ProseMirror tr:hover td{background-color:var(--editor-bg-subtle)}.ProseMirror img{border:1px solid var(--editor-border-default);max-width:100%;height:auto;box-shadow:var(--editor-shadow-sm);transition:all var(--editor-transition-normal);border-radius:8px;display:block}.ProseMirror img:hover{box-shadow:var(--editor-shadow-lg);transform:translateY(-2px)}.ProseMirror .image-wrapper{margin:var(--editor-spacing-4) 0;flex-direction:column;display:flex}.ProseMirror .image-wrapper.align-left{align-items:flex-start}.ProseMirror .image-wrapper.align-center{align-items:center}.ProseMirror .image-wrapper.align-right{align-items:flex-end}.ProseMirror hr{margin:var(--editor-spacing-8) 0;border:none;border-top:2px solid var(--editor-border-default)}.floating-menu{background-color:var(--editor-bg-default);border:1px solid var(--editor-border-default);box-shadow:var(--editor-shadow-lg);padding:var(--editor-spacing-1);gap:var(--editor-spacing-1);animation:fadeIn var(--editor-transition-normal);-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px);border-radius:8px;align-items:center;display:flex}.toolbar-button{height:2.25rem;padding:0 var(--editor-spacing-3);transition:all var(--editor-transition-fast);color:var(--editor-text-default);background-color:#0000;border:1px solid #0000;border-radius:6px;justify-content:center;align-items:center;font-size:.875rem;font-weight:500;display:inline-flex}.toolbar-button:hover{background-color:var(--editor-bg-subtle);color:var(--editor-text-default)}.toolbar-button:focus-visible{box-shadow:0 0 0 2px var(--editor-border-strong);outline:none}.toolbar-button:disabled{opacity:.5;cursor:not-allowed}.toolbar-button.active{background-color:var(--editor-bg-muted);color:var(--editor-text-blue)}@media (width<=640px){.ProseMirror{padding:var(--editor-spacing-8) var(--editor-spacing-4)}.ProseMirror h1{font-size:2rem}.ProseMirror h2{font-size:1.75rem}.ProseMirror h3{font-size:1.5rem}.ProseMirror h4{font-size:1.25rem}.ProseMirror p{font-size:1rem}}@keyframes fadeIn{0%{opacity:0;transform:translateY(-8px)}to{opacity:1;transform:translateY(0)}}@media print{.ProseMirror{max-width:none;padding:0}.floating-menu,.toolbar-button{display:none}}.is-editor-empty:before{color:var(--editor-text-gray);content:attr(data-placeholder);float:left;pointer-events:none;height:0}
+/*$vite$:1*/

package/dist/components/date_range_picker/index.d.ts

@@ -8,4 +8,4 @@ interface Props {
     optional?: boolean;
 }
 export declare const DateRangePicker: ({ startDate, dueDate, onStartDateChange, onDueDateChange, errorMessage, label, optional, }: Props) => import("react/jsx-runtime").JSX.Element;
-export {};
+export { DateDisplay, DateInput, DatePanel } from './components';

package/dist/components/description_markdown_editor/components/index.d.ts

@@ -0,0 +1 @@
+export * from './toolbar_button';

package/dist/components/description_markdown_editor/components/toolbar_button/index.d.ts

@@ -0,0 +1,12 @@
+import { Editor } from '@tiptap/react';
+interface Props {
+    editor: Editor | null;
+    onClick: (editor: Editor) => void;
+    isActive: (editor: Editor) => boolean;
+    canDo: (editor: Editor) => boolean;
+    icon: React.ElementType;
+    label: string;
+    className?: string;
+}
+export declare const ToolbarButton: React.FC<Props>;
+export {};

package/dist/components/description_markdown_editor/index.d.ts

@@ -0,0 +1,17 @@
+export interface DescriptionMarkdownEditorRef {
+    insertContent: (text: string) => void;
+    clearContent: () => void;
+}
+interface DescriptionMarkdownEditorProps {
+    value: string;
+    onChange: (markdown: string) => void;
+    placeholder?: string;
+    onSubmit?: () => void;
+    onEscape?: () => void;
+    className?: string;
+    editorClassName?: string;
+    disabled?: boolean;
+    footer?: React.ReactNode;
+}
+export declare const DescriptionMarkdownEditor: import('react').ForwardRefExoticComponent<DescriptionMarkdownEditorProps & import('react').RefAttributes<DescriptionMarkdownEditorRef>>;
+export {};

package/dist/components/description_markdown_editor/utils/index.d.ts

@@ -0,0 +1,6 @@
+export declare function parseMarkdownToHtml(markdown: string): string;
+/**
+ * Párrafos vacíos no sobreviven al ciclo HTML → turndown → marked.
+ * Sustituirlos por ZWCSP permite round‑trip estable del markdown persistido.
+ */
+export declare function htmlForMarkdownExport(html: string): string;

package/dist/components/form_input/index.d.ts

@@ -0,0 +1,15 @@
+import { FieldErrors, FieldValues, Path, UseFormRegister } from 'react-hook-form';
+interface Props<T extends FieldValues> {
+    label?: string;
+    name: Path<T>;
+    type?: string;
+    placeholder?: string;
+    register: UseFormRegister<T>;
+    errors: FieldErrors<T>;
+    className?: string;
+    optional?: boolean;
+    disabled?: boolean;
+    size?: "default" | "sm";
+}
+export declare function FormInput<T extends FieldValues>({ label, name, type, placeholder, register, errors, className, optional, disabled, size, }: Props<T>): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/form_select/index.d.ts

@@ -0,0 +1,25 @@
+import { ReactNode } from 'react';
+import { Control, FieldErrors, FieldValues } from 'react-hook-form';
+interface FormSelectProps {
+    name: string;
+    label: string;
+    control: Control<any & FieldValues>;
+    options: {
+        value: string;
+        label: string;
+    }[];
+    placeholder?: string;
+    className?: string;
+    errors?: FieldErrors<any & FieldValues>;
+    renderItem?: (option: {
+        value: string;
+        label: string;
+    }) => ReactNode;
+    children?: (option: {
+        value: string;
+        label: string;
+    }) => ReactNode;
+    size?: "default" | "sm";
+}
+export declare const FormSelect: React.FC<FormSelectProps>;
+export {};

package/dist/components/form_textarea/index.d.ts

@@ -0,0 +1,14 @@
+import { FieldErrors, FieldValues, Path, UseFormRegister } from 'react-hook-form';
+interface Props<T extends FieldValues> extends React.ComponentProps<"textarea"> {
+    label?: string;
+    name: Path<T>;
+    type?: string;
+    placeholder?: string;
+    register: UseFormRegister<T>;
+    errors: FieldErrors<T>;
+    className?: string;
+    optional?: boolean;
+    autoFocus?: boolean;
+}
+export declare function FormTextarea<T extends FieldValues>({ label, name, placeholder, register, errors, className, optional, autoFocus, ...props }: Props<T>): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/rich_text_editor/components/document_dialog/index.d.ts

@@ -0,0 +1,8 @@
+interface Props {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onSave: (name: string) => Promise<void>;
+    isSaving?: boolean;
+}
+export declare function SaveDocumentNameDialog({ open, onOpenChange, onSave, isSaving, }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/rich_text_editor/components/index.d.ts

@@ -0,0 +1 @@
+export * from './document_dialog';

package/dist/components/rich_text_editor/extensions/floating_menu/index.d.ts

@@ -0,0 +1,4 @@
+import { Editor } from '@tiptap/core';
+export declare function TipTapFloatingMenu({ editor }: {
+    editor: Editor;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/components/rich_text_editor/extensions/floating_toolbar/index.d.ts

@@ -0,0 +1,4 @@
+import { Editor } from '@tiptap/core';
+export declare function FloatingToolbar({ editor }: {
+    editor: Editor | null;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/rich_text_editor/extensions/image/image-extension.d.ts

@@ -0,0 +1 @@
+export declare const ImageExtension: import('@tiptap/core').Node<import('@tiptap/extension-image').ImageOptions, any>;

package/dist/components/rich_text_editor/extensions/image/index.d.ts

@@ -0,0 +1 @@
+export { ImageExtension } from './image-extension';

package/dist/components/rich_text_editor/extensions/image/tiptap-image.d.ts

@@ -0,0 +1,2 @@
+import { NodeViewProps } from '@tiptap/react';
+export declare function TiptapImage(props: NodeViewProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/rich_text_editor/extensions/image_placeholder/index.d.ts

@@ -0,0 +1,17 @@
+import { Node } from '@tiptap/react';
+export interface ImagePlaceholderOptions {
+    HTMLAttributes: Record<string, unknown>;
+    onUpload?: (url: string) => void;
+    onError?: (error: string) => void;
+}
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        imagePlaceholder: {
+            /**
+             * Inserts an image placeholder
+             */
+            insertImagePlaceholder: () => ReturnType;
+        };
+    }
+}
+export declare const ImagePlaceholder: Node<ImagePlaceholderOptions, any>;

package/dist/components/rich_text_editor/extensions/index.d.ts

@@ -0,0 +1,5 @@
+export * from './floating_menu';
+export * from './floating_toolbar';
+export * from './image';
+export * from './image_placeholder';
+export * from './search_and_replace';

package/dist/components/rich_text_editor/extensions/search_and_replace/index.d.ts

@@ -0,0 +1,54 @@
+import { Extension, Range } from '@tiptap/core';
+import { PluginKey } from '@tiptap/pm/state';
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        search: {
+            /**
+             * @description Set search term in extension.
+             */
+            setSearchTerm: (searchTerm: string) => ReturnType;
+            /**
+             * @description Set replace term in extension.
+             */
+            setReplaceTerm: (replaceTerm: string) => ReturnType;
+            /**
+             * @description Replace first instance of search result with given replace term.
+             */
+            replace: () => ReturnType;
+            /**
+             * @description Replace all instances of search result with given replace term.
+             */
+            replaceAll: () => ReturnType;
+            /**
+             * @description Select the next search result.
+             */
+            selectNextResult: () => ReturnType;
+            /**
+             * @description Select the previous search result.
+             */
+            selectPreviousResult: () => ReturnType;
+            /**
+             * @description Set case sensitivity in extension.
+             */
+            setCaseSensitive: (caseSensitive: boolean) => ReturnType;
+        };
+    }
+}
+export declare const searchAndReplacePluginKey: PluginKey<any>;
+export interface SearchAndReplaceOptions {
+    searchResultClass: string;
+    selectedResultClass: string;
+    disableRegex: boolean;
+}
+export interface SearchAndReplaceStorage {
+    searchTerm: string;
+    replaceTerm: string;
+    results: Range[];
+    lastSearchTerm: string;
+    selectedResult: number;
+    lastSelectedResult: number;
+    caseSensitive: boolean;
+    lastCaseSensitiveState: boolean;
+}
+export declare const SearchAndReplace: Extension<SearchAndReplaceOptions, SearchAndReplaceStorage>;
+export default SearchAndReplace;

package/dist/components/rich_text_editor/index.d.ts

@@ -0,0 +1,13 @@
+import { JSONContent } from '@tiptap/core';
+export interface RichTextEditorRef {
+    save: () => Promise<void>;
+    isDirty: boolean;
+    fileId: string | undefined;
+}
+export declare const RichTextEditor: import('react').ForwardRefExoticComponent<{
+    className?: string;
+    fileId?: string;
+    /** Si se define, el botón "Guardar" persistirá el documento vía este callback. */
+    onSave?: (schema: JSONContent) => Promise<void>;
+    onSaveSuccess?: () => void;
+} & import('react').RefAttributes<RichTextEditorRef>>;

package/dist/components/rich_text_editor/lib/tiptap-utils.d.ts

@@ -0,0 +1,15 @@
+import { Editor } from '@tiptap/core';
+import { Selection } from '@tiptap/pm/state';
+/**
+ * Gets the bounding rectangle of the current selection in the editor.
+ * Uses the native DOM selection for more reliable results with portaled elements.
+ */
+export declare const getSelectionBoundingRect: (editor: Editor) => DOMRect | null;
+/**
+ * Checks if the current selection is valid for showing floating elements.
+ */
+export declare const isSelectionValid: (editor: Editor, selection?: Selection, excludedNodeTypes?: string[]) => boolean;
+/**
+ * Checks if the current text selection is valid for editing.
+ */
+export declare const isTextSelectionValid: (editor: Editor) => boolean;

package/dist/components/rich_text_editor/toolbars/alignment/index.d.ts

@@ -0,0 +1 @@
+export declare const AlignmentToolbar: () => import("react/jsx-runtime").JSX.Element;

package/dist/components/rich_text_editor/toolbars/blockquote/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const BlockquoteToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { BlockquoteToolbar };

package/dist/components/rich_text_editor/toolbars/bold/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const BoldToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { BoldToolbar };

package/dist/components/rich_text_editor/toolbars/bullet_list/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const BulletListToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { BulletListToolbar };

package/dist/components/rich_text_editor/toolbars/code/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const CodeToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { CodeToolbar };

package/dist/components/rich_text_editor/toolbars/code_block/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const CodeBlockToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { CodeBlockToolbar };

package/dist/components/rich_text_editor/toolbars/color_and_highlight/index.d.ts

@@ -0,0 +1 @@
+export declare const ColorHighlightToolbar: () => import("react/jsx-runtime").JSX.Element;

package/dist/components/rich_text_editor/toolbars/editor_toolbar/index.d.ts

@@ -0,0 +1,7 @@
+import { Editor } from '@tiptap/core';
+export declare const EditorToolbar: ({ editor, isExpanded, onToggleExpand, rightContent, }: {
+    editor: Editor;
+    isExpanded?: boolean;
+    onToggleExpand?: () => void;
+    rightContent?: React.ReactNode;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/components/rich_text_editor/toolbars/hard_break/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const HardBreakToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { HardBreakToolbar };

package/dist/components/rich_text_editor/toolbars/headings/index.d.ts

@@ -0,0 +1,2 @@
+import { default as React } from 'react';
+export declare const HeadingsToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;

package/dist/components/rich_text_editor/toolbars/horizontal_rule/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const HorizontalRuleToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { HorizontalRuleToolbar };

package/dist/components/rich_text_editor/toolbars/image_placeholder_toolbar/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const ImagePlaceholderToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { ImagePlaceholderToolbar };

package/dist/components/rich_text_editor/toolbars/index.d.ts

@@ -0,0 +1,22 @@
+export * from './alignment';
+export * from './blockquote';
+export * from './bold';
+export * from './bullet_list';
+export * from './code';
+export * from './code_block';
+export * from './color_and_highlight';
+export * from './editor_toolbar';
+export * from './hard_break';
+export * from './headings';
+export * from './horizontal_rule';
+export * from './image_placeholder_toolbar';
+export * from './italic';
+export * from './link';
+export * from './mobile_toolbar_group';
+export * from './ordered_list';
+export * from './redo';
+export * from './search_and_replace_toolbar';
+export * from './strikethrough';
+export * from './toolbar_provider';
+export * from './underline';
+export * from './undo';

package/dist/components/rich_text_editor/toolbars/italic/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const ItalicToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { ItalicToolbar };

package/dist/components/rich_text_editor/toolbars/link/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const LinkToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { LinkToolbar };

package/dist/components/rich_text_editor/toolbars/mobile_toolbar_group/index.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+interface MobileToolbarGroupProps {
+    label: string;
+    children: React.ReactNode;
+    className?: string;
+}
+export declare const MobileToolbarGroup: ({ label, children, className, }: MobileToolbarGroupProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MobileToolbarItem: ({ children, active, onClick, closeDrawer, ...props }: React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    active?: boolean;
+    closeDrawer?: () => void;
+}) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/rich_text_editor/toolbars/ordered_list/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const OrderedListToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { OrderedListToolbar };

package/dist/components/rich_text_editor/toolbars/redo/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const RedoToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { RedoToolbar };

package/dist/components/rich_text_editor/toolbars/search_and_replace_toolbar/index.d.ts

@@ -0,0 +1 @@
+export declare function SearchAndReplaceToolbar(): import("react/jsx-runtime").JSX.Element;

package/dist/components/rich_text_editor/toolbars/strikethrough/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const StrikeThroughToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { StrikeThroughToolbar };

package/dist/components/rich_text_editor/toolbars/toolbar_provider/context.d.ts

@@ -0,0 +1,7 @@
+import { Editor } from '@tiptap/react';
+import { default as React } from 'react';
+export interface ToolbarContextProps {
+    editor: Editor;
+}
+export declare const ToolbarContext: React.Context<ToolbarContextProps | null>;
+export declare const useToolbar: () => ToolbarContextProps;

package/dist/components/rich_text_editor/toolbars/toolbar_provider/index.d.ts

@@ -0,0 +1,2 @@
+export { ToolbarProvider } from './toolbar_provider';
+export { useToolbar, type ToolbarContextProps } from './context';

package/dist/components/rich_text_editor/toolbars/toolbar_provider/toolbar_provider.d.ts

@@ -0,0 +1,8 @@
+import { Editor } from '@tiptap/react';
+import { default as React } from 'react';
+interface ToolbarProviderProps {
+    editor: Editor;
+    children: React.ReactNode;
+}
+export declare const ToolbarProvider: ({ editor, children }: ToolbarProviderProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/rich_text_editor/toolbars/underline/index.d.ts

@@ -0,0 +1,3 @@
+import { default as React } from 'react';
+declare const UnderlineToolbar: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export { UnderlineToolbar };