@peasant-labs/fairtrade 0.0.60 → 0.0.61

package/dist/lib/closed-value.js

@@ -0,0 +1,23 @@
+//#region src/ui/closed-value.js
+function e(e, r) {
+	t(e), n(r);
+	let i = String(e);
+	return Object.freeze({
+		wire: e,
+		label: r,
+		String: () => i,
+		toString: () => i,
+		toJSON: () => e
+	});
+}
+function t(e) {
+	if (!(typeof e == "string" && e.length > 0) && !(typeof e == "number" && Number.isFinite(e))) throw TypeError(`closed(wire, label) failed in src/ui/closed-value.js: wire must be a non-empty string or a finite number, received ${r(e)}. A closed value's wire is the exact value persisted and compared, so it must be a primitive with a stable value (for example 'project' or 25). Pass the primitive at the member definition.`);
+}
+function n(e) {
+	if (!(typeof e == "string" && e.length > 0)) throw TypeError(`closed(wire, label) failed in src/ui/closed-value.js: label must be a non-empty string, received ${r(e)}. The label is the human-readable text shown for the member, so every member needs its own (for example '25' for the numeric wire 25). Pass the label at the member definition.`);
+}
+function r(e) {
+	return typeof e == "string" ? JSON.stringify(e) : typeof e == "number" ? String(e) : e === null ? "null" : Array.isArray(e) ? "an array" : `a ${typeof e}`;
+}
+//#endregion
+export { e as closed };

package/dist/lib/types/closed-value.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A closed value: a frozen object that carries its wire value, the label a
+ * surface shows for it, and the conversion hooks.
+ *
+ * - `wire` is the exact value persisted, compared, and sent on the wire.
+ * - `label` is the human-readable text shown for the member.
+ * - `String()` is the Go-style explicit text conversion; it returns `String(wire)`.
+ * - `toString()` is the text conversion used by `String(value)` and template literals.
+ * - `toJSON()` is the persistence conversion used by `JSON.stringify`; it returns `wire`.
+ *
+ * @template {string | number} W - the exact value persisted, compared, and sent on the wire.
+ * @template {string} L - the human-readable label shown for the member.
+ * @typedef {{
+ *   readonly wire: W,
+ *   readonly label: L,
+ *   String: () => string,
+ *   toString: () => string,
+ *   toJSON: () => W,
+ * }} ClosedValue
+ */
+/**
+ * Create one frozen closed-set member.
+ *
+ * @template {string | number} W
+ * @template {string} L
+ * @param {W} wire - the exact value persisted, compared, and sent on the wire.
+ * @param {L} label - the human-readable text shown for the member.
+ * @returns {ClosedValue<W, L>} a new frozen member for this `(wire, label)` pair.
+ */
+export function closed<W extends string | number, L extends string>(wire: W, label: L): ClosedValue<W, L>;
+/**
+ * A closed value: a frozen object that carries its wire value, the label a
+ * surface shows for it, and the conversion hooks.
+ *
+ * - `wire` is the exact value persisted, compared, and sent on the wire.
+ * - `label` is the human-readable text shown for the member.
+ * - `String()` is the Go-style explicit text conversion; it returns `String(wire)`.
+ * - `toString()` is the text conversion used by `String(value)` and template literals.
+ * - `toJSON()` is the persistence conversion used by `JSON.stringify`; it returns `wire`.
+ */
+export type ClosedValue<W extends string | number, L extends string> = {
+    readonly wire: W;
+    readonly label: L;
+    String: () => string;
+    toString: () => string;
+    toJSON: () => W;
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@peasant-labs/fairtrade",
   "private": false,
-  "version": "0.0.60",
+  "version": "0.0.61",
   "description": "Fairtrade design-system library: canonical tokens, base styles, component CSS, and React UI exports.",
   "type": "module",
   "license": "Apache-2.0",
@@ -47,6 +47,12 @@
       "require": "./dist/lib/icons.js",
       "default": "./dist/lib/icons.js"
     },
