react-native-webrtc-kaleidoscope 2.0.0 → 2.1.0

package/dist/catalog/shaders/plasma/plasma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plasma.d.ts","sourceRoot":"","sources":["../../../../catalog/shaders/plasma/plasma.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,oDAAoD;AACpD,MAAM,MAAM,cAAc,GAAG;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,eAAe,EAAE,SAAS,cAAc,EAqBpD,CAAC","sourcesContent":["// Plasma layer-shader interface: typed uniforms + control descriptor. A two-\n// color time-morphing field, an opaque BACKGROUND layer (the cheapest\n// procedural engine worth shipping). The same shader also backs the standalone\n// `plasma` book presets (ocean/sunset/mint/fast) via ShaderOptionsMap; this file\n// is the layer-side type + control surface. Shader source is shaders/plasma.frag.\n\nimport type { RGB } from '../../../src/lib/primitives.types';\nimport type { UniformControl } from '../_shared/types';\n\n/** Typed uniforms for the `plasma` layer shader. */\nexport type PlasmaUniforms = {\n  /** First palette color, RGB each channel 0..1. */\n  readonly uColorA: RGB;\n  /** Second palette color, RGB each channel 0..1. */\n  readonly uColorB: RGB;\n  /** Animation rate; 0 freezes the field. */\n  readonly uSpeed: number;\n  /** Spatial frequency; higher = more, tighter cells. */\n  readonly uScale: number;\n};\n\n/** The `plasma` shader's tunable uniforms; defaults are the cool \"ocean\" look. */\nexport const PLASMA_CONTROLS: readonly UniformControl[] = [\n  { name: 'uColorA', kind: 'color', default: [0.0, 0.3, 0.6], doc: 'First palette color.' },\n  { name: 'uColorB', kind: 'color', default: [0.0, 0.6, 0.6], doc: 'Second palette color.' },\n  {\n    name: 'uSpeed',\n    kind: 'float',\n    default: 0.3,\n    min: 0,\n    max: 2,\n    step: 0.01,\n    doc: 'Animation rate; 0 freezes.',\n  },\n  {\n    name: 'uScale',\n    kind: 'float',\n    default: 8,\n    min: 1,\n    max: 20,\n    step: 0.5,\n    doc: 'Spatial frequency; higher = tighter cells.',\n  },\n];\n"]}

package/dist/catalog/shaders/plasma/plasma.form.d.ts

@@ -0,0 +1,3 @@
+import { type KaleidoscopeControls } from '../../../src/components/preset-control-panel';
+export declare function PlasmaForm({ uniforms, onPatch, disabled }: KaleidoscopeControls): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=plasma.form.d.ts.map

package/dist/catalog/shaders/plasma/plasma.form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plasma.form.d.ts","sourceRoot":"","sources":["../../../../catalog/shaders/plasma/plasma.form.tsx"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,8CAA8C,CAAC;AAGtD,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,oBAAoB,2CAiB/E","sourcesContent":["// Plasma's editor form: the shader OWNS its control layout. This pass just stacks\n// one <Control uniform=\"…\"/> per uniform in declared order (the auto-form's shape);\n// the point is that this file exists per shader, so layout/grouping is a local edit\n// here, and a new primitive flows in through <Control> without touching it.\n// Conventional layer id: \"plasma\".\n\nimport {\n  Control,\n  ControlForm,\n  ControlSection,\n  type KaleidoscopeControls,\n} from '../../../src/components/preset-control-panel';\nimport { PLASMA_CONTROLS } from './plasma';\n\nexport function PlasmaForm({ uniforms, onPatch, disabled }: KaleidoscopeControls) {\n  return (\n    <ControlForm\n      id=\"plasma\"\n      uniforms={uniforms.plasma ?? {}}\n      onPatch={onPatch}\n      disabled={disabled}\n      controls={PLASMA_CONTROLS}\n    >\n      <ControlSection title=\"plasma\">\n        <Control uniform=\"uColorA\" />\n        <Control uniform=\"uColorB\" />\n        <Control uniform=\"uSpeed\" />\n        <Control uniform=\"uScale\" />\n      </ControlSection>\n    </ControlForm>\n  );\n}\n"]}

package/dist/catalog/shaders/plasma/plasma.form.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlasmaForm = PlasmaForm;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// Plasma's editor form: the shader OWNS its control layout. This pass just stacks
+// one <Control uniform="…"/> per uniform in declared order (the auto-form's shape);
+// the point is that this file exists per shader, so layout/grouping is a local edit
+// here, and a new primitive flows in through <Control> without touching it.
+// Conventional layer id: "plasma".
+const preset_control_panel_1 = require("../../../src/components/preset-control-panel");
+const plasma_1 = require("./plasma");
+function PlasmaForm({ uniforms, onPatch, disabled }) {
+    return ((0, jsx_runtime_1.jsx)(preset_control_panel_1.ControlForm, { id: "plasma", uniforms: uniforms.plasma ?? {}, onPatch: onPatch, disabled: disabled, controls: plasma_1.PLASMA_CONTROLS, children: (0, jsx_runtime_1.jsxs)(preset_control_panel_1.ControlSection, { title: "plasma", children: [(0, jsx_runtime_1.jsx)(preset_control_panel_1.Control, { uniform: "uColorA" }), (0, jsx_runtime_1.jsx)(preset_control_panel_1.Control, { uniform: "uColorB" }), (0, jsx_runtime_1.jsx)(preset_control_panel_1.Control, { uniform: "uSpeed" }), (0, jsx_runtime_1.jsx)(preset_control_panel_1.Control, { uniform: "uScale" })] }) }));
+}
+//# sourceMappingURL=plasma.form.js.map

package/dist/catalog/shaders/plasma/plasma.form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plasma.form.js","sourceRoot":"","sources":["../../../../catalog/shaders/plasma/plasma.form.tsx"],"names":[],"mappings":";;;;AAAA,kFAAkF;AAClF,oFAAoF;AACpF,oFAAoF;AACpF,4EAA4E;AAC5E,mCAAmC;AAEnC,uFAKsD;AACtD,qCAA2C;AAE3C,oBAA2B,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAwB;IAC9E,OAAO,CACL,uBAAC,kCAAW,IACV,EAAE,EAAC,QAAQ,EACX,QAAQ,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE,EAC/B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,wBAAe,YAEzB,wBAAC,qCAAc,IAAC,KAAK,EAAC,QAAQ,aAC5B,uBAAC,8BAAO,IAAC,OAAO,EAAC,SAAS,GAAG,EAC7B,uBAAC,8BAAO,IAAC,OAAO,EAAC,SAAS,GAAG,EAC7B,uBAAC,8BAAO,IAAC,OAAO,EAAC,QAAQ,GAAG,EAC5B,uBAAC,8BAAO,IAAC,OAAO,EAAC,QAAQ,GAAG,IACb,GACL,CACf,CAAC;AACJ,CAAC","sourcesContent":["// Plasma's editor form: the shader OWNS its control layout. This pass just stacks\n// one <Control uniform=\"…\"/> per uniform in declared order (the auto-form's shape);\n// the point is that this file exists per shader, so layout/grouping is a local edit\n// here, and a new primitive flows in through <Control> without touching it.\n// Conventional layer id: \"plasma\".\n\nimport {\n  Control,\n  ControlForm,\n  ControlSection,\n  type KaleidoscopeControls,\n} from '../../../src/components/preset-control-panel';\nimport { PLASMA_CONTROLS } from './plasma';\n\nexport function PlasmaForm({ uniforms, onPatch, disabled }: KaleidoscopeControls) {\n  return (\n    <ControlForm\n      id=\"plasma\"\n      uniforms={uniforms.plasma ?? {}}\n      onPatch={onPatch}\n      disabled={disabled}\n      controls={PLASMA_CONTROLS}\n    >\n      <ControlSection title=\"plasma\">\n        <Control uniform=\"uColorA\" />\n        <Control uniform=\"uColorB\" />\n        <Control uniform=\"uSpeed\" />\n        <Control uniform=\"uScale\" />\n      </ControlSection>\n    </ControlForm>\n  );\n}\n"]}

package/dist/catalog/shaders/plasma/plasma.js

@@ -0,0 +1,32 @@
+"use strict";
+// Plasma layer-shader interface: typed uniforms + control descriptor. A two-
+// color time-morphing field, an opaque BACKGROUND layer (the cheapest
+// procedural engine worth shipping). The same shader also backs the standalone
+// `plasma` book presets (ocean/sunset/mint/fast) via ShaderOptionsMap; this file
+// is the layer-side type + control surface. Shader source is shaders/plasma.frag.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLASMA_CONTROLS = void 0;
+/** The `plasma` shader's tunable uniforms; defaults are the cool "ocean" look. */
+exports.PLASMA_CONTROLS = [
+    { name: 'uColorA', kind: 'color', default: [0.0, 0.3, 0.6], doc: 'First palette color.' },
+    { name: 'uColorB', kind: 'color', default: [0.0, 0.6, 0.6], doc: 'Second palette color.' },
+    {
+        name: 'uSpeed',
+        kind: 'float',
+        default: 0.3,
+        min: 0,
+        max: 2,
+        step: 0.01,
+        doc: 'Animation rate; 0 freezes.',
+    },
+    {
+        name: 'uScale',
+        kind: 'float',
+        default: 8,
+        min: 1,
+        max: 20,
+        step: 0.5,
+        doc: 'Spatial frequency; higher = tighter cells.',
+    },
+];
+//# sourceMappingURL=plasma.js.map

