@happyvertical/smrt-svelte 0.55.8 → 0.55.10

package/dist/components/overview/operations.js

@@ -0,0 +1,358 @@
+/**
+ * Structured overview operations (#3727 phase 4): the batch an assistant (or
+ * any other non-UI caller) applies to an overview, and the description it
+ * reads first.
+ *
+ * An operation is data, never code: `add`, `configure`, `move`, `resize` and
+ * `remove`, with the same option vocabulary the grid's own editor uses. A batch
+ * is planned against the page's definition and the current override with the
+ * phase-1 model and then checked with {@link checkOverviewOverride}, so it can
+ * only produce an override the save endpoint would accept. A batch is atomic:
+ * one invalid operation rejects the whole batch and nothing is returned to
+ * apply. Nothing here loads data or runs a query.
+ *
+ * Svelte-free; on both `./overview` and `./overview/server`.
+ */
+import { checkOverviewOverride, diffOverview, nextWidgetId, resolveOverview, } from './model.js';
+import { defaultWidgetOptions, validateWidgetOptions } from './schema.js';
+import { OVERVIEW_DEFAULT_MAX_WIDGETS, OVERVIEW_ID_PATTERN, } from './types.js';
+/** Most operations one batch may carry. */
+export const OVERVIEW_MAX_OPERATIONS = 20;
+export const OVERVIEW_OPERATION_KINDS = [
+    'add',
+    'configure',
+    'move',
+    'resize',
+    'remove',
+];
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+const OPERATION_KEYS = {
+    add: ['op', 'type', 'span', 'options', 'index'],
+    configure: ['op', 'id', 'options'],
+    move: ['op', 'id', 'index'],
+    resize: ['op', 'id', 'span'],
+    remove: ['op', 'id'],
+};
+function cloneWidget(widget) {
+    return { ...widget, options: { ...widget.options } };
+}
+function describeOptionIssues(issues) {
+    return issues
+        .map((issue) => `${issue.key || '(options)'}: ${issue.code}`)
+        .join(', ');
+}
+function typeAllowed(definition, def) {
+    return ((!definition.allowed || definition.allowed.includes(def.type)) &&
+        (!def.allowedIn || def.allowedIn.includes(definition.id)));
+}
+/** Widget types an overview allows, in registration order. */
+export function allowedWidgetTypes(definition, registry) {
+    return registry.list().filter((def) => typeAllowed(definition, def));
+}
+/**
+ * Plan a batch of operations against an overview. Total: never throws, never
+ * mutates its input. On success, persist (or `controller.restore`) the
+ * returned `override`; on failure nothing may be applied.
+ */
+export function planOverviewOperations(input) {
+    const { definition, registry } = input;
+    const max = input.maxOperations ?? OVERVIEW_MAX_OPERATIONS;
+    const batchIssue = (code, message) => ({
+        ok: false,
+        issues: [{ index: null, op: null, widgetId: null, code, message }],
+    });
+    if (!Array.isArray(input.operations) || input.operations.length === 0) {
+        return batchIssue('malformed', 'operations must be a non-empty array');
+    }
+    if (input.operations.length > max) {
+        return batchIssue('too_many_operations', `a batch holds at most ${max} operations`);
+    }
+    const resolved = resolveOverview(definition, input.override, registry);
+    const current = diffOverview(resolved.base, resolved.document);
+    const widgets = resolved.document.widgets.map(cloneWidget);
+    const cap = definition.maxWidgets ?? OVERVIEW_DEFAULT_MAX_WIDGETS;
+    const reserved = new Set([
+        ...resolved.base.widgets.map((widget) => widget.id),
+        ...widgets.map((widget) => widget.id),
+        ...(current?.removed ?? []),
+    ]);
+    const context = { models: definition.models };
+    const issues = [];
+    const results = [];
+    input.operations.forEach((raw, index) => {
+        const op = isRecord(raw) && typeof raw.op === 'string' ? raw.op : null;
+        const widgetId = isRecord(raw) && typeof raw.id === 'string' ? raw.id : null;
+        const fail = (code, message, extra = {}) => {
+            issues.push({ index, op, widgetId, code, message, ...extra });
+        };
+        if (!isRecord(raw) || op === null) {
+            fail('malformed', 'operation must be an object with an "op"');
+            return;
+        }
+        if (!OVERVIEW_OPERATION_KINDS.includes(op)) {
+            fail('malformed', `unknown op "${op}"; use one of ${OVERVIEW_OPERATION_KINDS.join(', ')}`);
+            return;
+        }
+        const kind = op;
+        const extra = Object.keys(raw).filter((key) => !OPERATION_KEYS[kind].includes(key));
+        if (extra.length) {
+            fail('malformed', `unknown field(s) for ${kind}: ${extra.join(', ')}`);
+            return;
+        }
+        const spanFor = (def, value) => {
+            if (typeof value !== 'number' ||
+                !Number.isInteger(value) ||
+                value < def.minSpan ||
+                value > def.maxSpan) {
+                fail('invalid_span', `span for "${def.type}" must be an integer from ${def.minSpan} to ${def.maxSpan}`);
+                return null;
+            }
+            return value;
+        };
+        const indexFor = (value, length) => {
+            if (typeof value !== 'number' || !Number.isInteger(value) || value < 0) {
+                fail('invalid_index', 'index must be a non-negative integer');
+                return null;
+            }
+            return Math.min(value, length);
+        };
+        const find = () => {
+            const position = widgetId === null || !OVERVIEW_ID_PATTERN.test(widgetId)
+                ? -1
+                : widgets.findIndex((widget) => widget.id === widgetId);
+            if (position < 0) {
+                fail('unknown_widget', `no widget "${widgetId ?? ''}" on this overview; ids are ${widgets.map((widget) => widget.id).join(', ') || '(none)'}`);
+                return null;
+            }
+            const widget = widgets[position];
+            return { position, widget, def: registry.get(widget.type) };
+        };
+        if (kind === 'add') {
+            const type = typeof raw.type === 'string' ? raw.type : '';
+            const def = registry.get(type);
+            if (!def) {
+                fail('unknown_type', `widget type "${type}" is not registered`);
+                return;
+            }
+            if (!typeAllowed(definition, def)) {
+                fail('type_not_allowed', `widget type "${type}" is not allowed on this overview; allowed: ${allowedWidgetTypes(definition, registry)
+                    .map((entry) => entry.type)
+                    .join(', ') || '(none)'}`);
+                return;
+            }
+            if (widgets.length >= cap) {
+                fail('limit', `an overview holds at most ${cap} widgets`);
+                return;
+            }
+            if (raw.options !== undefined && !isRecord(raw.options)) {
+                fail('invalid_options', 'options must be an object');
+                return;
+            }
+            const checked = validateWidgetOptions(def.options, { ...defaultWidgetOptions(def.options), ...(raw.options ?? {}) }, context);
+            if (!checked.ok) {
+                fail('invalid_options', `options do not match "${type}": ${describeOptionIssues(checked.issues)}`, { options: checked.issues });
+                return;
+            }
+            const span = raw.span === undefined ? def.defaultSpan : spanFor(def, raw.span);
+            if (span === null)
+                return;
+            const at = raw.index === undefined
+                ? widgets.length
+                : indexFor(raw.index, widgets.length);
+            if (at === null)
+                return;
+            const id = nextWidgetId(reserved);
+            reserved.add(id);
+            widgets.splice(at, 0, {
+                id,
+                type,
+                span,
+                options: checked.options,
+                version: def.version,
+            });
+            results.push({ index, op: kind, id });
+            return;
+        }
+        const found = find();
+        if (!found)
+            return;
+        const { position, widget, def } = found;
+        if (kind === 'remove') {
+            widgets.splice(position, 1);
+            results.push({ index, op: kind, id: widget.id });
+            return;
+        }
+        if (kind === 'move') {
+            const rest = widgets.filter((entry) => entry.id !== widget.id);
+            const at = indexFor(raw.index, rest.length);
+            if (at === null)
+                return;
+            rest.splice(at, 0, widget);
+            widgets.splice(0, widgets.length, ...rest);
+            results.push({ index, op: kind, id: widget.id });
+            return;
+        }
+        if (!def) {
+            fail('unknown_type', `widget type "${widget.type}" is not registered`);
+            return;
+        }
+        if (kind === 'resize') {
+            const span = spanFor(def, raw.span);
+            if (span === null)
+                return;
+            widgets[position] = { ...widget, span };
+            results.push({ index, op: kind, id: widget.id });
+            return;
+        }
+        // configure
+        if (!isRecord(raw.options)) {
+            fail('invalid_options', 'options must be an object');
+            return;
+        }
+        const checked = validateWidgetOptions(def.options, { ...widget.options, ...raw.options }, context);
+        if (!checked.ok) {
+            fail('invalid_options', `options do not match "${widget.type}": ${describeOptionIssues(checked.issues)}`, { options: checked.issues });
+            return;
+        }
+        widgets[position] = {
+            ...widget,
+            options: checked.options,
+            version: def.version,
+        };
+        results.push({ index, op: kind, id: widget.id });
+    });
+    if (issues.length > 0)
+        return { ok: false, issues };
+    // The same strict check the save endpoint runs: whatever the operations
+    // produced must be an override the server would accept.
+    const proposed = diffOverview(resolved.base, { widgets });
+    const checked = checkOverviewOverride(definition, proposed, registry);
+    if (!checked.ok) {
+        return { ok: false, issues: checked.issues.map(fromOverviewIssue) };
+    }
+    const document = resolveOverview(definition, checked.override, registry).document;
+    return {
+        ok: true,
+        override: checked.override,
+        document,
+        results,
+        unchanged: JSON.stringify(checked.override) === JSON.stringify(current ?? null),
+    };
+}
+function fromOverviewIssue(issue) {
+    const code = issue.code === 'unknown_type' ||
+        issue.code === 'type_not_allowed' ||
+        issue.code === 'invalid_options' ||
+        issue.code === 'invalid_span'
+        ? issue.code
+        : issue.code === 'too_many'
+            ? 'limit'
+            : 'rejected';
+    return {
+        index: null,
+        op: null,
+        widgetId: issue.widgetId,
+        code,
+        message: issue.message,
+        ...(issue.options ? { options: issue.options } : {}),
+    };
+}
+/** Describe an overview for a caller that builds operations (an assistant). */
+export function describeOverview(input) {
+    const { definition, registry } = input;
+    const t = input.translate ?? ((key) => key);
+    const resolved = resolveOverview(definition, input.override, registry);
+    const describeField = (field) => {
+        const out = {
+            key: field.key,
+            type: field.type,
+            label: t(field.label),
+        };
+        if (field.help)
+            out.help = t(field.help);
+        if (field.required)
+            out.required = true;
+        if (field.default !== undefined)
+            out.default = field.default;
+        if (field.min !== undefined)
+            out.min = field.min;
+        if (field.max !== undefined)
+            out.max = field.max;
+        if (field.maxLength !== undefined)
+            out.maxLength = field.maxLength;
+        if (field.choices)
+            out.choices = field.choices.map((c) => c.value);
+        if (field.type === 'model' && definition.models) {
+            out.models = [...definition.models];
+        }
+        return out;
+    };
+    const titleOf = (widget) => {
+        const title = widget.options.title;
+        if (typeof title === 'string' && title)
+            return title;
+        const def = registry.get(widget.type);
+        return def ? t(def.title) : widget.type;
+    };
+    return {
+        id: definition.id,
+        canCustomize: input.canCustomize,
+        customized: diffOverview(resolved.base, resolved.document) !== null,
+        maxWidgets: definition.maxWidgets ?? OVERVIEW_DEFAULT_MAX_WIDGETS,
+        maxOperations: input.maxOperations ?? OVERVIEW_MAX_OPERATIONS,
+        widgetTypes: allowedWidgetTypes(definition, registry).map((def) => ({
+            type: def.type,
+            title: t(def.title),
+            ...(def.description ? { description: t(def.description) } : {}),
+            version: def.version,
+            span: { default: def.defaultSpan, min: def.minSpan, max: def.maxSpan },
+            options: def.options.map(describeField),
+        })),
+        widgets: resolved.document.widgets.map((widget, index) => ({
+            ...cloneWidget(widget),
+            index,
+            title: titleOf(widget),
+        })),
+    };
+}
+/**
+ * JSON schema of one operation, for a tool's `inputSchema` / `parameters`.
+ * Option values are JSON primitives; the per-type fields come from
+ * {@link describeOverview}.
+ */
+export const OVERVIEW_OPERATION_SCHEMA = {
+    type: 'object',
+    required: ['op'],
+    additionalProperties: false,
+    properties: {
+        op: { type: 'string', enum: [...OVERVIEW_OPERATION_KINDS] },
+        type: {
+            type: 'string',
+            description: 'add: a widget type the description lists.',
+        },
+        id: {
+            type: 'string',
+            description: 'configure/move/resize/remove: an existing widget id.',
+        },
+        span: {
+            type: 'integer',
+            minimum: 1,
+            maximum: 4,
+            description: "add/resize: columns, within the type's span range.",
+        },
+        index: {
+            type: 'integer',
+            minimum: 0,
+            description: 'add/move: zero-based position.',
+        },
+        options: {
+            type: 'object',
+            description: 'add: the options; configure: keys to change (null resets a key). Only the fields the description lists; values are strings, numbers or booleans.',
+            additionalProperties: {
+                type: ['string', 'number', 'boolean', 'null'],
+            },
+        },
+    },
+};

