@artkit-ai/react 0.0.0-stage → 0.2.0

package/dist/editor-session.js

@@ -0,0 +1,192 @@
+import { ArtifactError, applyOperations, isArtifactError, } from '@artkit-ai/core';
+const DEFAULT_COALESCE_MS = 1000;
+const DEFAULT_MAX_UNDO = 200;
+/** Draft of one artifact with local undo and redo. Batches are applied in order, one at a time. */
+export class DraftSession {
+    registry;
+    locale;
+    coalesceMs;
+    maxUndo;
+    now;
+    base;
+    current;
+    undoStack = [];
+    redoStack = [];
+    queue = Promise.resolve();
+    pending = 0;
+    error;
+    lint;
+    changes = [];
+    snapshot;
+    listeners = new Set();
+    disposed = false;
+    constructor(options) {
+        this.registry = options.registry;
+        this.locale = options.locale ?? 'en';
+        this.coalesceMs = options.coalesceMs ?? DEFAULT_COALESCE_MS;
+        this.maxUndo = options.maxUndo ?? DEFAULT_MAX_UNDO;
+        this.now = options.now ?? (() => Date.now());
+        this.base = options.artifact;
+        this.current = { artifact: options.artifact, operations: [], at: 0, typing: false };
+        this.lint = this.lintOf(options.artifact);
+        this.snapshot = this.buildSnapshot();
+    }
+    /** The current snapshot. Its identity changes only when the state changes. */
+    getSnapshot = () => this.snapshot;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    };
+    /**
+     * Applies a batch to the draft. Resolves to `true` when the batch was accepted. A rejected batch leaves the draft
+     * untouched and sets `snapshot.error`.
+     */
+    apply(operations, options = {}) {
+        if (operations.length === 0)
+            return Promise.resolve(true);
+        this.pending += 1;
+        this.publish();
+        const run = this.queue.then(async () => {
+            if (this.disposed)
+                return false;
+            const typing = options.kind === 'typing' || options.kind === 'continuous';
+            try {
+                const result = await applyOperations(this.registry, this.current.artifact, operations, {
+                    locale: this.locale,
+                });
+                const next = {
+                    ...this.current.artifact,
+                    formatVersion: result.formatVersion,
+                    title: result.title,
+                    locale: result.locale,
+                    themeId: result.themeId,
+                    content: result.content,
+                };
+                const now = this.now();
+                const coalesce = typing && this.current.typing && now - this.current.at <= this.coalesceMs;
+                if (!coalesce) {
+                    this.undoStack.push(this.current);
+                    if (this.undoStack.length > this.maxUndo)
+                        this.undoStack.shift();
+                }
+                this.redoStack = [];
+                this.current = {
+                    artifact: next,
+                    operations: [...this.current.operations, ...operations],
+                    at: now,
+                    typing,
+                };
+                this.lint = result.lint;
+                this.changes = result.diff;
+                this.error = undefined;
+                return true;
+            }
+            catch (error) {
+                this.error = errorOf(error);
+                return false;
+            }
+        });
+        this.queue = run.finally(() => {
+            this.pending -= 1;
+            this.publish();
+        });
+        return run.then((accepted) => {
+            this.publish();
+            return accepted;
+        });
+    }
+    /** Steps back one edit (local). Returns false when there is nothing to undo. */
+    undo() {
+        const previous = this.undoStack.pop();
+        if (!previous)
+            return false;
+        this.redoStack.push(this.current);
+        this.restore(previous);
+        return true;
+    }
+    /** Steps forward after an undo. Returns false when there is nothing to redo. */
+    redo() {
+        const next = this.redoStack.pop();
+        if (!next)
+            return false;
+        this.undoStack.push(this.current);
+        this.restore(next);
+        return true;
+    }
+    /**
+     * Adopts an artifact loaded or saved by the application. A clean draft follows the new artifact. A draft that has
+     * changes keeps its content, and the base moves to the new version so the next save is a complete one.
+     */
+    load(artifact) {
+        if (artifact.id !== this.base.id)
+            throw new ArtifactError('INVALID_OPERATION', 'Load the same artifact.');
+        const clean = !this.buildSnapshot().dirty;
+        const sameContent = JSON.stringify(artifact.content) === JSON.stringify(this.current.artifact.content);
+        this.base = artifact;
+        if (clean || sameContent) {
+            this.current = { artifact, operations: [], at: 0, typing: false };
+            this.undoStack = [];
+            this.redoStack = [];
+            this.lint = this.lintOf(artifact);
+            this.changes = [];
+        }
+        this.publish();
+    }
+    /** Stops the session: later batches are ignored and listeners are dropped. */
+    dispose() {
+        this.disposed = true;
+        this.listeners.clear();
+    }
+    restore(step) {
+        this.current = step;
+        this.lint = this.lintOf(step.artifact);
+        this.changes = [];
+        this.error = undefined;
+        this.publish();
+    }
+    lintOf(artifact) {
+        const adapter = this.registry.get(artifact.format, this.locale);
+        return adapter.lint(artifact.content, {
+            locale: artifact.locale,
+            theme: this.registry.theme(artifact.themeId, this.locale),
+        });
+    }
+    publish() {
+        this.snapshot = this.buildSnapshot();
+        for (const listener of this.listeners)
+            listener();
+    }
+    buildSnapshot() {
+        const dirty = this.current.operations.length > 0 ||
+            JSON.stringify(this.current.artifact.content) !== JSON.stringify(this.base.content) ||
+            this.current.artifact.title !== this.base.title;
+        return {
+            baseVersion: this.base.version,
+            artifact: this.current.artifact,
+            operations: this.current.operations,
+            dirty,
+            canUndo: this.undoStack.length > 0,
+            canRedo: this.redoStack.length > 0,
+            pending: this.pending > 0,
+            ...(this.error ? { error: this.error } : {}),
+            lint: this.lint,
+            changes: this.changes,
+        };
+    }
+}
+function errorOf(error) {
+    if (isArtifactError(error)) {
+        const payload = error.toPayload();
+        return {
+            code: payload.error.code,
+            message: payload.error.message,
+            issues: payload.error.issues ?? [],
+        };
+    }
+    return {
+        code: 'INTERNAL_ERROR',
+        message: error instanceof Error ? error.message : String(error),
+        issues: [],
+    };
+}
+//# sourceMappingURL=editor-session.js.map