package/dist/catalog/shaders/plasma/plasma.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plasma.js","sourceRoot":"","sources":["../../../../catalog/shaders/plasma/plasma.ts"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,sEAAsE;AACtE,+EAA+E;AAC/E,iFAAiF;AACjF,kFAAkF;;;AAiBlF,kFAAkF;AACrE,QAAA,eAAe,GAA8B;IACxD,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,sBAAsB,EAAE;IACzF,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,uBAAuB,EAAE;IAC1F;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,GAAG;QACZ,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,4BAA4B;KAClC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC;QACV,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,EAAE;QACP,IAAI,EAAE,GAAG;QACT,GAAG,EAAE,4CAA4C;KAClD;CACF,CAAC","sourcesContent":["// Plasma layer-shader interface: typed uniforms + control descriptor. A two-\n// color time-morphing field, an opaque BACKGROUND layer (the cheapest\n// procedural engine worth shipping). The same shader also backs the standalone\n// `plasma` book presets (ocean/sunset/mint/fast) via ShaderOptionsMap; this file\n// is the layer-side type + control surface. Shader source is shaders/plasma.frag.\n\nimport type { RGB } from '../../../src/lib/primitives.types';\nimport type { UniformControl } from '../_shared/types';\n\n/** Typed uniforms for the `plasma` layer shader. */\nexport type PlasmaUniforms = {\n  /** First palette color, RGB each channel 0..1. */\n  readonly uColorA: RGB;\n  /** Second palette color, RGB each channel 0..1. */\n  readonly uColorB: RGB;\n  /** Animation rate; 0 freezes the field. */\n  readonly uSpeed: number;\n  /** Spatial frequency; higher = more, tighter cells. */\n  readonly uScale: number;\n};\n\n/** The `plasma` shader's tunable uniforms; defaults are the cool \"ocean\" look. */\nexport const PLASMA_CONTROLS: readonly UniformControl[] = [\n  { name: 'uColorA', kind: 'color', default: [0.0, 0.3, 0.6], doc: 'First palette color.' },\n  { name: 'uColorB', kind: 'color', default: [0.0, 0.6, 0.6], doc: 'Second palette color.' },\n  {\n    name: 'uSpeed',\n    kind: 'float',\n    default: 0.3,\n    min: 0,\n    max: 2,\n    step: 0.01,\n    doc: 'Animation rate; 0 freezes.',\n  },\n  {\n    name: 'uScale',\n    kind: 'float',\n    default: 8,\n    min: 1,\n    max: 20,\n    step: 0.5,\n    doc: 'Spatial frequency; higher = tighter cells.',\n  },\n];\n"]}

package/dist/catalog/shaders/simianlights/simianlights.d.ts

@@ -0,0 +1,20 @@
+import type { RGB } from '../../../src/lib/primitives.types';
+import type { UniformControl } from '../_shared/types';
+/** Typed uniforms for the `simianlights` layer shader. */
+export type SimianlightsUniforms = {
+    /** Overall tint / color grade; [1,1,1] keeps the stock star colors. */
+    readonly uColor: RGB;
+    /** Final glow multiplier; 1 = stock, higher = brighter field. */
+    readonly uBrightness: number;
+    /** Drift + rotation rate; 1 = stock, 0 freezes the field. */
+    readonly uSpeed: number;
+    /** Star color-cycle (twinkle) rate; 1 = stock. */
+    readonly uTwinkleSpeed: number;
+    /** Starfield zoom / density; >1 = more, smaller stars. */
+    readonly uScale: number;
+    /** Star-core size; 1 = stock, higher = fatter cores. */
+    readonly uStarGlow: number;
+};
+/** The `simianlights` shader's tunable uniforms; defaults reproduce the stock look. */
+export declare const SIMIANLIGHTS_CONTROLS: readonly UniformControl[];
+//# sourceMappingURL=simianlights.d.ts.map

package/dist/catalog/shaders/simianlights/simianlights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simianlights.d.ts","sourceRoot":"","sources":["../../../../catalog/shaders/simianlights/simianlights.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mCAAmC,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAAG;IACjC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,EAAE,SAAS,cAAc,EA+C1D,CAAC","sourcesContent":["// Simianlights layer-shader interface: typed uniforms + control descriptor. The\n// calmer sibling of the nebula (fewer starfield layers, larger near-field\n// scale), same opaque BACKGROUND-layer role and same uniform surface. Shader\n// source is ./simianlights.frag.\n\nimport type { RGB } from '../../../src/lib/primitives.types';\nimport type { UniformControl } from '../_shared/types';\n\n/** Typed uniforms for the `simianlights` layer shader. */\nexport type SimianlightsUniforms = {\n  /** Overall tint / color grade; [1,1,1] keeps the stock star colors. */\n  readonly uColor: RGB;\n  /** Final glow multiplier; 1 = stock, higher = brighter field. */\n  readonly uBrightness: number;\n  /** Drift + rotation rate; 1 = stock, 0 freezes the field. */\n  readonly uSpeed: number;\n  /** Star color-cycle (twinkle) rate; 1 = stock. */\n  readonly uTwinkleSpeed: number;\n  /** Starfield zoom / density; >1 = more, smaller stars. */\n  readonly uScale: number;\n  /** Star-core size; 1 = stock, higher = fatter cores. */\n  readonly uStarGlow: number;\n};\n\n/** The `simianlights` shader's tunable uniforms; defaults reproduce the stock look. */\nexport const SIMIANLIGHTS_CONTROLS: readonly UniformControl[] = [\n  { name: 'uColor', kind: 'color', default: [1, 1, 1], doc: 'Overall tint / color grade.' },\n  {\n    name: 'uBrightness',\n    kind: 'float',\n    default: 1,\n    min: 0,\n    max: 3,\n    step: 0.01,\n    doc: 'Final glow multiplier.',\n  },\n  {\n    name: 'uSpeed',\n    kind: 'float',\n    default: 1,\n    min: 0,\n    max: 3,\n    step: 0.01,\n    doc: 'Drift + rotation rate; 0 freezes.',\n  },\n  {\n    name: 'uTwinkleSpeed',\n    kind: 'float',\n    default: 1,\n    min: 0,\n    max: 3,\n    step: 0.01,\n    doc: 'Star twinkle rate.',\n  },\n  {\n    name: 'uScale',\n    kind: 'float',\n    default: 1,\n    min: 0.3,\n    max: 3,\n    step: 0.01,\n    doc: 'Zoom / density; >1 = more, smaller stars.',\n  },\n  {\n    name: 'uStarGlow',\n    kind: 'float',\n    default: 1,\n    min: 0.2,\n    max: 3,\n    step: 0.01,\n    doc: 'Star-core size.',\n  },\n];\n"]}

package/dist/catalog/shaders/simianlights/simianlights.form.d.ts

@@ -0,0 +1,3 @@
+import { type KaleidoscopeControls } from '../../../src/components/preset-control-panel';
+export declare function SimianlightsForm({ uniforms, onPatch, disabled }: KaleidoscopeControls): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=simianlights.form.d.ts.map

package/dist/catalog/shaders/simianlights/simianlights.form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simianlights.form.d.ts","sourceRoot":"","sources":["../../../../catalog/shaders/simianlights/simianlights.form.tsx"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,8CAA8C,CAAC;AAGtD,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,oBAAoB,2CAmBrF","sourcesContent":["// Simianlights' editor form: the shader OWNS its control layout. This pass just\n// stacks one <Control uniform=\"…\"/> per uniform in declared order (the auto-form's\n// shape); the point is that this file exists per shader, so layout/grouping is a\n// local edit here, and a new primitive flows in through <Control> without touching\n// it. Conventional layer id: \"field\".\n\nimport {\n  Control,\n  ControlForm,\n  ControlSection,\n  type KaleidoscopeControls,\n} from '../../../src/components/preset-control-panel';\nimport { SIMIANLIGHTS_CONTROLS } from './simianlights';\n\nexport function SimianlightsForm({ uniforms, onPatch, disabled }: KaleidoscopeControls) {\n  return (\n    <ControlForm\n      id=\"field\"\n      uniforms={uniforms.field ?? {}}\n      onPatch={onPatch}\n      disabled={disabled}\n      controls={SIMIANLIGHTS_CONTROLS}\n    >\n      <ControlSection title=\"simianlights\">\n        <Control uniform=\"uColor\" />\n        <Control uniform=\"uBrightness\" />\n        <Control uniform=\"uSpeed\" />\n        <Control uniform=\"uTwinkleSpeed\" />\n        <Control uniform=\"uScale\" />\n        <Control uniform=\"uStarGlow\" />\n      </ControlSection>\n    </ControlForm>\n  );\n}\n"]}

