@buoy-gg/shared-ui 7.0.35 → 7.0.36

package/lib/typescript/module/sync/valueShape.d.ts

@@ -0,0 +1,77 @@
+/**
+ * A compact type sketch of a runtime value — one implementation, shared by every
+ * adapter that hands data to a model.
+ *
+ * WHY. A model cannot write a well-formed item into a list it has never seen the
+ * shape of, and we were not showing it. Measured on `cart/bag-still-zustand`: the
+ * rendered prompt is 83,000 characters and the words `lineId`, `itemId`,
+ * `sizeId`, `addonIds` and `unitPrice` appear in it ZERO times. Every model
+ * "failing" that case invented a line shape because inventing was the only move
+ * available. The zustand typed-edit guard would have caught the invention — but
+ * only on a list that already holds an item, since it builds its template from
+ * `list[0]`. On an EMPTY list there is no template, the guard has nothing to
+ * compare against, and the invented shape is written silently.
+ *
+ * So the sketch has two jobs, and the second is the one that pays:
+ *
+ *   1. Say what the items in a list look like, so an addition can match.
+ *   2. Say when NOTHING knows — an empty list's item shape is not merely
+ *      unread, it is unknowable from runtime state, and the honest answer is to
+ *      admit that rather than let a guess through unremarked.
+ *
+ * It is deliberately tiny. A sketch of a 120-line bag is the same size as a
+ * sketch of a 2-line one, so unlike the data it survives the engine's 24,000-
+ * character result cap — which is the whole point, because the cases where the
+ * model most needs the shape are exactly the ones where the data got cut off.
+ */
+/**
+ * `{lineId: string, qty: number, addonIds: string[]}` — a one-line type for a
+ * value, built from the value itself.
+ *
+ * An array is described by its FIRST item, because a list whose items disagree
+ * is a list nothing can safely add to and the guard will say so anyway. An empty
+ * array is `unknown[]`, which is the true answer and the one that matters: it
+ * tells a reader that adding to this list is unchecked.
+ */
+export declare function shapeOf(value: unknown, depth?: number): string;
+export interface ListShape {
+    /** Dotted path from the value's root: `lines`, `user.addresses`. */
+    path: string;
+    /** How many items are in it right now. */
+    length: number;
+    /** The item type, or undefined when the list is empty and nothing can know it. */
+    item?: string;
+}
+/**
+ * Every list inside a value, with the shape of what goes in it.
+ *
+ * This is what a caller needs before adding to a list, and it is the part that
+ * cannot be recovered from a truncated read of the data itself.
+ *
+ * A list with `item: undefined` is the warning case: it is empty, so its item
+ * shape exists nowhere in the running app — not in the store, not in the
+ * persisted copy, not in this sketch. Anything added to it goes in unchecked.
+ */
+export declare function listShapes(value: unknown, path?: string, out?: ListShape[], depth?: number, budget?: {
+    visited: number;
+}): ListShape[];
+/** True when a sketch stopped early, so a caller can say so rather than imply completeness. */
+export declare function shapesWereTruncated(value: unknown): boolean;
+/**
+ * The lists in a value that a caller could add to WITHOUT any way to know the
+ * item shape. Empty by definition on a healthy value; non-empty means a write
+ * into one of these paths cannot be checked by anything.
+ */
+export declare function unshapedLists(value: unknown): string[];
+/**
+ * The sketch an adapter attaches to a read: the value's own type, plus the item
+ * type of every list in it.
+ *
+ * Returns undefined when there is nothing worth saying (a scalar, or an object
+ * holding no lists) so adapters can spread it and add no noise.
+ */
+export declare function shapeSummary(value: unknown): {
+    shape: string;
+    lists?: ListShape[];
+} | undefined;
+//# sourceMappingURL=valueShape.d.ts.map

package/lib/typescript/module/sync/valueShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueShape.d.ts","sourceRoot":"","sources":["../../../../src/sync/valueShape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAkBH;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,MAAM,CAkBzD;AAED,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,OAAO,EACd,IAAI,SAAK,EACT,GAAG,GAAE,SAAS,EAAO,EACrB,KAAK,SAAI,EACT,MAAM,GAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAmB,GAC3C,SAAS,EAAE,CAwBb;AAED,+FAA+F;AAC/F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI3D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAItD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,SAAS,CAM/F"}