package/dist/components/overview/server.d.ts

@@ -5,8 +5,10 @@
  * schemas, widget registry, and the server load contract. Safe to import from
  * a `+page.server.ts` or a save endpoint.
  */
+export { createOverviewAssistantSurface, type OverviewAssistantPersistResult, type OverviewAssistantSurface, type OverviewAssistantSurfaceOptions, } from './assistant-surface.js';
 export { type LoadOverviewOptions, loadOverview, type WidgetLoadInput, } from './load.js';
 export { applyOverviewOverride, checkOverviewOverride, defineOverview, diffOverview, isEmptyOverride, nextWidgetId, type OverviewOverrideCheck, parseOverviewDocument, parseOverviewOverride, type ResolvedOverview, resolveOverview, type SanitizeOptions, sanitizeOverview, } from './model.js';
+export { allowedWidgetTypes, type DescribeOverviewInput, describeOverview, OVERVIEW_MAX_OPERATIONS, OVERVIEW_OPERATION_KINDS, OVERVIEW_OPERATION_SCHEMA, type OverviewAddOperation, type OverviewConfigureOperation, type OverviewDescription, type OverviewMoveOperation, type OverviewOperation, type OverviewOperationIssue, type OverviewOperationIssueCode, type OverviewOperationKind, type OverviewOperationResult, type OverviewOptionDescription, type OverviewPlan, type OverviewRemoveOperation, type OverviewResizeOperation, type OverviewWidgetTypeDescription, type PlanOverviewOperationsInput, planOverviewOperations, } from './operations.js';
 export { parseRecipeExportRef, type RecipeExportResolver, type RecipeWidgetRegistration, type RecipeWidgetSkip, type RecipeWidgetSkipReason, type RecipeWidgetSource, type RegisterRecipeWidgetsOptions, registerRecipeWidgets, } from './recipe-widgets.js';
 export { createWidgetRegistry, defaultWidgetRegistry, registerWidget, resolveWidgetComponents, type WidgetComponents, WidgetRegistry, } from './registry.js';
 export { assertWidgetOptionFields, defaultWidgetOptions, IDENTIFIER_PATTERN, MODEL_PATTERN, optionsEqual, validateWidgetOptions, } from './schema.js';

