@bicharts/shape-core 0.5.53 → 0.5.55

package/dist/types/models.d.ts

@@ -110,6 +110,25 @@ export type LLMClientHints = {
     allowGeneratedMeasures?: string;
     industryContext?: string;
     favorStyle?: string;
+    /**
+     * WHICH PROJECTION the reader picked, when the row they clicked was a projected one
+     * (servers from 2026-09-03). The "What fits?" list offers a projected type once per
+     * projection that admits it - the same chart at two grains, 3 marks or 4 - so the pick
+     * has to name one. This is the projection's KEY (`viaProjectionKey` from the row), never
+     * its prose label. Absent means "decide for me", which is what every earlier client sends
+     * and what the auto-pick path always sends: the server falls back to the first projection
+     * that admits the type.
+     */
+    favorProjection?: string;
+    /**
+     * Does this host let the reader CHOOSE a grain, and send it back as `favorProjection`?
+     *
+     * Only a client that answers true is offered a projected type more than once. One that
+     * renders both rows and remembers only the chart name would let the reader pick a grain
+     * the server then re-decides - an offer nothing can honour. Absent or false is the safe
+     * answer, and the only answer before this existed.
+     */
+    supportsProjectionChoice?: boolean;
     favorLimitTo?: string;
     favorLimitCount?: number;
     groupToOthersLabel?: string;
@@ -210,6 +229,14 @@ export type LLMQualifyResult = {
         language?: string;
         recommended?: boolean;
         viaProjection?: string;
+        /**
+         * The projection's stable identity, beside `viaProjection`'s prose (servers from
+         * 2026-09-03). Null on a direct offer. A type several projections admit appears once
+         * per projection - each row a different grain - so a host that lets the reader pick
+         * one must send this back as `clientHints.favorProjection`, or the server re-decides
+         * the grain by its own ordering.
+         */
+        viaProjectionKey?: string;
         isPreview?: boolean;
         detailNote?: string;
     }[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/shape-core",
-  "version": "0.5.53",
+  "version": "0.5.55",
   "description": "Host-agnostic data-shape profiler: ingest a dataset's rows through IValueCollection.addRow and read back the measured shape as an LLMColumnWithValue[] payload — types, cardinality, temporal/ordinal detection, geographic region and point resolution, cross-column signals. MEASUREMENT only: the policy that decides what a measured shape means for chart selection lives server-side.",
   "license": "Apache-2.0",
   "type": "module",