package/dist/catalog/shaders/simianlights/simianlights.form.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimianlightsForm = SimianlightsForm;
+const jsx_runtime_1 = require("react/jsx-runtime");
+// Simianlights' editor form: the shader OWNS its control layout. This pass just
+// stacks one <Control uniform="…"/> per uniform in declared order (the auto-form's
+// shape); the point is that this file exists per shader, so layout/grouping is a
+// local edit here, and a new primitive flows in through <Control> without touching
+// it. Conventional layer id: "field".
+const preset_control_panel_1 = require("../../../src/components/preset-control-panel");
+const simianlights_1 = require("./simianlights");
+function SimianlightsForm({ uniforms, onPatch, disabled }) {
+    return ((0, jsx_runtime_1.jsx)(preset_control_panel_1.ControlForm, { id: "field", uniforms: uniforms.field ?? {}, onPatch: onPatch, disabled: disabled, controls: simianlights_1.SIMIANLIGHTS_CONTROLS, children: (0, jsx_runtime_1.jsxs)(preset_control_panel_1.ControlSection, { title: "simianlights", children: [(0, jsx_runtime_1.jsx)(preset_control_panel_1.Control, { uniform: "uColor" }), (0, jsx_runtime_1.jsx)(preset_control_panel_1.Control, { uniform: "uBrightness" }), (0, jsx_runtime_1.jsx)(preset_control_panel_1.Control, { uniform: "uSpeed" }), (0, jsx_runtime_1.jsx)(preset_control_panel_1.Control, { uniform: "uTwinkleSpeed" }), (0, jsx_runtime_1.jsx)(preset_control_panel_1.Control, { uniform: "uScale" }), (0, jsx_runtime_1.jsx)(preset_control_panel_1.Control, { uniform: "uStarGlow" })] }) }));
+}
+//# sourceMappingURL=simianlights.form.js.map

package/dist/catalog/shaders/simianlights/simianlights.form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simianlights.form.js","sourceRoot":"","sources":["../../../../catalog/shaders/simianlights/simianlights.form.tsx"],"names":[],"mappings":";;;;AAAA,gFAAgF;AAChF,mFAAmF;AACnF,iFAAiF;AACjF,mFAAmF;AACnF,sCAAsC;AAEtC,uFAKsD;AACtD,iDAAuD;AAEvD,0BAAiC,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAwB;IACpF,OAAO,CACL,uBAAC,kCAAW,IACV,EAAE,EAAC,OAAO,EACV,QAAQ,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE,EAC9B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,oCAAqB,YAE/B,wBAAC,qCAAc,IAAC,KAAK,EAAC,cAAc,aAClC,uBAAC,8BAAO,IAAC,OAAO,EAAC,QAAQ,GAAG,EAC5B,uBAAC,8BAAO,IAAC,OAAO,EAAC,aAAa,GAAG,EACjC,uBAAC,8BAAO,IAAC,OAAO,EAAC,QAAQ,GAAG,EAC5B,uBAAC,8BAAO,IAAC,OAAO,EAAC,eAAe,GAAG,EACnC,uBAAC,8BAAO,IAAC,OAAO,EAAC,QAAQ,GAAG,EAC5B,uBAAC,8BAAO,IAAC,OAAO,EAAC,WAAW,GAAG,IAChB,GACL,CACf,CAAC;AACJ,CAAC","sourcesContent":["// Simianlights' editor form: the shader OWNS its control layout. This pass just\n// stacks one <Control uniform=\"…\"/> per uniform in declared order (the auto-form's\n// shape); the point is that this file exists per shader, so layout/grouping is a\n// local edit here, and a new primitive flows in through <Control> without touching\n// it. Conventional layer id: \"field\".\n\nimport {\n  Control,\n  ControlForm,\n  ControlSection,\n  type KaleidoscopeControls,\n} from '../../../src/components/preset-control-panel';\nimport { SIMIANLIGHTS_CONTROLS } from './simianlights';\n\nexport function SimianlightsForm({ uniforms, onPatch, disabled }: KaleidoscopeControls) {\n  return (\n    <ControlForm\n      id=\"field\"\n      uniforms={uniforms.field ?? {}}\n      onPatch={onPatch}\n      disabled={disabled}\n      controls={SIMIANLIGHTS_CONTROLS}\n    >\n      <ControlSection title=\"simianlights\">\n        <Control uniform=\"uColor\" />\n        <Control uniform=\"uBrightness\" />\n        <Control uniform=\"uSpeed\" />\n        <Control uniform=\"uTwinkleSpeed\" />\n        <Control uniform=\"uScale\" />\n        <Control uniform=\"uStarGlow\" />\n      </ControlSection>\n    </ControlForm>\n  );\n}\n"]}

package/dist/catalog/shaders/simianlights/simianlights.js

@@ -0,0 +1,57 @@
+"use strict";
+// Simianlights layer-shader interface: typed uniforms + control descriptor. The
+// calmer sibling of the nebula (fewer starfield layers, larger near-field
+// scale), same opaque BACKGROUND-layer role and same uniform surface. Shader
+// source is ./simianlights.frag.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SIMIANLIGHTS_CONTROLS = void 0;
+/** The `simianlights` shader's tunable uniforms; defaults reproduce the stock look. */
+exports.SIMIANLIGHTS_CONTROLS = [
+    { name: 'uColor', kind: 'color', default: [1, 1, 1], doc: 'Overall tint / color grade.' },
+    {
+        name: 'uBrightness',
+        kind: 'float',
+        default: 1,
+        min: 0,
+        max: 3,
+        step: 0.01,
+        doc: 'Final glow multiplier.',
+    },
+    {
+        name: 'uSpeed',
+        kind: 'float',
+        default: 1,
+        min: 0,
+        max: 3,
+        step: 0.01,
+        doc: 'Drift + rotation rate; 0 freezes.',
+    },
+    {
+        name: 'uTwinkleSpeed',
+        kind: 'float',
+        default: 1,
+        min: 0,
+        max: 3,
+        step: 0.01,
+        doc: 'Star twinkle rate.',
+    },
+    {
+        name: 'uScale',
+        kind: 'float',
+        default: 1,
+        min: 0.3,
+        max: 3,
+        step: 0.01,
+        doc: 'Zoom / density; >1 = more, smaller stars.',
+    },
+    {
+        name: 'uStarGlow',
+        kind: 'float',
+        default: 1,
+        min: 0.2,
+        max: 3,
+        step: 0.01,
+        doc: 'Star-core size.',
+    },
+];
+//# sourceMappingURL=simianlights.js.map

package/dist/catalog/shaders/simianlights/simianlights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simianlights.js","sourceRoot":"","sources":["../../../../catalog/shaders/simianlights/simianlights.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,0EAA0E;AAC1E,6EAA6E;AAC7E,iCAAiC;;;AAqBjC,uFAAuF;AAC1E,QAAA,qBAAqB,GAA8B;IAC9D,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,6BAA6B,EAAE;IACzF;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC;QACV,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,wBAAwB;KAC9B;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC;QACV,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,mCAAmC;KACzC;IACD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC;QACV,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,oBAAoB;KAC1B;IACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC;QACV,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,2CAA2C;KACjD;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC;QACV,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,IAAI;QACV,GAAG,EAAE,iBAAiB;KACvB;CACF,CAAC","sourcesContent":["// Simianlights layer-shader interface: typed uniforms + control descriptor. The\n// calmer sibling of the nebula (fewer starfield layers, larger near-field\n// scale), same opaque BACKGROUND-layer role and same uniform surface. Shader\n// source is ./simianlights.frag.\n\nimport type { RGB } from '../../../src/lib/primitives.types';\nimport type { UniformControl } from '../_shared/types';\n\n/** Typed uniforms for the `simianlights` layer shader. */\nexport type SimianlightsUniforms = {\n  /** Overall tint / color grade; [1,1,1] keeps the stock star colors. */\n  readonly uColor: RGB;\n  /** Final glow multiplier; 1 = stock, higher = brighter field. */\n  readonly uBrightness: number;\n  /** Drift + rotation rate; 1 = stock, 0 freezes the field. */\n  readonly uSpeed: number;\n  /** Star color-cycle (twinkle) rate; 1 = stock. */\n  readonly uTwinkleSpeed: number;\n  /** Starfield zoom / density; >1 = more, smaller stars. */\n  readonly uScale: number;\n  /** Star-core size; 1 = stock, higher = fatter cores. */\n  readonly uStarGlow: number;\n};\n\n/** The `simianlights` shader's tunable uniforms; defaults reproduce the stock look. */\nexport const SIMIANLIGHTS_CONTROLS: readonly UniformControl[] = [\n  { name: 'uColor', kind: 'color', default: [1, 1, 1], doc: 'Overall tint / color grade.' },\n  {\n    name: 'uBrightness',\n    kind: 'float',\n    default: 1,\n    min: 0,\n    max: 3,\n    step: 0.01,\n    doc: 'Final glow multiplier.',\n  },\n  {\n    name: 'uSpeed',\n    kind: 'float',\n    default: 1,\n    min: 0,\n    max: 3,\n    step: 0.01,\n    doc: 'Drift + rotation rate; 0 freezes.',\n  },\n  {\n    name: 'uTwinkleSpeed',\n    kind: 'float',\n    default: 1,\n    min: 0,\n    max: 3,\n    step: 0.01,\n    doc: 'Star twinkle rate.',\n  },\n  {\n    name: 'uScale',\n    kind: 'float',\n    default: 1,\n    min: 0.3,\n    max: 3,\n    step: 0.01,\n    doc: 'Zoom / density; >1 = more, smaller stars.',\n  },\n  {\n    name: 'uStarGlow',\n    kind: 'float',\n    default: 1,\n    min: 0.2,\n    max: 3,\n    step: 0.01,\n    doc: 'Star-core size.',\n  },\n];\n"]}

