docblocks-react-ui 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # docblocks-react-ui
 
+## 0.4.1
+
+### Patch Changes
+
+- ddc068e: The standalone `DatabaseTable` gains a `className` prop: the consumer's
+  sizing / layout classes merge over the component's root (the package's
+  `--docblocks-*` token scope's anchor, merged with the consumer's own
+  classes). The grid already stands the root's width (`w-full`); the
+  `className` closes the height's stand — a height-constrained root (the
+  consumer's `h-*` class) stands the grid's inner scroll over the toolbar
+  
+  - header + rows (the card / content / grid-region's flex plumbing:
+    `flex-1 min-h-0`), and the unconstrained's stand is the content's height
+    (as over the document's database block — the plumbing stands inert over
+    the block's context).
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -422,7 +422,8 @@ function TablesSection({ bridge }: { bridge: DatabaseBridge }) {
 }
 ```
 
-- `DatabaseTable({ bridge, tableId, readOnly?, view?, onViewChange? })` —
+- `DatabaseTable({ bridge, tableId, readOnly?, view?, onViewChange?,
+className? })` —
   the live grid over the bridge's table id (the same data stand as the
   document block: the schema, the rows, the live events, the optimistic
   cell layer). The view's settings (`filter`, `columnOrder`,
@@ -430,7 +431,12 @@ function TablesSection({ bridge }: { bridge: DatabaseBridge }) {
   the optional `view` prop at mount); `onViewChange(patch)` receives one
   patch per change for the consumer's persistence (the controlled mode
   stands absent — the state is never external). `readOnly` gates the
-  editing's paths (the read-only block's parity). The component is
+  editing's paths (the read-only block's parity). The sizing's stand is
+  the consumer's: the grid stands the root's width (`w-full`), and the
+  `className` over the root (the component's own classes stand merged
+  over it) — a height-constrained root stands the grid's inner scroll
+  (the unconstrained's stand is the content's height, as over the
+  document's block). The component is
   self-contained: it wraps itself in the package's i18n scope and anchors
   the `--docblocks-*` token scope over its own root, so it themes
   standalone over the consumer's page (the `dark` class over an ancestor

package/dist/{Editor-BgG_An_T.mjs → Editor-CUToaW9z.mjs}

@@ -9544,6 +9544,7 @@ function GridBody({ blockId, bridge, tableId, filter, columnOrder, hiddenColumns
 		"data-slot": "docblocks/block",
 		"data-block-type": "database",
 		"data-block-id": blockId,
+		className: "min-h-0 flex-1",
 		children: /* @__PURE__ */ jsx(CardContent, {
 			"data-slot": "docblocks/database",
 			"data-state": "loading",
@@ -9559,7 +9560,7 @@ function GridBody({ blockId, bridge, tableId, filter, columnOrder, hiddenColumns
 		"data-slot": "docblocks/block",
 		"data-block-type": "database",
 		"data-block-id": blockId,
-		className: "\n          my-(--docblocks-block-spacing) rounded-(--docblocks-radius) border-(length:--docblocks-table-border-width)\n          border-(--docblocks-table-border-color) outline-none\n        ",
+		className: "\n          my-(--docblocks-block-spacing) min-h-0 flex-1 rounded-(--docblocks-radius)\n          border-(length:--docblocks-table-border-width) border-(--docblocks-table-border-color) outline-none\n        ",
 		children: /* @__PURE__ */ jsxs(CardContent, {
 			"data-slot": "docblocks/database",
 			"data-state": "broken",
@@ -9651,10 +9652,10 @@ function GridBody({ blockId, bridge, tableId, filter, columnOrder, hiddenColumns
 		"data-block-type": "database",
 		"data-block-id": blockId,
 		"data-state": "ready",
-		className: "\n        my-(--docblocks-block-spacing) rounded-(--docblocks-radius) border-(length:--docblocks-table-border-width)\n        border-(--docblocks-table-border-color) outline-none\n      ",
+		className: "\n        my-(--docblocks-block-spacing) flex min-h-0 flex-1 flex-col rounded-(--docblocks-radius)\n        border-(length:--docblocks-table-border-width) border-(--docblocks-table-border-color) outline-none\n      ",
 		children: /* @__PURE__ */ jsxs(CardContent, {
 			"data-slot": "docblocks/database",
-			className: "flex flex-col gap-(--docblocks-block-spacing) p-(--docblocks-block-spacing)",
+			className: "flex min-h-0 flex-1 flex-col gap-(--docblocks-block-spacing) p-(--docblocks-block-spacing)",
 			children: [
 				/* @__PURE__ */ jsxs("div", {
 					"data-slot": "docblocks/database-toolbar",
@@ -9761,6 +9762,7 @@ function GridBody({ blockId, bridge, tableId, filter, columnOrder, hiddenColumns
 				}),
 				/* @__PURE__ */ jsxs(ScrollArea, {
 					"data-slot": "docblocks/database-grid",
+					className: "min-h-0 flex-1",
 					children: [/* @__PURE__ */ jsxs("div", {
 						ref: tableRef,
 						"data-slot": "docblocks/database-table",

package/dist/{index-1dJBnGYv.d.mts → index-BQRTt8x2.d.mts}

@@ -767,6 +767,12 @@ interface DatabaseTableProps {
   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 consumer's sizing / layout's classes over the root (the package's
+   *  token's scope's anchor + the flex-column's stand): the width stands the
+   *  consumer's layout (the grid's `w-full`'s parity), and a height-
+   *  constrained root stands the grid's inner scroll (the unconstrained's
+   *  stand is the content's height, as over the document's block). */
+  className?: string;
 }
 /**
  * The standalone's database table: the live grid over the bridge's table
@@ -777,9 +783,12 @@ interface DatabaseTableProps {
  * 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).
+ * as the consumer-placed components). The sizing's stand is the
+ * consumer's: the `className` over the root (a height-constrained root
+ * stands the grid's inner scroll; the unconstrained's stand is the
+ * content's height).
  */
-declare function DatabaseTable({ bridge, tableId, readOnly, view, onViewChange }: DatabaseTableProps): import("react").JSX.Element;
+declare function DatabaseTable({ bridge, tableId, readOnly, view, onViewChange, className }: DatabaseTableProps): import("react").JSX.Element;
 //#endregion
 //#region src/database/standalone/use-table-list.d.ts
 /**

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { n as BlockRendererMap, r as BlockRendererProps, t as BlockRenderer } from "./index-YJcgf8Hh.mjs";
-import { $ as ProtocolLimits, A as filterIsComplete, B as DatabaseBridge, C as DatabaseTableView, Ct as BlobSubtype, D as DatabaseTableRow, E as DatabaseTablePhase, F as BridgeTableDescription, G as IsoInstant, H as FilterConditionInput, I as BridgeValueInput, J as OperationStatus, K as MutationContext, L as CellMap, M as BatchOp, N as BridgeColumn, O as UseDatabaseTable, P as BridgeColumnAnnotation, Q as ProtocolDescriptor, R as CellValueParse, S as DatabaseTableProps, St as BlobStore, T as useDatabaseTable, Tt as createMemoryBlobStore, U as FilterInput, V as DomainEvent, W as Id, X as PageSnapshot, Y as PageQuery, Z as ProtocolCapability, _ as PresencePeer, _t as isBridgeError, a as EditorContextValue, at as SortInput, b as useTableList, bt as BlobMeta, c as EmbedSandboxPolicy, ct as SubscriptionStatus, d as PdfPreview, dt as TableEvent, et as QueryOperator, f as PdfPreviewProps, ft as TableRef, g as PresenceIdentity, gt as BridgeErrorCode, h as PresenceCrypto, ht as BridgeError, i as AccessLevel, it as RowWire, j as FilterBuilder, k as emptyFilter, l as MentionEntry, lt as TableDescription, m as SyncEmbedResolver, mt as BRIDGE_ERROR_CODES, n as DEFAULT_EMBED_SANDBOX, nt as Revision, o as EditorMode, ot as SubscriptionHandle, p as PresenceConfig, pt as TableSnapshot, q as MutationReceipt, r as EditorProvider, rt as RowPage, s as EditorProviderProps, st as SubscriptionObserver, t as useEditorContext, tt as QuerySemantics, u as MentionProvider, ut as TableEnvelopeBase, v as PresenceSharing, vt as isBridgeErrorCode, w as UseTableList, wt as blobSubtypeOf, x as DatabaseTable, xt as BlobRef, y as PresenceSharingMode, yt as toBridgeError, z as Column } from "./index-1dJBnGYv.mjs";
+import { $ as ProtocolLimits, A as filterIsComplete, B as DatabaseBridge, C as DatabaseTableView, Ct as BlobSubtype, D as DatabaseTableRow, E as DatabaseTablePhase, F as BridgeTableDescription, G as IsoInstant, H as FilterConditionInput, I as BridgeValueInput, J as OperationStatus, K as MutationContext, L as CellMap, M as BatchOp, N as BridgeColumn, O as UseDatabaseTable, P as BridgeColumnAnnotation, Q as ProtocolDescriptor, R as CellValueParse, S as DatabaseTableProps, St as BlobStore, T as useDatabaseTable, Tt as createMemoryBlobStore, U as FilterInput, V as DomainEvent, W as Id, X as PageSnapshot, Y as PageQuery, Z as ProtocolCapability, _ as PresencePeer, _t as isBridgeError, a as EditorContextValue, at as SortInput, b as useTableList, bt as BlobMeta, c as EmbedSandboxPolicy, ct as SubscriptionStatus, d as PdfPreview, dt as TableEvent, et as QueryOperator, f as PdfPreviewProps, ft as TableRef, g as PresenceIdentity, gt as BridgeErrorCode, h as PresenceCrypto, ht as BridgeError, i as AccessLevel, it as RowWire, j as FilterBuilder, k as emptyFilter, l as MentionEntry, lt as TableDescription, m as SyncEmbedResolver, mt as BRIDGE_ERROR_CODES, n as DEFAULT_EMBED_SANDBOX, nt as Revision, o as EditorMode, ot as SubscriptionHandle, p as PresenceConfig, pt as TableSnapshot, q as MutationReceipt, r as EditorProvider, rt as RowPage, s as EditorProviderProps, st as SubscriptionObserver, t as useEditorContext, tt as QuerySemantics, u as MentionProvider, ut as TableEnvelopeBase, v as PresenceSharing, vt as isBridgeErrorCode, w as UseTableList, wt as blobSubtypeOf, x as DatabaseTable, xt as BlobRef, y as PresenceSharingMode, yt as toBridgeError, z as Column } from "./index-BQRTt8x2.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";
@@ -294,7 +294,7 @@ declare function AlertDescription({ className, ...props }: React.ComponentProps<
 //#endregion
 //#region src/shared/ui/Badge.d.ts
 declare const badgeVariants: (props?: ({
-  variant?: "default" | "destructive" | "outline" | "secondary" | "custom" | null | undefined;
+  variant?: "default" | "destructive" | "custom" | "secondary" | "outline" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function Badge({ className, variant, asChild, ...props }: React.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
   asChild?: boolean;
@@ -305,7 +305,7 @@ declare function BareSelect({ className, children, ...props }: React.ComponentPr
 //#endregion
 //#region src/shared/ui/Button.d.ts
 declare const buttonVariants: (props?: ({
-  variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
+  variant?: "link" | "default" | "destructive" | "secondary" | "outline" | "ghost" | null | undefined;
   size?: "default" | "icon" | "sm" | "lg" | "xl" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function Button({ className, variant, size, asChild, type, ...props }: React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-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, Gt as useText, H as DropdownMenuSeparator, Ht as usePresenceSharing, I as DropdownMenuGroup, It as ScrollArea, J as Separator, Jt as blobSubtypeOf, K as DropdownMenuSubTrigger, 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 useSelection, V as DropdownMenuRadioItem, Vt as usePresence, W as DropdownMenuSub, Wt as useSelectionView, X as PopoverAnchor, Y as Popover, Yt as createMemoryBlobStore, 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 renderRuns, 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-BgG_An_T.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, Gt as useText, H as DropdownMenuSeparator, Ht as usePresenceSharing, I as DropdownMenuGroup, It as ScrollArea, J as Separator, Jt as blobSubtypeOf, K as DropdownMenuSubTrigger, 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 useSelection, V as DropdownMenuRadioItem, Vt as usePresence, W as DropdownMenuSub, Wt as useSelectionView, X as PopoverAnchor, Y as Popover, Yt as createMemoryBlobStore, 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 renderRuns, 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-CUToaW9z.mjs";
 import { d as cn, l as preventDefault } from "./constants-BaAj3jDA.mjs";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
@@ -392,9 +392,12 @@ const EMPTY_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).
+* as the consumer-placed components). The sizing's stand is the
+* consumer's: the `className` over the root (a height-constrained root
+* stands the grid's inner scroll; the unconstrained's stand is the
+* content's height).
 */
-function DatabaseTable({ bridge, tableId, readOnly = false, view, onViewChange }) {
+function DatabaseTable({ bridge, tableId, readOnly = false, view, onViewChange, className }) {
 	const [viewState, setViewState] = useState(view ?? EMPTY_VIEW);
 	const viewRef = useRef(viewState);
 	viewRef.current = viewState;
@@ -409,6 +412,7 @@ function DatabaseTable({ bridge, tableId, readOnly = false, view, onViewChange }
 	return /* @__PURE__ */ jsx(DocblocksI18nProvider, { children: /* @__PURE__ */ jsx("div", {
 		"data-slot": "docblocks/editor",
 		"data-readonly": readOnly ? "true" : void 0,
+		className: cn("flex flex-col", className),
 		children: /* @__PURE__ */ jsx(GridBody, {
 			bridge,
 			tableId,

package/dist/mermaid/index.mjs

@@ -1,4 +1,4 @@
-import { Kt 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-BgG_An_T.mjs";
+import { Kt 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-CUToaW9z.mjs";
 import { r as TriangleAlert } from "../constants-BaAj3jDA.mjs";
 import { t as LoaderCircle } from "../LoaderCircle-AGVFE4IP.mjs";
 import { useEffect, useRef, useState } from "react";

package/dist/pdf/index.d.mts

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docblocks-react-ui",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "React rendering + editing layer for docblocks: hooks, block renderers, caret/selection, keyboard, clipboard.",
   "type": "module",
   "license": "MIT",