Files
ausboss-ComfyUI-AusBoss/js/shared/node_settings.mjs
T
ausboss ae931c9b36 Add shared per-node settings and help-card infrastructure
A schema-driven gear menu (toggles, numbers, text, segmented choices)
persisted per node type in localStorage, a reusable info-card popup, a
widget show/hide helper that keeps widgets_values stable, and a hand-drawn
gear icon - the plumbing the LoRA Loader and LM Studio gears build on.
2026-08-16 19:42:08 -05:00

54 lines
2.1 KiB
JavaScript

// Schema-driven per-node settings: pure validation and merge logic for the
// gear menus (settings_menu.mjs does the DOM and storage). A schema is an
// array of entries; entries with a `key` describe one setting, entries with
// only `section` render as headers and hold no value.
//
// { section: "Civitai" }
// { key, label, type: "toggle", default: false, hint }
// { key, label, type: "number", default: 1, min, max, step, hint }
// { key, label, type: "text", default: ",", hint, placeholder }
// { key, label, type: "choice", default: "standard", options: [...], hint }
export function schemaDefaults(schema) {
const values = {};
for (const entry of schema) {
if (entry.key !== undefined) values[entry.key] = entry.default;
}
return values;
}
// Coerce one stored value against its schema entry; the entry's default wins
// whenever the stored value is missing or the wrong shape.
export function coerceSetting(entry, value) {
switch (entry.type) {
case "toggle":
return typeof value === "boolean" ? value : entry.default;
case "number": {
const number = typeof value === "string" && value.trim() !== "" ? Number(value) : value;
if (typeof number !== "number" || !Number.isFinite(number)) return entry.default;
let clamped = number;
if (typeof entry.min === "number") clamped = Math.max(entry.min, clamped);
if (typeof entry.max === "number") clamped = Math.min(entry.max, clamped);
return clamped;
}
case "text":
return typeof value === "string" ? value : entry.default;
case "choice":
return entry.options?.includes(value) ? value : entry.default;
default:
return entry.default;
}
}
// Merge stored values over the schema defaults. Unknown stored keys are
// dropped; every schema key comes back with a valid value.
export function mergeSettings(schema, stored) {
const values = {};
const source = stored && typeof stored === "object" ? stored : {};
for (const entry of schema) {
if (entry.key === undefined) continue;
values[entry.key] = coerceSetting(entry, source[entry.key]);
}
return values;
}