package/lib/typescript/module/ui/components/ExpandablePopover.d.ts

@@ -33,6 +33,19 @@ export interface ExpandablePopoverProps {
     testID?: string;
     /** Handle for the collapse button at the bottom of the expanded panel. */
     collapseTestID?: string;
+    /**
+     * Something inside needs the user — drawn on the COLLAPSED peek too.
+     *
+     * A badge on a chip nobody can see is no badge: the dock folds to a
+     * peek tab, and a minimized tool's "needs your approval" was invisible
+     * until someone happened to expand it. `color` paints the dot; `glyph`
+     * (e.g. "!") sits inside it for the case that needs a tap.
+     */
+    attention?: {
+        color: string;
+        glyph?: string;
+        label?: string;
+    } | null;
 }
-export declare function ExpandablePopover({ hasItems, itemCount, showCount, width, children, expandedHeight, onExpandedChange, defaultExpanded, collapsedContent, collapsedLabel, expandedStyle, persistState, storageKey, peekHeight, testID, collapseTestID, }: ExpandablePopoverProps): React.JSX.Element | null;
+export declare function ExpandablePopover({ hasItems, itemCount, showCount, width, children, expandedHeight, onExpandedChange, defaultExpanded, collapsedContent, collapsedLabel, attention, expandedStyle, persistState, storageKey, peekHeight, testID, collapseTestID, }: ExpandablePopoverProps): React.JSX.Element | null;
 //# sourceMappingURL=ExpandablePopover.d.ts.map

package/lib/typescript/module/ui/components/ExpandablePopover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpandablePopover.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/ExpandablePopover.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,EAML,SAAS,EACT,SAAS,EACV,MAAM,cAAc,CAAC;AAQtB,MAAM,WAAW,sBAAsB;IACrC,mFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,6BAA6B;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAuJD,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EACT,SAAgB,EAChB,KAAqB,EACrB,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,eAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,YAAoB,EACpB,UAAU,EACV,UAAgC,EAChC,MAAM,EACN,cAAc,GACf,EAAE,sBAAsB,4BAsIxB"}
+{"version":3,"file":"ExpandablePopover.d.ts","sourceRoot":"","sources":["../../../../../src/ui/components/ExpandablePopover.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,EAML,SAAS,EACT,SAAS,EACV,MAAM,cAAc,CAAC;AAQtB,MAAM,WAAW,sBAAsB;IACrC,mFAAmF;IACnF,QAAQ,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,6BAA6B;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACnC,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uCAAuC;IACvC,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACtE;AAoKD,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,SAAS,EACT,SAAgB,EAChB,KAAqB,EACrB,QAAQ,EACR,cAAc,EACd,gBAAgB,EAChB,eAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,SAAgB,EAChB,aAAa,EACb,YAAoB,EACpB,UAAU,EACV,UAAgC,EAChC,MAAM,EACN,cAAc,GACf,EAAE,sBAAsB,4BAuIxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/shared-ui",
-  "version": "7.0.35",
+  "version": "7.0.36",
   "description": "Shared UI components, hooks, and utilities",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -136,10 +136,10 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@buoy-gg/floating-tools-core": "^7.0.35"
+    "@buoy-gg/floating-tools-core": "^7.0.36"
   },
   "peerDependencies": {
-    "@buoy-gg/license": "7.0.35",
+    "@buoy-gg/license": "7.0.36",
     "@react-native-clipboard/clipboard": "*",
     "expo-clipboard": "*",
     "expo-file-system": "*",
@@ -167,7 +167,7 @@
     "expo-clipboard": "~7.1.5",
     "react-native-safe-area-context": "^5.6.2",
     "typescript": "~5.8.3",
-    "@buoy-gg/license": "^7.0.35"
+    "@buoy-gg/license": "^7.0.36"
   },
   "react-native-builder-bob": {
     "source": "src",