package/dist/components/overview/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/components/overview/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,eAAe,EACf,KAAK,eAAe,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,4BAA4B,EACjC,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/components/overview/server.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,8BAA8B,EAC9B,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,GACrC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,mBAAmB,EACxB,YAAY,EACZ,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,KAAK,qBAAqB,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,eAAe,EACf,KAAK,eAAe,EACpB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,4BAA4B,EACjC,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,cAAc,YAAY,CAAC"}

package/dist/components/overview/server.js

@@ -5,8 +5,10 @@
  * schemas, widget registry, and the server load contract. Safe to import from
  * a `+page.server.ts` or a save endpoint.
  */
+export { createOverviewAssistantSurface, } from './assistant-surface.js';
 export { loadOverview, } from './load.js';
 export { applyOverviewOverride, checkOverviewOverride, defineOverview, diffOverview, isEmptyOverride, nextWidgetId, parseOverviewDocument, parseOverviewOverride, resolveOverview, sanitizeOverview, } from './model.js';
+export { allowedWidgetTypes, describeOverview, OVERVIEW_MAX_OPERATIONS, OVERVIEW_OPERATION_KINDS, OVERVIEW_OPERATION_SCHEMA, planOverviewOperations, } from './operations.js';
 export { parseRecipeExportRef, registerRecipeWidgets, } from './recipe-widgets.js';
 export { createWidgetRegistry, defaultWidgetRegistry, registerWidget, resolveWidgetComponents, WidgetRegistry, } from './registry.js';
 export { assertWidgetOptionFields, defaultWidgetOptions, IDENTIFIER_PATTERN, MODEL_PATTERN, optionsEqual, validateWidgetOptions, } from './schema.js';

