@kitlangton/knobs 0.4.0-next.14 → 0.4.0-next.16

package/dist/types/panel/page.d.ts

@@ -1,15 +1,7 @@
 import type { StoragePort } from "../core/storage.js";
-import type { MountPanelOptions, SectionFolded } from "../core/store.js";
+import type { FoldSummaryInfo, MountPanelOptions, SectionFolded } from "../core/store.js";
 import type { Panel } from "./panel.js";
-/** What a folded card's or section's summary is made of (see `MountPageOptions.groupSummary`). */
-export interface FoldSummaryInfo {
-    /** The group preset its values match (its name), "Custom" when none does; null without any. */
-    readonly preset: string | null;
-    /** How many of its rows differ from their defaults (a spring's two keys count once). */
-    readonly changed: number;
-    /** Its value keys. */
-    readonly keys: readonly string[];
-}
+export type { FoldSummaryInfo };
 export interface MountPageOptions extends MountPanelOptions {
     /** Section order; sections not listed follow in the order they first appear. */
     readonly sections?: readonly string[];
@@ -39,11 +31,6 @@ export interface MountPageOptions extends MountPanelOptions {
      * opening it if it's folded.
      */
     readonly nav?: boolean;
-    /**
-     * What a folded group card's header says. By default "<matching preset, or Custom> · N
-     * changed", leaving out what doesn't apply. `null` shows nothing.
-     */
-    readonly groupSummary?: (group: string, info: FoldSummaryInfo) => string | Node | null;
     /** What a folded section's heading says ("N changed · M cards" by default; `preset` is null). */
     readonly sectionSummary?: (section: string, info: FoldSummaryInfo) => string | Node | null;
 }

package/dist/types/panel/summary.d.ts

@@ -0,0 +1,22 @@
+import type { Controls } from "../core/store.js";
+/** A row of a folded panel card, as its summary reads it. */
+export interface SummaryRow {
+    /** Its value as text ("CSS orb", "12 px"), or "" where it has no short form. */
+    readonly value: string;
+    /** Whether it differs from its default. */
+    readonly changed: boolean;
+    /** Whether it's a choice (the likeliest to say what the card is set to). */
+    readonly choice: boolean;
+}
+/**
+ * A folded panel card's summary, by default: a one-row card's value; otherwise the most telling
+ * value (its matching group preset, else its first changed value, else its first choice) and
+ * "N changed", each only where it applies. `preset` is null for a card without group presets.
+ */
+export declare function panelFoldSummary(rows: readonly SummaryRow[], preset: string | null): string;
+/**
+ * Which presets the values are measured against (the panel's, each scope's and each group's).
+ * It changes when one is chosen or saved even if no value moves, which still changes what counts
+ * as changed: marks, resets and folded summaries follow it.
+ */
+export declare const baseSignature: (controls: Pick<Controls<any>, "activePreset" | "activeGroupPreset" | "scopes" | "groupPresets">) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitlangton/knobs",
-  "version": "0.4.0-next.14",
+  "version": "0.4.0-next.16",
   "description": "Per-component tuning controls. Explore in development, ship constants.",
   "type": "module",
   "license": "MIT",