package/dist/src/components/form/control-form.d.ts

@@ -0,0 +1,37 @@
+import type { ReactNode } from 'react';
+import type { UniformControl } from '../../../catalog/shaders';
+/** One field's value: a scalar uniform or a vecN (e.g. an RGB triple). */
+export type FieldValue = number | readonly number[];
+type FormValues = Readonly<Record<string, FieldValue>>;
+/** The live form state a field reads/writes via `useField`. */
+export type ControlFormContextValue = {
+    readonly values: FormValues;
+    readonly setField: (key: string, value: FieldValue) => void;
+    readonly disabled: boolean;
+    /** The form's test-id scope (`kld.<preset>.<layer>`); fields append their uniform. */
+    readonly path: string;
+    /** The control descriptors, so `<Control uniform>` can resolve one by name. */
+    readonly controls?: readonly UniformControl[];
+};
+export declare const ControlFormContext: import("react").Context<ControlFormContextValue | null>;
+export type ControlFormProps = {
+    /** The layer id this form patches; the discriminator in the emitted patch. */
+    readonly id: string;
+    /** The layer's baked uniforms; the form seeds from these at mount. */
+    readonly uniforms: FormValues;
+    /** Emitted (debounced) with the layer id and the current edited uniforms. */
+    readonly onPatch: (patch: {
+        id: string;
+        uniforms: Record<string, FieldValue>;
+    }) => void;
+    /** Disables every field in the form (read by `useField`). */
+    readonly disabled?: boolean;
+    /** Trailing-edge debounce for the emit, in ms. 0 (default) emits per change. */
+    readonly debounceMs?: number;
+    /** The shader's control descriptors; lets children use `<Control uniform>`. */
+    readonly controls?: readonly UniformControl[];
+    readonly children: ReactNode;
+};
+export declare function ControlForm({ id, uniforms, onPatch, disabled, debounceMs, controls, children, }: ControlFormProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=control-form.d.ts.map

package/dist/src/components/form/control-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-form.d.ts","sourceRoot":"","sources":["../../../../src/components/form/control-form.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D,0EAA0E;AAC1E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAEpD,KAAK,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAEvD,+DAA+D;AAC/D,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C,CAAC;AAEF,eAAO,MAAM,kBAAkB,yDAAsD,CAAC;AAQtF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IACxF,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,CAAC;AAEF,wBAAgB,WAAW,CAAC,EAC1B,EAAE,EACF,QAAQ,EACR,OAAO,EACP,QAAgB,EAChB,UAAc,EACd,QAAQ,EACR,QAAQ,GACT,EAAE,gBAAgB,2CA+ClB","sourcesContent":["// ControlForm: the per-layer micro-provider that owns one form's view model.\n//\n// It holds the synchronous local values fields read (so a slider tracks the drag\n// without a host round-trip) and emits the debounced, trailing-flushed\n// `onPatch({ id, uniforms })` the host routes into `kaleidoscope(activeId, [...])`.\n//\n// Reset is by REMOUNT, never by effect: the Tuner renders the active controls\n// component keyed by preset id, so a preset switch unmounts this and a fresh\n// ControlForm re-seeds from `uniforms`. There is no effect syncing state to props.\n\nimport type { ReactNode } from 'react';\nimport { createContext, useContext, useEffect, useReducer, useRef } from 'react';\nimport type { UniformControl } from '../../../catalog/shaders';\nimport { controlScope } from '../../lib/test-id';\nimport { ControlScopeContext } from './scope';\n\n/** One field's value: a scalar uniform or a vecN (e.g. an RGB triple). */\nexport type FieldValue = number | readonly number[];\n\ntype FormValues = Readonly<Record<string, FieldValue>>;\n\n/** The live form state a field reads/writes via `useField`. */\nexport type ControlFormContextValue = {\n  readonly values: FormValues;\n  readonly setField: (key: string, value: FieldValue) => void;\n  readonly disabled: boolean;\n  /** The form's test-id scope (`kld.<preset>.<layer>`); fields append their uniform. */\n  readonly path: string;\n  /** The control descriptors, so `<Control uniform>` can resolve one by name. */\n  readonly controls?: readonly UniformControl[];\n};\n\nexport const ControlFormContext = createContext<ControlFormContextValue | null>(null);\n\ntype Action = { readonly key: string; readonly value: FieldValue };\n\nfunction reducer(state: FormValues, action: Action): FormValues {\n  return { ...state, [action.key]: action.value };\n}\n\nexport type ControlFormProps = {\n  /** The layer id this form patches; the discriminator in the emitted patch. */\n  readonly id: string;\n  /** The layer's baked uniforms; the form seeds from these at mount. */\n  readonly uniforms: FormValues;\n  /** Emitted (debounced) with the layer id and the current edited uniforms. */\n  readonly onPatch: (patch: { id: string; uniforms: Record<string, FieldValue> }) => void;\n  /** Disables every field in the form (read by `useField`). */\n  readonly disabled?: boolean;\n  /** Trailing-edge debounce for the emit, in ms. 0 (default) emits per change. */\n  readonly debounceMs?: number;\n  /** The shader's control descriptors; lets children use `<Control uniform>`. */\n  readonly controls?: readonly UniformControl[];\n  readonly children: ReactNode;\n};\n\nexport function ControlForm({\n  id,\n  uniforms,\n  onPatch,\n  disabled = false,\n  debounceMs = 0,\n  controls,\n  children,\n}: ControlFormProps) {\n  const [values, dispatch] = useReducer(reducer, uniforms);\n\n  // Latest onPatch in a ref so the emit effect doesn't re-arm when the parent\n  // passes a fresh callback each render.\n  const onPatchRef = useRef(onPatch);\n  onPatchRef.current = onPatch;\n\n  // The latest not-yet-emitted edit, held so it can be flushed on unmount (a\n  // preset switch remounts this form mid-debounce; the trailing value must not be\n  // lost). Cleared when it fires.\n  const pending = useRef<(() => void) | null>(null);\n\n  // Skip the emit for the initial seed; only edits should patch.\n  const seeded = useRef(false);\n  useEffect(() => {\n    if (!seeded.current) {\n      seeded.current = true;\n      return;\n    }\n    const fire = () => {\n      pending.current = null;\n      onPatchRef.current({ id, uniforms: { ...values } });\n    };\n    if (debounceMs <= 0) {\n      fire();\n      return;\n    }\n    pending.current = fire;\n    const t = setTimeout(fire, debounceMs);\n    return () => clearTimeout(t);\n  }, [values, id, debounceMs]);\n\n  // Flush a pending debounced edit on unmount so the trailing value survives a\n  // remount/preset switch.\n  useEffect(() => () => pending.current?.(), []);\n\n  const presetId = useContext(ControlScopeContext);\n  const ctx: ControlFormContextValue = {\n    values,\n    setField: (key, value) => dispatch({ key, value }),\n    disabled,\n    path: controlScope(presetId, id),\n    controls,\n  };\n\n  return <ControlFormContext.Provider value={ctx}>{children}</ControlFormContext.Provider>;\n}\n"]}

package/dist/src/components/form/control-form.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControlFormContext = void 0;
+exports.ControlForm = ControlForm;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const test_id_1 = require("../../lib/test-id");
+const scope_1 = require("./scope");
+exports.ControlFormContext = (0, react_1.createContext)(null);
+function reducer(state, action) {
+    return { ...state, [action.key]: action.value };
+}
+function ControlForm({ id, uniforms, onPatch, disabled = false, debounceMs = 0, controls, children, }) {
+    const [values, dispatch] = (0, react_1.useReducer)(reducer, uniforms);
+    // Latest onPatch in a ref so the emit effect doesn't re-arm when the parent
+    // passes a fresh callback each render.
+    const onPatchRef = (0, react_1.useRef)(onPatch);
+    onPatchRef.current = onPatch;
+    // The latest not-yet-emitted edit, held so it can be flushed on unmount (a
+    // preset switch remounts this form mid-debounce; the trailing value must not be
+    // lost). Cleared when it fires.
+    const pending = (0, react_1.useRef)(null);
+    // Skip the emit for the initial seed; only edits should patch.
+    const seeded = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (!seeded.current) {
+            seeded.current = true;
+            return;
+        }
+        const fire = () => {
+            pending.current = null;
+            onPatchRef.current({ id, uniforms: { ...values } });
+        };
+        if (debounceMs <= 0) {
+            fire();
+            return;
+        }
+        pending.current = fire;
+        const t = setTimeout(fire, debounceMs);
+        return () => clearTimeout(t);
+    }, [values, id, debounceMs]);
+    // Flush a pending debounced edit on unmount so the trailing value survives a
+    // remount/preset switch.
+    (0, react_1.useEffect)(() => () => pending.current?.(), []);
+    const presetId = (0, react_1.useContext)(scope_1.ControlScopeContext);
+    const ctx = {
+        values,
+        setField: (key, value) => dispatch({ key, value }),
+        disabled,
+        path: (0, test_id_1.controlScope)(presetId, id),
+        controls,
+    };
+    return (0, jsx_runtime_1.jsx)(exports.ControlFormContext.Provider, { value: ctx, children: children });
+}
+//# sourceMappingURL=control-form.js.map

