@shadow-garden/bapbong-ui 0.1.0

package/dist/lib/cell-properties.d.ts

@@ -0,0 +1,35 @@
+import type { BorderStyle } from '@shadow-garden/bapbong-contracts';
+/** Which edges a border preset paints (Outside/Inside are position-dependent
+ *  across a multi-cell block — the host resolves them per cell). */
+export type BorderPreset = 'all' | 'none' | 'outside' | 'inside' | 'top' | 'bottom' | 'left' | 'right' | 'insideH' | 'insideV';
+/** The chosen border pen + which preset to apply it with. */
+export interface BorderChoice {
+    preset: BorderPreset;
+    /** Stroke width in CSS px (converted from the pt picker). */
+    width: number;
+    style: BorderStyle;
+    color: string;
+}
+export interface CellPropsResult {
+    background: string | null;
+    vAlign: 'top' | 'center' | 'bottom';
+    /** Present only if the user picked a border preset (else borders untouched). */
+    border?: BorderChoice;
+}
+export interface CellPropertiesOptions {
+    initial: {
+        background: string | null;
+        vAlign: 'top' | 'center' | 'bottom';
+    };
+    /** Disable Inside / Inside-H / Inside-V (meaningless for a 1×1 selection). */
+    singleCell: boolean;
+    onApply: (result: CellPropsResult) => void;
+}
+/**
+ * The cell-properties dialog (modal): fill, vertical alignment, and a Word/Docs
+ * style borders panel (10 presets + width / style / colour). Borders are
+ * action-based — pick the pen, click a preset, and on Apply the host paints
+ * that preset across the selected block. Untouched borders are left as-is.
+ */
+export declare function openCellProperties({ initial, singleCell, onApply }: CellPropertiesOptions): void;
+//# sourceMappingURL=cell-properties.d.ts.map

package/dist/lib/cell-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-properties.d.ts","sourceRoot":"","sources":["../../src/lib/cell-properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAIpE;oEACoE;AACpE,MAAM,MAAM,YAAY,GACpB,KAAK,GACL,MAAM,GACN,SAAS,GACT,QAAQ,GACR,KAAK,GACL,QAAQ,GACR,MAAM,GACN,OAAO,GACP,SAAS,GACT,SAAS,CAAC;AAEd,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpC,gFAAgF;IAChF,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;KAAE,CAAC;IAC5E,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;CAC5C;AAiFD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,qBAAqB,GAAG,IAAI,CAyLhG"}

package/dist/lib/context-menu.d.ts

@@ -0,0 +1,24 @@
+/** A one-shot context-menu row. */
+export interface ContextMenuItem {
+    label: string;
+    run: () => void;
+    /** Render disabled when false. */
+    enabled?: boolean;
+    /** Optional right-aligned hint (e.g. '⌘X'). */
+    shortcut?: string;
+}
+export type ContextMenuEntry = ContextMenuItem | 'separator';
+export interface ContextMenuHandle {
+    close(): void;
+}
+/**
+ * Show a context menu at viewport point `at`. One-shot rows (label + run, with
+ * optional enabled/shortcut) and separators; closes on select, outside click,
+ * Escape, or scroll. Only one is open at a time. Reusable for any right-click
+ * surface — the editor's pointer hook gives the host the position + target.
+ */
+export declare function showContextMenu(entries: ContextMenuEntry[], at: {
+    x: number;
+    y: number;
+}): ContextMenuHandle;
+//# sourceMappingURL=context-menu.d.ts.map

package/dist/lib/context-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.d.ts","sourceRoot":"","sources":["../../src/lib/context-menu.ts"],"names":[],"mappings":"AAEA,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,KAAK,IAAI,IAAI,CAAC;CACf;AAuBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CA2E5G"}

package/dist/lib/dialog.d.ts

