@tempots/beatui 0.82.0 → 0.83.0

package/dist/types/lexical-i18n/locales/ru.d.ts

@@ -0,0 +1,91 @@
+declare const ru: {
+    cut: string;
+    copy: string;
+    paste: string;
+    insertTable: string;
+    indent: string;
+    outdent: string;
+    fontFamily: string;
+    fontSize: string;
+    fontColor: string;
+    highlightColor: string;
+    backgroundColor: string;
+    clearFormatting: string;
+    bold: string;
+    italic: string;
+    underline: string;
+    strikethrough: string;
+    code: string;
+    heading1: string;
+    heading2: string;
+    heading3: string;
+    heading4: string;
+    heading5: string;
+    heading6: string;
+    bulletList: string;
+    orderedList: string;
+    checkList: string;
+    quote: string;
+    codeBlock: string;
+    divider: string;
+    link: string;
+    table: string;
+    undo: string;
+    redo: string;
+    slashCommandsTitle: string;
+    slashCommandsEmpty: string;
+    slashCommandHeading1: string;
+    slashCommandHeading1Desc: string;
+    slashCommandHeading2: string;
+    slashCommandHeading2Desc: string;
+    slashCommandHeading3: string;
+    slashCommandHeading3Desc: string;
+    slashCommandBulletList: string;
+    slashCommandBulletListDesc: string;
+    slashCommandOrderedList: string;
+    slashCommandOrderedListDesc: string;
+    slashCommandQuote: string;
+    slashCommandQuoteDesc: string;
+    slashCommandCodeBlock: string;
+    slashCommandCodeBlockDesc: string;
+    slashCommandDivider: string;
+    slashCommandDividerDesc: string;
+    slashCommandTable: string;
+    slashCommandTableDesc: string;
+    insertRowAbove: string;
+    insertRowBelow: string;
+    insertColumnLeft: string;
+    insertColumnRight: string;
+    deleteRow: string;
+    deleteColumn: string;
+    deleteTable: string;
+    linkUrl: string;
+    linkUrlPlaceholder: string;
+    linkText: string;
+    linkTextPlaceholder: string;
+    linkInsert: string;
+    linkEdit: string;
+    linkRemove: string;
+    linkOpen: string;
+    codeLanguage: string;
+    codeLanguagePlaceholder: string;
+    exportMarkdown: string;
+    exportHtml: string;
+    exportJson: string;
+    importFile: string;
+    characterCount: (count: number) => string;
+    characterCountWithMax: (count: number, max: number) => string;
+    characterCountExceeded: string;
+    errorGeneric: string;
+    errorLoadFailed: string;
+    errorSaveFailed: string;
+    placeholder: string;
+    placeholderEmpty: string;
+    a11yEditor: string;
+    a11yToolbar: string;
+    a11yFloatingToolbar: string;
+    a11ySlashCommands: string;
+    a11yTableControls: string;
+    a11yCodeLanguage: string;
+};
+export default ru;

package/dist/types/lexical-i18n/locales/tr.d.ts