package/dist/components/workspace/admin-shell/settings-delta.d.ts

@@ -0,0 +1,21 @@
+import type { ShellSettingsDelta } from './types.js';
+/** One part of a stored delta that was dropped, and why. */
+export interface ShellSettingsIssue {
+    /** Dotted path of the dropped value, e.g. `keymap.left`. */
+    path: string;
+    message: string;
+}
+export interface ShellSettingsDeltaCheck {
+    /** The readable part, pruned (empty object when nothing is left). */
+    delta: ShellSettingsDelta;
+    /** What was dropped. Empty when the input was a valid delta. */
+    issues: ShellSettingsIssue[];
+}
+/**
+ * Validate and prune an untrusted shell settings delta. Never throws:
+ * unknown keys and malformed values are dropped and reported, the rest is
+ * kept. A caller that must refuse bad input (a save) checks `issues`; a
+ * reader that must degrade (a load) uses `delta`.
+ */
+export declare function sanitizeShellSettingsDelta(input: unknown): ShellSettingsDeltaCheck;
+//# sourceMappingURL=settings-delta.d.ts.map

package/dist/components/workspace/admin-shell/settings-delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-delta.d.ts","sourceRoot":"","sources":["../../../../src/components/workspace/admin-shell/settings-delta.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAIV,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAmBpB,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,KAAK,EAAE,kBAAkB,CAAC;IAC1B,gEAAgE;IAChE,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AA+CD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,uBAAuB,CAgFzB"}