@@ -0,0 +1,55 @@
+export interface DialogOptions {
+    title?: string;
+    /** Modal (backdrop + focus trap) vs non-modal floating panel. Default false. */
+    modal?: boolean;
+    /** Extra class on the `<dialog>` element. */
+    className?: string;
+    /**
+     * Pin a non-modal dialog's top-right corner just inside this rect (e.g. the
+     * editor's canvas viewport) instead of the screen corner. Re-evaluated on
+     * open + scroll/resize. Return null to fall back to the default position.
+     */
+    anchor?: () => DOMRect | null;
+}
+/**
+ * A generic, framework-agnostic dialog — a reusable overlay primitive built on
+ * the native `<dialog>` element (so modal mode gets focus-trapping, `Esc` and a
+ * backdrop for free). Drop any element into `body`; call `open()` / `close()`.
+ * Used by the find panel, the prompt helper, the keyboard-shortcuts popup, and
+ * (later) the cell-properties dialog — one primitive, not N bespoke widgets.
+ */
+export declare class Dialog {
+    readonly el: HTMLDialogElement;
+    /** Content slot — put your element(s) here. */
+    readonly body: HTMLElement;
+    private readonly title;
+    private readonly modal;
+    private readonly anchor?;
+    private readonly closeListeners;
+    private readonly reposition;
+    constructor(options?: DialogOptions);
+    private attachReposition;
+    private detachReposition;
+    setTitle(text: string): void;
+    /** Replace the body content. */
+    setContent(node: HTMLElement): void;
+    open(): void;
+    close(): void;
+    get isOpen(): boolean;
+    /** Subscribe to close (Esc, ✕, backdrop, or `close()`); returns unsubscribe. */
+    onClose(cb: () => void): () => void;
+    destroy(): void;
+}
+export interface PromptOptions {
+    title: string;
+    placeholder?: string;
+    initial?: string;
+    confirm?: string;
+    cancel?: string;
+}
+/**
+ * A one-line input modal built on {@link Dialog} — the vanilla replacement for
+ * `window.prompt`. Resolves to the trimmed value, or null if cancelled/closed.
+ */
+export declare function promptDialog(options: PromptOptions): Promise<string | null>;
+//# sourceMappingURL=dialog.d.ts.map

package/dist/lib/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../src/lib/dialog.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;CAC/B;AAqBD;;;;;;GAMG;AACH,qBAAa,MAAM;IACjB,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAOzB;gBAEU,OAAO,GAAE,aAAkB;IA4CvC,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,gBAAgB;IAKxB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5B,gCAAgC;IAChC,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAInC,IAAI,IAAI,IAAI;IAUZ,KAAK,IAAI,IAAI;IAIb,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,gFAAgF;IAChF,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKnC,OAAO,IAAI,IAAI;CAKhB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4C3E"}

package/dist/lib/find.d.ts

@@ -0,0 +1,53 @@
+/** Query / match-count snapshot the find plugin emits. */
+export interface FindState {
+    query: string;
+    count: number;
+    /** 1-based index of the active match (0 when none). */
+    active: number;
+}
+/**
+ * The find/replace surface the panel binds to — the editor's `find` handle
+ * (FindPlugin) satisfies it structurally, so this package never imports the
+ * editor (same decoupling as {@link EditorHandle}).
+ */
+export interface FindHandle {
+    setQuery(q: string): void;
+    next(): void;
+    prev(): void;
+    clear(): void;
+    replaceCurrent(text: string): void;
+    replaceAll(text: string): void;
+    /** Subscribe to query/count/active changes; returns an unsubscribe. */
+    onState(cb: (s: FindState) => void): () => void;
+}
+export interface FindDialogOptions {
+    /** Modal vs non-modal (default false — keeps the document editable). */
+    modal?: boolean;
+    /** Pin the panel's top-right inside this rect (e.g. the canvas viewport). */
+    anchor?: () => DOMRect | null;
+    /** Open on Ctrl/Cmd+F (pre-empting the browser's native find). Default true. */
+    shortcut?: boolean;
+    /** Override the (English) default labels for i18n. */
+    labels?: Partial<{
+        title: string;
+        find: string;
+        replace: string;
+        prev: string;
+        next: string;
+        replaceOne: string;
+        replaceAll: string;
+    }>;
+}
+export interface FindDialogHandle {
+    open(): void;
+    close(): void;
+    destroy(): void;
+}
+/**
+ * Build a find/replace panel inside a {@link Dialog}, bound to `find`
+ * (`editor.find`). Returns open/close/destroy; opening focuses the query input,
+ * closing clears the search so highlights go away. The host (any framework)
+ * just opens it from a menu / shortcut.
+ */
+export declare function createFindDialog(find: FindHandle, options?: FindDialogOptions): FindDialogHandle;
+//# sourceMappingURL=find.d.ts.map