package/dist/editor-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-session.js","sourceRoot":"","sources":["../src/editor-session.ts"],"names":[],"mappings":"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"}

package/dist/hooks.d.ts

@@ -0,0 +1,64 @@
+import { type Artifact, ArtifactError, type CommitResult } from '@artkit-ai/core';
+import type { ClientExportResult } from './client.js';
+export interface UseArtifactOptions {
+    /** Already-known artifact (e.g. from a chat message), shown immediately and cached. */
+    initial?: Artifact;
+    /** Revalidate the latest version on mount (default true). */
+    revalidate?: boolean;
+}
+export interface UseArtifactResult {
+    artifact: Artifact | undefined;
+    error: unknown;
+    loading: boolean;
+    /** Fetches the latest version again (specific versions never change). */
+    refresh(): Promise<Artifact | undefined>;
+}
+/** Loads an artifact through the client with a shared cache (spec §13.2). Pass undefined to skip. */
+export declare function useArtifact(id: string | undefined, options?: UseArtifactOptions): UseArtifactResult;
+/** Latest known version of an artifact in the cache, updated when commits arrive. */
+export declare function useLatestVersion(id: string | undefined): number | undefined;
+export interface ApplyConflict {
+    operations: unknown[];
+    baseVersion: number;
+    currentVersion?: number;
+}
+export interface ApplyOptions {
+    /** Defaults to the latest cached version (loaded when unknown). */
+    baseVersion?: number;
+}
+export interface UseApplyOperationsResult {
+    apply(operations: unknown[], options?: ApplyOptions): Promise<CommitResult>;
+    pending: boolean;
+    error: ArtifactError | undefined;
+    /** Set on VERSION_CONFLICT: what changed since the base, and the operations that were refused. */
+    conflict: ApplyConflict | undefined;
+    /** Sends the refused operations again on the latest version. */
+    retry(): Promise<CommitResult>;
+    reset(): void;
+}
+/** Sends operations with `baseVersion` and surfaces conflicts (spec §13.2). */
+export declare function useApplyOperations(id: string): UseApplyOperationsResult;
+export interface ExportOptions {
+    /** Triggers a browser download (default true). */
+    download?: boolean;
+    options?: Record<string, unknown>;
+    /** `auto` (default) exports in the browser when a browser-capable exporter is loaded. */
+    prefer?: 'auto' | 'browser' | 'server';
+    signal?: AbortSignal;
+}
+export interface UseArtifactExportResult {
+    exportArtifact(format: string, options?: ExportOptions): Promise<ClientExportResult>;
+    pending: string | undefined;
+    error: ArtifactError | undefined;
+    warnings: string[];
+    /** Formats available for the artifact's kind (server formats plus browser exporters). */
+    formats: string[];
+    /** Loads the kind's browser exporters so `formats` includes them. */
+    loadFormats(): Promise<void>;
+}
+/**
+ * Exports in the browser when a loaded exporter with runtime `any`/`browser` handles the format, else
+ * through the client (spec §13.2), and triggers a download.
+ */
+export declare function useArtifactExport(id: string, format?: string): UseArtifactExportResult;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACb,aAAa,EACb,KAAK,YAAY,EAIlB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAetD,MAAM,WAAW,kBAAkB;IACjC,uFAAuF;IACvF,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,OAAO,IAAI,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,qGAAqG;AACrG,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,kBAAuB,GAAG,iBAAiB,CAmCvG;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQ3E;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5E,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,kGAAkG;IAClG,QAAQ,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,gEAAgE;IAChE,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,CAmDvE;AAED,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrF,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,aAAa,GAAG,SAAS,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yFAAyF;IACzF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,qEAAqE;IACrE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,uBAAuB,CAyGtF"}