package/dist/src/components/form/control-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-form.js","sourceRoot":"","sources":["../../../../src/components/form/control-form.tsx"],"names":[],"mappings":";;;;;AAWA,iCAAiF;AAEjF,+CAAiD;AACjD,mCAA8C;AAkBjC,QAAA,kBAAkB,GAAG,IAAA,qBAAa,EAAiC,IAAI,CAAC,CAAC;AAItF,SAAS,OAAO,CAAC,KAAiB,EAAE,MAAc;IAChD,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AAClD,CAAC;AAkBD,qBAA4B,EAC1B,EAAE,EACF,QAAQ,EACR,OAAO,EACP,QAAQ,GAAG,KAAK,EAChB,UAAU,GAAG,CAAC,EACd,QAAQ,EACR,QAAQ,GACS;IACjB,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAA,kBAAU,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEzD,4EAA4E;IAC5E,uCAAuC;IACvC,MAAM,UAAU,GAAG,IAAA,cAAM,EAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,2EAA2E;IAC3E,gFAAgF;IAChF,gCAAgC;IAChC,MAAM,OAAO,GAAG,IAAA,cAAM,EAAsB,IAAI,CAAC,CAAC;IAElD,+DAA+D;IAC/D,MAAM,MAAM,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAC;IAC7B,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YACvB,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC;QACF,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACpB,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QACD,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACvC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAE7B,6EAA6E;IAC7E,yBAAyB;IACzB,IAAA,iBAAS,EAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAAG,IAAA,kBAAU,EAAC,2BAAmB,CAAC,CAAC;IACjD,MAAM,GAAG,GAA4B;QACnC,MAAM;QACN,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAClD,QAAQ;QACR,IAAI,EAAE,IAAA,sBAAY,EAAC,QAAQ,EAAE,EAAE,CAAC;QAChC,QAAQ;KACT,CAAC;IAEF,OAAO,uBAAC,QAAA,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,GAAG,YAAG,QAAQ,GAA+B,CAAC;AAC3F,CAAC","sourcesContent":["// ControlForm: the per-layer micro-provider that owns one form's view model.\n//\n// It holds the synchronous local values fields read (so a slider tracks the drag\n// without a host round-trip) and emits the debounced, trailing-flushed\n// `onPatch({ id, uniforms })` the host routes into `kaleidoscope(activeId, [...])`.\n//\n// Reset is by REMOUNT, never by effect: the Tuner renders the active controls\n// component keyed by preset id, so a preset switch unmounts this and a fresh\n// ControlForm re-seeds from `uniforms`. There is no effect syncing state to props.\n\nimport type { ReactNode } from 'react';\nimport { createContext, useContext, useEffect, useReducer, useRef } from 'react';\nimport type { UniformControl } from '../../../catalog/shaders';\nimport { controlScope } from '../../lib/test-id';\nimport { ControlScopeContext } from './scope';\n\n/** One field's value: a scalar uniform or a vecN (e.g. an RGB triple). */\nexport type FieldValue = number | readonly number[];\n\ntype FormValues = Readonly<Record<string, FieldValue>>;\n\n/** The live form state a field reads/writes via `useField`. */\nexport type ControlFormContextValue = {\n  readonly values: FormValues;\n  readonly setField: (key: string, value: FieldValue) => void;\n  readonly disabled: boolean;\n  /** The form's test-id scope (`kld.<preset>.<layer>`); fields append their uniform. */\n  readonly path: string;\n  /** The control descriptors, so `<Control uniform>` can resolve one by name. */\n  readonly controls?: readonly UniformControl[];\n};\n\nexport const ControlFormContext = createContext<ControlFormContextValue | null>(null);\n\ntype Action = { readonly key: string; readonly value: FieldValue };\n\nfunction reducer(state: FormValues, action: Action): FormValues {\n  return { ...state, [action.key]: action.value };\n}\n\nexport type ControlFormProps = {\n  /** The layer id this form patches; the discriminator in the emitted patch. */\n  readonly id: string;\n  /** The layer's baked uniforms; the form seeds from these at mount. */\n  readonly uniforms: FormValues;\n  /** Emitted (debounced) with the layer id and the current edited uniforms. */\n  readonly onPatch: (patch: { id: string; uniforms: Record<string, FieldValue> }) => void;\n  /** Disables every field in the form (read by `useField`). */\n  readonly disabled?: boolean;\n  /** Trailing-edge debounce for the emit, in ms. 0 (default) emits per change. */\n  readonly debounceMs?: number;\n  /** The shader's control descriptors; lets children use `<Control uniform>`. */\n  readonly controls?: readonly UniformControl[];\n  readonly children: ReactNode;\n};\n\nexport function ControlForm({\n  id,\n  uniforms,\n  onPatch,\n  disabled = false,\n  debounceMs = 0,\n  controls,\n  children,\n}: ControlFormProps) {\n  const [values, dispatch] = useReducer(reducer, uniforms);\n\n  // Latest onPatch in a ref so the emit effect doesn't re-arm when the parent\n  // passes a fresh callback each render.\n  const onPatchRef = useRef(onPatch);\n  onPatchRef.current = onPatch;\n\n  // The latest not-yet-emitted edit, held so it can be flushed on unmount (a\n  // preset switch remounts this form mid-debounce; the trailing value must not be\n  // lost). Cleared when it fires.\n  const pending = useRef<(() => void) | null>(null);\n\n  // Skip the emit for the initial seed; only edits should patch.\n  const seeded = useRef(false);\n  useEffect(() => {\n    if (!seeded.current) {\n      seeded.current = true;\n      return;\n    }\n    const fire = () => {\n      pending.current = null;\n      onPatchRef.current({ id, uniforms: { ...values } });\n    };\n    if (debounceMs <= 0) {\n      fire();\n      return;\n    }\n    pending.current = fire;\n    const t = setTimeout(fire, debounceMs);\n    return () => clearTimeout(t);\n  }, [values, id, debounceMs]);\n\n  // Flush a pending debounced edit on unmount so the trailing value survives a\n  // remount/preset switch.\n  useEffect(() => () => pending.current?.(), []);\n\n  const presetId = useContext(ControlScopeContext);\n  const ctx: ControlFormContextValue = {\n    values,\n    setField: (key, value) => dispatch({ key, value }),\n    disabled,\n    path: controlScope(presetId, id),\n    controls,\n  };\n\n  return <ControlFormContext.Provider value={ctx}>{children}</ControlFormContext.Provider>;\n}\n"]}

package/dist/src/components/form/make-controls.d.ts

@@ -0,0 +1,22 @@
+import type { ReactElement } from 'react';
+import type { RGB } from '../../lib/primitives.types';
+import { type ColorPickerProps } from '../ui/color-picker';
+import { type SliderProps } from '../ui/slider';
+type NumericKeys<U> = {
+    [K in keyof U]: U[K] extends number ? K : never;
+}[keyof U];
+type RgbKeys<U> = {
+    [K in keyof U]: U[K] extends RGB ? K : never;
+}[keyof U];
+type TypedSlider<U> = (props: Omit<SliderProps, 'uniform'> & {
+    readonly uniform: NumericKeys<U> & string;
+}) => ReactElement;
+type TypedColorPicker<U> = (props: Omit<ColorPickerProps, 'uniform'> & {
+    readonly uniform: RgbKeys<U> & string;
+}) => ReactElement;
+export declare function makeControls<U>(): {
+    readonly Slider: TypedSlider<U>;
+    readonly ColorPicker: TypedColorPicker<U>;
+};
+export {};
+//# sourceMappingURL=make-controls.d.ts.map