package/dist/components/workspace/admin-shell/settings-delta.js

@@ -0,0 +1,142 @@
+/**
+ * Read an untrusted value as a {@link ShellSettingsDelta} (#3727).
+ *
+ * The browser settings adapter trusts what it wrote itself; a server that
+ * stores shell preferences for many users (`@happyvertical/smrt-preferences`)
+ * must not. This module is pure (no Svelte, no DOM) and is published on the
+ * Node-safe `./workspace/server` subpath as well as `./workspace`.
+ */
+import { isShellLayoutEmpty, normalizeShellLayout } from './layout.js';
+const EDGES = ['top', 'left', 'right', 'bottom'];
+const PANEL_STATES = ['hidden', 'collapsed', 'expanded'];
+const MODIFIERS = ['altKey', 'ctrlKey', 'metaKey', 'shiftKey'];
+const DELTA_KEYS = new Set([
+    'hotkeysEnabled',
+    'keymap',
+    'panels',
+    'sizes',
+    'activeFocusToolId',
+    'layout',
+]);
+/** `KeyboardEvent.code` values are short ASCII identifiers. */
+const KEY_CODE_PATTERN = /^[A-Za-z][A-Za-z0-9]{0,31}$/;
+/** Generous bound on a stored panel width in CSS pixels. */
+const MAX_PANEL_SIZE = 10_000;
+const MAX_FOCUS_TOOL_ID_LENGTH = 200;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readBinding(value) {
+    if (!isRecord(value) || typeof value.code !== 'string')
+        return undefined;
+    if (!KEY_CODE_PATTERN.test(value.code))
+        return undefined;
+    const binding = { code: value.code };
+    for (const key of Object.keys(value)) {
+        if (key === 'code')
+            continue;
+        if (!MODIFIERS.includes(key))
+            return undefined;
+        const flag = value[key];
+        if (typeof flag !== 'boolean')
+            return undefined;
+        if (flag)
+            binding[key] = true;
+    }
+    return binding;
+}
+function readEdgeMap(value, name, read, issues) {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value)) {
+        issues.push({ path: name, message: 'must be an object keyed by edge' });
+        return undefined;
+    }
+    const out = {};
+    for (const [edge, entry] of Object.entries(value)) {
+        if (!EDGES.includes(edge)) {
+            issues.push({ path: `${name}.${edge}`, message: 'unknown edge' });
+            continue;
+        }
+        const parsed = read(entry);
+        if (parsed === undefined) {
+            issues.push({ path: `${name}.${edge}`, message: 'invalid value' });
+            continue;
+        }
+        out[edge] = parsed;
+    }
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+/**
+ * Validate and prune an untrusted shell settings delta. Never throws:
+ * unknown keys and malformed values are dropped and reported, the rest is
+ * kept. A caller that must refuse bad input (a save) checks `issues`; a
+ * reader that must degrade (a load) uses `delta`.
+ */
+export function sanitizeShellSettingsDelta(input) {
+    const issues = [];
+    const delta = {};
+    if (input === null || input === undefined)
+        return { delta, issues };
+    if (!isRecord(input)) {
+        issues.push({ path: '', message: 'shell settings must be an object' });
+        return { delta, issues };
+    }
+    for (const key of Object.keys(input)) {
+        if (!DELTA_KEYS.has(key)) {
+            issues.push({ path: key, message: 'unknown setting' });
+        }
+    }
+    if (input.hotkeysEnabled !== undefined) {
+        if (typeof input.hotkeysEnabled === 'boolean') {
+            delta.hotkeysEnabled = input.hotkeysEnabled;
+        }
+        else {
+            issues.push({ path: 'hotkeysEnabled', message: 'must be a boolean' });
+        }
+    }
+    if (input.activeFocusToolId !== undefined) {
+        const id = input.activeFocusToolId;
+        if (id === null ||
+            (typeof id === 'string' &&
+                id !== '' &&
+                id.length <= MAX_FOCUS_TOOL_ID_LENGTH)) {
+            delta.activeFocusToolId = id;
+        }
+        else {
+            issues.push({
+                path: 'activeFocusToolId',
+                message: 'must be a short string or null',
+            });
+        }
+    }
+    const keymap = readEdgeMap(input.keymap, 'keymap', (entry) => (entry === null ? null : readBinding(entry)), issues);
+    if (keymap)
+        delta.keymap = keymap;
+    const panels = readEdgeMap(input.panels, 'panels', (entry) => PANEL_STATES.includes(entry)
+        ? entry
+        : undefined, issues);
+    if (panels)
+        delta.panels = panels;
+    // A `null` size means "back to the configured width": nothing to store.
+    const sizes = readEdgeMap(isRecord(input.sizes)
+        ? Object.fromEntries(Object.entries(input.sizes).filter(([, size]) => size !== null))
+        : input.sizes, 'sizes', (entry) => typeof entry === 'number' &&
+        Number.isFinite(entry) &&
+        entry > 0 &&
+        entry <= MAX_PANEL_SIZE
+        ? entry
+        : undefined, issues);
+    if (sizes)
+        delta.sizes = sizes;
+    if (input.layout !== undefined) {
+        const layout = normalizeShellLayout(input.layout);
+        if (!isShellLayoutEmpty(layout)) {
+            delta.layout = layout;
+        }
+        else if (input.layout !== null) {
+            issues.push({ path: 'layout', message: 'unreadable or empty layout' });
+        }
+    }
+    return { delta, issues };
+}

