@shadow-garden/bapbong-ui 0.15.0 → 0.17.0

package/dist/lib/equation-gallery.d.ts

@@ -0,0 +1,44 @@
+import type { EqNode, VectorImageSpec } from '@shadow-garden/bapbong-contracts';
+/** One entry of the built-in gallery: a name and the equation it inserts. */
+export interface BuiltInEquation {
+    name: string;
+    ast: EqNode[];
+}
+/**
+ * The built-in equations Insert ▸ Equation offers, the way Word's gallery
+ * does. Chosen for the documents bapbong is actually used on — Vietnamese
+ * exam papers — so the list is the secondary-school canon, not Word's
+ * (Fourier series has no place in a year-12 paper). Each is a real AST: what
+ * lands in the document is editable, exports as m:oMath, and needs no
+ * conversion.
+ */
+export declare const BUILT_IN_EQUATIONS: readonly BuiltInEquation[];
+/**
+ * A typeset equation drawn as inline SVG — the SAME display list the canvas
+ * painter replays, so a preview is the drawing the page will show rather
+ * than an approximation of it. Pure geometry from contracts: this package
+ * still knows nothing about the layout engine (the caller typesets and
+ * hands the spec over).
+ */
+export declare function equationPreviewSvg(spec: VectorImageSpec, opts?: {
+    maxWidth?: number;
+}): SVGSVGElement;
+export interface EquationGalleryOptions {
+    /** Entries to offer. Defaults to {@link BUILT_IN_EQUATIONS}. */
+    items?: readonly BuiltInEquation[];
+    /**
+     * Typesets one entry the way the document does — hosts pass the layout
+     * engine bound to the editor's own measurer, so a preview matches the
+     * page exactly. Without it the preview falls back to the equation's
+     * linear spelling.
+     */
+    layout?: (ast: EqNode[], sizePt: number) => VectorImageSpec | null;
+    /** A gallery entry was chosen — insert this equation. */
+    onPick: (ast: EqNode[]) => void;
+    /** The footer action: start an empty equation instead. */
+    onNew: () => void;
+    /** Shortcut hint shown beside the footer action (e.g. "⌥="). */
+    newShortcut?: string;
+}
+export declare function equationGallery(options: EquationGalleryOptions): HTMLElement;
+//# sourceMappingURL=equation-gallery.d.ts.map

package/dist/lib/equation-gallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equation-gallery.d.ts","sourceRoot":"","sources":["../../src/lib/equation-gallery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,eAAe,EAEhB,MAAM,kCAAkC,CAAC;AAI1C,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAkBD;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAqExD,CAAC;AAIF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,eAAe,EACrB,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,aAAa,CAYf;AAiDD,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,KAAK,eAAe,GAAG,IAAI,CAAC;IACnE,yDAAyD;IACzD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAChC,0DAA0D;IAC1D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8BD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,WAAW,CA6D5E"}

package/dist/lib/equation-panel.d.ts

@@ -0,0 +1,30 @@
+import type { EqNode, EqStructure, VectorImageSpec } from '@shadow-garden/bapbong-contracts';
+export interface EquationPanelOptions {
+    /**
+     * Typesets one template the way the document would — the host passes the
+     * layout engine bound to the editor's measurer, so a preview is the
+     * drawing the page will show. Without it the structure grid falls back to
+     * plain labels.
+     */
+    layout?: (ast: EqNode[], sizePt: number) => VectorImageSpec | null;
+    /** A symbol was chosen — insert this character at the slot caret. */
+    onSymbol: (ch: string) => void;
+    /** A structure was chosen — insert this template at the slot caret. */
+    onStructure: (s: EqStructure) => void;
+}
+export interface EquationPanel {
+    /** The panel element. The caller positions it and shows/hides it. */
+    readonly el: HTMLElement;
+    destroy(): void;
+}
+/**
+ * The equation palette: Word's Symbols and Structures galleries as ONE
+ * floating surface with tabs inside it, rather than a bar that opens a
+ * separate flyout. Switching tabs then swaps the contents while the frame
+ * stays put — and inserting six symbols in a row costs no re-opening.
+ *
+ * Knows nothing about the editor: it reports a chosen symbol or template and
+ * the host hands that to the slot editor.
+ */
+export declare function equationPanel(options: EquationPanelOptions): EquationPanel;
+//# sourceMappingURL=equation-panel.d.ts.map