package/dist/lib/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/lib/find.ts"],"names":[],"mappings":"AAGA,0DAA0D;AAC1D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,IAAI,IAAI,CAAC;IACb,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uEAAuE;IACvE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB;AAuBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAuGpG"}

package/dist/lib/internal.d.ts

@@ -0,0 +1,25 @@
+import type { Collection, Command, Dispatch, EditorChange } from '@shadow-garden/bapbong-contracts';
+/** The editor `run` state type, derived from the {@link Command} contract so
+ *  this package needs no direct ProseMirror dependency. */
+export type EditorStateOf = Parameters<Command['run']>[0];
+/**
+ * The minimal editor surface every bapbong-ui widget binds to. `BapbongEditor`
+ * satisfies it structurally, so this package never imports the editor — both
+ * just speak the `contracts` vocabulary (the same decoupling as the plugin
+ * contract). A host framework only supplies the element + this handle.
+ */
+export interface EditorHandle {
+    /** Named command registry the UI renders + dispatches against. */
+    readonly commands: Collection<Command>;
+    /** Current document + selection (throws before a document is loaded). */
+    readonly state: EditorStateOf;
+    /** Apply a transaction. */
+    dispatch: Dispatch;
+    /** Return focus to the editor (after a control takes a click). */
+    focus(): void;
+    /** Subscribe to editor cycles; returns an unsubscribe. Drives active state. */
+    onChange(cb: (c: EditorChange) => void): () => void;
+}
+/** Inject a stylesheet once, keyed by `id` (idempotent across mounts). */
+export declare function injectStyle(id: string, css: string): void;
+//# sourceMappingURL=internal.d.ts.map

package/dist/lib/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/lib/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEpG;2DAC2D;AAC3D,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACvC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,2BAA2B;IAC3B,QAAQ,EAAE,QAAQ,CAAC;IACnB,kEAAkE;IAClE,KAAK,IAAI,IAAI,CAAC;IACd,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CACrD;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAMzD"}

package/dist/lib/menubar.d.ts

