avtc-claude-settings-ui 1.0.13 → 1.0.15

package/README.md

@@ -99,6 +99,8 @@ const tree = buildPaneTree(els, controller, { bodyColumns: e.props.bodyColumns }
 | `buildPaneTree(els, controller, options)` | Composes the render tree over the surface's element table |
 | `settingsFilePaths(name)` | Global/project file path helpers for the schema |
 | `registerSettingsCommand`, `loadSettingsHandle` | Wiring a `/name-settings`-style command and lazy handle load |
+| `captureCtx` | Stash the host's models list / enabled-models patterns at pane-open (feeds the `model` type's presets) |
+| `modelPairsFromSettings(settings, reservedValues)` | Labeled model rows for the host's own models from a Claude settings snapshot — `availableModels` entries plus `modelPicker`-only options, labels from the lineup; pass the engine values you already offer (aliases, spawn keywords) so they never duplicate |
 | `registerTypeDefinition` | Custom setting types |
 | Types | `SettingsSchema`, `SettingSchema`, `SettingsTabSchema`, `FsAdapter`, `EnvStore`, `PaneController`, `PaneTreeOptions`, … |
 

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { captureCtx } from "./ctx-store.js";
 export type { EnvStore } from "./factory.js";
 export { createSettingsExtension } from "./factory.js";
 export type { FsAdapter } from "./fs-adapter.js";
+export { modelPairsFromSettings } from "./model-presets.js";
 export type { PaneController, PaneControllerOptions, PaneHandle, PaneNotify, PaneStorageLevels, } from "./pane/controller.js";
 export { createPaneController } from "./pane/controller.js";
 export type { PaneElements, PaneTreeOptions } from "./pane/tree.js";

package/dist/index.js

@@ -8,6 +8,10 @@
 export { captureCtx } from "./ctx-store.js";
 // The settings store — create the handle over injected fs/env seams.
 export { createSettingsExtension } from "./factory.js";
+// Settings-derived model rows — labeled [label, value] pairs for the user's own
+// models (availableModels entries + modelPicker-only options) from a settings
+// snapshot; the host supplies the engine values it reserves for itself.
+export { modelPairsFromSettings } from "./model-presets.js";
 // The pane — the interaction model + tree composition a host's ui.render hook drives.
 export { createPaneController } from "./pane/controller.js";
 export { buildPaneTree } from "./pane/tree.js";

package/dist/model-presets.d.ts

@@ -16,6 +16,19 @@ export declare function splitModelId(value: string): {
     provider: string;
     id: string;
 } | null;
+/** Labeled `[label, value]` rows for the user's own models, read from a Claude
+ *  Code settings snapshot (the `$.settings.read` shape):
+ *
+ * - each `availableModels` entry becomes a row — the value verbatim (an id the
+ *   host's own model selection accepts), labeled from `modelPicker.options`
+ *   when the user named it there
+ * - `modelPicker.options` entries no `availableModels` entry names append after
+ *   them (their own label, or the id), so a picker lineup alone still yields rows
+ *
+ * `reservedValues` are engine values the caller already offers its own way
+ * (aliases, spawn keywords) — they never become rows here. Malformed shapes
+ * (non-arrays, non-strings, bad options) collapse to zero rows; never throws. */
+export declare function modelPairsFromSettings(settings: unknown, reservedValues: ReadonlySet<string>): PresetPair[];
 /**
  * Glob match over the minimatch subset patterns use: `*` (any run), `?`
  * (exactly one), everything else literal; case-insensitive. No brace

package/dist/model-presets.js

@@ -33,6 +33,69 @@ export function splitModelId(value) {
         return null;
     return { provider: value.slice(0, slash), id: value.slice(slash + 1) };
 }
+/** Labeled `[label, value]` rows for the user's own models, read from a Claude
+ *  Code settings snapshot (the `$.settings.read` shape):
+ *
+ * - each `availableModels` entry becomes a row — the value verbatim (an id the
+ *   host's own model selection accepts), labeled from `modelPicker.options`
+ *   when the user named it there
+ * - `modelPicker.options` entries no `availableModels` entry names append after
+ *   them (their own label, or the id), so a picker lineup alone still yields rows
+ *
+ * `reservedValues` are engine values the caller already offers its own way
+ * (aliases, spawn keywords) — they never become rows here. Malformed shapes
+ * (non-arrays, non-strings, bad options) collapse to zero rows; never throws. */
+export function modelPairsFromSettings(settings, reservedValues) {
+    if (settings === null || typeof settings !== "object")
+        return [];
+    const root = settings;
+    const pickerOptions = [];
+    const labels = new Map();
+    const picker = root.modelPicker;
+    if (picker !== null && typeof picker === "object") {
+        const options = picker.options;
+        if (Array.isArray(options)) {
+            for (const option of options) {
+                if (option === null || typeof option !== "object")
+                    continue;
+                const model = option.model;
+                const label = option.label;
+                if (typeof model !== "string" || model.trim().length === 0)
+                    continue;
+                const trimmedModel = model.trim();
+                const labelStr = typeof label === "string" && label.length > 0 ? label : undefined;
+                pickerOptions.push({ model: trimmedModel, label: labelStr });
+                if (labelStr)
+                    labels.set(trimmedModel, labelStr);
+            }
+        }
+    }
+    const pairs = [];
+    const seen = new Set();
+    const raw = root.availableModels;
+    if (Array.isArray(raw)) {
+        for (const entry of raw) {
+            if (typeof entry !== "string")
+                continue;
+            const value = entry.trim();
+            if (value.length === 0 || seen.has(value))
+                continue;
+            if (reservedValues.has(value.toLowerCase()))
+                continue;
+            seen.add(value);
+            pairs.push([labels.get(value) ?? value, value]);
+        }
+    }
+    for (const option of pickerOptions) {
+        if (seen.has(option.model))
+            continue;
+        if (reservedValues.has(option.model.toLowerCase()))
+            continue;
+        seen.add(option.model);
+        pairs.push([option.label ?? option.model, option.model]);
+    }
+    return pairs;
+}
 /**
  * Glob match over the minimatch subset patterns use: `*` (any run), `?`
  * (exactly one), everything else literal; case-insensitive. No brace

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "avtc-claude-settings-ui",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "A schema-driven settings UI for Claude mods — define your settings, get a tabbed pane, a /<name>-settings command, and layered persistence.",
   "type": "module",
   "license": "MIT",