package/dist/components/workspace/index.d.ts

@@ -39,6 +39,7 @@ export { default as ShortcutsOverlay } from './admin-shell/ShortcutsOverlay.svel
 export { default as SystemScopePanel } from './admin-shell/SystemScopePanel.svelte';
 export { default as SystemStatusChips } from './admin-shell/SystemStatusChips.svelte';
 export { clampPanelSize, DEFAULT_SHELL_KEYMAP, DEFAULT_SHELL_PANEL_RESIZE, LocalStorageShellSettingsAdapter, mergeShellSettingsDelta, panelPersists, pruneShellSettingsDelta, resolveHotkey, resolveInitialPanelState, resolvePanelResize, resolveShellConfig, stripUnpersistedSettings, } from './admin-shell/settings.js';
+export { type ShellSettingsDeltaCheck, type ShellSettingsIssue, sanitizeShellSettingsDelta, } from './admin-shell/settings-delta.js';
 export { isShellIconName, SHELL_DEFAULT_SECTION_ICON, SHELL_ICON_PATHS, SHELL_SECTION_ICONS, type ShellIconName, } from './admin-shell/shell-icons.js';
 export type { ShellPlacementItem, ShellRegion, ShellSlot, } from './admin-shell/slots.js';
 export { isShellSlot, resolveSlot, SHELL_DOCK_ITEM_PREFIX, SHELL_HOST_SLOT_ITEM_PREFIX, SHELL_SLOTS, shellDockItemId, shellHostSlotItemId, slotFallbackChain, slotRegion, } from './admin-shell/slots.js';

