@ecsplico/editor 3.1.1 → 3.2.0

package/dist/server/handlers/index.d.ts

@@ -1,4 +1,6 @@
+import { generateBodySchema } from "../../features/ai/protocol/generate.js";
+import { completeBodySchema } from "../../features/ai/protocol/complete.js";
 import { AiHandlerContext, HandlerContext, HandlerRequest, HandlerResponse, authenticated, empty, enforceRateLimit, eventStream, json, port, readBody, text } from "./context.js";
-import { chatBodySchema, chatPost, completeBodySchema, completePost, extractBodySchema, extractPost, generateBodySchema, generatePost, modelsGet, transcriptCleanupBodySchema, transcriptCleanupPost } from "./ai.js";
+import { chatBodySchema, chatPost, completePost, extractBodySchema, extractPost, generatePost, modelsGet, transcriptCleanupBodySchema, transcriptCleanupPost } from "./ai.js";
 import { assetGet, assetPost, capabilitiesGet, listWorkspaceTags, settingsGet, settingsPut, settingsPutBodySchema, tagsGet, themeDelete, themeGet, themePost, themesGet, usersGet } from "./editor.js";
 export { type AiHandlerContext, type HandlerContext, type HandlerRequest, type HandlerResponse, assetGet, assetPost, authenticated, capabilitiesGet, chatBodySchema, chatPost, completeBodySchema, completePost, empty, enforceRateLimit, eventStream, extractBodySchema, extractPost, generateBodySchema, generatePost, json, listWorkspaceTags, modelsGet, port, readBody, settingsGet, settingsPut, settingsPutBodySchema, tagsGet, text, themeDelete, themeGet, themePost, themesGet, transcriptCleanupBodySchema, transcriptCleanupPost, usersGet };

package/dist/server/handlers/index.js

@@ -1,4 +1,6 @@
+import { completeBodySchema } from "../../features/ai/protocol/complete.js";
+import { generateBodySchema } from "../../features/ai/protocol/generate.js";
 import { authenticated, empty, enforceRateLimit, eventStream, json, port, readBody, text } from "./context.js";
-import { chatBodySchema, chatPost, completeBodySchema, completePost, extractBodySchema, extractPost, generateBodySchema, generatePost, modelsGet, transcriptCleanupBodySchema, transcriptCleanupPost } from "./ai.js";
+import { chatBodySchema, chatPost, completePost, extractBodySchema, extractPost, generatePost, modelsGet, transcriptCleanupBodySchema, transcriptCleanupPost } from "./ai.js";
 import { assetGet, assetPost, capabilitiesGet, listWorkspaceTags, settingsGet, settingsPut, settingsPutBodySchema, tagsGet, themeDelete, themeGet, themePost, themesGet, usersGet } from "./editor.js";
 export { assetGet, assetPost, authenticated, capabilitiesGet, chatBodySchema, chatPost, completeBodySchema, completePost, empty, enforceRateLimit, eventStream, extractBodySchema, extractPost, generateBodySchema, generatePost, json, listWorkspaceTags, modelsGet, port, readBody, settingsGet, settingsPut, settingsPutBodySchema, tagsGet, text, themeDelete, themeGet, themePost, themesGet, transcriptCleanupBodySchema, transcriptCleanupPost, usersGet };

package/dist/server/index.d.ts

@@ -1,7 +1,8 @@
 import { PresetConfig, TranscriptionConfig } from "../config/index.js";
 import { AuthenticateRequest } from "./auth.js";
+import { ChatMessage } from "../features/ai/protocol/generate.js";
 import { HttpError } from "./errors.js";