package/dist/hooks.js

@@ -0,0 +1,205 @@
+import { ArtifactError, isArtifactError, silentLogger, slugify, } from '@artkit-ai/core';
+import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';
+import { useArtkit } from './context.js';
+import { triggerDownload } from './download.js';
+const NO_ENTRY = Object.freeze({ loading: false });
+const noop = () => { };
+const noSubscription = () => noop;
+function toArtifactError(error) {
+    if (isArtifactError(error))
+        return error;
+    return new ArtifactError('INTERNAL_ERROR', 'Internal error while processing the request.', {
+        cause: error,
+    });
+}
+/** Loads an artifact through the client with a shared cache (spec §13.2). Pass undefined to skip. */
+export function useArtifact(id, options = {}) {
+    const { cache } = useArtkit();
+    const { initial, revalidate = true } = options;
+    const subscribe = useCallback((listener) => (id ? cache.subscribe(id, listener) : noop), [cache, id]);
+    const read = () => (id ? cache.entry(id) : NO_ENTRY);
+    const entry = useSyncExternalStore(id ? subscribe : noSubscription, read, read);
+    useEffect(() => {
+        if (initial && initial.id === id)
+            cache.put(initial);
+    }, [cache, id, initial]);
+    useEffect(() => {
+        if (!id)
+            return;
+        cache.load(id, revalidate).catch(noop);
+    }, [cache, id, revalidate]);
+    const usableInitial = initial && initial.id === id ? initial : undefined;
+    const artifact = entry.artifact && (!usableInitial || entry.artifact.version >= usableInitial.version)
+        ? entry.artifact
+        : (usableInitial ?? entry.artifact);
+    const refresh = useCallback(async () => {
+        if (!id)
+            return undefined;
+        return cache.load(id, true);
+    }, [cache, id]);
+    return {
+        artifact,
+        error: artifact ? undefined : entry.error,
+        loading: !artifact && !entry.error && id !== undefined,
+        refresh,
+    };
+}
+/** Latest known version of an artifact in the cache, updated when commits arrive. */
+export function useLatestVersion(id) {
+    const { cache } = useArtkit();
+    const subscribe = useCallback((listener) => (id ? cache.subscribe(id, listener) : noop), [cache, id]);
+    const read = () => (id ? cache.latest(id)?.version : undefined);
+    return useSyncExternalStore(subscribe, read, read);
+}
+/** Sends operations with `baseVersion` and surfaces conflicts (spec §13.2). */
+export function useApplyOperations(id) {
+    const { client, cache } = useArtkit();
+    const [state, setState] = useState({
+        pending: false,
+    });
+    const conflictRef = useRef(undefined);
+    const apply = useCallback(async (operations, options = {}) => {
+        setState({ pending: true });
+        let baseVersion = options.baseVersion;
+        try {
+            baseVersion ??= cache.latest(id)?.version ?? (await cache.load(id)).version;
+            const result = await client.apply(id, { baseVersion, operations });
+            cache.put(result.artifact);
+            conflictRef.current = undefined;
+            setState({ pending: false });
+            return result;
+        }
+        catch (caught) {
+            const error = toArtifactError(caught);
+            let conflict;
+            if (error.code === 'VERSION_CONFLICT') {
+                const current = error.details.currentVersion;
+                conflict = {
+                    operations,
+                    baseVersion: baseVersion ?? 0,
+                    ...(typeof current === 'number' ? { currentVersion: current } : {}),
+                };
+                cache.load(id, true).catch(noop);
+            }
+            conflictRef.current = conflict;
+            setState({ pending: false, error, ...(conflict ? { conflict } : {}) });
+            throw error;
+        }
+    }, [client, cache, id]);
+    const retry = useCallback(async () => {
+        const conflict = conflictRef.current;
+        if (!conflict)
+            throw new ArtifactError('NOT_FOUND', 'There is no conflicting batch to retry.');
+        const latest = await cache.load(id, true);
+        return apply(conflict.operations, { baseVersion: latest.version });
+    }, [apply, cache, id]);
+    const reset = useCallback(() => {
+        conflictRef.current = undefined;
+        setState({ pending: false });
+    }, []);
+    return { apply, pending: state.pending, error: state.error, conflict: state.conflict, retry, reset };
+}
+/**
+ * Exports in the browser when a loaded exporter with runtime `any`/`browser` handles the format, else
+ * through the client (spec §13.2), and triggers a download.
+ */
+export function useArtifactExport(id, format) {
+    const ctx = useArtkit();
+    const { client, cache, registry } = ctx;
+    const [pending, setPending] = useState(undefined);
+    const [error, setError] = useState(undefined);
+    const [warnings, setWarnings] = useState([]);
+    const [loaded, setLoaded] = useState([]);
+    const knownFormat = format ?? cache.latest(id)?.format;
+    const browserExporters = useCallback(async (artifactKind) => {
+        const fromRegistry = registry.exporters(artifactKind).filter((exporter) => exporter.runtime !== 'node');
+        if (!ctx.hasExporters(artifactKind))
+            return fromRegistry;
+        const lazy = (await ctx.loadExporters(artifactKind)).filter((exporter) => exporter.format === artifactKind && exporter.runtime !== 'node');
+        return [...lazy, ...fromRegistry];
+    }, [ctx, registry]);
+    const loadFormats = useCallback(async () => {
+        if (!knownFormat)
+            return;
+        try {
+            setLoaded(await browserExporters(knownFormat));
+        }
+        catch {
+            // Without browser exporters the server formats still work.
+        }
+    }, [browserExporters, knownFormat]);
+    const formats = useMemo(() => {
+        if (!knownFormat)
+            return [];
+        const set = new Set(ctx.exportFormats[knownFormat] ?? []);
+        for (const exporter of registry.exporters(knownFormat))
+            if (exporter.runtime !== 'node')
+                set.add(exporter.target);
+        for (const exporter of loaded)
+            set.add(exporter.target);
+        return [...set];
+    }, [ctx.exportFormats, knownFormat, loaded, registry]);
+    const exportArtifact = useCallback(async (format, options = {}) => {
+        setPending(format);
+        setError(undefined);
+        setWarnings([]);
+        try {
+            const artifact = cache.latest(id) ?? (await cache.load(id));
+            let result;
+            if (options.prefer !== 'server') {
+                const exporter = (await browserExporters(artifact.format).catch(() => [])).find((candidate) => candidate.target === format);
+                if (exporter) {
+                    const collected = [];
+                    let bytes;
+                    try {
+                        bytes = await exporter.export(artifact.content, {
+                            title: artifact.title,
+                            theme: ctx.themeFor(artifact.themeId),
+                            locale: artifact.locale,
+                            assets: ctx.assets ?? {
+                                resolve: (ref) => Promise.reject(new ArtifactError('NOT_FOUND', `Asset not available in the browser: ${ref}.`)),
+                            },
+                            logger: silentLogger,
+                            warn: (message) => collected.push(message),
+                            ...(options.signal ? { signal: options.signal } : {}),
+                            ...(options.options ? { options: options.options } : {}),
+                        });
+                    }
+                    catch (cause) {
+                        throw isArtifactError(cause)
+                            ? cause
+                            : new ArtifactError('EXPORT_FAILED', `Failed to export to ${format}.`, { cause });
+                    }
+                    result = {
+                        bytes,
+                        mimeType: exporter.mimeType,
+                        filename: `${slugify(artifact.title)}.${exporter.extension}`,
+                        warnings: collected,
+                    };
+                }
+                else if (options.prefer === 'browser') {
+                    throw new ArtifactError('EXPORT_FAILED', `No browser exporter for format ${format}.`);
+                }
+            }
+            result ??= await client.export(id, {
+                format,
+                ...(options.options ? { options: options.options } : {}),
+                ...(options.signal ? { signal: options.signal } : {}),
+            });
+            setWarnings(result.warnings);
+            if (options.download !== false)
+                triggerDownload(result);
+            return result;
+        }
+        catch (caught) {
+            const failure = toArtifactError(caught);
+            setError(failure);
+            throw failure;
+        }
+        finally {
+            setPending(undefined);
+        }
+    }, [browserExporters, cache, client, ctx, id]);
+    return { exportArtifact, pending, error, warnings, formats, loadFormats };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/i18n.d.ts

@@ -0,0 +1,135 @@
+/** UI strings in pt-BR and en (spec §18.1). Templates use `{name}` placeholders. */
+export declare const uiMessages: {
+    en: {
+        loading: string;
+        generating: string;
+        provisional: string;
+        noRenderer: string;
+        loadFailed: string;
+        retry: string;
+        close: string;
+        open: string;
+        openTitle: string;
+        version: string;
+        versionShort: string;
+        latest: string;
+        tabView: string;
+        tabCode: string;
+        tabEdit: string;
+        save: string;
+        tabsLabel: string;
+        copy: string;
+        copied: string;
+        export: string;
+        exportAs: string;
+        exporting: string;
+        exported: string;
+        exportWarnings: string;
+        noExportFormats: string;
+        rejectReason: string;
+        confirmReject: string;
+        cancel: string;
+        loadMore: string;
+        by: string;
+        actor_agent: string;
+        actor_user: string;
+        actor_system: string;
+        changes: string;
+        noChanges: string;
+        change_added: string;
+        change_removed: string;
+        change_changed: string;
+        change_moved: string;
+        diffUnified: string;
+        diffSplit: string;
+        diffViewLabel: string;
+        lineAdded: string;
+        lineRemoved: string;
+        undo: string;
+        redo: string;
+        undone: string;
+        redone: string;
+        saving: string;
+        saved: string;
+        unsaved: string;
+        rolledBack: string;
+        dismiss: string;
+        readOnly: string;
+        lockedBy: string;
+        lockedUntil: string;
+        reapplyMine: string;
+        editorLabel: string;
+        lintWarnings: string;
+    };
+    'pt-BR': {
+        loading: string;
+        generating: string;
+        provisional: string;
+        noRenderer: string;
+        loadFailed: string;
+        retry: string;
+        close: string;
+        open: string;
+        openTitle: string;
+        version: string;
+        versionShort: string;
+        latest: string;
+        tabView: string;
+        tabCode: string;
+        tabEdit: string;
+        save: string;
+        tabsLabel: string;
+        copy: string;
+        copied: string;
+        export: string;
+        exportAs: string;
+        exporting: string;
+        exported: string;
+        exportWarnings: string;
+        noExportFormats: string;
+        rejectReason: string;
+        confirmReject: string;
+        cancel: string;
+        loadMore: string;
+        by: string;
+        actor_agent: string;
+        actor_user: string;
+        actor_system: string;
+        changes: string;
+        noChanges: string;
+        change_added: string;
+        change_removed: string;
+        change_changed: string;
+        change_moved: string;
+        diffUnified: string;
+        diffSplit: string;
+        diffViewLabel: string;
+        lineAdded: string;
+        lineRemoved: string;
+        undo: string;
+        redo: string;
+        undone: string;
+        redone: string;
+        saving: string;
+        saved: string;
+        unsaved: string;
+        rolledBack: string;
+        dismiss: string;
+        readOnly: string;
+        lockedBy: string;
+        lockedUntil: string;
+        reapplyMine: string;
+        editorLabel: string;
+        lintWarnings: string;
+    };
+};
+export type UiMessageKey = keyof (typeof uiMessages)['en'];
+export type UiMessages = Record<UiMessageKey, string>;
+/** Extra or overriding catalogs, keyed by BCP-47 tag (`es`, `pt-PT`) or language. */
+export type UiMessageOverrides = Record<string, Partial<UiMessages>>;
+export type Translate = (key: UiMessageKey, params?: Record<string, string | number>) => string;
+/**
+ * Resolution order: exact override, language override, built-in catalog (pt* → pt-BR, else en), English.
+ */
+export declare function createTranslator(locale: string, overrides?: UiMessageOverrides): Translate;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,eAAO,MAAM,UAAU;;QAEnB,OAAO;QACP,UAAU;QACV,WAAW;QACX,UAAU;QACV,UAAU;QACV,KAAK;QACL,KAAK;QACL,IAAI;QACJ,SAAS;QACT,OAAO;QACP,YAAY;QACZ,MAAM;QACN,OAAO;QACP,OAAO;QACP,OAAO;QACP,IAAI;QACJ,SAAS;QACT,IAAI;QACJ,MAAM;QACN,MAAM;QACN,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,cAAc;QACd,eAAe;QACf,YAAY;QACZ,aAAa;QACb,MAAM;QACN,QAAQ;QACR,EAAE;QACF,WAAW;QACX,UAAU;QACV,YAAY;QACZ,OAAO;QACP,SAAS;QACT,YAAY;QACZ,cAAc;QACd,cAAc;QACd,YAAY;QACZ,WAAW;QACX,SAAS;QACT,aAAa;QACb,SAAS;QACT,WAAW;QACX,IAAI;QACJ,IAAI;QACJ,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,OAAO;QACP,UAAU;QACV,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,WAAW;QACX,WAAW;QACX,WAAW;QACX,YAAY;;;QAGZ,OAAO;QACP,UAAU;QACV,WAAW;QACX,UAAU;QACV,UAAU;QACV,KAAK;QACL,KAAK;QACL,IAAI;QACJ,SAAS;QACT,OAAO;QACP,YAAY;QACZ,MAAM;QACN,OAAO;QACP,OAAO;QACP,OAAO;QACP,IAAI;QACJ,SAAS;QACT,IAAI;QACJ,MAAM;QACN,MAAM;QACN,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,cAAc;QACd,eAAe;QACf,YAAY;QACZ,aAAa;QACb,MAAM;QACN,QAAQ;QACR,EAAE;QACF,WAAW;QACX,UAAU;QACV,YAAY;QACZ,OAAO;QACP,SAAS;QACT,YAAY;QACZ,cAAc;QACd,cAAc;QACd,YAAY;QACZ,WAAW;QACX,SAAS;QACT,aAAa;QACb,SAAS;QACT,WAAW;QACX,IAAI;QACJ,IAAI;QACJ,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,OAAO;QACP,UAAU;QACV,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,WAAW;QACX,WAAW;QACX,WAAW;QACX,YAAY;;CAEkC,CAAC;AAEnD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAEtD,qFAAqF;AACrF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;AAErE,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;AAQhG;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,kBAAuB,GAAG,SAAS,CAW9F"}