package/dist/components/workspace/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/workspace/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/workspace/index.ts"],"names":[],"mappings":"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"}

package/dist/components/workspace/index.js

@@ -41,6 +41,7 @@ export { default as ShortcutsOverlay } from './admin-shell/ShortcutsOverlay.svel
 export { default as SystemScopePanel } from './admin-shell/SystemScopePanel.svelte';
 export { default as SystemStatusChips } from './admin-shell/SystemStatusChips.svelte';
 export { clampPanelSize, DEFAULT_SHELL_KEYMAP, DEFAULT_SHELL_PANEL_RESIZE, LocalStorageShellSettingsAdapter, mergeShellSettingsDelta, panelPersists, pruneShellSettingsDelta, resolveHotkey, resolveInitialPanelState, resolvePanelResize, resolveShellConfig, stripUnpersistedSettings, } from './admin-shell/settings.js';
+export { sanitizeShellSettingsDelta, } from './admin-shell/settings-delta.js';
 export { isShellIconName, SHELL_DEFAULT_SECTION_ICON, SHELL_ICON_PATHS, SHELL_SECTION_ICONS, } from './admin-shell/shell-icons.js';
 export { isShellSlot, resolveSlot, SHELL_DOCK_ITEM_PREFIX, SHELL_HOST_SLOT_ITEM_PREFIX, SHELL_SLOTS, shellDockItemId, shellHostSlotItemId, slotFallbackChain, slotRegion, } from './admin-shell/slots.js';
 export { ADMIN_SHELL_DESKTOP_QUERY, ADMIN_SHELL_PHONE_QUERY, createShellState, detectShellViewport, ShellState, } from './admin-shell/state.svelte.js';