package/dist/src/components/form/make-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-controls.d.ts","sourceRoot":"","sources":["../../../../src/components/form/make-controls.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAExD,KAAK,WAAW,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,KAAK;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AACnF,KAAK,OAAO,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,KAAK;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC;AAE5E,KAAK,WAAW,CAAC,CAAC,IAAI,CACpB,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAAA;CAAE,KAChF,YAAY,CAAC;AAElB,KAAK,gBAAgB,CAAC,CAAC,IAAI,CACzB,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAA;CAAE,KACjF,YAAY,CAAC;AAElB,wBAAgB,YAAY,CAAC,CAAC,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC3C,CAKA","sourcesContent":["// makeControls<U>(): the typed-factory escape from React context invariance.\n// Returns the field primitives with their `uniform` prop narrowed to the keys of\n// the shader's uniform type whose value matches the widget (numeric keys for the\n// Slider, RGB-tuple keys for the ColorPicker). A shader fragment authors\n// `const { Slider, ColorPicker } = makeControls<CloudsUniforms>()`, after which a\n// typo'd or wrong-typed `uniform` is a compile error. The components still\n// self-wire through the nearest ControlForm at runtime.\n\nimport type { ReactElement } from 'react';\nimport type { RGB } from '../../lib/primitives.types';\nimport { ColorPicker, type ColorPickerProps } from '../ui/color-picker';\nimport { Slider, type SliderProps } from '../ui/slider';\n\ntype NumericKeys<U> = { [K in keyof U]: U[K] extends number ? K : never }[keyof U];\ntype RgbKeys<U> = { [K in keyof U]: U[K] extends RGB ? K : never }[keyof U];\n\ntype TypedSlider<U> = (\n  props: Omit<SliderProps, 'uniform'> & { readonly uniform: NumericKeys<U> & string },\n) => ReactElement;\n\ntype TypedColorPicker<U> = (\n  props: Omit<ColorPickerProps, 'uniform'> & { readonly uniform: RgbKeys<U> & string },\n) => ReactElement;\n\nexport function makeControls<U>(): {\n  readonly Slider: TypedSlider<U>;\n  readonly ColorPicker: TypedColorPicker<U>;\n} {\n  return {\n    Slider: Slider as TypedSlider<U>,\n    ColorPicker: ColorPicker as TypedColorPicker<U>,\n  };\n}\n"]}

package/dist/src/components/form/make-controls.js

@@ -0,0 +1,19 @@
+"use strict";
+// makeControls<U>(): the typed-factory escape from React context invariance.
+// Returns the field primitives with their `uniform` prop narrowed to the keys of
+// the shader's uniform type whose value matches the widget (numeric keys for the
+// Slider, RGB-tuple keys for the ColorPicker). A shader fragment authors
+// `const { Slider, ColorPicker } = makeControls<CloudsUniforms>()`, after which a
+// typo'd or wrong-typed `uniform` is a compile error. The components still
+// self-wire through the nearest ControlForm at runtime.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeControls = makeControls;
+const color_picker_1 = require("../ui/color-picker");
+const slider_1 = require("../ui/slider");
+function makeControls() {
+    return {
+        Slider: slider_1.Slider,
+        ColorPicker: color_picker_1.ColorPicker,
+    };
+}
+//# sourceMappingURL=make-controls.js.map

package/dist/src/components/form/make-controls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-controls.js","sourceRoot":"","sources":["../../../../src/components/form/make-controls.ts"],"names":[],"mappings":";AAAA,6EAA6E;AAC7E,iFAAiF;AACjF,iFAAiF;AACjF,yEAAyE;AACzE,kFAAkF;AAClF,2EAA2E;AAC3E,wDAAwD;;;AAIxD,qDAAwE;AACxE,yCAAwD;AAaxD;IAIE,OAAO;QACL,MAAM,EAAE,eAAwB;QAChC,WAAW,EAAE,0BAAkC;KAChD,CAAC;AACJ,CAAC","sourcesContent":["// makeControls<U>(): the typed-factory escape from React context invariance.\n// Returns the field primitives with their `uniform` prop narrowed to the keys of\n// the shader's uniform type whose value matches the widget (numeric keys for the\n// Slider, RGB-tuple keys for the ColorPicker). A shader fragment authors\n// `const { Slider, ColorPicker } = makeControls<CloudsUniforms>()`, after which a\n// typo'd or wrong-typed `uniform` is a compile error. The components still\n// self-wire through the nearest ControlForm at runtime.\n\nimport type { ReactElement } from 'react';\nimport type { RGB } from '../../lib/primitives.types';\nimport { ColorPicker, type ColorPickerProps } from '../ui/color-picker';\nimport { Slider, type SliderProps } from '../ui/slider';\n\ntype NumericKeys<U> = { [K in keyof U]: U[K] extends number ? K : never }[keyof U];\ntype RgbKeys<U> = { [K in keyof U]: U[K] extends RGB ? K : never }[keyof U];\n\ntype TypedSlider<U> = (\n  props: Omit<SliderProps, 'uniform'> & { readonly uniform: NumericKeys<U> & string },\n) => ReactElement;\n\ntype TypedColorPicker<U> = (\n  props: Omit<ColorPickerProps, 'uniform'> & { readonly uniform: RgbKeys<U> & string },\n) => ReactElement;\n\nexport function makeControls<U>(): {\n  readonly Slider: TypedSlider<U>;\n  readonly ColorPicker: TypedColorPicker<U>;\n} {\n  return {\n    Slider: Slider as TypedSlider<U>,\n    ColorPicker: ColorPicker as TypedColorPicker<U>,\n  };\n}\n"]}

package/dist/src/components/form/scope.d.ts

@@ -0,0 +1,2 @@
+export declare const ControlScopeContext: import("react").Context<string | null>;
+//# sourceMappingURL=scope.d.ts.map

package/dist/src/components/form/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../../src/components/form/scope.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,mBAAmB,wCAAqC,CAAC","sourcesContent":["// ControlScopeContext: the active preset id, provided by PresetControlPanel above\n// the controls component so each ControlForm can compose its test-id scope\n// (`kld.<preset>.<layer>`) without the per-composite forms having to thread it.\n// Null when a ControlForm is rendered standalone (no Tuner); the scope then\n// drops the preset segment.\n\nimport { createContext } from 'react';\n\nexport const ControlScopeContext = createContext<string | null>(null);\n"]}

package/dist/src/components/form/scope.js

@@ -0,0 +1,11 @@
+"use strict";
+// ControlScopeContext: the active preset id, provided by PresetControlPanel above
+// the controls component so each ControlForm can compose its test-id scope
+// (`kld.<preset>.<layer>`) without the per-composite forms having to thread it.
+// Null when a ControlForm is rendered standalone (no Tuner); the scope then
+// drops the preset segment.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControlScopeContext = void 0;
+const react_1 = require("react");
+exports.ControlScopeContext = (0, react_1.createContext)(null);
+//# sourceMappingURL=scope.js.map

package/dist/src/components/form/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../../src/components/form/scope.ts"],"names":[],"mappings":";AAAA,kFAAkF;AAClF,2EAA2E;AAC3E,gFAAgF;AAChF,4EAA4E;AAC5E,4BAA4B;;;AAE5B,iCAAsC;AAEzB,QAAA,mBAAmB,GAAG,IAAA,qBAAa,EAAgB,IAAI,CAAC,CAAC","sourcesContent":["// ControlScopeContext: the active preset id, provided by PresetControlPanel above\n// the controls component so each ControlForm can compose its test-id scope\n// (`kld.<preset>.<layer>`) without the per-composite forms having to thread it.\n// Null when a ControlForm is rendered standalone (no Tuner); the scope then\n// drops the preset segment.\n\nimport { createContext } from 'react';\n\nexport const ControlScopeContext = createContext<string | null>(null);\n"]}

package/dist/src/components/form/use-field.d.ts

@@ -0,0 +1,10 @@
+import { type FieldValue } from './control-form';
+export type Field = {
+    readonly value: FieldValue | undefined;
+    readonly onChange: (value: FieldValue) => void;
+    readonly disabled: boolean;
+    /** Deterministic `accessibilityIdentifier` for this field: `<form path>.<key>`. */
+    readonly testID: string;
+};
+export declare function useField(key: string): Field;
+//# sourceMappingURL=use-field.d.ts.map