-import { AiModels, AiModelsConfig, ChatMessage, ChatTurnPart, createAiModels, streamChat, streamChatTurn, upstreamError } from "./ai.js";
+import { AiModels, AiModelsConfig, ChatTurnPart, createAiModels, streamChat, streamChatTurn, upstreamError } from "./ai.js";
 import { AssetStore, CollabStateStore, Directory, DocumentAdmin, DocumentStore, EditorPorts, Identity, ModelProvider, PORT_CAPABILITY, SettingsStore, ThemeStore, serverCapabilities } from "./ports.js";
 import { COLLAB_FIELD, CollabConnection, CollabServer, CollabServerOptions, WebSocketLike, createCollabServer } from "./collab.js";
 import { decodeCollabState, encodeCollabState, isStateStale } from "./collab-state.js";

package/dist/settings/index.d.ts

@@ -36,12 +36,19 @@ export interface EditorSettings {
     kindIcon: KindIconVisibility;
     /** Standard drag handle of blocks without kind icon: on the hovered block, or permanently beside every block. */
     dragHandle: DragHandleVisibility;
+    /** Target size in characters of the parts a length split cuts a Baustein into (200–20000). */
+    splitTargetChars: number;
   };
   appearance: {
     /** Id of the Obsidian theme applied to the whole app (themes feature); `null` = the standard Nuxt UI look. */
     theme: string | null;
   };
 }
+/** Bounds of `blocks.splitTargetChars`. */
+export declare const SPLIT_TARGET_CHARS_MIN = 200;
+export declare const SPLIT_TARGET_CHARS_MAX = 20000;
+/** The split target typed into the field as a valid setting: rounded and clamped to its bounds; `current` when `typed` is empty or not a number. */
+export declare function clampSplitTargetChars(typed: string, current: number): number;
 export declare const EDITOR_SETTINGS_DEFAULTS: EditorSettings;
 /** Complete, valid settings (the body of `PUT /api/editor/settings`). */
 export declare const editorSettingsSchema: z.ZodObject<{
@@ -95,6 +102,7 @@ export declare const editorSettingsSchema: z.ZodObject<{
       always: "always";
       hover: "hover";
     }>;
+    splitTargetChars: z.ZodNumber;
   }, z.core.$strip>;
   appearance: z.ZodObject<{
     theme: z.ZodNullable<z.ZodString>;

package/dist/settings/index.js

@@ -4,6 +4,14 @@ import { z } from "zod";
 const EDITOR_SETTINGS_VERSION = 1;
 /** Valid theme id: lowercase slug, used as directory name and in `/api/editor/themes/:id`. Defined here so core never imports a feature. */
 const THEME_ID = /^[a-z0-9][a-z0-9-]{0,63}$/;
+/** Bounds of `blocks.splitTargetChars`. */
+const SPLIT_TARGET_CHARS_MIN = 200;
+const SPLIT_TARGET_CHARS_MAX = 2e4;
+/** The split target typed into the field as a valid setting: rounded and clamped to its bounds; `current` when `typed` is empty or not a number. */
+function clampSplitTargetChars(typed, current) {
+	const value = Math.round(Number(typed));
+	return typed.trim() !== "" && Number.isFinite(value) ? Math.min(SPLIT_TARGET_CHARS_MAX, Math.max(200, value)) : current;
+}
 const EDITOR_SETTINGS_DEFAULTS = {
 	version: 1,
 	editing: {
@@ -22,7 +30,8 @@ const EDITOR_SETTINGS_DEFAULTS = {
 		structure: "composite",
 		treeRoot: "folders",
 		kindIcon: "always",
-		dragHandle: "hover"
+		dragHandle: "hover",
+		splitTargetChars: 1500
 	},
 	appearance: { theme: null }
 };
@@ -38,6 +47,7 @@ const structureSchema = z.enum(STRUCTURE_MODES);
 const treeRootSchema = z.enum(TREE_ROOTS);
 const kindIconSchema = z.enum(KIND_ICON_VISIBILITIES);
 const dragHandleSchema = z.enum(DRAG_HANDLE_VISIBILITIES);
+const splitTargetCharsSchema = z.number().int().min(200).max(SPLIT_TARGET_CHARS_MAX);
 const themeSchema = z.string().regex(THEME_ID).nullable();
 /** Complete, valid settings (the body of `PUT /api/editor/settings`). */
 const editorSettingsSchema = z.object({
@@ -58,7 +68,8 @@ const editorSettingsSchema = z.object({
 		structure: structureSchema,
 		treeRoot: treeRootSchema,
 		kindIcon: kindIconSchema,
-		dragHandle: dragHandleSchema
+		dragHandle: dragHandleSchema,
+		splitTargetChars: splitTargetCharsSchema
 	}),
 	appearance: z.object({ theme: themeSchema })
 });
@@ -103,12 +114,13 @@ function parseEditorSettings(input) {
 			structure: valid(structureSchema, blocks.structure, defaults.blocks.structure),
 			treeRoot: valid(treeRootSchema, blocks.treeRoot, defaults.blocks.treeRoot),
 			kindIcon: valid(kindIconSchema, blocks.kindIcon, defaults.blocks.kindIcon),
-			dragHandle: valid(dragHandleSchema, blocks.dragHandle, defaults.blocks.dragHandle)
+			dragHandle: valid(dragHandleSchema, blocks.dragHandle, defaults.blocks.dragHandle),
+			splitTargetChars: valid(splitTargetCharsSchema, blocks.splitTargetChars, defaults.blocks.splitTargetChars)
 		},
 		appearance: { theme: valid(themeSchema, appearance.theme, defaults.appearance.theme) }
 	};
 }
 //#endregion