package/dist/lib/equation-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equation-panel.d.ts","sourceRoot":"","sources":["../../src/lib/equation-panel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,WAAW,EACX,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAS1C,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,KAAK,eAAe,GAAG,IAAI,CAAC;IACnE,qEAAqE;IACrE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,uEAAuE;IACvE,WAAW,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,OAAO,IAAI,IAAI,CAAC;CACjB;AA+BD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA8I1E"}

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

@@ -1 +1 @@
-{"version":3,"file":"font-dialog.d.ts","sourceRoot":"","sources":["../../src/lib/font-dialog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AA+B5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,4CAA4C;IAC5C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChD;AAsGD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,KAAK,EACL,OAAO,GACR,EAAE,iBAAiB,GAAG,IAAI,CA2T1B"}
+{"version":3,"file":"font-dialog.d.ts","sourceRoot":"","sources":["../../src/lib/font-dialog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AA+B5E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,4CAA4C;IAC5C,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChD;AAkGD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,QAAQ,EACR,KAAK,EACL,OAAO,GACR,EAAE,iBAAiB,GAAG,IAAI,CA4T1B"}

package/dist/lib/internal.d.ts

@@ -32,6 +32,14 @@ export declare const IS_MAC: boolean;
  * a host passes its app registry after it for chords like ⌘F that live there.
  */
 export declare function shortcutLabel(command: string, registries: readonly (KeybindingRegistry | undefined)[]): string | undefined;
+/**
+ * The segmented tab strip every bapbong-ui surface uses — the Font dialog's
+ * Font/Advanced, the equation palette's Symbols/Structures. One definition,
+ * so a widget added later cannot drift into its own look, and it reads the
+ * `--bb-ui-active-*` and `--bb-ui-control-*` variables the host already maps
+ * to its theme rather than inventing names nobody sets.
+ */
+export declare const TABS_CSS = "\n.bb-tabs{display:inline-flex;align-self:flex-start;border:0.5px solid var(--bb-ui-control-border,var(--bb-ui-border,#d8d6cf));border-radius:6px;overflow:hidden}\n.bb-tab{height:30px;padding:0 18px;border:0;border-right:0.5px solid var(--bb-ui-border,#e3e3e0);background:transparent;color:inherit;opacity:.65;font:inherit;font-size:13px;cursor:pointer}\n.bb-tab:last-child{border-right:0}\n.bb-tab:hover{background:var(--bb-ui-hover,#f1efe8);opacity:.9}\n.bb-tab[aria-selected=\"true\"]{background:var(--bb-ui-active-bg,#e6f1fb);color:var(--bb-ui-active-fg,#0c447c);opacity:1}\n";
 /** Inject a stylesheet once, keyed by `id` (idempotent across mounts). */
 export declare function injectStyle(id: string, css: string): void;
 /** A rectangle to hang a floating panel from — a caret box, a button, or any

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

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/lib/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AAG1C;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;IACpD;gFAC4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAC3C;AAED;2EAC2E;AAC3E,eAAO,MAAM,MAAM,EAAE,OAGV,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,SAAS,CAAC,kBAAkB,GAAG,SAAS,CAAC,EAAE,GACtD,MAAM,GAAG,SAAS,CAOpB;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAMzD;AAED;iDACiD;AACjD,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;oEAGoE;AACpE,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAgBxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,GAAG;IAClD,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,CAwCA"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/lib/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AAG1C;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;IACpD;gFAC4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAC3C;AAED;2EAC2E;AAC3E,eAAO,MAAM,MAAM,EAAE,OAGV,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,SAAS,CAAC,kBAAkB,GAAG,SAAS,CAAC,EAAE,GACtD,MAAM,GAAG,SAAS,CAOpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,wkBAMpB,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAMzD;AAED;iDACiD;AACjD,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;oEAGoE;AACpE,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAgBxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,GAAG;IAClD,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC,CAwCA"}

package/dist/lib/link-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link-panel.d.ts","sourceRoot":"","sources":["../../src/lib/link-panel.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD;;;;;+CAK2C;IAC3C,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,SAAS,EAAE,OAAO,CAAC;QACnB,IAAI,IAAI,IAAI,CAAC;KACd,GAAG,IAAI,CAAC;IACT;qBACiB;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;+DAG2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd;0EACsE;IACtE,MAAM,IAAI,OAAO,CAAC;CACnB;AAyDD,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CA8MrE"}
+{"version":3,"file":"link-panel.d.ts","sourceRoot":"","sources":["../../src/lib/link-panel.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD;;;;;+CAK2C;IAC3C,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,SAAS,EAAE,OAAO,CAAC;QACnB,IAAI,IAAI,IAAI,CAAC;KACd,GAAG,IAAI,CAAC;IACT;qBACiB;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;+DAG2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd;0EACsE;IACtE,MAAM,IAAI,OAAO,CAAC;CACnB;AAyDD,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CA+MrE"}

package/dist/lib/table-style-panel.d.ts

@@ -0,0 +1,45 @@
+import { type ResolvedTableStyle, type TableLook } from '@shadow-garden/bapbong-contracts';
+/**
+ * The Table style panel — Word's Table Design surface as one non-modal
+ * floating dialog: the six tblLook gates ("Table style options") and a
+ * gallery of styles whose thumbnails are drawn from the SAME resolved sheet
+ * and the SAME cellStyleLayer the renderer uses, so a preview can never
+ * disagree with the page.
+ *
+ * The host owns the data and the commands (applyTableStyle / setTableLook);
+ * the panel renders and reports. All three entry points — Format ▸ Table ▸
+ * Table style…, the contextual toolbar button, the table context menu — open
+ * this one instance.
+ */
+export interface TableStyleGalleryItem {
+    id: string;
+    /** Human name for the tile tooltip + footer ("Light Grid · Accent 3"). */
+    name: string;
+    style: ResolvedTableStyle;
+}
+export interface TableStylePanelOptions {
+    /** Gallery content, re-read on every {@link TableStylePanelHandle.refresh}:
+     *  typically the document's own sheet plus the host's built-in catalog. */
+    styles: () => TableStyleGalleryItem[];
+    /** The enclosing table's pair, or null when the caret left every table. */
+    current: () => {
+        styleId: string | null;
+        look: TableLook;
+    } | null;
+    /** A gallery pick (null = the "None" tile). */
+    onPick: (item: TableStyleGalleryItem | null) => void;
+    /** A gate checkbox flip. */
+    onLook: (patch: Partial<TableLook>) => void;
+    /** Where to float (see Dialog.anchor / panelAnchor). */
+    anchor?: () => DOMRect | null;
+}
+export interface TableStylePanelHandle {
+    open(): void;
+    close(): void;
+    /** Re-read styles()/current() and redraw. Cheap no-op when nothing moved. */
+    refresh(): void;
+    destroy(): void;
+    readonly isOpen: boolean;
+}
+export declare function createTableStylePanel(options: TableStylePanelOptions): TableStylePanelHandle;
+//# sourceMappingURL=table-style-panel.d.ts.map

package/dist/lib/table-style-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-style-panel.d.ts","sourceRoot":"","sources":["../../src/lib/table-style-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EAEvB,KAAK,SAAS,EACf,MAAM,kCAAkC,CAAC;AAI1C;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC;+EAC2E;IAC3E,MAAM,EAAE,MAAM,qBAAqB,EAAE,CAAC;IACtC,2EAA2E;IAC3E,OAAO,EAAE,MAAM;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC;IAClE,+CAA+C;IAC/C,MAAM,EAAE,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,KAAK,IAAI,CAAC;IACrD,4BAA4B;IAC5B,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IAC5C,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,6EAA6E;IAC7E,OAAO,IAAI,IAAI,CAAC;IAChB,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAyED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAmHvB"}

package/dist/lib/toolbar.d.ts

@@ -79,16 +79,38 @@ export interface ToolbarButton {
     label?: string;
     /** Inline SVG markup (used instead of `label`). */
     svg?: string;
+    /** Text rendered BESIDE the svg — a labelled button ("Table style"). */
+    text?: string;
+    /** Render as an accent pill (the is-active palette, so every theme that
+     *  restyles active buttons restyles this too) — for the one control in a
+     *  contextual group that users should spot without hunting. */
+    accent?: boolean;
+    /** Append a small ▾ — the button opens a panel. */
+    caret?: boolean;
     /** Called with the button element (the anchor for what opens). */
     onClick: (anchor: HTMLElement) => void;
 }
 /** A toolbar group entry: a command name (button) or a control
  *  (select/colour/split/button). */
 export type ToolbarEntry = string | ToolbarSelect | ToolbarColor | ToolbarSplit | ToolbarButton;
+/** A toolbar cluster: a plain entry list, or one that only SHOWS in certain
+ *  editor states (`visible`) — the contextual "Table style" group renders
+ *  only while the caret sits in a table. Visibility is re-evaluated on every
+ *  editor change, and a flip re-runs the overflow fold, so a group appearing
+ *  never silently pushes the tail of the row out of sight. */
+export type ToolbarGroup = ToolbarEntry[] | {
+    entries: ToolbarEntry[];
+    visible?: (state: EditorStateOf) => boolean;
+    /** Fold into the overflow popover only after every non-sticky group
+     *  has folded (tail-first among sticky groups themselves) — for the
+     *  contextual control that should stay in sight while anything else
+     *  can still give way. */
+    sticky?: boolean;
+};
 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[][];
+    groups?: ToolbarGroup[];
     /** Presentation per command name, merged over the built-in defaults. */
     items?: Record<string, ToolbarItem>;
 }
@@ -106,5 +128,24 @@ export declare function defaultToolbarGroups(commands: Collection<Command>): str
  * DOM, styling and active-state tracking; a host framework only provides the
  * element and the editor handle, then calls `destroy()` on teardown.
  */
+/** One toolbar group as the fold arithmetic sees it. */
+export interface FoldCandidate {
+    /** Original toolbar position — identity for the returned set. */
+    idx: number;
+    /** Measured width in px (the caller caches the last non-zero measurement:
+     *  a group inside the CLOSED popover is display:none and measures 0). */
+    width: number;
+    sticky: boolean;
+    /** Conditionally hidden right now — takes no space, never folds. */
+    hidden: boolean;
+}
+/**
+ * Which groups must fold into the ⋮ popover, as pure arithmetic: called with
+ * ONE batch of measurements, so the layout pass costs a single reflow
+ * instead of the old mutate-then-remeasure loop (O(N) forced reflows per
+ * resize tick). Fold order is non-sticky tail-first, then sticky tail-first
+ * — a sticky group leaves the row only when nothing else can give way.
+ */
+export declare function foldPlan(candidates: readonly FoldCandidate[], avail: number, moreWidth: number, gap: number): Set<number>;
 export declare function mountToolbar(host: HTMLElement, editor: EditorHandle, options?: ToolbarOptions): ToolbarHandle;
 //# sourceMappingURL=toolbar.d.ts.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shadow-garden/bapbong-ui",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "bapbong — framework-agnostic editor UI (toolbar/menubar) that mounts into a host element and binds to editor.commands",
   "license": "MIT",
   "repository": {
@@ -56,6 +56,6 @@
     }
   },
   "dependencies": {
-    "@shadow-garden/bapbong-contracts": "^0.14.0"
+    "@shadow-garden/bapbong-contracts": "^0.16.0"
   }
 }