package/dist/components/workspace/server/index.d.ts

@@ -1,13 +1,17 @@
 /**
  * @happyvertical/smrt-svelte/workspace/server
  *
- * Server-only utilities for the workspace shell — currently the dock
- * availability gate composer (Phase 4c per happyvertical/smrt#1226).
+ * Server-only utilities for the workspace shell: the dock availability gate
+ * composer (Phase 4c per happyvertical/smrt#1226) and the shell settings
+ * delta sanitizer and merge a server-side preference store uses (#3727).
  *
  * Node-safe: no Svelte component imports, no browser-only APIs. Import
  * this subpath from `+server.ts` endpoints, REST handlers, or anywhere
  * else outside the client bundle.
  */
+export { mergeShellSettingsDelta } from '../admin-shell/settings.js';
+export { type ShellSettingsDeltaCheck, type ShellSettingsIssue, sanitizeShellSettingsDelta, } from '../admin-shell/settings-delta.js';
+export type { ShellHotkeyBinding, ShellSettingsDelta, } from '../admin-shell/types.js';
 export { composeDockAvailability } from './compose-availability.js';
 export type { AvailableTool, ComposeDockAvailabilityOptions, GatedToolSummary, GateEvaluationContext, GateEvaluator, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/workspace/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/workspace/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,aAAa,EACb,8BAA8B,EAC9B,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/workspace/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,0BAA0B,GAC3B,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,aAAa,EACb,8BAA8B,EAC9B,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/components/workspace/server/index.js

@@ -1,11 +1,14 @@
 /**
  * @happyvertical/smrt-svelte/workspace/server
  *
- * Server-only utilities for the workspace shell — currently the dock
- * availability gate composer (Phase 4c per happyvertical/smrt#1226).
+ * Server-only utilities for the workspace shell: the dock availability gate
+ * composer (Phase 4c per happyvertical/smrt#1226) and the shell settings
+ * delta sanitizer and merge a server-side preference store uses (#3727).
  *
  * Node-safe: no Svelte component imports, no browser-only APIs. Import
  * this subpath from `+server.ts` endpoints, REST handlers, or anywhere
  * else outside the client bundle.
  */
+export { mergeShellSettingsDelta } from '../admin-shell/settings.js';
+export { sanitizeShellSettingsDelta, } from '../admin-shell/settings-delta.js';
 export { composeDockAvailability } from './compose-availability.js';

package/dist/i18n/server.d.ts

@@ -22,6 +22,7 @@ import './strings.forms.js';
 import './strings.board.js';
 import './strings.sortable.js';
 import './strings.audit.js';
+import './strings.notifications.js';
 import './strings.import-export.js';
 import './strings.workspace.js';
 import './strings.screens.js';

package/dist/i18n/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/i18n/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAGL,KAAK,4BAA4B,EAElC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AAMrC,OAAO,6BAA6B,CAAC;AACrC,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,4BAA4B,CAAC;AACpC,OAAO,wBAAwB,CAAC;AAChC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,yBAAyB,CAAC;AACjC,OAAO,wBAAwB,CAAC;AAEhC,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,4BAA4B,CAAC,UAAU,CAAC,CAAC;IACpD;;;OAGG;IACH,EAAE,CAAC,EAAE,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACxC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC,CA4BvB"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/i18n/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAGL,KAAK,4BAA4B,EAElC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AAMrC,OAAO,6BAA6B,CAAC;AACrC,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,4BAA4B,CAAC;AACpC,OAAO,4BAA4B,CAAC;AACpC,OAAO,wBAAwB,CAAC;AAChC,OAAO,sBAAsB,CAAC;AAC9B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,yBAAyB,CAAC;AACjC,OAAO,wBAAwB,CAAC;AAEhC,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,4BAA4B,CAAC,UAAU,CAAC,CAAC;IACpD;;;OAGG;IACH,EAAE,CAAC,EAAE,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACxC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,YAAY,CAAC,CA4BvB"}