@@ -0,0 +1,91 @@
+declare const tr: {
+    cut: string;
+    copy: string;
+    paste: string;
+    insertTable: string;
+    indent: string;
+    outdent: string;
+    fontFamily: string;
+    fontSize: string;
+    fontColor: string;
+    highlightColor: string;
+    backgroundColor: string;
+    clearFormatting: string;
+    bold: string;
+    italic: string;
+    underline: string;
+    strikethrough: string;
+    code: string;
+    heading1: string;
+    heading2: string;
+    heading3: string;
+    heading4: string;
+    heading5: string;
+    heading6: string;
+    bulletList: string;
+    orderedList: string;
+    checkList: string;
+    quote: string;
+    codeBlock: string;
+    divider: string;
+    link: string;
+    table: string;
+    undo: string;
+    redo: string;
+    slashCommandsTitle: string;
+    slashCommandsEmpty: string;
+    slashCommandHeading1: string;
+    slashCommandHeading1Desc: string;
+    slashCommandHeading2: string;
+    slashCommandHeading2Desc: string;
+    slashCommandHeading3: string;
+    slashCommandHeading3Desc: string;
+    slashCommandBulletList: string;
+    slashCommandBulletListDesc: string;
+    slashCommandOrderedList: string;
+    slashCommandOrderedListDesc: string;
+    slashCommandQuote: string;
+    slashCommandQuoteDesc: string;
+    slashCommandCodeBlock: string;
+    slashCommandCodeBlockDesc: string;
+    slashCommandDivider: string;
+    slashCommandDividerDesc: string;
+    slashCommandTable: string;
+    slashCommandTableDesc: string;
+    insertRowAbove: string;
+    insertRowBelow: string;
+    insertColumnLeft: string;
+    insertColumnRight: string;
+    deleteRow: string;
+    deleteColumn: string;
+    deleteTable: string;
+    linkUrl: string;
+    linkUrlPlaceholder: string;
+    linkText: string;
+    linkTextPlaceholder: string;
+    linkInsert: string;
+    linkEdit: string;
+    linkRemove: string;
+    linkOpen: string;
+    codeLanguage: string;
+    codeLanguagePlaceholder: string;
+    exportMarkdown: string;
+    exportHtml: string;
+    exportJson: string;
+    importFile: string;
+    characterCount: (count: number) => string;
+    characterCountWithMax: (count: number, max: number) => string;
+    characterCountExceeded: string;
+    errorGeneric: string;
+    errorLoadFailed: string;
+    errorSaveFailed: string;
+    placeholder: string;
+    placeholderEmpty: string;
+    a11yEditor: string;
+    a11yToolbar: string;
+    a11yFloatingToolbar: string;
+    a11ySlashCommands: string;
+    a11yTableControls: string;
+    a11yCodeLanguage: string;
+};
+export default tr;

package/dist/types/lexical-i18n/locales/ur.d.ts

@@ -0,0 +1,91 @@
+declare const ur: {
+    cut: string;
+    copy: string;
+    paste: string;
+    insertTable: string;
+    indent: string;
+    outdent: string;
+    fontFamily: string;
+    fontSize: string;
+    fontColor: string;
+    highlightColor: string;
+    backgroundColor: string;
+    clearFormatting: string;
+    bold: string;
+    italic: string;
+    underline: string;
+    strikethrough: string;
+    code: string;
+    heading1: string;
+    heading2: string;
+    heading3: string;
+    heading4: string;
+    heading5: string;
+    heading6: string;
+    bulletList: string;
+    orderedList: string;
+    checkList: string;
+    quote: string;
+    codeBlock: string;
+    divider: string;
+    link: string;
+    table: string;
+    undo: string;
+    redo: string;
+    slashCommandsTitle: string;
+    slashCommandsEmpty: string;
+    slashCommandHeading1: string;
+    slashCommandHeading1Desc: string;
+    slashCommandHeading2: string;
+    slashCommandHeading2Desc: string;
+    slashCommandHeading3: string;
+    slashCommandHeading3Desc: string;
+    slashCommandBulletList: string;
+    slashCommandBulletListDesc: string;
+    slashCommandOrderedList: string;
+    slashCommandOrderedListDesc: string;
+    slashCommandQuote: string;
+    slashCommandQuoteDesc: string;
+    slashCommandCodeBlock: string;
+    slashCommandCodeBlockDesc: string;
+    slashCommandDivider: string;
+    slashCommandDividerDesc: string;
+    slashCommandTable: string;
+    slashCommandTableDesc: string;
+    insertRowAbove: string;
+    insertRowBelow: string;
+    insertColumnLeft: string;
+    insertColumnRight: string;
+    deleteRow: string;
+    deleteColumn: string;
+    deleteTable: string;
+    linkUrl: string;
+    linkUrlPlaceholder: string;
+    linkText: string;
+    linkTextPlaceholder: string;
+    linkInsert: string;
+    linkEdit: string;
+    linkRemove: string;
+    linkOpen: string;
+    codeLanguage: string;
+    codeLanguagePlaceholder: string;
+    exportMarkdown: string;
+    exportHtml: string;
+    exportJson: string;
+    importFile: string;
+    characterCount: (count: number) => string;
+    characterCountWithMax: (count: number, max: number) => string;
+    characterCountExceeded: string;
+    errorGeneric: string;
+    errorLoadFailed: string;
+    errorSaveFailed: string;
+    placeholder: string;
+    placeholderEmpty: string;
+    a11yEditor: string;
+    a11yToolbar: string;
+    a11yFloatingToolbar: string;
+    a11ySlashCommands: string;
+    a11yTableControls: string;
+    a11yCodeLanguage: string;
+};
+export default ur;