@@ -0,0 +1,56 @@
+import type { Collection, Command } from '@shadow-garden/bapbong-contracts';
+import { type EditorHandle } from './internal.js';
+/** Run a registry command (and read its active/enabled state). */
+export interface CommandEntry {
+    command: string;
+    label?: string;
+}
+/** Run a host-supplied action (File ▸ Open, View ▸ comment mode, Help…). */
+export interface ActionEntry {
+    label: string;
+    run: () => void;
+    isActive?: () => boolean;
+    isEnabled?: () => boolean;
+    shortcut?: string;
+}
+/** A nested dropdown. */
+export interface SubmenuEntry {
+    label: string;
+    submenu: MenuEntry[];
+}
+/** Custom flyout content (e.g. a table size grid). `close` dismisses the menu. */
+export interface WidgetEntry {
+    label: string;
+    widget: (close: () => void) => HTMLElement;
+}
+export type MenuEntry = 'separator' | CommandEntry | ActionEntry | SubmenuEntry | WidgetEntry;
+/** A top-level menu (its title + dropdown entries). */
+export interface Menu {
+    label: string;
+    entries: MenuEntry[];
+}
+export interface MenubarOptions {
+    /** Menus to render. Default: a single "Format" menu derived from the registry. */
+    menus?: Menu[];
+    /** Command-name → row label override, merged over the built-in labels. */
+    labels?: Record<string, string>;
+    /** `vertical` stacks the menu titles in a column and opens each dropdown to
+     *  the right, bottom-aligned so it grows upward — for a menubar docked in a
+     *  corner (e.g. bottom-left). Default `horizontal` (a classic top bar). */
+    orientation?: 'horizontal' | 'vertical';
+}
+export interface MenubarHandle {
+    destroy(): void;
+}
+/** Default menus: a "Format" menu of marks, a separator, then alignments —
+ *  only the commands the registry actually has. */
+export declare function defaultMenus(commands: Collection<Command>): Menu[];
+/**
+ * Render a menubar into `host` and wire it to `editor`. Top-level titles open
+ * dropdowns; entries can be registry commands (with an active check), host
+ * actions, nested submenus, or custom widgets. The lib owns the DOM, styling,
+ * open/close and active state; the host framework only supplies the element +
+ * the editor handle, then calls `destroy()`.
+ */
+export declare function mountMenubar(host: HTMLElement, editor: EditorHandle, options?: MenubarOptions): MenubarHandle;
+//# sourceMappingURL=menubar.d.ts.map

package/dist/lib/menubar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menubar.d.ts","sourceRoot":"","sources":["../../src/lib/menubar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,KAAK,YAAY,EAAmC,MAAM,eAAe,CAAC;AAEnF,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,yBAAyB;AACzB,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AACD,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,IAAI,KAAK,WAAW,CAAC;CAC5C;AACD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC;AAE9F,uDAAuD;AACvD,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC;;+EAE2E;IAC3E,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AAmDD;mDACmD;AACnD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAUlE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,cAAmB,GAC3B,aAAa,CA0Lf"}

package/dist/lib/table-grid.d.ts

@@ -0,0 +1,14 @@
+export interface TableGridOptions {
+    /** Max selectable rows / columns (the grid size). Default 8 × 10. */
+    maxRows?: number;
+    maxCols?: number;
+    /** Called with the 1-based size when a cell is clicked. */
+    onPick: (rows: number, cols: number) => void;
+}
+/**
+ * A Word/Docs-style table size picker: hover the grid to size, click to choose.
+ * Returns a detached element to drop into a menu widget flyout; calls
+ * `onPick(rows, cols)` (1-based) on click.
+ */
+export declare function tableGridPicker(options: TableGridOptions): HTMLElement;
+//# sourceMappingURL=table-grid.d.ts.map

package/dist/lib/table-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-grid.d.ts","sourceRoot":"","sources":["../../src/lib/table-grid.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAUD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,WAAW,CAuCtE"}

package/dist/lib/toolbar.d.ts

