docblocks-react-ui 0.1.1 → 0.2.0

package/dist/{index-D6_ysSmQ.d.mts → index-DOKS86aH.d.mts}

@@ -669,12 +669,11 @@ interface UseDatabaseTable {
     rowId: string;
     cells: Record<string, unknown>;
   }>): Promise<void>;
-  /** The mixed paste (the spec's paste batch): the visible rows' updates
-   *  (from the active row down) + the overflow's creates — ONE `batchRows`
-   *  (one transaction, one undo entry; the inverse = the updates' restore
-   *  + the created rows' deletion). The updates stand the optimistic
-   *  apply; the creates stand over the post-commit refresh. Returns the
-   *  created rows' ids. */
+  /** The mixed paste: the visible rows' updates (from the active row down)
+   *  + the overflow's creates — ONE `batchRows` (one transaction, one undo
+   *  entry; the inverse = the updates' restore + the created rows'
+   *  deletion). The updates stand the optimistic apply; the creates stand
+   *  over the post-commit refresh. Returns the created rows' ids. */
   pasteRows(input: {
     updates: Array<{
       rowId: string;
@@ -718,6 +717,85 @@ interface UseDatabaseTable {
  */
 declare function useDatabaseTable(bridge: DatabaseBridge, tableId: string, filter?: DatabaseFilterPayload): UseDatabaseTable;
 //#endregion
+//#region src/database/standalone/models.d.ts
+/**
+ * The database table's view settings — the standalone's `DatabaseTable`
+ * stand over the block's view attrs: the `filter`, the `columnOrder`, the
+ * `hiddenColumns`, the `columnWidths`, and the legacy `name` (the display
+ * stands the bridge's table name, as over the block — the `name` attr is
+ * the persistence's parity, not a display override). The schema's
+ * `views` / `viewType` attrs stand out of the UI's v1 (the view's kinds
+ * are unrendered).
+ */
+interface DatabaseTableView {
+  /** The display name's legacy parity (the bridge's table name stands the display). */
+  name?: string;
+  /** The applied filter (the block's `filter` attr's payload shape). */
+  filter?: DatabaseFilterPayload;
+  /** The visible columns' order (the drag's committed stand). */
+  columnOrder?: string[];
+  /** The hidden columns' ids (the column menu's toggle stand). */
+  hiddenColumns?: string[];
+  /** The columns' widths (px, over the `columnOrder` positions). */
+  columnWidths?: number[];
+}
+/** The `useTableList`'s return: the catalog's read projection + the create / rename's mutations. */
+interface UseTableList {
+  /** The catalog's tables (the system tables stand absent); `null` until the first successful read. */
+  tables: TableRef[] | null;
+  /** The catalog read's in-flight stand. */
+  loading: boolean;
+  /** The catalog read's last error (the `BridgeError` stand — the create / rename's failures stand their promises' rejects). */
+  error: BridgeError | null;
+  /** The catalog's re-read (the manual's stand — the contract's catalog stands no push). */
+  refresh: () => Promise<void>;
+  /** The `createTable`'s mutation (the fresh's `operationId` per op; rejects with the `BridgeError`). Resolves the created table's ref. */
+  create: (name: string) => Promise<TableRef>;
+  /** The `renameTable`'s mutation (the fresh's `operationId` per op; rejects with the `BridgeError`). */
+  rename: (tableId: string, name: string) => Promise<void>;
+}
+//#endregion
+//#region src/database/standalone/DatabaseTable.d.ts
+interface DatabaseTableProps {
+  /** The consumer's bridge (the table's truth). */
+  bridge: DatabaseBridge;
+  /** The bridge's table id (the `TableRef.id` over the `listTables`'s catalog). */
+  tableId: string;
+  /** The read-only's stand: the grid's data stands rendered, the editing's paths stand off (the block's read-only's parity). */
+  readOnly?: boolean;
+  /** The initial view's state (the consumer's persistence's seed; the mount's stand only — the controlled's mode stands absent). */
+  view?: Partial<DatabaseTableView>;
+  /** The view's change's hook (the persistence's stand; the patch = the changed's attrs only). */
+  onViewChange?: (patch: Partial<DatabaseTableView>) => void;
+}
+/**
+ * The standalone's database table: the live grid over the bridge's table
+ * id — the same `useDatabaseTable`'s data stand as the document block
+ * (the schema + the rows + the live events + the optimistic cell's layer),
+ * rendered outside any document (the consumer's own page / panel). The
+ * view's settings stand the internal's state (seeded from the `view`
+ * prop) + the consumer's persistence over the `onViewChange`'s patch
+ * (one patch per change, as the block's `updateBlock` stand). The i18n's
+ * scope stands self-contained (the package's instance — the same's stand
+ * as the consumer-placed components).
+ */
+declare function DatabaseTable({ bridge, tableId, readOnly, view, onViewChange }: DatabaseTableProps): import("react").JSX.Element;
+//#endregion
+//#region src/database/standalone/use-table-list.d.ts
+/**
+ * The table catalog's hook (the standalone's stand): the consumer's
+ * `DatabaseBridge`'s catalog read (`listTables` — the system tables stand
+ * absent) + the `createTable` / `renameTable` mutations (the fresh's
+ * `operationId` per op over `newMutationContext`). The catalog's truth
+ * stands in the bridge — the hook's state is the read projection,
+ * re-read over the own's successful mutations (the auto's stand) + the
+ * manual's `refresh` (the contract's catalog stands no push — the
+ * per-table's events stand over the `useDatabaseTable`'s subscription).
+ * The create / rename's failures stand their promises' rejects (the
+ * `BridgeError` stand) — the `error` state is the catalog read's own.
+ */
+declare function useTableList(bridge: DatabaseBridge): UseTableList;
+//#endregion
 //#region src/canvas/clipboard.d.ts
 /** The one copied canvas item (the deep data; the ids stand the originals). */
 type ClipboardItem = {
@@ -1072,4 +1150,4 @@ declare const DEFAULT_EMBED_SANDBOX = "allow-scripts allow-forms allow-popups";
 /** Read the per-instance editor context; throws outside an EditorProvider. */
 declare function useEditorContext(): EditorContextValue;
 //#endregion
-export { TableEnvelopeBase as $, DomainEvent as A, ProtocolCapability as B, BridgeColumnAnnotation as C, CellValueParse as D, CellMap as E, MutationContext as F, Revision as G, ProtocolLimits as H, MutationReceipt as I, SortInput as J, RowPage as K, OperationStatus as L, FilterInput as M, Id as N, Column as O, IsoInstant as P, TableDescription as Q, PageQuery as R, BridgeColumn as S, BridgeValueInput as T, QueryOperator as U, ProtocolDescriptor as V, QuerySemantics as W, SubscriptionObserver as X, SubscriptionHandle as Y, SubscriptionStatus as Z, UseDatabaseTable as _, EditorContextValue as a, BridgeErrorCode as at, FilterBuilder as b, EmbedSandboxPolicy as c, toBridgeError as ct, PdfPreview as d, BlobStore as dt, TableEvent as et, PdfPreviewProps as f, BlobSubtype as ft, DatabaseTableRow as g, DatabaseTablePhase as h, AccessLevel as i, BridgeError as it, FilterConditionInput as j, DatabaseBridge as k, MentionEntry as l, BlobMeta as lt, useDatabaseTable as m, createMemoryBlobStore as mt, DEFAULT_EMBED_SANDBOX as n, TableSnapshot as nt, EditorMode as o, isBridgeError as ot, SyncEmbedResolver as p, blobSubtypeOf as pt, RowWire as q, EditorProvider as r, BRIDGE_ERROR_CODES as rt, EditorProviderProps as s, isBridgeErrorCode as st, useEditorContext as t, TableRef as tt, MentionProvider as u, BlobRef as ut, emptyFilter as v, BridgeTableDescription as w, BatchOp as x, filterIsComplete as y, PageSnapshot as z };
+export { SortInput as $, BridgeValueInput as A, MutationContext as B, emptyFilter as C, BridgeColumn as D, BatchOp as E, DomainEvent as F, ProtocolCapability as G, OperationStatus as H, FilterConditionInput as I, QueryOperator as J, ProtocolDescriptor as K, FilterInput as L, CellValueParse as M, Column as N, BridgeColumnAnnotation as O, DatabaseBridge as P, RowWire as Q, Id as R, UseDatabaseTable as S, FilterBuilder as T, PageQuery as U, MutationReceipt as V, PageSnapshot as W, Revision as X, QuerySemantics as Y, RowPage as Z, DatabaseTableView as _, BlobSubtype as _t, EditorContextValue as a, TableEvent as at, DatabaseTablePhase as b, EmbedSandboxPolicy as c, BRIDGE_ERROR_CODES as ct, PdfPreview as d, isBridgeError as dt, SubscriptionHandle as et, PdfPreviewProps as f, isBridgeErrorCode as ft, DatabaseTableProps as g, BlobStore as gt, DatabaseTable as h, BlobRef as ht, AccessLevel as i, TableEnvelopeBase as it, CellMap as j, BridgeTableDescription as k, MentionEntry as l, BridgeError as lt, useTableList as m, BlobMeta as mt, DEFAULT_EMBED_SANDBOX as n, SubscriptionStatus as nt, EditorMode as o, TableRef as ot, SyncEmbedResolver as p, toBridgeError as pt, ProtocolLimits as q, EditorProvider as r, TableDescription as rt, EditorProviderProps as s, TableSnapshot as st, useEditorContext as t, SubscriptionObserver as tt, MentionProvider as u, BridgeErrorCode as ut, UseTableList as v, blobSubtypeOf as vt, filterIsComplete as w, DatabaseTableRow as x, useDatabaseTable as y, createMemoryBlobStore as yt, IsoInstant as z };

package/dist/index.d.mts

@@ -1,6 +1,5 @@
 import { n as BlockRendererMap, r as BlockRendererProps, t as BlockRenderer } from "./index-YJcgf8Hh.mjs";
-import { n as EditorView, t as Editor } from "./Editor-DT7RkRXf.mjs";
-import { $ as TableEnvelopeBase, A as DomainEvent, B as ProtocolCapability, C as BridgeColumnAnnotation, D as CellValueParse, E as CellMap, F as MutationContext, G as Revision, H as ProtocolLimits, I as MutationReceipt, J as SortInput, K as RowPage, L as OperationStatus, M as FilterInput, N as Id, O as Column, P as IsoInstant, Q as TableDescription, R as PageQuery, S as BridgeColumn, T as BridgeValueInput, U as QueryOperator, V as ProtocolDescriptor, W as QuerySemantics, X as SubscriptionObserver, Y as SubscriptionHandle, Z as SubscriptionStatus, _ as UseDatabaseTable, a as EditorContextValue, at as BridgeErrorCode, b as FilterBuilder, c as EmbedSandboxPolicy, ct as toBridgeError, d as PdfPreview, dt as BlobStore, et as TableEvent, f as PdfPreviewProps, ft as BlobSubtype, g as DatabaseTableRow, h as DatabaseTablePhase, i as AccessLevel, it as BridgeError, j as FilterConditionInput, k as DatabaseBridge, l as MentionEntry, lt as BlobMeta, m as useDatabaseTable, mt as createMemoryBlobStore, n as DEFAULT_EMBED_SANDBOX, nt as TableSnapshot, o as EditorMode, ot as isBridgeError, p as SyncEmbedResolver, pt as blobSubtypeOf, q as RowWire, r as EditorProvider, rt as BRIDGE_ERROR_CODES, s as EditorProviderProps, st as isBridgeErrorCode, t as useEditorContext, tt as TableRef, u as MentionProvider, ut as BlobRef, v as emptyFilter, w as BridgeTableDescription, x as BatchOp, y as filterIsComplete, z as PageSnapshot } from "./index-D6_ysSmQ.mjs";
+import { $ as SortInput, A as BridgeValueInput, B as MutationContext, C as emptyFilter, D as BridgeColumn, E as BatchOp, F as DomainEvent, G as ProtocolCapability, H as OperationStatus, I as FilterConditionInput, J as QueryOperator, K as ProtocolDescriptor, L as FilterInput, M as CellValueParse, N as Column, O as BridgeColumnAnnotation, P as DatabaseBridge, Q as RowWire, R as Id, S as UseDatabaseTable, T as FilterBuilder, U as PageQuery, V as MutationReceipt, W as PageSnapshot, X as Revision, Y as QuerySemantics, Z as RowPage, _ as DatabaseTableView, _t as BlobSubtype, a as EditorContextValue, at as TableEvent, b as DatabaseTablePhase, c as EmbedSandboxPolicy, ct as BRIDGE_ERROR_CODES, d as PdfPreview, dt as isBridgeError, et as SubscriptionHandle, f as PdfPreviewProps, ft as isBridgeErrorCode, g as DatabaseTableProps, gt as BlobStore, h as DatabaseTable, ht as BlobRef, i as AccessLevel, it as TableEnvelopeBase, j as CellMap, k as BridgeTableDescription, l as MentionEntry, lt as BridgeError, m as useTableList, mt as BlobMeta, n as DEFAULT_EMBED_SANDBOX, nt as SubscriptionStatus, o as EditorMode, ot as TableRef, p as SyncEmbedResolver, pt as toBridgeError, q as ProtocolLimits, r as EditorProvider, rt as TableDescription, s as EditorProviderProps, st as TableSnapshot, t as useEditorContext, tt as SubscriptionObserver, u as MentionProvider, ut as BridgeErrorCode, v as UseTableList, vt as blobSubtypeOf, w as filterIsComplete, x as DatabaseTableRow, y as useDatabaseTable, yt as createMemoryBlobStore, z as IsoInstant } from "./index-DOKS86aH.mjs";
 import * as React from "react";
 import { ComponentType, ReactNode } from "react";
 import { Block, BlockId, BlockType, Doc, DocMeta, PresenceState, Selection, SelectionView, SyncEmbedRef, TextRun } from "docblocks-core";
@@ -14,6 +13,41 @@ import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
 import * as SelectPrimitive from "@radix-ui/react-select";
 import * as TabsPrimitive from "@radix-ui/react-tabs";
 import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+//#region src/Editor.d.ts
+/**
+ * The document's view mode: the page flow (the root's children in reading
+ * order) or the canvas (the page as a miniature rectangle plus the surface
+ * elements on one canvas). View state — switching writes nothing to the
+ * data (like the selection).
+ */
+type EditorView = "page" | "canvas";
+interface EditorProps {
+  view?: EditorView;
+  /** The format toolbar's color palette (the default six colors). */
+  formatPalette?: readonly string[];
+}
+/**
+ * The document's editor: the root is the editor's focus/keyboard scope
+ * (the undo/redo hotkeys only fire for keys targeted inside it), and the
+ * root block context is provided for every entry (the entry list's
+ * siblings, and the entry root's sequence container as the gestures'
+ * command parent — a subtree entry root is a page block, structurally
+ * childless, so its commands target the container of its sequence, not
+ * itself).
+ *
+ * The `view` prop selects the rendering: "page" (default) is the flat page
+ * sequence — every page block is its own `Reorder.Item` row (the nesting is
+ * the block's `indent` attr; a list item's marker is a rendered label per
+ * row), the top-level rows render through `AnimatePresence` (`sync`), and
+ * the drag-reorder is pure framer `Reorder` (one drag = one range move of
+ * the dragged block's derived subtree — see the `motion` segment);
+ * "canvas" renders the document's page as a page miniature and the
+ * root-level surfaces' elements on one canvas (see CanvasView). The
+ * `formatPalette` prop overrides the floating format toolbar's color
+ * palette.
+ */
+declare function Editor({ view, formatPalette }: EditorProps): import("react").JSX.Element;
+//#endregion
 //#region src/database/bridge/annotation.d.ts
 /** The standard PostgreSQL type names per operator / input group. The contract
  *  is type-agnostic — this is the package's DEFAULT catalog; a non-standard
@@ -61,13 +95,17 @@ declare function isDatabaseBridge(candidate: unknown): candidate is DatabaseBrid
 declare function validateProtocolDescriptor(descriptor: ProtocolDescriptor): Set<ProtocolCapability>;
 //#endregion
 //#region src/database/use-database-table/utils.d.ts
-/** The cell-value equality (null / undefined stand as the empty cell). */
+/** The cell-value equality (null / undefined stand as the empty cell).
+ *  The composite value (the multi-select's array) stands the element-wise
+ *  stand: the same content over a fresh array instance is NOT a change
+ *  (the identity stand would commit the no-op and push the undo entry). */
 declare function cellValueEqual(current: unknown, next: unknown): boolean;
 /** The write's context: the fresh client-issued operation id (a UUID,
  *  unique within the retention) + the issue time. Every user action stands
  *  a fresh `operationId` — the id is never reused across logical
- *  operations, and a failed write is reconciled by the SAME id (the
- *  bridge's idempotency), never a silent new one. */
+ *  operations. The lost response's reconciliation (the write's fate) is
+ *  the consumer's stand over the bridge's `getOperationStatus`; the UI's
+ *  convergence is the rebaseline (the next snapshot / the envelope). */
 declare function newMutationContext(): MutationContext;
 //#endregion
 //#region src/canvas/text-fonts.d.ts
@@ -112,7 +150,9 @@ declare const SHAPE_FONT_OPTIONS: readonly [{
 declare const SHAPE_FONT_STACKS: Record<string, string>;
 //#endregion
 //#region src/DocHeader.d.ts
-declare function DocHeader({ doc, view, onViewChange, accessLevel, mode, onModeChange, publishedDoc }: {
+/** The header's props (the consumer's state: the doc's stand, the view and
+ *  the mode's switchers — the consumer owns the view / the mode's state). */
+interface DocHeaderProps {
   /** The headless document (the consumer's own stand: the live doc over the editor's stand, the published snapshot over the viewer's stand — the reader's browser never holds the live document). */
   doc?: Doc;
   view: EditorView;
@@ -125,7 +165,13 @@ declare function DocHeader({ doc, view, onViewChange, accessLevel, mode, onModeC
   onModeChange?: (mode: EditorMode) => void;
   /** The published snapshot (the meta's source over the published's stand; the "Published"'s option stands disabled over its absence). */
   publishedDoc?: Doc | null;
-}): import("react").JSX.Element;
+}
+/** The header's i18n scope: the package's instance stands the provider's seat
+ *  over the panel (the consumer places the header outside the editor — the
+ *  editor's own scope never reaches it). A consumer-wrapped subtree stands
+ *  the same instance nested — the provider is a plain context, the render
+ *  is unchanged. */
+declare function DocHeader(props: DocHeaderProps): import("react").JSX.Element;
 //#endregion
 //#region src/hooks.d.ts
 /** The headless document owned by the nearest EditorProvider. */
@@ -385,4 +431,4 @@ declare function TooltipContent({ className, sideOffset, children, ...props }: R
 //#region src/shared/ui/cn.d.ts
 declare function cn(...inputs: ClassValue[]): string;
 //#endregion
-export { type AccessLevel, Alert, AlertDescription, AlertTitle, BASELINE_CAPABILITIES, BRIDGE_ERROR_CODES, Badge, BareSelect, type BatchOp, type BlobMeta, type BlobRef, type BlobStore, type BlobSubtype, type BlockRenderer, type BlockRendererMap, type BlockRendererProps, type BridgeColumn, type BridgeColumnAnnotation, BridgeError, type BridgeErrorCode, type BridgeTableDescription, type BridgeValueInput, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CellMap, type CellValueParse, Checkbox, type Column, DEFAULT_EMBED_SANDBOX, type DatabaseBridge, type DatabaseTablePhase, type DatabaseTableRow, DocHeader, type DomainEvent, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Editor, type EditorContextValue, type EditorMode, EditorProvider, type EditorProviderProps, type EditorView, type EmbedSandboxPolicy, FORMAT_PALETTE, FilterBuilder, type FilterConditionInput, type FilterInput, type FormatMark, type Id, Input, type IsoInstant, Label, MONO_FONT_STACK, type MentionEntry, type MentionProvider, type MutationContext, type MutationReceipt, type OperationStatus, PROTOCOL_VERSION, type PageQuery, type PageSnapshot, type PdfPreview, type PdfPreviewProps, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, type ProtocolCapability, type ProtocolDescriptor, type ProtocolLimits, type QueryOperator, type QuerySemantics, type Revision, type RowPage, type RowWire, SHAPE_FONT_OPTIONS, SHAPE_FONT_STACKS, ScrollArea, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, type SortInput, type SubscriptionHandle, type SubscriptionObserver, type SubscriptionStatus, type SyncEmbedRef, type SyncEmbedResolver, TEXT_TYPES, type TableDescription, type TableEnvelopeBase, type TableEvent, type TableRef, type TableSnapshot, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UI_FONT_ID, UI_FONT_STACK, type UseDatabaseTable, badgeVariants, blobSubtypeOf, buttonVariants, cellValueEqual, cn, columnAnnotation, conditionMatches, createMemoryBlobStore, emptyFilter, filterIsComplete, isBridgeError, isBridgeErrorCode, isDatabaseBridge, markToggleAction, newMutationContext, parseCellValue, renderRuns, toBridgeError, useBlock, useDatabaseTable, useDoc, useEditorContext, useMeta, usePresence, useSelection, useSelectionView, useText, validateProtocolDescriptor };
+export { type AccessLevel, Alert, AlertDescription, AlertTitle, BASELINE_CAPABILITIES, BRIDGE_ERROR_CODES, Badge, BareSelect, type BatchOp, type BlobMeta, type BlobRef, type BlobStore, type BlobSubtype, type BlockRenderer, type BlockRendererMap, type BlockRendererProps, type BridgeColumn, type BridgeColumnAnnotation, BridgeError, type BridgeErrorCode, type BridgeTableDescription, type BridgeValueInput, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CellMap, type CellValueParse, Checkbox, type Column, DEFAULT_EMBED_SANDBOX, type DatabaseBridge, DatabaseTable, type DatabaseTablePhase, type DatabaseTableProps, type DatabaseTableRow, type DatabaseTableView, DocHeader, type DomainEvent, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Editor, type EditorContextValue, type EditorMode, EditorProvider, type EditorProviderProps, type EditorView, type EmbedSandboxPolicy, FORMAT_PALETTE, FilterBuilder, type FilterConditionInput, type FilterInput, type FormatMark, type Id, Input, type IsoInstant, Label, MONO_FONT_STACK, type MentionEntry, type MentionProvider, type MutationContext, type MutationReceipt, type OperationStatus, PROTOCOL_VERSION, type PageQuery, type PageSnapshot, type PdfPreview, type PdfPreviewProps, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, type ProtocolCapability, type ProtocolDescriptor, type ProtocolLimits, type QueryOperator, type QuerySemantics, type Revision, type RowPage, type RowWire, SHAPE_FONT_OPTIONS, SHAPE_FONT_STACKS, ScrollArea, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, type SortInput, type SubscriptionHandle, type SubscriptionObserver, type SubscriptionStatus, type SyncEmbedRef, type SyncEmbedResolver, TEXT_TYPES, type TableDescription, type TableEnvelopeBase, type TableEvent, type TableRef, type TableSnapshot, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UI_FONT_ID, UI_FONT_STACK, type UseDatabaseTable, type UseTableList, badgeVariants, blobSubtypeOf, buttonVariants, cellValueEqual, cn, columnAnnotation, conditionMatches, createMemoryBlobStore, emptyFilter, filterIsComplete, isBridgeError, isBridgeErrorCode, isDatabaseBridge, markToggleAction, newMutationContext, parseCellValue, renderRuns, toBridgeError, useBlock, useDatabaseTable, useDoc, useEditorContext, useMeta, usePresence, useSelection, useSelectionView, useTableList, useText, validateProtocolDescriptor };

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { $ as DropdownMenuContent, A as DEFAULT_EMBED_SANDBOX, B as Select, Bt as badgeVariants, Ct as CardAction, Dt as CardHeader, Et as CardFooter, F as newMutationContext, Ft as BookOpen, G as SelectScrollDownButton, Gt as PROTOCOL_VERSION, H as SelectGroup, Ht as AlertDescription, I as FilterBuilder, It as Button, J as SelectTrigger, Jt as BRIDGE_ERROR_CODES, K as SelectScrollUpButton, Kt as isDatabaseBridge, L as emptyFilter, Lt as buttonVariants, N as useDatabaseTable, Nt as Eye, O as EditorProvider, Ot as CardTitle, P as cellValueEqual, Q as DropdownMenuCheckboxItem, Qt as toBridgeError, R as filterIsComplete, Rt as BareSelect, St as Card, Tt as CardDescription, U as SelectItem, Ut as AlertTitle, V as SelectContent, Vt as Alert, W as SelectLabel, Wt as BASELINE_CAPABILITIES, X as Label, Xt as isBridgeError, Y as SelectValue, Yt as BridgeError, Z as DropdownMenu, Zt as isBridgeErrorCode, _t as PopoverHeader, an as Input, at as DropdownMenuRadioItem, bn as blobSubtypeOf, cn as useMeta, ct as DropdownMenuSub, dn as useSelectionView, dt as DropdownMenuTrigger, en as conditionMatches, et as DropdownMenuGroup, fn as useText, ft as Separator, g as markToggleAction, gn as renderRuns, gt as PopoverDescription, ht as PopoverContent, in as ScrollArea, it as DropdownMenuRadioGroup, jt as Pen, k as useEditorContext, l as SHAPE_FONT_OPTIONS, ln as usePresence, lt as DropdownMenuSubContent, mt as PopoverAnchor, nn as TEXT_TYPES, nt as DropdownMenuLabel, on as useBlock, ot as DropdownMenuSeparator, p as FORMAT_PALETTE, pt as Popover, q as SelectSeparator, qt as validateProtocolDescriptor, rn as columnAnnotation, rt as DropdownMenuPortal, sn as useDoc, st as DropdownMenuShortcut, t as Editor, tn as parseCellValue, tt as DropdownMenuItem, u as SHAPE_FONT_STACKS, un as useSelection, ut as DropdownMenuSubTrigger, vt as PopoverTitle, wt as CardContent, xn as createMemoryBlobStore, xt as Checkbox, yt as PopoverTrigger, z as SegmentSelector, zt as Badge } from "./Editor-CiJY5R4v.mjs";
+import { $ as PopoverHeader, A as SelectTrigger, At as isBridgeErrorCode, B as DropdownMenuRadioGroup, Bt as useMeta, C as SelectContent, Ct as BASELINE_CAPABILITIES, D as SelectScrollDownButton, Dt as BRIDGE_ERROR_CODES, E as SelectLabel, Et as validateProtocolDescriptor, F as DropdownMenuContent, Ft as columnAnnotation, G as DropdownMenuSubContent, H as DropdownMenuSeparator, Ht as useSelection, I as DropdownMenuGroup, It as ScrollArea, J as Separator, Jt as createMemoryBlobStore, K as DropdownMenuSubTrigger, Kt as renderRuns, L as DropdownMenuItem, Lt as Input, M as Label, Mt as conditionMatches, N as DropdownMenu, Nt as parseCellValue, O as SelectScrollUpButton, Ot as BridgeError, P as DropdownMenuCheckboxItem, Pt as TEXT_TYPES, Q as PopoverDescription, R as DropdownMenuLabel, Rt as useBlock, S as Select, St as AlertTitle, T as SelectItem, Tt as isDatabaseBridge, U as DropdownMenuShortcut, Ut as useSelectionView, V as DropdownMenuRadioItem, Vt as usePresence, W as DropdownMenuSub, Wt as useText, X as PopoverAnchor, Y as Popover, Z as PopoverContent, _ as FilterBuilder, _t as BareSelect, a as SHAPE_FONT_STACKS, at as CardAction, b as Skeleton, bt as Alert, ct as CardFooter, d as useEditorContext, dt as Pen, et as PopoverTitle, f as DEFAULT_EMBED_SANDBOX, ft as Eye, g as newMutationContext, gt as buttonVariants, h as cellValueEqual, ht as Button, i as SHAPE_FONT_OPTIONS, it as Card, j as SelectValue, jt as toBridgeError, k as SelectSeparator, kt as isBridgeError, l as markToggleAction, lt as CardHeader, m as useDatabaseTable, mt as BookOpen, nt as DocblocksI18nProvider, o as FORMAT_PALETTE, ot as CardContent, p as GridBody, q as DropdownMenuTrigger, qt as blobSubtypeOf, rt as Checkbox, st as CardDescription, t as Editor, tt as PopoverTrigger, u as EditorProvider, ut as CardTitle, v as emptyFilter, vt as Badge, w as SelectGroup, wt as PROTOCOL_VERSION, x as SegmentSelector, xt as AlertDescription, y as filterIsComplete, yt as badgeVariants, z as DropdownMenuPortal, zt as useDoc } from "./Editor-YAlRhGNW.mjs";
 import { c as cn, o as preventDefault } from "./constants-D4FTL0ph.mjs";
-import { t as Skeleton } from "./Skeleton-D922Ths5.mjs";
-import { useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useTranslation } from "react-i18next";
 import { cva } from "class-variance-authority";
 import * as TabsPrimitive from "@radix-ui/react-tabs";
 import * as TooltipPrimitive from "@radix-ui/react-tooltip";
@@ -211,14 +211,20 @@ const AVATAR_EMOJI = [
 * content is portaled outside the editor root, where the `--docblocks-*`
 * tokens are not mapped).
 */
-function EmojiPicker({ selected, onPick, onClear }) {
+/** The picker's i18n scope: the package's instance stands the provider's seat
+*  over the picker (it stands also outside the editor's scope). */
+function EmojiPicker(props) {
+	return /* @__PURE__ */ jsx(DocblocksI18nProvider, { children: /* @__PURE__ */ jsx(EmojiPickerInner, { ...props }) });
+}
+function EmojiPickerInner({ selected, onPick, onClear }) {
+	const { t } = useTranslation("editor");
 	const pickEmoji = (emoji) => () => onPick(emoji);
 	return /* @__PURE__ */ jsxs("div", {
 		"data-slot": "docblocks/emoji-picker",
 		className: "flex w-52 flex-col gap-2",
 		children: [/* @__PURE__ */ jsx("div", {
 			role: "group",
-			"aria-label": "Avatar emoji",
+			"aria-label": t("shared.emojiPickerGroup"),
 			className: "grid grid-cols-6 gap-1",
 			children: AVATAR_EMOJI.map(({ emoji, label }) => {
 				const isSelected = selected === emoji;
@@ -246,7 +252,7 @@ function EmojiPicker({ selected, onPick, onClear }) {
 			"data-slot": "docblocks/emoji-picker-clear",
 			className: "\n          -mx-1 h-auto px-2 py-1 text-left text-xs font-normal text-muted-foreground transition-colors\n          focus-visible:ring-0 focus-visible:outline-1 focus-visible:outline-ring\n        ",
 			onClick: onClear,
-			children: "Remove avatar"
+			children: t("shared.removeAvatar")
 		})]
 	});
 }
@@ -374,6 +380,101 @@ function TooltipContent({ className, sideOffset = 0, children, ...props }) {
 	}) });
 }
 //#endregion
+//#region src/database/standalone/DatabaseTable.tsx
+/** The stable absent-seed's stand (the `view` prop's absent stand). */
+const EMPTY_VIEW = {};
+/**
+* The standalone's database table: the live grid over the bridge's table
+* id — the same `useDatabaseTable`'s data stand as the document block
+* (the schema + the rows + the live events + the optimistic cell's layer),
+* rendered outside any document (the consumer's own page / panel). The
+* view's settings stand the internal's state (seeded from the `view`
+* prop) + the consumer's persistence over the `onViewChange`'s patch
+* (one patch per change, as the block's `updateBlock` stand). The i18n's
+* scope stands self-contained (the package's instance — the same's stand
+* as the consumer-placed components).
+*/
+function DatabaseTable({ bridge, tableId, readOnly = false, view, onViewChange }) {
+	const [viewState, setViewState] = useState(view ?? EMPTY_VIEW);
+	const viewRef = useRef(viewState);
+	viewRef.current = viewState;
+	const handleViewChange = useCallback((patch) => {
+		const typed = patch;
+		setViewState((current) => ({
+			...current,
+			...typed
+		}));
+		if (onViewChange !== void 0) onViewChange(typed);
+	}, [onViewChange]);
+	return /* @__PURE__ */ jsx(DocblocksI18nProvider, { children: /* @__PURE__ */ jsx(GridBody, {
+		bridge,
+		tableId,
+		filter: viewState.filter,
+		columnOrder: viewState.columnOrder,
+		hiddenColumns: viewState.hiddenColumns,
+		columnWidths: viewState.columnWidths,
+		onViewChange: handleViewChange,
+		readColumnOrder: () => viewRef.current.columnOrder,
+		readOnly
+	}) });
+}
+//#endregion
+//#region src/database/standalone/use-table-list.ts
+/**
+* The table catalog's hook (the standalone's stand): the consumer's
+* `DatabaseBridge`'s catalog read (`listTables` — the system tables stand
+* absent) + the `createTable` / `renameTable` mutations (the fresh's
+* `operationId` per op over `newMutationContext`). The catalog's truth
+* stands in the bridge — the hook's state is the read projection,
+* re-read over the own's successful mutations (the auto's stand) + the
+* manual's `refresh` (the contract's catalog stands no push — the
+* per-table's events stand over the `useDatabaseTable`'s subscription).
+* The create / rename's failures stand their promises' rejects (the
+* `BridgeError` stand) — the `error` state is the catalog read's own.
+*/
+function useTableList(bridge) {
+	const [tables, setTables] = useState(null);
+	const [loading, setLoading] = useState(true);
+	const [error, setError] = useState(null);
+	const bridgeRef = useRef(bridge);
+	bridgeRef.current = bridge;
+	const readSeq = useRef(0);
+	const refresh = useCallback(async () => {
+		const seq = ++readSeq.current;
+		setLoading(true);
+		try {
+			const list = await bridgeRef.current.listTables();
+			if (seq !== readSeq.current) return;
+			setTables(list);
+			setError(null);
+		} catch (error) {
+			if (seq !== readSeq.current) return;
+			setTables(null);
+			setError(toBridgeError(error));
+		} finally {
+			if (seq === readSeq.current) setLoading(false);
+		}
+	}, []);
+	useEffect(() => {
+		refresh();
+	}, [refresh]);
+	return {
+		tables,
+		loading,
+		error,
+		refresh,
+		create: useCallback(async (name) => {
+			const receipt = await bridgeRef.current.createTable({ name }, newMutationContext());
+			await refresh();
+			return receipt.result;
+		}, [refresh]),
+		rename: useCallback(async (tableId, name) => {
+			await bridgeRef.current.renameTable(tableId, { name }, newMutationContext());
+			await refresh();
+		}, [refresh])
+	};
+}
+//#endregion
 //#region src/DocHeader.tsx
 /**
 * The document's header panel — a consumer-placed component (outside the
@@ -436,7 +537,16 @@ function InlineEditInput({ initial, ariaLabel, slot, className, onCommit, onCanc
 		onKeyDown: onInputKeyDown
 	});
 }
-function DocHeader({ doc, view, onViewChange, accessLevel = "editor", mode = "edit", onModeChange, publishedDoc }) {
+/** The header's i18n scope: the package's instance stands the provider's seat
+*  over the panel (the consumer places the header outside the editor — the
+*  editor's own scope never reaches it). A consumer-wrapped subtree stands
+*  the same instance nested — the provider is a plain context, the render
+*  is unchanged. */
+function DocHeader(props) {
+	return /* @__PURE__ */ jsx(DocblocksI18nProvider, { children: /* @__PURE__ */ jsx(DocHeaderInner, { ...props }) });
+}
+function DocHeaderInner({ doc, view, onViewChange, accessLevel = "editor", mode = "edit", onModeChange, publishedDoc }) {
+	const { t } = useTranslation("editor");
 	const effectiveMode = accessLevel === "viewer" ? "published" : mode;
 	const viewMode = effectiveMode !== "edit";
 	const snapshot = effectiveMode === "published" ? accessLevel === "viewer" ? doc ?? null : publishedDoc ?? null : null;
@@ -490,16 +600,16 @@ function DocHeader({ doc, view, onViewChange, accessLevel = "editor", mode = "ed
 			/* @__PURE__ */ jsx(SegmentSelector, {
 				options: [{
 					value: "page",
-					label: "Page view",
+					label: t("docHeader.pageView"),
 					icon: /* @__PURE__ */ jsx(SquareText, { className: "size-4" })
 				}, {
 					value: "canvas",
-					label: "Canvas view",
+					label: t("docHeader.canvasView"),
 					icon: /* @__PURE__ */ jsx(Network, { className: "size-4" })
 				}],
 				value: view,
 				onChange: switchView,
-				ariaLabel: "Document view",
+				ariaLabel: t("docHeader.documentViewAria"),
 				slot: "docblocks/doc-header-view",
 				pillSlot: "docblocks/doc-header-view-pill",
 				buttonAttrName: "doc-header-view-button"
@@ -508,31 +618,31 @@ function DocHeader({ doc, view, onViewChange, accessLevel = "editor", mode = "ed
 				options: [
 					{
 						value: "edit",
-						label: "Edit mode",
+						label: t("docHeader.editMode"),
 						icon: /* @__PURE__ */ jsx(Pen, { className: "size-4" })
 					},
 					{
 						value: "view",
-						label: "View mode",
+						label: t("docHeader.viewMode"),
 						icon: /* @__PURE__ */ jsx(Eye, { className: "size-4" })
 					},
 					{
 						value: "published",
-						label: "Published",
+						label: t("docHeader.published"),
 						icon: /* @__PURE__ */ jsx(BookOpen, { className: "size-4" }),
 						disabled: publishedDoc === null || publishedDoc === void 0
 					}
 				],
 				value: effectiveMode,
 				onChange: switchMode,
-				ariaLabel: "Document mode",
+				ariaLabel: t("docHeader.documentModeAria"),
 				slot: "docblocks/doc-header-mode",
 				pillSlot: "docblocks/doc-header-mode-pill",
 				buttonAttrName: "doc-header-mode-button"
 			}) : null,
 			viewMode ? /* @__PURE__ */ jsx("span", {
 				"data-slot": "docblocks/doc-header-avatar",
-				"aria-label": "Document avatar",
+				"aria-label": t("docHeader.documentAvatarAria"),
 				className: cn("flex size-8 shrink-0 items-center justify-center overflow-hidden rounded-full text-base font-normal", displayMeta.avatar ? "bg-muted" : "border border-dashed border-input text-muted-foreground"),
 				children: displayMeta.avatar ?? ""
 			}) : /* @__PURE__ */ jsxs(Popover, {
@@ -545,8 +655,8 @@ function DocHeader({ doc, view, onViewChange, accessLevel = "editor", mode = "ed
 						variant: "ghost",
 						size: "icon",
 						"data-slot": "docblocks/doc-header-avatar",
-						"aria-label": "Edit the document avatar",
-						title: "Edit the avatar",
+						"aria-label": t("docHeader.editAvatarAria"),
+						title: t("docHeader.editAvatar"),
 						className: cn("size-8 shrink-0 overflow-hidden rounded-full text-base font-normal", liveMeta.avatar ? "bg-muted" : "border border-dashed border-input text-muted-foreground"),
 						children: liveMeta.avatar ? liveMeta.avatar : "+"
 					})
@@ -564,30 +674,30 @@ function DocHeader({ doc, view, onViewChange, accessLevel = "editor", mode = "ed
 			}),
 			titleEditing && !viewMode ? /* @__PURE__ */ jsx(InlineEditInput, {
 				initial: liveMeta.title,
-				ariaLabel: "Document title",
+				ariaLabel: t("docHeader.documentTitleAria"),
 				slot: "docblocks/doc-header-title-edit",
 				className: "\n            h-auto min-w-0 flex-1 border-0 bg-background p-0 text-lg font-semibold shadow-none\n            focus-visible:ring-0\n            dark:bg-transparent\n          ",
 				onCommit: commitTitleEdit,
 				onCancel: cancelTitleEdit
 			}) : viewMode ? /* @__PURE__ */ jsx("span", {
 				"data-slot": "docblocks/doc-header-title",
-				"aria-label": "Document title",
+				"aria-label": t("docHeader.documentTitleAria"),
 				className: "min-w-0 flex-1 truncate text-left text-lg font-semibold",
 				children: displayMeta.title || /* @__PURE__ */ jsx("span", {
 					className: "text-muted-foreground",
-					children: "Untitled"
+					children: t("common:untitled")
 				})
 			}) : /* @__PURE__ */ jsx(Button, {
 				type: "button",
 				variant: "ghost",
 				"data-slot": "docblocks/doc-header-title",
-				"aria-label": "Edit the document title",
-				title: "Edit the title",
+				"aria-label": t("docHeader.editTitleAria"),
+				title: t("docHeader.editTitle"),
 				onClick: beginTitleEdit,
 				className: "h-auto min-w-0 flex-1 truncate text-left text-lg font-semibold",
 				children: liveMeta.title || /* @__PURE__ */ jsx("span", {
 					className: "text-muted-foreground",
-					children: "Untitled"
+					children: t("common:untitled")
 				})
 			})
 		]
@@ -638,4 +748,4 @@ const UI_FONT_STACK = "'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif
 */
 const MONO_FONT_STACK = "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";
 //#endregion
-export { Alert, AlertDescription, AlertTitle, BASELINE_CAPABILITIES, BRIDGE_ERROR_CODES, Badge, BareSelect, BridgeError, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, DEFAULT_EMBED_SANDBOX, DocHeader, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Editor, EditorProvider, FORMAT_PALETTE, FilterBuilder, Input, Label, MONO_FONT_STACK, PROTOCOL_VERSION, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, SHAPE_FONT_OPTIONS, SHAPE_FONT_STACKS, ScrollArea, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, TEXT_TYPES, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UI_FONT_ID, UI_FONT_STACK, badgeVariants, blobSubtypeOf, buttonVariants, cellValueEqual, cn, columnAnnotation, conditionMatches, createMemoryBlobStore, emptyFilter, filterIsComplete, isBridgeError, isBridgeErrorCode, isDatabaseBridge, markToggleAction, newMutationContext, parseCellValue, renderRuns, toBridgeError, useBlock, useDatabaseTable, useDoc, useEditorContext, useMeta, usePresence, useSelection, useSelectionView, useText, validateProtocolDescriptor };
+export { Alert, AlertDescription, AlertTitle, BASELINE_CAPABILITIES, BRIDGE_ERROR_CODES, Badge, BareSelect, BridgeError, Button, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, DEFAULT_EMBED_SANDBOX, DatabaseTable, DocHeader, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Editor, EditorProvider, FORMAT_PALETTE, FilterBuilder, Input, Label, MONO_FONT_STACK, PROTOCOL_VERSION, Popover, PopoverAnchor, PopoverContent, PopoverDescription, PopoverHeader, PopoverTitle, PopoverTrigger, SHAPE_FONT_OPTIONS, SHAPE_FONT_STACKS, ScrollArea, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Skeleton, TEXT_TYPES, Tabs, TabsContent, TabsList, TabsTrigger, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UI_FONT_ID, UI_FONT_STACK, badgeVariants, blobSubtypeOf, buttonVariants, cellValueEqual, cn, columnAnnotation, conditionMatches, createMemoryBlobStore, emptyFilter, filterIsComplete, isBridgeError, isBridgeErrorCode, isDatabaseBridge, markToggleAction, newMutationContext, parseCellValue, renderRuns, toBridgeError, useBlock, useDatabaseTable, useDoc, useEditorContext, useMeta, usePresence, useSelection, useSelectionView, useTableList, useText, validateProtocolDescriptor };

package/dist/mermaid/index.mjs

@@ -1,9 +1,9 @@
-import { Ht as AlertDescription, Nt as Eye, Pt as CodeXml, Ut as AlertTitle, Vt as Alert, c as CodeHeader, h as textOf, hn as INLINE_CODE_CLASS, k as useEditorContext, m as TextBlock, s as childrenSlot, z as SegmentSelector } from "../Editor-CiJY5R4v.mjs";
+import { Gt as INLINE_CODE_CLASS, St as AlertTitle, b as Skeleton, bt as Alert, c as textOf, d as useEditorContext, ft as Eye, n as childrenSlot, pt as CodeXml, r as CodeHeader, s as TextBlock, x as SegmentSelector, xt as AlertDescription } from "../Editor-YAlRhGNW.mjs";
 import { n as TriangleAlert } from "../constants-D4FTL0ph.mjs";
 import { t as LoaderCircle } from "../LoaderCircle-AGVFE4IP.mjs";
-import { t as Skeleton } from "../Skeleton-D922Ths5.mjs";
 import { useEffect, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { useTranslation } from "react-i18next";
 import mermaid from "mermaid";
 //#region src/mermaid/mermaid-config.ts
 /** The mermaid renderer's config stand (the v1 security + behavior stand —
@@ -44,7 +44,7 @@ function safeId(id) {
 	return id.replace(/[^a-zA-Z0-9_-]/g, "");
 }
 //#endregion
-//#region src/mermaid/useContainerTheme.ts
+//#region src/mermaid/use-container-theme.ts
 /** The editor's theme for one ref'd element, reactive to a theme flip:
 * a single MutationObserver watches the `class` attribute of the
 * element's ancestor chain (collected on mount — the preview's branch
@@ -93,6 +93,7 @@ function useContainerTheme(ref) {
 /** A unique mermaid render id per attempt (mermaid requires one per render). */
 let renderSeq = 0;
 function MermaidDiagram({ id, text }) {
+	const { t } = useTranslation("blocks");
 	const containerRef = useRef(null);
 	const theme = useContainerTheme(containerRef);
 	const [state, setState] = useState({
@@ -165,7 +166,7 @@ function MermaidDiagram({ id, text }) {
 			className: "absolute inset-0 flex items-center justify-center gap-2",
 			children: [/* @__PURE__ */ jsx(LoaderCircle, { className: "size-4 animate-spin" }), /* @__PURE__ */ jsx("span", {
 				"data-slot": "docblocks/mermaid-loading",
-				children: "rendering…"
+				children: t("code.rendering")
 			})]
 		})]
 	});

package/dist/pdf/index.d.mts

@@ -1,4 +1,4 @@
-import { f as PdfPreviewProps } from "../index-D6_ysSmQ.mjs";
+import { f as PdfPreviewProps } from "../index-DOKS86aH.mjs";
 //#region src/pdf/PdfFirstPage.d.ts
 declare function PdfFirstPage({ id, url, name }: PdfPreviewProps): import("react").JSX.Element;
 //#endregion

package/dist/pdf/index.mjs

@@ -2,6 +2,7 @@ import { a as isSafeDownloadHref, c as cn, n as TriangleAlert, t as isEmbeddable
 import { t as LoaderCircle } from "../LoaderCircle-AGVFE4IP.mjs";
 import { useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useTranslation } from "react-i18next";
 import { GlobalWorkerOptions, RenderingCancelledException, getDocument } from "pdfjs-dist";
 //#region src/pdf/pdf-worker.ts
 /** The pdfjs-dist worker wiring (the side-effect): the worker file is
@@ -22,6 +23,9 @@ import { GlobalWorkerOptions, RenderingCancelledException, getDocument } from "p
 const WORKER_URL = new URL(`./pdf.worker.min.mjs`, import.meta.url);
 GlobalWorkerOptions.workerSrc = WORKER_URL.toString();
 const WASM_URL = new URL("./", WORKER_URL).toString();
+if (typeof window !== "undefined") fetch(WORKER_URL, { method: "HEAD" }).catch(() => {
+	console.warn("docblocks: the pdf worker's asset is unreachable over this entry — the pdf preview stands the native viewer's fallback (the worker's load fails). The dist/pdf/ directory must stand served as static assets next to the subpath's entry.");
+});
 //#endregion
 //#region src/pdf/PdfFirstPage.tsx
 /** The first-page preview of one `pdf`-subtype image block: fetch the
@@ -33,6 +37,7 @@ const WASM_URL = new URL("./", WORKER_URL).toString();
 * so a torn-down preview leaves no network request or pdf.js worker
 * behind. */
 function PdfFirstPage({ id, url, name }) {
+	const { t } = useTranslation("blocks");
 	const canvasRef = useRef(null);
 	const loadingTaskRef = useRef(null);
 	const renderTaskRef = useRef(null);
@@ -111,13 +116,9 @@ function PdfFirstPage({ id, url, name }) {
 		children: [/* @__PURE__ */ jsxs("div", {
 			"data-slot": "docblocks/image-pdf-error",
 			className: "\n            mb-2 flex items-center gap-2 rounded-(--docblocks-radius) border-(length:--docblocks-table-border-width)\n            border-(--docblocks-table-border-color) bg-(--muted) px-3 py-2 text-sm text-(--muted-foreground)\n          ",
-			children: [/* @__PURE__ */ jsx(TriangleAlert, { className: "size-4 shrink-0" }), /* @__PURE__ */ jsxs("span", {
+			children: [/* @__PURE__ */ jsx(TriangleAlert, { className: "size-4 shrink-0" }), /* @__PURE__ */ jsx("span", {
 				className: "min-w-0 flex-1 truncate",
-				children: [
-					"PDF preview unavailable (",
-					error,
-					"). Showing the built-in viewer."
-				]
+				children: t("code.pdfPreviewUnavailable", { error })
 			})]
 		}), isEmbeddablePdfUrl(url) ? /* @__PURE__ */ jsx("iframe", {
 			"data-slot": "docblocks/image-pdf",
@@ -155,7 +156,7 @@ function PdfFirstPage({ id, url, name }) {
 			className: "flex h-48 w-full items-center justify-center gap-2 text-sm text-(--muted-foreground)",
 			children: [/* @__PURE__ */ jsx(LoaderCircle, { className: "size-4 animate-spin" }), /* @__PURE__ */ jsx("span", {
 				"data-slot": "docblocks/image-pdf-loading",
-				children: "loading preview…"
+				children: t("code.pdfLoading")
 			})]
 		})]
 	});