package/dist/types/lexical-i18n/locales/vi.d.ts

@@ -0,0 +1,91 @@
+declare const vi: {
+    cut: string;
+    copy: string;
+    paste: string;
+    insertTable: string;
+    indent: string;
+    outdent: string;
+    fontFamily: string;
+    fontSize: string;
+    fontColor: string;
+    highlightColor: string;
+    backgroundColor: string;
+    clearFormatting: string;
+    bold: string;
+    italic: string;
+    underline: string;
+    strikethrough: string;
+    code: string;
+    heading1: string;
+    heading2: string;
+    heading3: string;
+    heading4: string;
+    heading5: string;
+    heading6: string;
+    bulletList: string;
+    orderedList: string;
+    checkList: string;
+    quote: string;
+    codeBlock: string;
+    divider: string;
+    link: string;
+    table: string;
+    undo: string;
+    redo: string;
+    slashCommandsTitle: string;
+    slashCommandsEmpty: string;
+    slashCommandHeading1: string;
+    slashCommandHeading1Desc: string;
+    slashCommandHeading2: string;
+    slashCommandHeading2Desc: string;
+    slashCommandHeading3: string;
+    slashCommandHeading3Desc: string;
+    slashCommandBulletList: string;
+    slashCommandBulletListDesc: string;
+    slashCommandOrderedList: string;
+    slashCommandOrderedListDesc: string;
+    slashCommandQuote: string;
+    slashCommandQuoteDesc: string;
+    slashCommandCodeBlock: string;
+    slashCommandCodeBlockDesc: string;
+    slashCommandDivider: string;
+    slashCommandDividerDesc: string;
+    slashCommandTable: string;
+    slashCommandTableDesc: string;
+    insertRowAbove: string;
+    insertRowBelow: string;
+    insertColumnLeft: string;
+    insertColumnRight: string;
+    deleteRow: string;
+    deleteColumn: string;
+    deleteTable: string;
+    linkUrl: string;
+    linkUrlPlaceholder: string;
+    linkText: string;
+    linkTextPlaceholder: string;
+    linkInsert: string;
+    linkEdit: string;
+    linkRemove: string;
+    linkOpen: string;
+    codeLanguage: string;
+    codeLanguagePlaceholder: string;
+    exportMarkdown: string;
+    exportHtml: string;
+    exportJson: string;
+    importFile: string;
+    characterCount: (count: number) => string;
+    characterCountWithMax: (count: number, max: number) => string;
+    characterCountExceeded: string;
+    errorGeneric: string;
+    errorLoadFailed: string;
+    errorSaveFailed: string;
+    placeholder: string;
+    placeholderEmpty: string;
+    a11yEditor: string;
+    a11yToolbar: string;
+    a11yFloatingToolbar: string;
+    a11ySlashCommands: string;
+    a11yTableControls: string;
+    a11yCodeLanguage: string;
+};
+export default vi;

package/dist/types/lexical-i18n/locales/zh.d.ts