package/dist/src/components/form/use-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-field.d.ts","sourceRoot":"","sources":["../../../../src/components/form/use-field.ts"],"names":[],"mappings":"AAUA,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAErE,MAAM,MAAM,KAAK,GAAG;IAClB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAc3C","sourcesContent":["// useField: a control primitive's hook into its ControlForm. Reads the field's\n// current value (synchronously, so display tracks input) and returns an onChange\n// that writes back. Throws without a ControlForm ancestor, which is the contract\n// that keeps shader fragments from being rendered standalone.\n//\n// This is the raw, loosely-typed hook; `makeControls<U>()` wraps it to constrain\n// the key and value types to a shader's uniform type.\n\nimport { useContext } from 'react';\nimport { fieldTestId } from '../../lib/test-id';\nimport { ControlFormContext, type FieldValue } from './control-form';\n\nexport type Field = {\n  readonly value: FieldValue | undefined;\n  readonly onChange: (value: FieldValue) => void;\n  readonly disabled: boolean;\n  /** Deterministic `accessibilityIdentifier` for this field: `<form path>.<key>`. */\n  readonly testID: string;\n};\n\nexport function useField(key: string): Field {\n  const ctx = useContext(ControlFormContext);\n  if (ctx === null) {\n    throw new Error(\n      `useField(\"${key}\") must be rendered inside a <ControlForm>. A shader control ` +\n        'fragment is mounted by its composite form, not standalone.',\n    );\n  }\n  return {\n    value: ctx.values[key],\n    onChange: (value) => ctx.setField(key, value),\n    disabled: ctx.disabled,\n    testID: fieldTestId(ctx.path, key),\n  };\n}\n"]}

package/dist/src/components/form/use-field.js

@@ -0,0 +1,27 @@
+"use strict";
+// useField: a control primitive's hook into its ControlForm. Reads the field's
+// current value (synchronously, so display tracks input) and returns an onChange
+// that writes back. Throws without a ControlForm ancestor, which is the contract
+// that keeps shader fragments from being rendered standalone.
+//
+// This is the raw, loosely-typed hook; `makeControls<U>()` wraps it to constrain
+// the key and value types to a shader's uniform type.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useField = useField;
+const react_1 = require("react");
+const test_id_1 = require("../../lib/test-id");
+const control_form_1 = require("./control-form");
+function useField(key) {
+    const ctx = (0, react_1.useContext)(control_form_1.ControlFormContext);
+    if (ctx === null) {
+        throw new Error(`useField("${key}") must be rendered inside a <ControlForm>. A shader control ` +
+            'fragment is mounted by its composite form, not standalone.');
+    }
+    return {
+        value: ctx.values[key],
+        onChange: (value) => ctx.setField(key, value),
+        disabled: ctx.disabled,
+        testID: (0, test_id_1.fieldTestId)(ctx.path, key),
+    };
+}
+//# sourceMappingURL=use-field.js.map

package/dist/src/components/form/use-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-field.js","sourceRoot":"","sources":["../../../../src/components/form/use-field.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,iFAAiF;AACjF,iFAAiF;AACjF,8DAA8D;AAC9D,EAAE;AACF,iFAAiF;AACjF,sDAAsD;;;AAEtD,iCAAmC;AACnC,+CAAgD;AAChD,iDAAqE;AAUrE,kBAAyB,GAAW;IAClC,MAAM,GAAG,GAAG,IAAA,kBAAU,EAAC,iCAAkB,CAAC,CAAC;IAC3C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,aAAa,GAAG,+DAA+D;YAC7E,4DAA4D,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC;QACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;QAC7C,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,MAAM,EAAE,IAAA,qBAAW,EAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC;KACnC,CAAC;AACJ,CAAC","sourcesContent":["// useField: a control primitive's hook into its ControlForm. Reads the field's\n// current value (synchronously, so display tracks input) and returns an onChange\n// that writes back. Throws without a ControlForm ancestor, which is the contract\n// that keeps shader fragments from being rendered standalone.\n//\n// This is the raw, loosely-typed hook; `makeControls<U>()` wraps it to constrain\n// the key and value types to a shader's uniform type.\n\nimport { useContext } from 'react';\nimport { fieldTestId } from '../../lib/test-id';\nimport { ControlFormContext, type FieldValue } from './control-form';\n\nexport type Field = {\n  readonly value: FieldValue | undefined;\n  readonly onChange: (value: FieldValue) => void;\n  readonly disabled: boolean;\n  /** Deterministic `accessibilityIdentifier` for this field: `<form path>.<key>`. */\n  readonly testID: string;\n};\n\nexport function useField(key: string): Field {\n  const ctx = useContext(ControlFormContext);\n  if (ctx === null) {\n    throw new Error(\n      `useField(\"${key}\") must be rendered inside a <ControlForm>. A shader control ` +\n        'fragment is mounted by its composite form, not standalone.',\n    );\n  }\n  return {\n    value: ctx.values[key],\n    onChange: (value) => ctx.setField(key, value),\n    disabled: ctx.disabled,\n    testID: fieldTestId(ctx.path, key),\n  };\n}\n"]}

package/dist/src/components/preset-book-menu/index.d.ts