+    "./closed-value": {
+      "types": "./dist/lib/types/closed-value.d.ts",
+      "import": "./dist/lib/closed-value.js",
+      "require": "./dist/lib/closed-value.js",
+      "default": "./dist/lib/closed-value.js"
+    },
     "./share": {
       "types": "./dist/lib/types/share/index.d.ts",
       "import": "./dist/lib/share.js",
@@ -91,6 +97,7 @@
     "icons:check": "node scripts/gen-app-icons.mjs --check",
     "build:app": "node scripts/gen-app-icons.mjs --check && node scripts/gen-llm-artifacts.mjs && node scripts/contrast.mjs && vite build",
     "test:contract": "tsc -p tsconfig.contract.json",
+    "test:closed-value": "node --test src/ui/closed-value.test.js",
     "test:share-types": "tsc -p tsconfig.share-types.json",
     "test:runtime-floor": "node scripts/runtime-floor.test.mjs",
     "test:code-map-state": "node scripts/code-map-state.test.mjs",
@@ -192,7 +199,7 @@
     "test:accessibility-semantics:mutations": "node scripts/parts-mutations.mjs scripts/accessibility-semantics.test.mjs scripts/testdata/accessibility-semantics.manifest.yaml",
     "test:parts": "pnpm test:transcript-integrity && pnpm test:transcript-integrity-viewer && pnpm test:transcript-ledger-chrome && pnpm test:transcript-ledger-turns && pnpm test:transcript-reading-layout && pnpm test:accessibility-semantics && pnpm test:code-map-disclosure && pnpm test:page-headings && pnpm test:code-map-line-counts && pnpm test:transcript-viewer-chrome && pnpm test:app-sections && pnpm test:local-offline-banner && pnpm test:app-sidebar && pnpm test:settings-nav && pnpm test:transcript-session-records && pnpm test:transcript-system-groups && pnpm test:transcript-viewer-format && pnpm test:prompt-digest-split && pnpm test:village-parts && pnpm test:publish-states && pnpm test:setting-row && pnpm test:repo-picker && pnpm test:commons-demo-pages && pnpm test:collectives-views && pnpm test:number-format && pnpm test:command-block",
     "test:parts:mutations": "pnpm test:transcript-integrity:mutations && pnpm test:transcript-integrity-viewer:mutations && pnpm test:transcript-ledger-chrome:mutations && pnpm test:transcript-ledger-turns:mutations && pnpm test:transcript-reading-layout:mutations && pnpm test:accessibility-semantics:mutations && pnpm test:code-map-disclosure:mutations && pnpm test:page-headings:mutations && pnpm test:code-map-line-counts:mutations && pnpm test:transcript-viewer-chrome:mutations && pnpm test:app-sections:mutations && pnpm test:local-offline-banner:mutations && pnpm test:app-sidebar:mutations && pnpm test:settings-nav:mutations && pnpm test:transcript-session-records:mutations && pnpm test:transcript-system-groups:mutations && pnpm test:transcript-viewer-format:mutations && pnpm test:prompt-digest-split:mutations && pnpm test:village-parts:mutations && pnpm test:publish-states:mutations && pnpm test:setting-row:mutations && pnpm test:repo-picker:mutations && pnpm test:commons-demo-pages:mutations && pnpm test:collectives-views:mutations && pnpm test:number-format:mutations && pnpm test:command-block:mutations",
-    "test:gates": "pnpm test:design-decisions && pnpm audit:design-decisions && pnpm test:port-record && pnpm test:demo-truth && pnpm test:datatable && pnpm test:structured-shiki && pnpm test:transcript-provenance && pnpm test:pi-transcript && pnpm test:pi-transcript:mutations && node scripts/gates.test.mjs && node scripts/turns-to-flow-edges.test.mjs && pnpm test:transcript-helpers && pnpm test:helper-groups && pnpm test:transcript-outcome-chip && pnpm test:transcript-viewer-outcome && pnpm test:parts && pnpm test:release-notes && pnpm test:share-card",
+    "test:gates": "pnpm test:design-decisions && pnpm audit:design-decisions && pnpm test:port-record && pnpm test:demo-truth && pnpm test:datatable && pnpm test:structured-shiki && pnpm test:transcript-provenance && pnpm test:pi-transcript && pnpm test:pi-transcript:mutations && node scripts/gates.test.mjs && node scripts/turns-to-flow-edges.test.mjs && pnpm test:transcript-helpers && pnpm test:helper-groups && pnpm test:transcript-outcome-chip && pnpm test:transcript-viewer-outcome && pnpm test:parts && pnpm test:release-notes && pnpm test:share-card && pnpm test:closed-value",
     "test:analytics": "node src/ui/analytics/metrics.test.mjs",
     "test:mobile-layout": "node scripts/mobile-layout.test.mjs",
     "test:transcript-composite-width": "node scripts/transcript-composite-width.test.mjs",