@@ -0,0 +1,91 @@
+declare const zh: {
+    cut: string;
+    copy: string;
+    paste: string;
+    insertTable: string;
+    indent: string;
+    outdent: string;
+    fontFamily: string;
+    fontSize: string;
+    fontColor: string;
+    highlightColor: string;
+    backgroundColor: string;
+    clearFormatting: string;
+    bold: string;
+    italic: string;
+    underline: string;
+    strikethrough: string;
+    code: string;
+    heading1: string;
+    heading2: string;
+    heading3: string;
+    heading4: string;
+    heading5: string;
+    heading6: string;
+    bulletList: string;
+    orderedList: string;
+    checkList: string;
+    quote: string;
+    codeBlock: string;
+    divider: string;
+    link: string;
+    table: string;
+    undo: string;
+    redo: string;
+    slashCommandsTitle: string;
+    slashCommandsEmpty: string;
+    slashCommandHeading1: string;
+    slashCommandHeading1Desc: string;
+    slashCommandHeading2: string;
+    slashCommandHeading2Desc: string;
+    slashCommandHeading3: string;
+    slashCommandHeading3Desc: string;
+    slashCommandBulletList: string;
+    slashCommandBulletListDesc: string;
+    slashCommandOrderedList: string;
+    slashCommandOrderedListDesc: string;
+    slashCommandQuote: string;
+    slashCommandQuoteDesc: string;
+    slashCommandCodeBlock: string;
+    slashCommandCodeBlockDesc: string;
+    slashCommandDivider: string;
+    slashCommandDividerDesc: string;
+    slashCommandTable: string;
+    slashCommandTableDesc: string;
+    insertRowAbove: string;
+    insertRowBelow: string;
+    insertColumnLeft: string;
+    insertColumnRight: string;
+    deleteRow: string;
+    deleteColumn: string;
+    deleteTable: string;
+    linkUrl: string;
+    linkUrlPlaceholder: string;
+    linkText: string;
+    linkTextPlaceholder: string;
+    linkInsert: string;
+    linkEdit: string;
+    linkRemove: string;
+    linkOpen: string;
+    codeLanguage: string;
+    codeLanguagePlaceholder: string;
+    exportMarkdown: string;
+    exportHtml: string;
+    exportJson: string;
+    importFile: string;
+    characterCount: (count: number) => string;
+    characterCountWithMax: (count: number, max: number) => string;
+    characterCountExceeded: string;
+    errorGeneric: string;
+    errorLoadFailed: string;
+    errorSaveFailed: string;
+    placeholder: string;
+    placeholderEmpty: string;
+    a11yEditor: string;
+    a11yToolbar: string;
+    a11yFloatingToolbar: string;
+    a11ySlashCommands: string;
+    a11yTableControls: string;
+    a11yCodeLanguage: string;
+};
+export default zh;

package/dist/types/lexical-i18n/translations.d.ts

@@ -0,0 +1,21 @@
+import type { LexicalMessages } from './default';
+/**
+ * Get a translated message by key from a messages object
+ */
+export declare function t(messages: LexicalMessages, key: keyof LexicalMessages, ...args: unknown[]): string;
+/**
+ * Get messages for a locale. Falls back to English if locale not found.
+ */
+export declare function getMessagesForLocale(locale: string): Promise<LexicalMessages>;
+/**
+ * Determine text direction based on locale
+ */
+export declare function getDirectionForLocale(locale: string): 'ltr' | 'rtl';
+/**
+ * Get default locale
+ */
+export declare function getDefaultLocale(): string;
+/**
+ * Get default messages
+ */
+export declare function getDefaultMessages(): LexicalMessages;

package/dist/types/markdown/index.d.ts