@@ -0,0 +1,52 @@
+import type { KaleidoscopePresetBook } from '../../kaleidoscope.preset-book.types';
+import type { Category, Family, PresetBookMenuProps, PresetView } from './preset-book-menu.types';
+/** The grouping usePresetBookMenu returns; named so BYO-layout consumers can type it. */
+export interface PresetBookMenuModel {
+    /** Distinct families present in the book, in first-appearance order. */
+    readonly families: ReadonlyArray<Family>;
+    /** The reconciled active family (survives a changed book; falls back to the first). */
+    readonly activeTab: Family | undefined;
+    /** Set the active family tab. */
+    readonly setActiveTab: (family: Family) => void;
+    /**
+     * Categories (taxonomy[1]) within the active family, first-appearance order.
+     * Empty when the family is flat (every preset is depth-1).
+     */
+    readonly categories: ReadonlyArray<Category>;
+    /** The reconciled active category, or undefined when the family is flat. */
+    readonly activeCategory: Category | undefined;
+    /** Set the active category. */
+    readonly setActiveCategory: (category: Category) => void;
+    /**
+     * Presets to display: the active family narrowed to the active category, or
+     * every preset in the family when it is flat.
+     */
+    readonly views: ReadonlyArray<PresetView>;
+}
+/**
+ * Tabbed, preset-book-driven picker. Controlled selection; emits the chosen id
+ * and the host applies it.
+ *
+ * @example
+ * <PresetBookMenu
+ *   presets={presets}
+ *   value={art}
+ *   onSelect={setArt}
+ * />
+ */
+export declare function PresetBookMenu<P extends KaleidoscopePresetBook>(props: PresetBookMenuProps<P>): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Group a preset book by family and category, and own the active tab and
+ * category. The grouping is plain; no hand-rolled memo: React Compiler memoizes
+ * it when the library is compiled, and it is cheap to recompute otherwise. The
+ * active tab and category are reconciled every render: each survives as long as
+ * it is still in the book, else it falls back to the first; so swapping
+ * `presets`, or switching to a family that lacks the prior category, can't strand
+ * a dead selection.
+ */
+export declare function usePresetBookMenu<P extends KaleidoscopePresetBook>(presets: P, labelFor?: (id: keyof P & string) => string): PresetBookMenuModel;
+export { PresetTile } from '../preset-tile';
+export { PresetBookMenuLayout } from './layout';
+export type { Category, Family, PresetBookMenuProps, PresetBookMenuSelection, PresetBookMenuStyleProps, PresetItemState, PresetView, RenderTile, } from './preset-book-menu.types';
+export { PresetGrid } from './preset-grid';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/components/preset-book-menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/preset-book-menu/index.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAGnF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGlG,yFAAyF;AACzF,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACzC,uFAAuF;IACvF,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,iCAAiC;IACjC,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC7C,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9C,+BAA+B;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACzD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,sBAAsB,EAAE,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,kDAqE7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,sBAAsB,EAChE,OAAO,EAAE,CAAC,EACV,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,MAAM,KAAK,MAAM,GAC1C,mBAAmB,CA6DrB;AA6ED,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EACV,QAAQ,EACR,MAAM,EACN,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,eAAe,EACf,UAAU,EACV,UAAU,GACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC","sourcesContent":["// The drop-in composite picker (#28): tabs over the consumer's preset families,\n// a left-hand category menu under the tabs, and a uniform tile grid filtered by\n// the active family and category. Controlled selection; emit the chosen id, the\n// host applies it. `usePresetBookMenu` is the orchestration (group the book by\n// family/category, own the active tab and category) and is exported for BYO\n// layouts.\n\nimport { useState } from 'react';\nimport { Pressable, StyleSheet, Text } from 'react-native';\nimport type { KaleidoscopePresetBook } from '../../kaleidoscope.preset-book.types';\nimport { categoryTestId, familyTestId } from '../../lib/test-id';\nimport { PresetBookMenuLayout } from './layout';\nimport type { Category, Family, PresetBookMenuProps, PresetView } from './preset-book-menu.types';\nimport { PresetGrid } from './preset-grid';\n\n/** The grouping usePresetBookMenu returns; named so BYO-layout consumers can type it. */\nexport interface PresetBookMenuModel {\n  /** Distinct families present in the book, in first-appearance order. */\n  readonly families: ReadonlyArray<Family>;\n  /** The reconciled active family (survives a changed book; falls back to the first). */\n  readonly activeTab: Family | undefined;\n  /** Set the active family tab. */\n  readonly setActiveTab: (family: Family) => void;\n  /**\n   * Categories (taxonomy[1]) within the active family, first-appearance order.\n   * Empty when the family is flat (every preset is depth-1).\n   */\n  readonly categories: ReadonlyArray<Category>;\n  /** The reconciled active category, or undefined when the family is flat. */\n  readonly activeCategory: Category | undefined;\n  /** Set the active category. */\n  readonly setActiveCategory: (category: Category) => void;\n  /**\n   * Presets to display: the active family narrowed to the active category, or\n   * every preset in the family when it is flat.\n   */\n  readonly views: ReadonlyArray<PresetView>;\n}\n\n/**\n * Tabbed, preset-book-driven picker. Controlled selection; emits the chosen id\n * and the host applies it.\n *\n * @example\n * <PresetBookMenu\n *   presets={presets}\n *   value={art}\n *   onSelect={setArt}\n * />\n */\nexport function PresetBookMenu<P extends KaleidoscopePresetBook>(props: PresetBookMenuProps<P>) {\n  // `className` (declared on PresetBookMenuProps) is intentionally not destructured: the\n  // ./nativewind cssInterop registration consumes it at the JSX boundary and\n  // merges the resolved classes into `style` before this body runs.\n  const {\n    presets,\n    value,\n    onSelect,\n    disabled = false,\n    renderTile,\n    labelFor,\n    tabLabelFor,\n    categoryLabelFor,\n    style,\n  } = props;\n  const {\n    families,\n    activeTab,\n    setActiveTab,\n    categories,\n    activeCategory,\n    setActiveCategory,\n    views,\n  } = usePresetBookMenu(presets, labelFor);\n\n  if (!activeTab) return null;\n  // The renderers speak string ids (PresetView.id); the public onSelect is\n  // narrowed to keyof P. Adapt once here so consumers need no cast (every id\n  // came from Object.keys(presets), so it is a real key).\n  const handleSelect = (id: string | null) => onSelect(id as (keyof P & string) | null);\n\n  return (\n    <PresetBookMenuLayout\n      style={style}\n      tabsZone={families.map((family) => (\n        <Tab\n          key={family}\n          label={tabLabelFor?.(family) ?? titleCase(family)}\n          active={family === activeTab}\n          disabled={disabled}\n          onPress={() => setActiveTab(family)}\n          testID={familyTestId(family)}\n        />\n      ))}\n      sidebarZone={\n        categories.length > 0\n          ? categories.map((category) => (\n              <CategoryItem\n                key={category}\n                label={categoryLabelFor?.(category) ?? category}\n                active={category === activeCategory}\n                disabled={disabled}\n                onPress={() => setActiveCategory(category)}\n                testID={categoryTestId(activeTab, category)}\n              />\n            ))\n          : undefined\n      }\n      bodyZone={\n        <PresetGrid\n          presets={views}\n          value={value}\n          onSelect={handleSelect}\n          disabled={disabled}\n          renderTile={renderTile}\n        />\n      }\n    />\n  );\n}\n\n/**\n * Group a preset book by family and category, and own the active tab and\n * category. The grouping is plain; no hand-rolled memo: React Compiler memoizes\n * it when the library is compiled, and it is cheap to recompute otherwise. The\n * active tab and category are reconciled every render: each survives as long as\n * it is still in the book, else it falls back to the first; so swapping\n * `presets`, or switching to a family that lacks the prior category, can't strand\n * a dead selection.\n */\nexport function usePresetBookMenu<P extends KaleidoscopePresetBook>(\n  presets: P,\n  labelFor?: (id: keyof P & string) => string,\n): PresetBookMenuModel {\n  const families: Family[] = [];\n  const viewsByFamily = new Map<Family, PresetView[]>();\n  const categoriesByFamily = new Map<Family, Category[]>();\n  const viewsByFamilyCategory = new Map<Family, Map<Category, PresetView[]>>();\n  for (const id of Object.keys(presets)) {\n    const preset = presets[id];\n    if (!preset) continue;\n    // taxonomy[0] is the family (tab); taxonomy[1], when present, is the\n    // category (left-hand menu). A depth-1 preset has no category.\n    const family = preset.taxonomy[0];\n    const category = preset.taxonomy[1];\n    const view: PresetView = {\n      id,\n      label: labelFor?.(id as keyof P & string) ?? preset.name,\n      family,\n      category,\n      source:\n        typeof preset.thumbnail === 'string' || typeof preset.thumbnail === 'number'\n          ? preset.thumbnail\n          : undefined,\n    };\n    if (!viewsByFamily.has(family)) {\n      families.push(family);\n      viewsByFamily.set(family, []);\n      categoriesByFamily.set(family, []);\n      viewsByFamilyCategory.set(family, new Map());\n    }\n    viewsByFamily.get(family)?.push(view);\n    if (category !== undefined) {\n      const cats = categoriesByFamily.get(family);\n      const catViews = viewsByFamilyCategory.get(family);\n      if (cats && catViews && !catViews.has(category)) {\n        cats.push(category);\n        catViews.set(category, []);\n      }\n      catViews?.get(category)?.push(view);\n    }\n  }\n\n  const [activeTab, setActiveTab] = useState<Family | undefined>(undefined);\n  const family = activeTab && families.includes(activeTab) ? activeTab : families[0];\n  const categories = (family && categoriesByFamily.get(family)) || [];\n\n  const [activeCategory, setActiveCategory] = useState<Category | undefined>(undefined);\n  const category =\n    activeCategory && categories.includes(activeCategory) ? activeCategory : categories[0];\n\n  const views = category\n    ? (family && viewsByFamilyCategory.get(family)?.get(category)) || []\n    : (family && viewsByFamily.get(family)) || [];\n\n  return {\n    families,\n    activeTab: family,\n    setActiveTab,\n    categories,\n    activeCategory: category,\n    setActiveCategory,\n    views,\n  };\n}\n\ninterface TabProps {\n  readonly label: string;\n  readonly active: boolean;\n  readonly disabled: boolean;\n  readonly onPress: () => void;\n  readonly testID: string;\n}\n\nfunction Tab({ label, active, disabled, onPress, testID }: TabProps) {\n  return (\n    <Pressable\n      accessibilityRole=\"tab\"\n      accessibilityState={{ selected: active, disabled }}\n      testID={testID}\n      disabled={disabled}\n      onPress={onPress}\n      style={[styles.tab, active && styles.tabActive, disabled && styles.tabDisabled]}\n    >\n      <Text style={[styles.tabLabel, active && styles.tabLabelActive]}>{label}</Text>\n    </Pressable>\n  );\n}\n\ninterface CategoryItemProps {\n  readonly label: string;\n  readonly active: boolean;\n  readonly disabled: boolean;\n  readonly onPress: () => void;\n  readonly testID: string;\n}\n\nfunction CategoryItem({ label, active, disabled, onPress, testID }: CategoryItemProps) {\n  return (\n    <Pressable\n      accessibilityRole=\"menuitem\"\n      accessibilityState={{ selected: active, disabled }}\n      testID={testID}\n      disabled={disabled}\n      onPress={onPress}\n      style={[\n        styles.category,\n        active && styles.categoryActive,\n        disabled && styles.categoryDisabled,\n      ]}\n    >\n      <Text style={[styles.categoryLabel, active && styles.categoryLabelActive]}>{label}</Text>\n    </Pressable>\n  );\n}\n\nfunction titleCase(s: string): string {\n  return s\n    .split('-')\n    .map((w) => (w ? w.charAt(0).toUpperCase() + w.slice(1) : w))\n    .join(' ');\n}\n\nconst styles = StyleSheet.create({\n  tab: { paddingVertical: 6, paddingHorizontal: 12, borderRadius: 999, backgroundColor: '#1f1f1f' },\n  tabActive: { backgroundColor: '#333' },\n  tabDisabled: { opacity: 0.5 },\n  tabLabel: { color: '#999', fontSize: 12, fontWeight: '600' },\n  tabLabelActive: { color: '#fff' },\n  category: {\n    paddingVertical: 6,\n    paddingHorizontal: 10,\n    borderRadius: 8,\n    backgroundColor: '#1a1a1a',\n  },\n  categoryActive: { backgroundColor: '#2c2c2c' },\n  categoryDisabled: { opacity: 0.5 },\n  categoryLabel: { color: '#9a9a9a', fontSize: 12, fontWeight: '500' },\n  categoryLabelActive: { color: '#fff' },\n});\n\nexport { PresetTile } from '../preset-tile';\n// The `./picker` subpath barrel: the chassis above plus the composable parts and\n// types a consumer can use to build a BYO layout.\nexport { PresetBookMenuLayout } from './layout';\nexport type {\n  Category,\n  Family,\n  PresetBookMenuProps,\n  PresetBookMenuSelection,\n  PresetBookMenuStyleProps,\n  PresetItemState,\n  PresetView,\n  RenderTile,\n} from './preset-book-menu.types';\nexport { PresetGrid } from './preset-grid';\n"]}