@capillaryjs/capillary-viz 1.0.0-alpha.1 → 1.0.0

package/CHANGELOG.md

@@ -6,6 +6,21 @@ and Semantic Versioning.
 
 ## Unreleased
 
+## 1.0.0 - 2026-09-14
+
+### Changed
+
+- Mark `BlockGraph` as a Capillary UI data surface so a labelled island Panel
+  can compose it flush with its chrome when it is the sole direct body child.
+- Align CategoryHidePanel and SplitSelectionPanel spacing with the refined
+  GroupBox form rhythm, including the generated visualization structural CSS.
+
+### Fixed
+
+- Replace loading BlockGraph content with a deterministic skeleton mosaic,
+  hiding cached counts and selection labels without clearing model state.
+  Error states no longer incorrectly report that the graph is busy.
+
 ## 1.0.0-alpha.1 - 2026-09-14
 
 ### Changed

package/README.md

@@ -28,6 +28,10 @@ With dependency collection, declare `BlockGraph`, `CategoryHidePanel`,
 `SplitSelectionPanel`, or `LineGraph` in the owning component's
 `static dependencies` instead.
 
+`BlockGraph` declares Capillary UI's static `dataSurface` host trait. When it
+is the sole direct body child of a labelled island `Panel`, the Panel makes the
+data surface flush with its chrome.
+
 ## Ownership model
 
 Applications supply items, stable keys, domain predicates, labels, semantic
@@ -227,6 +231,12 @@ the new position. Preset buttons expose their active state with
 `BlockGraph<T>` renders a nested proportional mosaic from a
 `BlockSelectionModel`.
 
+Initial and Loading snapshots render a deterministic, decorative skeleton
+mosaic instead of cached blocks, counts, or selection labels. The caller's
+model and selection remain intact. Skeletons are hidden from assistive
+technology, the graph exposes a loading status, and Clear selection is
+unavailable until loading ends. Error and ready-empty states remain distinct.
+
 | Prop | Meaning |
 | --- | --- |
 | `model` | Required caller-owned block selection model |

package/dist/components/BlockGraph.d.ts

@@ -1,4 +1,4 @@
-import { Button, Component } from '@capillaryjs/capillary-ui';
+import { Button, Component, Placeholder } from '@capillaryjs/capillary-ui';
 import type { ComponentProps, CapillaryUiChild } from '@capillaryjs/capillary-ui';
 import type { BlockNode } from '../block.js';
 import { BlockSelectionModel } from '../block.js';
@@ -13,7 +13,8 @@ export declare class BlockGraph<TItem = unknown> extends Component<BlockGraphPro
     static liveProps: readonly string[];
     render(): CapillaryUiChild;
     static hostName: string;
-    static dependencies: (typeof Button)[];
+    static dataSurface: "data";
+    static dependencies: (typeof Placeholder | typeof Button)[];
     static css: string;
     private renderBlock;
     private renderPartitionError;

package/dist/components/BlockGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockGraph.d.ts","sourceRoot":"","sources":["../../src/components/BlockGraph.tsx"],"names":[],"mappings":"AACA,OAAO,EAAC,MAAM,EAAE,SAAS,EAAM,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAC,cAAc,EAAE,gBAAgB,EAAC,MAAM,2BAA2B,CAAA;AAE/E,OAAO,KAAK,EAAC,SAAS,EAAY,MAAM,aAAa,CAAA;AACrD,OAAO,EAAC,mBAAmB,EAAY,MAAM,aAAa,CAAA;AAS1D,MAAM,WAAW,eAAe,CAAC,KAAK,CAAE,SAAQ,cAAc;IAC1D,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,mFAAmF;AACnF,qBAAa,UAAU,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9E,OAAgB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAK;IACjD,MAAM,IAAI,gBAAgB;IAmE1B,OAAgB,QAAQ,SAAgB;IACxC,OAAgB,YAAY,oBAAW;IAEvC,MAAM,CAAC,GAAG,SAkKT;IAED,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,UAAU;CASrB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAE3F"}
+{"version":3,"file":"BlockGraph.d.ts","sourceRoot":"","sources":["../../src/components/BlockGraph.tsx"],"names":[],"mappings":"AACA,OAAO,EAAC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAM,MAAM,2BAA2B,CAAA;AAC7E,OAAO,KAAK,EAAC,cAAc,EAAE,gBAAgB,EAAC,MAAM,2BAA2B,CAAA;AAE/E,OAAO,KAAK,EAAC,SAAS,EAAY,MAAM,aAAa,CAAA;AACrD,OAAO,EAAC,mBAAmB,EAAY,MAAM,aAAa,CAAA;AAS1D,MAAM,WAAW,eAAe,CAAC,KAAK,CAAE,SAAQ,cAAc;IAC1D,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,mFAAmF;AACnF,qBAAa,UAAU,CAAC,KAAK,GAAG,OAAO,CAAE,SAAQ,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9E,OAAgB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAK;IACjD,MAAM,IAAI,gBAAgB;IA8E1B,OAAgB,QAAQ,SAAgB;IACxC,MAAM,CAAC,WAAW,EAAG,MAAM,CAAS;IACpC,OAAgB,YAAY,yCAAwB;IAEpD,MAAM,CAAC,GAAG,SA6LT;IAED,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,UAAU;CASrB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,CAE3F"}