@@ -0,0 +1,73 @@
+import type { Collection, Command } from '@shadow-garden/bapbong-contracts';
+import { type EditorHandle, type EditorStateOf } from './internal.js';
+/** Presentation for one toolbar button — the headless {@link Command} carries
+ *  no UI, so labels/icons live here. */
+export interface ToolbarItem {
+    /** Tooltip + accessible label. */
+    title: string;
+    /** Text/glyph shown when `svg` is absent. */
+    label?: string;
+    /** Inline SVG markup (used instead of `label`). */
+    svg?: string;
+    /** Extra class on the button (e.g. to render a bold "B"). */
+    className?: string;
+}
+/** A dropdown control in the toolbar (e.g. font size / family). The host owns
+ *  the command to run — the toolbar just renders the `<select>` and reports the
+ *  current value, so the lib stays decoupled from specific commands. */
+export interface ToolbarSelect {
+    kind: 'select';
+    /** Tooltip + accessible label. */
+    title: string;
+    options: {
+        label: string;
+        value: string;
+    }[];
+    /** Current value to show from editor state (`''` = none / mixed). */
+    value: (state: EditorStateOf) => string;
+    /** Called when the user picks a value. */
+    onSelect: (value: string) => void;
+    /** Fixed width in px (defaults to auto). */
+    width?: number;
+}
+/** A colour-picker control: a button (a glyph over a colour bar) that opens a
+ *  swatch palette. The host owns the command; the lib renders the popover. */
+export interface ToolbarColor {
+    kind: 'color';
+    title: string;
+    /** Glyph above the colour bar (e.g. 'A' for text colour, '🖉' for highlight). */
+    glyph: string;
+    /** Swatch colours offered (hex). */
+    swatches: string[];
+    /** Offer a "None / automatic" entry that clears the colour. */
+    allowNone?: boolean;
+    /** Current colour from state (shown in the bar), or null. */
+    value: (state: EditorStateOf) => string | null;
+    /** Called with the picked colour (null = cleared). */
+    onSelect: (color: string | null) => void;
+}
+/** A toolbar group entry: a command name (button) or a control (select/colour). */
+export type ToolbarEntry = string | ToolbarSelect | ToolbarColor;
+export interface ToolbarOptions {
+    /** Groups rendered as separated clusters — command names (buttons) and/or
+     *  controls (selects). Defaults to marks then alignments, from the registry. */
+    groups?: ToolbarEntry[][];
+    /** Presentation per command name, merged over the built-in defaults. */
+    items?: Record<string, ToolbarItem>;
+}
+/** Handle returned by {@link mountToolbar}. */
+export interface ToolbarHandle {
+    destroy(): void;
+}
+/**
+ * Default grouping: every non-`align-*` command, then the `align-*` commands —
+ * derived from the registry so new commands appear without config.
+ */
+export declare function defaultToolbarGroups(commands: Collection<Command>): string[][];
+/**
+ * Render a toolbar into `host` and wire it to `editor`. The lib owns all the
+ * DOM, styling and active-state tracking; a host framework only provides the
+ * element and the editor handle, then calls `destroy()` on teardown.
+ */
+export declare function mountToolbar(host: HTMLElement, editor: EditorHandle, options?: ToolbarOptions): ToolbarHandle;
+//# sourceMappingURL=toolbar.d.ts.map

package/dist/lib/toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../src/lib/toolbar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAe,MAAM,eAAe,CAAC;AAEnF;wCACwC;AACxC,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;wEAEwE;AACxE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,qEAAqE;IACrE,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,CAAC;IACxC,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;8EAC8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,MAAM,GAAG,IAAI,CAAC;IAC/C,sDAAsD;IACtD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAC1C;AAED,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B;oFACgF;IAChF,MAAM,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC;IAC1B,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACrC;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AA0ED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,EAAE,CAK9E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,cAAmB,GAC3B,aAAa,CA4Nf"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@shadow-garden/bapbong-ui",
+  "version": "0.1.0",
+  "description": "bapbong — framework-agnostic editor UI (toolbar/menubar) that mounts into a host element and binds to editor.commands",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shadowgarden-app/bapbong.git",
+    "directory": "packages/ui"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "@shadow-garden/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx": {
+    "tags": [
+      "scope:app"
+    ],
+    "targets": {
+      "build": {
+        "executor": "@nx/esbuild:esbuild",
+        "outputs": [
+          "{options.outputPath}"
+        ],
+        "options": {
+          "outputPath": "packages/ui/dist",
+          "main": "packages/ui/src/index.ts",
+          "tsConfig": "packages/ui/tsconfig.lib.json",
+          "format": [
+            "esm",
+            "cjs"
+          ],
+          "declarationRootDir": "packages/ui/src",
+          "external": [
+            "@shadow-garden/bapbong-contracts"
+          ]
+        }
+      }
+    }
+  },
+  "dependencies": {
+    "@shadow-garden/bapbong-contracts": "^0.1.0"
+  }
+}