-export { AI_LANGUAGES, AUTHOR_COLOR_STYLES, COMMENTS_LAYOUTS, DRAG_HANDLE_VISIBILITIES, EDITOR_SETTINGS_DEFAULTS, EDITOR_SETTINGS_VERSION, HEADING_CONVERSION_SCOPES, KIND_ICON_VISIBILITIES, MODEL_SLOTS, STRUCTURE_MODES, THEME_ID, TREE_ROOTS, editorSettingsSchema, parseEditorSettings };
+export { AI_LANGUAGES, AUTHOR_COLOR_STYLES, COMMENTS_LAYOUTS, DRAG_HANDLE_VISIBILITIES, EDITOR_SETTINGS_DEFAULTS, EDITOR_SETTINGS_VERSION, HEADING_CONVERSION_SCOPES, KIND_ICON_VISIBILITIES, MODEL_SLOTS, SPLIT_TARGET_CHARS_MAX, SPLIT_TARGET_CHARS_MIN, STRUCTURE_MODES, THEME_ID, TREE_ROOTS, clampSplitTargetChars, editorSettingsSchema, parseEditorSettings };
 
 //# sourceMappingURL=index.js.map

package/dist/settings/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/settings/index.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  AI_LANGUAGES,\n  type AiLanguage,\n  AUTHOR_COLOR_STYLES,\n  type AuthorColorStyle,\n  COMMENTS_LAYOUTS,\n  type CommentsLayout,\n  DRAG_HANDLE_VISIBILITIES,\n  type DragHandleVisibility,\n  HEADING_CONVERSION_SCOPES,\n  type HeadingConversionScope,\n  KIND_ICON_VISIBILITIES,\n  type KindIconVisibility,\n  MODEL_SLOTS,\n  type ModelSlot,\n  STRUCTURE_MODES,\n  type StructureMode,\n  TREE_ROOTS,\n  type TreeRoot,\n} from './values'\n\nexport * from './values'\n\nexport const EDITOR_SETTINGS_VERSION = 1\n\n/** Valid theme id: lowercase slug, used as directory name and in `/api/editor/themes/:id`. Defined here so core never imports a feature. */\nexport const THEME_ID = /^[a-z0-9][a-z0-9-]{0,63}$/\n\n/** A user's editor preferences, shared by all editors on the page; persisted per user through the `settings` port. */\nexport interface EditorSettings {\n  version: typeof EDITOR_SETTINGS_VERSION\n  editing: {\n    /** Blocks „Gliederung umwandeln“ (both directions) converts when nothing is selected. */\n    headingConversionScope: HeadingConversionScope\n    /** Text is tinted per author (authors feature): each run in the colour of the user who wrote it. */\n    authorColors: boolean\n    /** `background`: tinted background; `text`: text in the author's colour. */\n    authorColorStyle: AuthorColorStyle\n    /** `margin`: comment cards in a column beside the text; `inline`: popover at the text plus the toolbar's list (comments feature). */\n    commentsLayout: CommentsLayout\n  }\n  ai: {\n    /** Ghost-text suggestions while typing (`GhostAutocomplete`). */\n    autocomplete: boolean\n    /** Model profile id per slot; a missing or unknown id falls back to the server's default preset for the slot. */\n    slots: Partial<Record<ModelSlot, string>>\n    /** Preselected target language of „Übersetzen“. */\n    translateLanguage: AiLanguage\n  }\n  blocks: {\n    /** Composite kind id the „Baustein“ shortcuts create (toolbar button, heading conversion). */\n    defaultKind: string\n    /** Preferred document structure: toolbar block types and the structure of AI-generated blocks. */\n    structure: StructureMode\n    /** Root of the document drawer while a composite file is loaded: nested in the folders, or the file itself. */\n    treeRoot: TreeRoot\n    /** Kind icon of composites (their drag handle): always visible, or only on hover, focus or while the details are open. */\n    kindIcon: KindIconVisibility\n    /** Standard drag handle of blocks without kind icon: on the hovered block, or permanently beside every block. */\n    dragHandle: DragHandleVisibility\n  }\n  appearance: {\n    /** Id of the Obsidian theme applied to the whole app (themes feature); `null` = the standard Nuxt UI look. */\n    theme: string | null\n  }\n}\n\nexport const EDITOR_SETTINGS_DEFAULTS: EditorSettings = {\n  version: EDITOR_SETTINGS_VERSION,\n  editing: { headingConversionScope: 'container', authorColors: false, authorColorStyle: 'background', commentsLayout: 'margin' },\n  ai: { autocomplete: false, slots: {}, translateLanguage: 'Englisch' },\n  blocks: { defaultKind: 'section', structure: 'composite', treeRoot: 'folders', kindIcon: 'always', dragHandle: 'hover' },\n  appearance: { theme: null },\n}\n\nconst headingConversionScopeSchema = z.enum(HEADING_CONVERSION_SCOPES)\nconst authorColorsSchema = z.boolean()\nconst authorColorStyleSchema = z.enum(AUTHOR_COLOR_STYLES)\nconst commentsLayoutSchema = z.enum(COMMENTS_LAYOUTS)\nconst autocompleteSchema = z.boolean()\nconst profileIdSchema = z.string().min(1).max(100)\nconst translateLanguageSchema = z.enum(AI_LANGUAGES)\nconst defaultKindSchema = z.string().min(1).max(100)\nconst structureSchema = z.enum(STRUCTURE_MODES)\nconst treeRootSchema = z.enum(TREE_ROOTS)\nconst kindIconSchema = z.enum(KIND_ICON_VISIBILITIES)\nconst dragHandleSchema = z.enum(DRAG_HANDLE_VISIBILITIES)\nconst themeSchema = z.string().regex(THEME_ID).nullable()\n\n/** Complete, valid settings (the body of `PUT /api/editor/settings`). */\nexport const editorSettingsSchema = z.object({\n  version: z.literal(EDITOR_SETTINGS_VERSION),\n  editing: z.object({\n    headingConversionScope: headingConversionScopeSchema,\n    authorColors: authorColorsSchema,\n    authorColorStyle: authorColorStyleSchema,\n    commentsLayout: commentsLayoutSchema,\n  }),\n  ai: z.object({\n    autocomplete: autocompleteSchema,\n    slots: z.partialRecord(z.enum(MODEL_SLOTS), profileIdSchema),\n    translateLanguage: translateLanguageSchema,\n  }),\n  blocks: z.object({\n    defaultKind: defaultKindSchema,\n    structure: structureSchema,\n    treeRoot: treeRootSchema,\n    kindIcon: kindIconSchema,\n    dragHandle: dragHandleSchema,\n  }),\n  appearance: z.object({ theme: themeSchema }),\n}) satisfies z.ZodType<EditorSettings>\n\nfunction record(value: unknown): Record<string, unknown> {\n  return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {}\n}\n\nfunction valid<T>(schema: z.ZodType<T>, value: unknown, fallback: T): T {\n  const parsed = schema.safeParse(value)\n  return parsed.success ? parsed.data : fallback\n}\n\n/**\n * Deep-merges unknown input over the defaults; unknown keys dropped, invalid values replaced. Accepts the legacy flat\n * `{ headingConversionScope }` shape of the per-browser settings before version 1. Always returns fresh objects.\n */\nexport function parseEditorSettings(input: unknown): EditorSettings {\n  const root = record(input)\n  const editing = record(root.editing)\n  const ai = record(root.ai)\n  const slots = record(ai.slots)\n  const blocks = record(root.blocks)\n  const appearance = record(root.appearance)\n  const defaults = EDITOR_SETTINGS_DEFAULTS\n  const legacyScope = valid(headingConversionScopeSchema, root.headingConversionScope, defaults.editing.headingConversionScope)\n  return {\n    version: EDITOR_SETTINGS_VERSION,\n    editing: {\n      headingConversionScope: valid(headingConversionScopeSchema, editing.headingConversionScope, legacyScope),\n      authorColors: valid(authorColorsSchema, editing.authorColors, defaults.editing.authorColors),\n      authorColorStyle: valid(authorColorStyleSchema, editing.authorColorStyle, defaults.editing.authorColorStyle),\n      commentsLayout: valid(commentsLayoutSchema, editing.commentsLayout, defaults.editing.commentsLayout),\n    },\n    ai: {\n      autocomplete: valid(autocompleteSchema, ai.autocomplete, defaults.ai.autocomplete),\n      slots: Object.fromEntries(MODEL_SLOTS.flatMap((slot) => {\n        const parsed = profileIdSchema.safeParse(slots[slot])\n        return parsed.success ? [[slot, parsed.data]] : []\n      })),\n      translateLanguage: valid(translateLanguageSchema, ai.translateLanguage, defaults.ai.translateLanguage),\n    },\n    blocks: {\n      defaultKind: valid(defaultKindSchema, blocks.defaultKind, defaults.blocks.defaultKind),\n      structure: valid(structureSchema, blocks.structure, defaults.blocks.structure),\n      treeRoot: valid(treeRootSchema, blocks.treeRoot, defaults.blocks.treeRoot),\n      kindIcon: valid(kindIconSchema, blocks.kindIcon, defaults.blocks.kindIcon),\n      dragHandle: valid(dragHandleSchema, blocks.dragHandle, defaults.blocks.dragHandle),\n    },\n    appearance: {\n      theme: valid(themeSchema, appearance.theme, defaults.appearance.theme),\n    },\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/settings/index.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  AI_LANGUAGES,\n  type AiLanguage,\n  AUTHOR_COLOR_STYLES,\n  type AuthorColorStyle,\n  COMMENTS_LAYOUTS,\n  type CommentsLayout,\n  DRAG_HANDLE_VISIBILITIES,\n  type DragHandleVisibility,\n  HEADING_CONVERSION_SCOPES,\n  type HeadingConversionScope,\n  KIND_ICON_VISIBILITIES,\n  type KindIconVisibility,\n  MODEL_SLOTS,\n  type ModelSlot,\n  STRUCTURE_MODES,\n  type StructureMode,\n  TREE_ROOTS,\n  type TreeRoot,\n} from './values'\n\nexport * from './values'\n\nexport const EDITOR_SETTINGS_VERSION = 1\n\n/** Valid theme id: lowercase slug, used as directory name and in `/api/editor/themes/:id`. Defined here so core never imports a feature. */\nexport const THEME_ID = /^[a-z0-9][a-z0-9-]{0,63}$/\n\n/** A user's editor preferences, shared by all editors on the page; persisted per user through the `settings` port. */\nexport interface EditorSettings {\n  version: typeof EDITOR_SETTINGS_VERSION\n  editing: {\n    /** Blocks „Gliederung umwandeln“ (both directions) converts when nothing is selected. */\n    headingConversionScope: HeadingConversionScope\n    /** Text is tinted per author (authors feature): each run in the colour of the user who wrote it. */\n    authorColors: boolean\n    /** `background`: tinted background; `text`: text in the author's colour. */\n    authorColorStyle: AuthorColorStyle\n    /** `margin`: comment cards in a column beside the text; `inline`: popover at the text plus the toolbar's list (comments feature). */\n    commentsLayout: CommentsLayout\n  }\n  ai: {\n    /** Ghost-text suggestions while typing (`GhostAutocomplete`). */\n    autocomplete: boolean\n    /** Model profile id per slot; a missing or unknown id falls back to the server's default preset for the slot. */\n    slots: Partial<Record<ModelSlot, string>>\n    /** Preselected target language of „Übersetzen“. */\n    translateLanguage: AiLanguage\n  }\n  blocks: {\n    /** Composite kind id the „Baustein“ shortcuts create (toolbar button, heading conversion). */\n    defaultKind: string\n    /** Preferred document structure: toolbar block types and the structure of AI-generated blocks. */\n    structure: StructureMode\n    /** Root of the document drawer while a composite file is loaded: nested in the folders, or the file itself. */\n    treeRoot: TreeRoot\n    /** Kind icon of composites (their drag handle): always visible, or only on hover, focus or while the details are open. */\n    kindIcon: KindIconVisibility\n    /** Standard drag handle of blocks without kind icon: on the hovered block, or permanently beside every block. */\n    dragHandle: DragHandleVisibility\n    /** Target size in characters of the parts a length split cuts a Baustein into (200–20000). */\n    splitTargetChars: number\n  }\n  appearance: {\n    /** Id of the Obsidian theme applied to the whole app (themes feature); `null` = the standard Nuxt UI look. */\n    theme: string | null\n  }\n}\n\n/** Bounds of `blocks.splitTargetChars`. */\nexport const SPLIT_TARGET_CHARS_MIN = 200\nexport const SPLIT_TARGET_CHARS_MAX = 20000\n\n/** The split target typed into the field as a valid setting: rounded and clamped to its bounds; `current` when `typed` is empty or not a number. */\nexport function clampSplitTargetChars(typed: string, current: number): number {\n  const value = Math.round(Number(typed))\n  return typed.trim() !== '' && Number.isFinite(value) ? Math.min(SPLIT_TARGET_CHARS_MAX, Math.max(SPLIT_TARGET_CHARS_MIN, value)) : current\n}\n\nexport const EDITOR_SETTINGS_DEFAULTS: EditorSettings = {\n  version: EDITOR_SETTINGS_VERSION,\n  editing: { headingConversionScope: 'container', authorColors: false, authorColorStyle: 'background', commentsLayout: 'margin' },\n  ai: { autocomplete: false, slots: {}, translateLanguage: 'Englisch' },\n  blocks: { defaultKind: 'section', structure: 'composite', treeRoot: 'folders', kindIcon: 'always', dragHandle: 'hover', splitTargetChars: 1500 },\n  appearance: { theme: null },\n}\n\nconst headingConversionScopeSchema = z.enum(HEADING_CONVERSION_SCOPES)\nconst authorColorsSchema = z.boolean()\nconst authorColorStyleSchema = z.enum(AUTHOR_COLOR_STYLES)\nconst commentsLayoutSchema = z.enum(COMMENTS_LAYOUTS)\nconst autocompleteSchema = z.boolean()\nconst profileIdSchema = z.string().min(1).max(100)\nconst translateLanguageSchema = z.enum(AI_LANGUAGES)\nconst defaultKindSchema = z.string().min(1).max(100)\nconst structureSchema = z.enum(STRUCTURE_MODES)\nconst treeRootSchema = z.enum(TREE_ROOTS)\nconst kindIconSchema = z.enum(KIND_ICON_VISIBILITIES)\nconst dragHandleSchema = z.enum(DRAG_HANDLE_VISIBILITIES)\nconst splitTargetCharsSchema = z.number().int().min(SPLIT_TARGET_CHARS_MIN).max(SPLIT_TARGET_CHARS_MAX)\nconst themeSchema = z.string().regex(THEME_ID).nullable()\n\n/** Complete, valid settings (the body of `PUT /api/editor/settings`). */\nexport const editorSettingsSchema = z.object({\n  version: z.literal(EDITOR_SETTINGS_VERSION),\n  editing: z.object({\n    headingConversionScope: headingConversionScopeSchema,\n    authorColors: authorColorsSchema,\n    authorColorStyle: authorColorStyleSchema,\n    commentsLayout: commentsLayoutSchema,\n  }),\n  ai: z.object({\n    autocomplete: autocompleteSchema,\n    slots: z.partialRecord(z.enum(MODEL_SLOTS), profileIdSchema),\n    translateLanguage: translateLanguageSchema,\n  }),\n  blocks: z.object({\n    defaultKind: defaultKindSchema,\n    structure: structureSchema,\n    treeRoot: treeRootSchema,\n    kindIcon: kindIconSchema,\n    dragHandle: dragHandleSchema,\n    splitTargetChars: splitTargetCharsSchema,\n  }),\n  appearance: z.object({ theme: themeSchema }),\n}) satisfies z.ZodType<EditorSettings>\n\nfunction record(value: unknown): Record<string, unknown> {\n  return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {}\n}\n\nfunction valid<T>(schema: z.ZodType<T>, value: unknown, fallback: T): T {\n  const parsed = schema.safeParse(value)\n  return parsed.success ? parsed.data : fallback\n}\n\n/**\n * Deep-merges unknown input over the defaults; unknown keys dropped, invalid values replaced. Accepts the legacy flat\n * `{ headingConversionScope }` shape of the per-browser settings before version 1. Always returns fresh objects.\n */\nexport function parseEditorSettings(input: unknown): EditorSettings {\n  const root = record(input)\n  const editing = record(root.editing)\n  const ai = record(root.ai)\n  const slots = record(ai.slots)\n  const blocks = record(root.blocks)\n  const appearance = record(root.appearance)\n  const defaults = EDITOR_SETTINGS_DEFAULTS\n  const legacyScope = valid(headingConversionScopeSchema, root.headingConversionScope, defaults.editing.headingConversionScope)\n  return {\n    version: EDITOR_SETTINGS_VERSION,\n    editing: {\n      headingConversionScope: valid(headingConversionScopeSchema, editing.headingConversionScope, legacyScope),\n      authorColors: valid(authorColorsSchema, editing.authorColors, defaults.editing.authorColors),\n      authorColorStyle: valid(authorColorStyleSchema, editing.authorColorStyle, defaults.editing.authorColorStyle),\n      commentsLayout: valid(commentsLayoutSchema, editing.commentsLayout, defaults.editing.commentsLayout),\n    },\n    ai: {\n      autocomplete: valid(autocompleteSchema, ai.autocomplete, defaults.ai.autocomplete),\n      slots: Object.fromEntries(MODEL_SLOTS.flatMap((slot) => {\n        const parsed = profileIdSchema.safeParse(slots[slot])\n        return parsed.success ? [[slot, parsed.data]] : []\n      })),\n      translateLanguage: valid(translateLanguageSchema, ai.translateLanguage, defaults.ai.translateLanguage),\n    },\n    blocks: {\n      defaultKind: valid(defaultKindSchema, blocks.defaultKind, defaults.blocks.defaultKind),\n      structure: valid(structureSchema, blocks.structure, defaults.blocks.structure),\n      treeRoot: valid(treeRootSchema, blocks.treeRoot, defaults.blocks.treeRoot),\n      kindIcon: valid(kindIconSchema, blocks.kindIcon, defaults.blocks.kindIcon),\n      dragHandle: valid(dragHandleSchema, blocks.dragHandle, defaults.blocks.dragHandle),\n      splitTargetChars: valid(splitTargetCharsSchema, blocks.splitTargetChars, defaults.blocks.splitTargetChars),\n    },\n    appearance: {\n      theme: valid(themeSchema, appearance.theme, defaults.appearance.theme),\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/styles/composites.css

@@ -1,4 +1,22 @@
 /* Styles of the composite feature (`@ecsplico/editor/composites`); import after `core.css`. */
+/* Colour baskets (`compositeFeature({ baskets })`): the default set's colours, light and dark like `tokens.css` (the host sets
+   `.dark`). Declared under `:where()` (specificity 0), a host's rule always wins; a custom basket brings its own `color`. */
+:where(:root) {
+  --sk-basket-red: #ef4444;
+  --sk-basket-orange: #f97316;
+  --sk-basket-yellow: #eab308;
+  --sk-basket-green: #22c55e;
+  --sk-basket-blue: #3b82f6;
+}
+
+:where(.dark) {
+  --sk-basket-red: #f87171;
+  --sk-basket-orange: #fb923c;
+  --sk-basket-yellow: #facc15;
+  --sk-basket-green: #4ade80;
+  --sk-basket-blue: #60a5fa;
+}
+
 /* Composite block: title, then description and tags row (data, hidden: the chips and the details popover of
    `CompositeChrome` show and edit them), then the body. */
 @layer components {
@@ -8,6 +26,16 @@
     padding-left: 1.25rem;
     border-left: 2px solid var(--sk-border);
   }
+  /* The node view sets `--sk-basket-color` of a composite in a colour basket (`compositeFeature({ baskets })`); the colours of the default set are the tokens above. */
+  /* Basket stripe: the border takes the basket's colour; the inset shadow thickens it at every nesting depth without moving content. */
+  .tiptap .composite[data-basket] {
+    border-left-color: var(--sk-basket-color, var(--sk-border));
+    box-shadow: inset 2px 0 0 var(--sk-basket-color, transparent);
+  }
+  /* Hidden title (`meta.titleHidden`, until a caret enters it): the title is gone and a strip keeps the chrome row (basket, show
+     title, status and tags; `CompositeChrome`) and the kind icon clear of the body. */
+  .tiptap .composite[data-title-hidden] { padding-top: 1.75rem; }
+  .tiptap .composite[data-title-hidden] > .composite__content > .composite-title { display: none; }
   .tiptap .composite .composite { margin: 1em 0; }
   .tiptap .composite .composite .composite { margin: 0.75em 0; padding-left: 1rem; border-left-width: 1px; }
   /* Derived Baustein (has a `meta.derivation`) that is not opened: a short faded preview. The content stays laid out and
@@ -45,6 +73,10 @@
   /* Description and tags rows are data only: the chips and the details popover of `CompositeChrome` show and edit them. */
   .tiptap .composite-description,
   .tiptap .composite-tags { display: none; }
+  /* Focus mode (`focusComposite`): the decorations of `CompositeFocus` hide every sibling of the focused Baustein
+     (`sk-focus-target`) and of each ancestor (`sk-focus-ancestor`). An ancestor keeps its title (its description and tags
+     rows are hidden above anyway; its title, description and tags are not siblings in the sense of the decorations). */
+  .tiptap .sk-focus-hidden { display: none !important; }
   /* Placeholder extension marks an empty title `is-empty`; the text is the kind's, set by CompositeView. */
   .tiptap .composite-title.is-empty::before {
     color: var(--sk-fg-dimmed);