@@ -1,3 +1,16 @@
+/**
+ * Markdown rendering for `@tempots/beatui/markdown`.
+ *
+ * Renders Markdown content to styled HTML using micromark with optional
+ * GFM (GitHub Flavored Markdown) support. HTML is escaped by default
+ * for safety.
+ *
+ * ```ts
+ * import { Markdown } from '@tempots/beatui/markdown'
+ * ```
+ *
+ * @module
+ */
 import { TNode, Value, Renderable } from '@tempots/dom';
 export type MarkdownOptions = {
     content: Value<string>;

package/dist/types/monaco/index.d.ts

@@ -1,3 +1,20 @@
+/**
+ * Public entry point for the `@tempots/beatui/monaco` optional module.
+ *
+ * Re-exports the Monaco editor input component, type definitions, and the
+ * environment configuration helper. Monaco workers are configured
+ * automatically when the editor is first loaded via CDN.
+ *
+ * ```ts
+ * import {
+ *   MonacoEditorInput,
+ *   configureMonacoEnvironment,
+ *   type MonacoLanguage,
+ * } from '@tempots/beatui/monaco'
+ * ```
+ *
+ * @module
+ */
 export * from '../components/monaco/monaco-editor-input';
 export * from './types';
 export { configureMonacoEnvironment } from './lazy-loader';

package/dist/types/monaco/lazy-loader.d.ts

@@ -1,5 +1,84 @@
+/**
+ * Lazy loader for Monaco Editor via CDN (no bundler configuration required).
+ *
+ * Uses the AMD/RequireJS loader shipped with Monaco to load the editor and
+ * language-specific features on demand. The loaded instance is cached so
+ * subsequent calls return immediately.
+ *
+ * @module
+ */
 import type * as MonacoTypes from 'monaco-editor';
+/**
+ * Loads the core Monaco Editor API from CDN and returns the fully
+ * initialised `monaco` namespace. The result is cached so subsequent
+ * calls resolve immediately.
+ *
+ * Workers are configured automatically before the first load.
+ *
+ * @returns The Monaco Editor API namespace.
+ *
+ * @example
+ * ```ts
+ * const monaco = await loadMonacoCore()
+ * const editor = monaco.editor.create(container, { language: 'typescript' })
+ * ```
+ */
 export declare function loadMonacoCore(): Promise<typeof MonacoTypes>;
+/**
+ * Loads and configures language-specific features (validation, diagnostics,
+ * schemas) for the given language in Monaco.
+ *
+ * The core Monaco API is loaded first if not already available. Language
+ * loading promises are cached so each language is configured at most once.
+ *
+ * @param language - The Monaco language identifier (e.g. `'json'`, `'typescript'`, `'yaml'`).
+ *
+ * @example
+ * ```ts
+ * await loadLanguageFeatures('json')
+ * ```
+ */
 export declare function loadLanguageFeatures(language: string): Promise<void>;
+/**
+ * Loads the Monaco Editor API **and** the language-specific features for the
+ * given language in parallel, returning the fully initialised `monaco`
+ * namespace.
+ *
+ * This is the recommended loader for most use cases since it ensures both
+ * the core editor and language support are ready before the editor is created.
+ *
+ * @param language - The Monaco language identifier (e.g. `'json'`, `'typescript'`).
+ * @returns The Monaco Editor API namespace.
+ *
+ * @example
+ * ```ts
+ * const monaco = await loadMonacoWithLanguage('json')
+ * const editor = monaco.editor.create(el, { value: '{}', language: 'json' })
+ * ```
+ */
 export declare function loadMonacoWithLanguage(language: string): Promise<typeof MonacoTypes>;
+/**
+ * Configures the Monaco worker environment.
+ *
+ * Call this before creating any editor instances if you need custom web
+ * workers (e.g. bundled workers instead of CDN workers). When called without
+ * arguments, the default CDN-based worker environment is set up.
+ *
+ * This function is a no-op in non-browser environments (SSR).
+ *
+ * @param getWorkerFn - Optional factory that returns a `Worker` for a given
+ *   `workerId` and `label`. When omitted, the default AMD/CDN worker setup
+ *   is used.
+ *
+ * @example
+ * ```ts
+ * // Use default CDN workers
+ * configureMonacoEnvironment()
+ *
+ * // Use custom bundled workers
+ * configureMonacoEnvironment((workerId, label) => {
+ *   return new Worker(new URL('./my-worker.js', import.meta.url))
+ * })
+ * ```
+ */
 export declare function configureMonacoEnvironment(getWorkerFn?: (workerId: string, label: string) => Worker): void;

package/dist/types/monaco/styles-url.d.ts

@@ -1,2 +1,13 @@
+/**
+ * Resolves the Monaco editor CSS stylesheet as an absolute URL.
+ *
+ * In library builds, Vite inlines this as a `data:` URL so consumers do not
+ * need any additional asset configuration. The resulting URL is used by the
+ * `cssInjection: 'link'` option of {@link MonacoEditorInput} to lazily
+ * inject the stylesheet via a `<link>` element.
+ *
+ * @module
+ */
 declare const cssHref: string;
+/** Absolute URL pointing to the Monaco editor CSS stylesheet. */
 export default cssHref;

package/dist/types/monaco/styles.d.ts

@@ -1,2 +1,13 @@
+/**
+ * Bundles Monaco editor CSS as a JavaScript string for lazy, bundler-agnostic
+ * injection (e.g. via a `<style>` element).
+ *
+ * Vite resolves the CSS import at build time so consumers need no special
+ * asset configuration. **Do not** import this module except from inside a
+ * lazy code path to avoid pulling the CSS into the main bundle.
+ *
+ * @module
+ */
+/** The Monaco editor CSS stylesheet as an inlined string. */
 declare const _default: string;
 export default _default;

package/dist/types/monaco/types.d.ts

@@ -1,14 +1,61 @@
+/**
+ * Type definitions for Monaco Editor integration within BeatUI.
+ *
+ * @module
+ */
 import { Value } from '@tempots/dom';
+/**
+ * Supported language identifiers for the Monaco editor.
+ *
+ * Includes the most common built-in languages as literal types, but any
+ * valid Monaco language string is accepted.
+ *
+ * @example
+ * ```ts
+ * const lang: MonacoLanguage = 'typescript'
+ * ```
+ */
 export type MonacoLanguage = 'plaintext' | 'json' | 'yaml' | 'typescript' | 'javascript' | 'css' | 'html' | string;
+/**
+ * Describes a JSON Schema to be registered with the Monaco JSON language
+ * service for validation and autocompletion.
+ */
 export type MonacoJSONSchema = {
+    /** URI identifying this schema (e.g. `'http://myserver/schema.json'`). */
     uri: string;
+    /** Glob patterns of files this schema applies to (e.g. `['*.json']`). */
     fileMatch: string[];
+    /** The JSON Schema object itself (any valid JSON Schema draft). */
     schema: any;
 };
+/**
+ * Monaco-specific options used by {@link MonacoEditorInput} in addition to
+ * the standard BeatUI `InputOptions`.
+ */
 export type MonacoEditorSpecificOptions = {
+    /**
+     * The programming language for syntax highlighting and validation.
+     * @default 'plaintext'
+     */
     language?: Value<MonacoLanguage>;
+    /**
+     * Additional Monaco editor constructor options passed directly to
+     * `monaco.editor.create()`.
+     */
     editorOptions?: Record<string, unknown>;
+    /**
+     * JSON Schemas to register with the Monaco JSON language service.
+     * Only relevant when `language` is `'json'`.
+     */
     jsonSchemas?: Value<MonacoJSONSchema[]> | undefined;
+    /**
+     * Whether the editor should be read-only.
+     * @default false
+     */
     readOnly?: Value<boolean>;
+    /**
+     * Optional fetcher for external JSON/YAML schemas. Used by JSON via
+     * prefetch and by YAML via `schemaRequestService`.
+     */
     schemaRequest?: Value<((url: string) => Promise<string>) | undefined> | ((url: string) => Promise<string>) | undefined;
 };