@ecsplico/editor 3.6.0 → 4.1.0

package/dist/settings/index.js

@@ -1,7 +1,7 @@
-import { AI_LANGUAGES, AUTHOR_COLOR_STYLES, COMMENTS_LAYOUTS, DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, KIND_ICON_VISIBILITIES, MODEL_SLOTS, STRUCTURE_MODES, TREE_ROOTS } from "./values.js";
+import { AI_LANGUAGES, AUTHOR_COLOR_STYLES, BLOCK_TYPE_ICON_VISIBILITIES, COMMENTS_LAYOUTS, DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, MODEL_ROLES, STRUCTURE_MODES, TREE_ROOTS } from "./values.js";
+import { EDITOR_SETTINGS_VERSION, isOutdatedEditorSettings, migrateEditorSettings } from "./migrate.js";
 import { z } from "zod";
 //#region src/settings/index.ts
-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`. */
@@ -13,7 +13,7 @@ function clampSplitTargetChars(typed, current) {
 	return typed.trim() !== "" && Number.isFinite(value) ? Math.min(SPLIT_TARGET_CHARS_MAX, Math.max(200, value)) : current;
 }
 const EDITOR_SETTINGS_DEFAULTS = {
-	version: 1,
+	version: 2,
 	editing: {
 		headingConversionScope: "container",
 		authorColors: false,
@@ -22,14 +22,14 @@ const EDITOR_SETTINGS_DEFAULTS = {
 	},
 	ai: {
 		autocomplete: false,
-		slots: {},
+		roles: {},
 		translateLanguage: "Englisch"
 	},
 	blocks: {
-		defaultKind: "section",
-		structure: "composite",
+		defaultBlockType: "section",
+		structure: "structured",
 		treeRoot: "folders",
-		kindIcon: "always",
+		blockTypeIcon: "always",
 		dragHandle: "hover",
 		splitTargetChars: 1500
 	},
@@ -42,16 +42,16 @@ const commentsLayoutSchema = z.enum(COMMENTS_LAYOUTS);
 const autocompleteSchema = z.boolean();
 const profileIdSchema = z.string().min(1).max(100);
 const translateLanguageSchema = z.enum(AI_LANGUAGES);
-const defaultKindSchema = z.string().min(1).max(100);
+const defaultBlockTypeSchema = z.string().min(1).max(100);
 const structureSchema = z.enum(STRUCTURE_MODES);
 const treeRootSchema = z.enum(TREE_ROOTS);
-const kindIconSchema = z.enum(KIND_ICON_VISIBILITIES);
+const blockTypeIconSchema = z.enum(BLOCK_TYPE_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({
-	version: z.literal(1),
+	version: z.literal(2),
 	editing: z.object({
 		headingConversionScope: headingConversionScopeSchema,
 		authorColors: authorColorsSchema,
@@ -60,14 +60,14 @@ const editorSettingsSchema = z.object({
 	}),
 	ai: z.object({
 		autocomplete: autocompleteSchema,
-		slots: z.partialRecord(z.enum(MODEL_SLOTS), profileIdSchema),
+		roles: z.partialRecord(z.enum(MODEL_ROLES), profileIdSchema),
 		translateLanguage: translateLanguageSchema
 	}),
 	blocks: z.object({
-		defaultKind: defaultKindSchema,
+		defaultBlockType: defaultBlockTypeSchema,
 		structure: structureSchema,
 		treeRoot: treeRootSchema,
-		kindIcon: kindIconSchema,
+		blockTypeIcon: blockTypeIconSchema,
 		dragHandle: dragHandleSchema,
 		splitTargetChars: splitTargetCharsSchema
 	}),
@@ -81,20 +81,21 @@ function valid(schema, value, fallback) {
 	return parsed.success ? parsed.data : fallback;
 }
 /**
-* Deep-merges unknown input over the defaults; unknown keys dropped, invalid values replaced. Accepts the legacy flat
-* `{ headingConversionScope }` shape of the per-browser settings before version 1. Always returns fresh objects.
+* Deep-merges unknown input over the defaults; unknown keys dropped, invalid values replaced. Reads older stored settings
+* through `migrateEditorSettings` (`./migrate`), including the legacy flat `{ headingConversionScope }` per-browser shape.
+* Always returns fresh objects of the current version.
 */
 function parseEditorSettings(input) {
-	const root = record(input);
+	const root = record(migrateEditorSettings(input));
 	const editing = record(root.editing);
 	const ai = record(root.ai);
-	const slots = record(ai.slots);
+	const roles = record(ai.roles);
 	const blocks = record(root.blocks);
 	const appearance = record(root.appearance);
 	const defaults = EDITOR_SETTINGS_DEFAULTS;
 	const legacyScope = valid(headingConversionScopeSchema, root.headingConversionScope, defaults.editing.headingConversionScope);
 	return {
-		version: 1,
+		version: 2,
 		editing: {
 			headingConversionScope: valid(headingConversionScopeSchema, editing.headingConversionScope, legacyScope),
 			authorColors: valid(authorColorsSchema, editing.authorColors, defaults.editing.authorColors),
@@ -103,17 +104,17 @@ function parseEditorSettings(input) {
 		},
 		ai: {
 			autocomplete: valid(autocompleteSchema, ai.autocomplete, defaults.ai.autocomplete),
-			slots: Object.fromEntries(MODEL_SLOTS.flatMap((slot) => {
-				const parsed = profileIdSchema.safeParse(slots[slot]);
-				return parsed.success ? [[slot, parsed.data]] : [];
+			roles: Object.fromEntries(MODEL_ROLES.flatMap((role) => {
+				const parsed = profileIdSchema.safeParse(roles[role]);
+				return parsed.success ? [[role, parsed.data]] : [];
 			})),
 			translateLanguage: valid(translateLanguageSchema, ai.translateLanguage, defaults.ai.translateLanguage)
 		},
 		blocks: {
-			defaultKind: valid(defaultKindSchema, blocks.defaultKind, defaults.blocks.defaultKind),
+			defaultBlockType: valid(defaultBlockTypeSchema, blocks.defaultBlockType, defaults.blocks.defaultBlockType),
 			structure: valid(structureSchema, blocks.structure, defaults.blocks.structure),
 			treeRoot: valid(treeRootSchema, blocks.treeRoot, defaults.blocks.treeRoot),
-			kindIcon: valid(kindIconSchema, blocks.kindIcon, defaults.blocks.kindIcon),
+			blockTypeIcon: valid(blockTypeIconSchema, blocks.blockTypeIcon, defaults.blocks.blockTypeIcon),
 			dragHandle: valid(dragHandleSchema, blocks.dragHandle, defaults.blocks.dragHandle),
 			splitTargetChars: valid(splitTargetCharsSchema, blocks.splitTargetChars, defaults.blocks.splitTargetChars)
 		},
@@ -121,6 +122,6 @@ function parseEditorSettings(input) {
 	};
 }
 //#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, SPLIT_TARGET_CHARS_MAX, SPLIT_TARGET_CHARS_MIN, STRUCTURE_MODES, THEME_ID, TREE_ROOTS, clampSplitTargetChars, editorSettingsSchema, parseEditorSettings };
+export { AI_LANGUAGES, AUTHOR_COLOR_STYLES, BLOCK_TYPE_ICON_VISIBILITIES, COMMENTS_LAYOUTS, DRAG_HANDLE_VISIBILITIES, EDITOR_SETTINGS_DEFAULTS, EDITOR_SETTINGS_VERSION, HEADING_CONVERSION_SCOPES, MODEL_ROLES, SPLIT_TARGET_CHARS_MAX, SPLIT_TARGET_CHARS_MIN, STRUCTURE_MODES, THEME_ID, TREE_ROOTS, clampSplitTargetChars, editorSettingsSchema, isOutdatedEditorSettings, migrateEditorSettings, 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    /** 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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"}
+{"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  BLOCK_TYPE_ICON_VISIBILITIES,\n  type BlockTypeIconVisibility,\n  COMMENTS_LAYOUTS,\n  type CommentsLayout,\n  DRAG_HANDLE_VISIBILITIES,\n  type DragHandleVisibility,\n  HEADING_CONVERSION_SCOPES,\n  type HeadingConversionScope,\n  MODEL_ROLES,\n  type ModelRole,\n  STRUCTURE_MODES,\n  type StructureMode,\n  TREE_ROOTS,\n  type TreeRoot,\n} from './values'\nimport { EDITOR_SETTINGS_VERSION, migrateEditorSettings } from './migrate'\n\nexport * from './values'\nexport { EDITOR_SETTINGS_VERSION, isOutdatedEditorSettings, migrateEditorSettings } from './migrate'\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 model role; a missing or unknown id falls back to the server's default preset for the role. */\n    roles: Partial<Record<ModelRole, string>>\n    /** Preselected target language of „Übersetzen“. */\n    translateLanguage: AiLanguage\n  }\n  blocks: {\n    /** Block type id the Typed block shortcuts create (toolbar button, heading conversion). */\n    defaultBlockType: 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 Document with Typed blocks is loaded: nested in the folders, or the file itself. */\n    treeRoot: TreeRoot\n    /** Block type icon of Typed blocks (their drag handle): always visible, or only on hover, focus or while the details are open. */\n    blockTypeIcon: BlockTypeIconVisibility\n    /** Standard drag handle of blocks without Block type 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 Typed block 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, roles: {}, translateLanguage: 'Englisch' },\n  blocks: { defaultBlockType: 'section', structure: 'structured', treeRoot: 'folders', blockTypeIcon: '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 defaultBlockTypeSchema = z.string().min(1).max(100)\nconst structureSchema = z.enum(STRUCTURE_MODES)\nconst treeRootSchema = z.enum(TREE_ROOTS)\nconst blockTypeIconSchema = z.enum(BLOCK_TYPE_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    roles: z.partialRecord(z.enum(MODEL_ROLES), profileIdSchema),\n    translateLanguage: translateLanguageSchema,\n  }),\n  blocks: z.object({\n    defaultBlockType: defaultBlockTypeSchema,\n    structure: structureSchema,\n    treeRoot: treeRootSchema,\n    blockTypeIcon: blockTypeIconSchema,\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. Reads older stored settings\n * through `migrateEditorSettings` (`./migrate`), including the legacy flat `{ headingConversionScope }` per-browser shape.\n * Always returns fresh objects of the current version.\n */\nexport function parseEditorSettings(input: unknown): EditorSettings {\n  const root = record(migrateEditorSettings(input))\n  const editing = record(root.editing)\n  const ai = record(root.ai)\n  const roles = record(ai.roles)\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      roles: Object.fromEntries(MODEL_ROLES.flatMap((role) => {\n        const parsed = profileIdSchema.safeParse(roles[role])\n        return parsed.success ? [[role, parsed.data]] : []\n      })),\n      translateLanguage: valid(translateLanguageSchema, ai.translateLanguage, defaults.ai.translateLanguage),\n    },\n    blocks: {\n      defaultBlockType: valid(defaultBlockTypeSchema, blocks.defaultBlockType, defaults.blocks.defaultBlockType),\n      structure: valid(structureSchema, blocks.structure, defaults.blocks.structure),\n      treeRoot: valid(treeRootSchema, blocks.treeRoot, defaults.blocks.treeRoot),\n      blockTypeIcon: valid(blockTypeIconSchema, blocks.blockTypeIcon, defaults.blocks.blockTypeIcon),\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/settings/migrate.d.ts

@@ -0,0 +1,18 @@
+//#region src/settings/migrate.d.ts
+/**
+ * Version 2 renamed `ai.slots` to `ai.roles`, `blocks.defaultKind` to `blocks.defaultBlockType`, `blocks.kindIcon` to
+ * `blocks.blockTypeIcon` and the `blocks.structure` value `'composite'` to `'structured'` (`migrateEditorSettings`).
+ */
+export declare const EDITOR_SETTINGS_VERSION = 2;
+/**
+ * Maps stored settings of version 1 (and the unversioned flat per-browser shape before it) to version 2: `ai.slots` →
+ * `ai.roles`, `blocks.defaultKind` → `blocks.defaultBlockType`, `blocks.kindIcon` → `blocks.blockTypeIcon`, the
+ * `blocks.structure` value `'composite'` → `'structured'`. A key that is already new wins over the old one; unknown keys
+ * and values pass through (`parseEditorSettings` validates). Input of version 2 or later, and anything that is not an
+ * object, is returned as it is, so the migration is idempotent. Never mutates `input`.
+ */
+export declare function migrateEditorSettings(input: unknown): unknown;
+/** True when `stored` is a settings record older than `EDITOR_SETTINGS_VERSION`: it is written back once, migrated (`migrateEditorSettings`). */
+export declare function isOutdatedEditorSettings(stored: unknown): boolean;
+//#endregion
+//# sourceMappingURL=migrate.d.ts.map

package/dist/settings/migrate.js

@@ -0,0 +1,46 @@
+//#region src/settings/migrate.ts
+/**
+* Version 2 renamed `ai.slots` to `ai.roles`, `blocks.defaultKind` to `blocks.defaultBlockType`, `blocks.kindIcon` to
+* `blocks.blockTypeIcon` and the `blocks.structure` value `'composite'` to `'structured'` (`migrateEditorSettings`).
+*/
+const EDITOR_SETTINGS_VERSION = 2;
+function record(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+/**
+* Maps stored settings of version 1 (and the unversioned flat per-browser shape before it) to version 2: `ai.slots` →
+* `ai.roles`, `blocks.defaultKind` → `blocks.defaultBlockType`, `blocks.kindIcon` → `blocks.blockTypeIcon`, the
+* `blocks.structure` value `'composite'` → `'structured'`. A key that is already new wins over the old one; unknown keys
+* and values pass through (`parseEditorSettings` validates). Input of version 2 or later, and anything that is not an
+* object, is returned as it is, so the migration is idempotent. Never mutates `input`.
+*/
+function migrateEditorSettings(input) {
+	const root = record(input);
+	if (root !== input || typeof root.version === "number" && root.version >= 2) return input;
+	const { slots, ...ai } = record(root.ai);
+	const { defaultKind, kindIcon, ...blocks } = record(root.blocks);
+	const migrated = {
+		...root,
+		version: 2
+	};
+	if ("ai" in root) migrated.ai = {
+		...slots !== void 0 && { roles: slots },
+		...ai
+	};
+	if ("blocks" in root) migrated.blocks = {
+		...defaultKind !== void 0 && { defaultBlockType: defaultKind },
+		...kindIcon !== void 0 && { blockTypeIcon: kindIcon },
+		...blocks,
+		...blocks.structure === "composite" && { structure: "structured" }
+	};
+	return migrated;
+}
+/** True when `stored` is a settings record older than `EDITOR_SETTINGS_VERSION`: it is written back once, migrated (`migrateEditorSettings`). */
+function isOutdatedEditorSettings(stored) {
+	const { version } = record(stored);
+	return typeof version !== "number" || version < 2;
+}
+//#endregion
+export { EDITOR_SETTINGS_VERSION, isOutdatedEditorSettings, migrateEditorSettings };
+
+//# sourceMappingURL=migrate.js.map

package/dist/settings/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","names":[],"sources":["../../src/settings/migrate.ts"],"sourcesContent":["// Read-time migration of stored editor settings: the only place outside tests and `core/schema/persisted-names.ts` that\n// still names the settings keys of version 1 (the legacy-names check exempts this file).\n\n/**\n * Version 2 renamed `ai.slots` to `ai.roles`, `blocks.defaultKind` to `blocks.defaultBlockType`, `blocks.kindIcon` to\n * `blocks.blockTypeIcon` and the `blocks.structure` value `'composite'` to `'structured'` (`migrateEditorSettings`).\n */\nexport const EDITOR_SETTINGS_VERSION = 2\n\nfunction record(value: unknown): Record<string, unknown> {\n  return value && typeof value === 'object' && !Array.isArray(value) ? value as Record<string, unknown> : {}\n}\n\n/**\n * Maps stored settings of version 1 (and the unversioned flat per-browser shape before it) to version 2: `ai.slots` →\n * `ai.roles`, `blocks.defaultKind` → `blocks.defaultBlockType`, `blocks.kindIcon` → `blocks.blockTypeIcon`, the\n * `blocks.structure` value `'composite'` → `'structured'`. A key that is already new wins over the old one; unknown keys\n * and values pass through (`parseEditorSettings` validates). Input of version 2 or later, and anything that is not an\n * object, is returned as it is, so the migration is idempotent. Never mutates `input`.\n */\nexport function migrateEditorSettings(input: unknown): unknown {\n  const root = record(input)\n  if (root !== input || (typeof root.version === 'number' && root.version >= EDITOR_SETTINGS_VERSION)) return input\n  const { slots, ...ai } = record(root.ai)\n  const { defaultKind, kindIcon, ...blocks } = record(root.blocks)\n  const migrated: Record<string, unknown> = { ...root, version: EDITOR_SETTINGS_VERSION }\n  if ('ai' in root) migrated.ai = { ...(slots !== undefined && { roles: slots }), ...ai }\n  if ('blocks' in root) {\n    migrated.blocks = {\n      ...(defaultKind !== undefined && { defaultBlockType: defaultKind }),\n      ...(kindIcon !== undefined && { blockTypeIcon: kindIcon }),\n      ...blocks,\n      ...(blocks.structure === 'composite' && { structure: 'structured' }),\n    }\n  }\n  return migrated\n}\n\n/** True when `stored` is a settings record older than `EDITOR_SETTINGS_VERSION`: it is written back once, migrated (`migrateEditorSettings`). */\nexport function isOutdatedEditorSettings(stored: unknown): boolean {\n  const { version } = record(stored)\n  return typeof version !== 'number' || version < EDITOR_SETTINGS_VERSION\n}\n"],"mappings":";;;;;AAOA,MAAa,0BAA0B;AAEvC,SAAS,OAAO,OAAyC;CACvD,OAAO,SAAS,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IAAI,QAAmC,CAAC;AAC3G;;;;;;;;AASA,SAAgB,sBAAsB,OAAyB;CAC7D,MAAM,OAAO,OAAO,KAAK;CACzB,IAAI,SAAS,SAAU,OAAO,KAAK,YAAY,YAAY,KAAK,WAAA,GAAqC,OAAO;CAC5G,MAAM,EAAE,OAAO,GAAG,OAAO,OAAO,KAAK,EAAE;CACvC,MAAM,EAAE,aAAa,UAAU,GAAG,WAAW,OAAO,KAAK,MAAM;CAC/D,MAAM,WAAoC;EAAE,GAAG;EAAM,SAAA;CAAiC;CACtF,IAAI,QAAQ,MAAM,SAAS,KAAK;EAAE,GAAI,UAAU,KAAA,KAAa,EAAE,OAAO,MAAM;EAAI,GAAG;CAAG;CACtF,IAAI,YAAY,MACd,SAAS,SAAS;EAChB,GAAI,gBAAgB,KAAA,KAAa,EAAE,kBAAkB,YAAY;EACjE,GAAI,aAAa,KAAA,KAAa,EAAE,eAAe,SAAS;EACxD,GAAG;EACH,GAAI,OAAO,cAAc,eAAe,EAAE,WAAW,aAAa;CACpE;CAEF,OAAO;AACT;;AAGA,SAAgB,yBAAyB,QAA0B;CACjE,MAAM,EAAE,YAAY,OAAO,MAAM;CACjC,OAAO,OAAO,YAAY,YAAY,UAAA;AACxC"}

package/dist/settings/values.d.ts

@@ -1,28 +1,28 @@
 //#region src/settings/values.d.ts
-/** Feature slots a model profile can be assigned to. */
-export declare const MODEL_SLOTS: readonly ["complete", "rewrite", "generate"];
-export type ModelSlot = typeof MODEL_SLOTS[number];
+/** Model roles (stored under `ai.roles`): what a model profile can be assigned to; each role is one AI function. */
+export declare const MODEL_ROLES: readonly ["complete", "rewrite", "generate"];
+export type ModelRole = typeof MODEL_ROLES[number];
 /** Target languages of the `translate` task: the stored ids, also the language name the model is asked for; displayed through the catalogs. */
 export declare const AI_LANGUAGES: readonly ["Deutsch", "Englisch", "Französisch", "Spanisch", "Italienisch"];
 export type AiLanguage = (typeof AI_LANGUAGES)[number];
 export declare const HEADING_CONVERSION_SCOPES: readonly ["container", "document", "heading"];
 /** Blocks converted when nothing is selected: the caret's composite body / document, the whole document, or the caret's heading with its content. */
 export type HeadingConversionScope = (typeof HEADING_CONVERSION_SCOPES)[number];
-/** How a user prefers documents structured: Markdown headings, or nested composites („Bausteine“). */
-export declare const STRUCTURE_MODES: readonly ["flat", "composite"];
+/** How a user prefers documents structured: Markdown headings (Flat mode), or nested Typed blocks (Structure mode). */
+export declare const STRUCTURE_MODES: readonly ["flat", "structured"];
 export type StructureMode = (typeof STRUCTURE_MODES)[number];
 /**
- * What the document drawer's tree is rooted in while a composite file (a document with Bausteine) is loaded:
+ * What the document drawer's tree is rooted in while a Document with Typed blocks is loaded:
  * `folders` nests files in the store's folders (the file is one entry of the folder tree), `file` makes the loaded
- * file itself the single root, with its Ordner/Dokument composites as the hierarchy below. Without a loaded composite
- * file the drawer always shows the folders.
+ * file itself the single root, with its Ordner/Dokument Typed blocks as the hierarchy below. Without a loaded Document with Typed blocks
+ * the drawer always shows the folders.
  */
 export declare const TREE_ROOTS: readonly ["folders", "file"];
 export type TreeRoot = (typeof TREE_ROOTS)[number];
-/** When a composite shows its kind icon (the icon is also its drag handle): permanently, or only while hovered, focused or its details are open. */
-export declare const KIND_ICON_VISIBILITIES: readonly ["always", "hover"];
-export type KindIconVisibility = (typeof KIND_ICON_VISIBILITIES)[number];
-/** When the standard drag handle of blocks without kind icon shows: on the hovered block, or permanently beside every block. */
+/** When a Typed block shows its Block type icon (the icon is also its drag handle): permanently, or only while hovered, focused or its details are open. */
+export declare const BLOCK_TYPE_ICON_VISIBILITIES: readonly ["always", "hover"];
+export type BlockTypeIconVisibility = (typeof BLOCK_TYPE_ICON_VISIBILITIES)[number];
+/** When the standard drag handle of blocks without Block type icon shows: on the hovered block, or permanently beside every block. */
 export declare const DRAG_HANDLE_VISIBILITIES: readonly ["hover", "always"];
 export type DragHandleVisibility = (typeof DRAG_HANDLE_VISIBILITIES)[number];
 /** How the author colouring mode shows a run's author (authors feature): tinted background or coloured text. */

package/dist/settings/values.js

@@ -1,6 +1,6 @@
 //#region src/settings/values.ts
-/** Feature slots a model profile can be assigned to. */
-const MODEL_SLOTS = [
+/** Model roles (stored under `ai.roles`): what a model profile can be assigned to; each role is one AI function. */
+const MODEL_ROLES = [
 	"complete",
 	"rewrite",
 	"generate"
@@ -18,24 +18,24 @@ const HEADING_CONVERSION_SCOPES = [
 	"document",
 	"heading"
 ];
-/** How a user prefers documents structured: Markdown headings, or nested composites („Bausteine“). */
-const STRUCTURE_MODES = ["flat", "composite"];
+/** How a user prefers documents structured: Markdown headings (Flat mode), or nested Typed blocks (Structure mode). */
+const STRUCTURE_MODES = ["flat", "structured"];
 /**
-* What the document drawer's tree is rooted in while a composite file (a document with Bausteine) is loaded:
+* What the document drawer's tree is rooted in while a Document with Typed blocks is loaded:
 * `folders` nests files in the store's folders (the file is one entry of the folder tree), `file` makes the loaded
-* file itself the single root, with its Ordner/Dokument composites as the hierarchy below. Without a loaded composite
-* file the drawer always shows the folders.
+* file itself the single root, with its Ordner/Dokument Typed blocks as the hierarchy below. Without a loaded Document with Typed blocks
+* the drawer always shows the folders.
 */
 const TREE_ROOTS = ["folders", "file"];
-/** When a composite shows its kind icon (the icon is also its drag handle): permanently, or only while hovered, focused or its details are open. */
-const KIND_ICON_VISIBILITIES = ["always", "hover"];
-/** When the standard drag handle of blocks without kind icon shows: on the hovered block, or permanently beside every block. */
+/** When a Typed block shows its Block type icon (the icon is also its drag handle): permanently, or only while hovered, focused or its details are open. */
+const BLOCK_TYPE_ICON_VISIBILITIES = ["always", "hover"];
+/** When the standard drag handle of blocks without Block type icon shows: on the hovered block, or permanently beside every block. */
 const DRAG_HANDLE_VISIBILITIES = ["hover", "always"];
 /** How the author colouring mode shows a run's author (authors feature): tinted background or coloured text. */
 const AUTHOR_COLOR_STYLES = ["background", "text"];
 /** How a user wants comments shown (comments feature): cards in a margin column beside the text, or a popover at the text with a list in the toolbar. */
 const COMMENTS_LAYOUTS = ["margin", "inline"];
 //#endregion
-export { AI_LANGUAGES, AUTHOR_COLOR_STYLES, COMMENTS_LAYOUTS, DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, KIND_ICON_VISIBILITIES, MODEL_SLOTS, STRUCTURE_MODES, TREE_ROOTS };
+export { AI_LANGUAGES, AUTHOR_COLOR_STYLES, BLOCK_TYPE_ICON_VISIBILITIES, COMMENTS_LAYOUTS, DRAG_HANDLE_VISIBILITIES, HEADING_CONVERSION_SCOPES, MODEL_ROLES, STRUCTURE_MODES, TREE_ROOTS };
 
 //# sourceMappingURL=values.js.map

package/dist/settings/values.js.map

@@ -1 +1 @@
-{"version":3,"file":"values.js","names":[],"sources":["../../src/settings/values.ts"],"sourcesContent":["// Inert enum values of the stored settings model. Vue-free and free of feature code: the settings schema imports only\n// this file, features import their values from here. Their presence does not install any feature.\n\n/** Feature slots a model profile can be assigned to. */\nexport const MODEL_SLOTS = ['complete', 'rewrite', 'generate'] as const\nexport type ModelSlot = typeof MODEL_SLOTS[number]\n\n/** Target languages of the `translate` task: the stored ids, also the language name the model is asked for; displayed through the catalogs. */\n// i18n-ignore: stored setting ids, not display text\nexport const AI_LANGUAGES = ['Deutsch', 'Englisch', 'Französisch', 'Spanisch', 'Italienisch'] as const\nexport type AiLanguage = (typeof AI_LANGUAGES)[number]\n\nexport const HEADING_CONVERSION_SCOPES = ['container', 'document', 'heading'] as const\n/** Blocks converted when nothing is selected: the caret's composite body / document, the whole document, or the caret's heading with its content. */\nexport type HeadingConversionScope = (typeof HEADING_CONVERSION_SCOPES)[number]\n\n/** How a user prefers documents structured: Markdown headings, or nested composites („Bausteine“). */\nexport const STRUCTURE_MODES = ['flat', 'composite'] as const\nexport type StructureMode = (typeof STRUCTURE_MODES)[number]\n\n/**\n * What the document drawer's tree is rooted in while a composite file (a document with Bausteine) is loaded:\n * `folders` nests files in the store's folders (the file is one entry of the folder tree), `file` makes the loaded\n * file itself the single root, with its Ordner/Dokument composites as the hierarchy below. Without a loaded composite\n * file the drawer always shows the folders.\n */\nexport const TREE_ROOTS = ['folders', 'file'] as const\nexport type TreeRoot = (typeof TREE_ROOTS)[number]\n\n/** When a composite shows its kind icon (the icon is also its drag handle): permanently, or only while hovered, focused or its details are open. */\nexport const KIND_ICON_VISIBILITIES = ['always', 'hover'] as const\nexport type KindIconVisibility = (typeof KIND_ICON_VISIBILITIES)[number]\n\n/** When the standard drag handle of blocks without kind icon shows: on the hovered block, or permanently beside every block. */\nexport const DRAG_HANDLE_VISIBILITIES = ['hover', 'always'] as const\nexport type DragHandleVisibility = (typeof DRAG_HANDLE_VISIBILITIES)[number]\n\n/** How the author colouring mode shows a run's author (authors feature): tinted background or coloured text. */\nexport const AUTHOR_COLOR_STYLES = ['background', 'text'] as const\nexport type AuthorColorStyle = (typeof AUTHOR_COLOR_STYLES)[number]\n\n/** How a user wants comments shown (comments feature): cards in a margin column beside the text, or a popover at the text with a list in the toolbar. */\nexport const COMMENTS_LAYOUTS = ['margin', 'inline'] as const\nexport type CommentsLayout = (typeof COMMENTS_LAYOUTS)[number]\n"],"mappings":";;AAIA,MAAa,cAAc;CAAC;CAAY;CAAW;AAAU;;AAK7D,MAAa,eAAe;CAAC;CAAW;CAAY;CAAe;CAAY;AAAa;AAG5F,MAAa,4BAA4B;CAAC;CAAa;CAAY;AAAS;;AAK5E,MAAa,kBAAkB,CAAC,QAAQ,WAAW;;;;;;;AASnD,MAAa,aAAa,CAAC,WAAW,MAAM;;AAI5C,MAAa,yBAAyB,CAAC,UAAU,OAAO;;AAIxD,MAAa,2BAA2B,CAAC,SAAS,QAAQ;;AAI1D,MAAa,sBAAsB,CAAC,cAAc,MAAM;;AAIxD,MAAa,mBAAmB,CAAC,UAAU,QAAQ"}
+{"version":3,"file":"values.js","names":[],"sources":["../../src/settings/values.ts"],"sourcesContent":["// Inert enum values of the stored settings model. Vue-free and free of feature code: the settings schema imports only\n// this file, features import their values from here. Their presence does not install any feature.\n\n/** Model roles (stored under `ai.roles`): what a model profile can be assigned to; each role is one AI function. */\nexport const MODEL_ROLES = ['complete', 'rewrite', 'generate'] as const\nexport type ModelRole = typeof MODEL_ROLES[number]\n\n/** Target languages of the `translate` task: the stored ids, also the language name the model is asked for; displayed through the catalogs. */\n// i18n-ignore: stored setting ids, not display text\nexport const AI_LANGUAGES = ['Deutsch', 'Englisch', 'Französisch', 'Spanisch', 'Italienisch'] as const\nexport type AiLanguage = (typeof AI_LANGUAGES)[number]\n\nexport const HEADING_CONVERSION_SCOPES = ['container', 'document', 'heading'] as const\n/** Blocks converted when nothing is selected: the caret's composite body / document, the whole document, or the caret's heading with its content. */\nexport type HeadingConversionScope = (typeof HEADING_CONVERSION_SCOPES)[number]\n\n/** How a user prefers documents structured: Markdown headings (Flat mode), or nested Typed blocks (Structure mode). */\nexport const STRUCTURE_MODES = ['flat', 'structured'] as const\nexport type StructureMode = (typeof STRUCTURE_MODES)[number]\n\n/**\n * What the document drawer's tree is rooted in while a Document with Typed blocks is loaded:\n * `folders` nests files in the store's folders (the file is one entry of the folder tree), `file` makes the loaded\n * file itself the single root, with its Ordner/Dokument Typed blocks as the hierarchy below. Without a loaded Document with Typed blocks\n * the drawer always shows the folders.\n */\nexport const TREE_ROOTS = ['folders', 'file'] as const\nexport type TreeRoot = (typeof TREE_ROOTS)[number]\n\n/** When a Typed block shows its Block type icon (the icon is also its drag handle): permanently, or only while hovered, focused or its details are open. */\nexport const BLOCK_TYPE_ICON_VISIBILITIES = ['always', 'hover'] as const\nexport type BlockTypeIconVisibility = (typeof BLOCK_TYPE_ICON_VISIBILITIES)[number]\n\n/** When the standard drag handle of blocks without Block type icon shows: on the hovered block, or permanently beside every block. */\nexport const DRAG_HANDLE_VISIBILITIES = ['hover', 'always'] as const\nexport type DragHandleVisibility = (typeof DRAG_HANDLE_VISIBILITIES)[number]\n\n/** How the author colouring mode shows a run's author (authors feature): tinted background or coloured text. */\nexport const AUTHOR_COLOR_STYLES = ['background', 'text'] as const\nexport type AuthorColorStyle = (typeof AUTHOR_COLOR_STYLES)[number]\n\n/** How a user wants comments shown (comments feature): cards in a margin column beside the text, or a popover at the text with a list in the toolbar. */\nexport const COMMENTS_LAYOUTS = ['margin', 'inline'] as const\nexport type CommentsLayout = (typeof COMMENTS_LAYOUTS)[number]\n"],"mappings":";;AAIA,MAAa,cAAc;CAAC;CAAY;CAAW;AAAU;;AAK7D,MAAa,eAAe;CAAC;CAAW;CAAY;CAAe;CAAY;AAAa;AAG5F,MAAa,4BAA4B;CAAC;CAAa;CAAY;AAAS;;AAK5E,MAAa,kBAAkB,CAAC,QAAQ,YAAY;;;;;;;AASpD,MAAa,aAAa,CAAC,WAAW,MAAM;;AAI5C,MAAa,+BAA+B,CAAC,UAAU,OAAO;;AAI9D,MAAa,2BAA2B,CAAC,SAAS,QAAQ;;AAI1D,MAAa,sBAAsB,CAAC,cAAc,MAAM;;AAIxD,MAAa,mBAAmB,CAAC,UAAU,QAAQ"}

package/dist/styles/composites.css

@@ -1,9 +1,9 @@
 /* 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`.
-   `--sk-kind-tone-mix` is how strongly a kind's tone (`CompositeKind.chrome.tone`) tints the Baustein surface. */
+   `--sk-block-type-tone-mix` is how strongly a Block type's tone (`BlockType.chrome.tone`) tints the Typed block surface. */
 :where(:root) {
-  --sk-kind-tone-mix: 8%;
+  --sk-block-type-tone-mix: 8%;
   --sk-basket-red: #ef4444;
   --sk-basket-orange: #f97316;
   --sk-basket-yellow: #eab308;
@@ -12,7 +12,7 @@
 }
 
 :where(.dark) {
-  --sk-kind-tone-mix: 14%;
+  --sk-block-type-tone-mix: 14%;
   --sk-basket-red: #f87171;
   --sk-basket-orange: #fb923c;
   --sk-basket-yellow: #facc15;
@@ -29,11 +29,11 @@
     padding-left: 1.25rem;
     border-left: 2px solid var(--sk-border);
   }
-  /* Kind tone: the node view sets `data-kind-tone` and `--sk-kind-tone` on a Baustein whose kind has `chrome.tone`; kinds without one are untouched.
+  /* Block type tone: the node view sets `data-block-type-tone` and `--sk-block-type-tone` on a Typed block whose Block type has `chrome.tone`; Block types without one are untouched.
      Declared before the basket stripe, which wins on the border when both apply. */
-  .tiptap .composite[data-kind-tone] {
-    background: color-mix(in oklab, var(--sk-kind-tone) var(--sk-kind-tone-mix), transparent);
-    border-left-color: var(--sk-kind-tone);
+  .tiptap .composite[data-block-type-tone] {
+    background: color-mix(in oklab, var(--sk-block-type-tone) var(--sk-block-type-tone-mix), transparent);
+    border-left-color: var(--sk-block-type-tone);
   }
   /* 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. */
@@ -47,7 +47,7 @@
   .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
+  /* Derived Typed block (has a `meta.derivation`) that is not opened: a short faded preview. The content stays laid out and
      only clipped, so ProseMirror positions and measurements stay valid; a caret inside opens it (`CompositeNode`). */
   .tiptap .composite.is-collapsed > .composite__content {
     max-height: 7rem;
@@ -82,7 +82,7 @@
   /* 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
+  /* Focus mode (`focusComposite`): the decorations of `CompositeFocus` hide every sibling of the focused Typed block
      (`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; }
@@ -94,7 +94,7 @@
     pointer-events: none;
     content: var(--composite-title-placeholder, '');
   }
-  /* Inline reference to a Baustein (`[@`): a link-like pill in the primary colour; greyed and struck when the target is gone. */
+  /* Inline reference to a Typed block (`[@`): a link-like pill in the primary colour; greyed and struck when the target is gone. */
   .tiptap .reference {
     color: var(--sk-primary);
     background: color-mix(in oklab, var(--sk-primary) 12%, transparent);

package/dist/tree/DocumentTree.js

@@ -77,7 +77,7 @@ const _hoisted_25 = {
 	class: "px-2.5 py-1.5 text-sm text-[var(--sk-muted)]"
 };
 const basketOption = "flex w-full items-center gap-2 rounded-sm px-2 py-1.5 text-left text-sm text-[var(--sk-fg)] transition-colors duration-150 hover:bg-[var(--sk-bg-elevated)] focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-[var(--sk-primary)]";
-/** The breadcrumb of the focus: the document (first crumb, leaves focus) and the Bausteine down to the focused one. */
+/** The breadcrumb of the focus: the document (first crumb, leaves focus) and the Typed blocks down to the focused one. */
 const _sfc_main = /*@__PURE__*/ defineComponent({
 	__name: "DocumentTree",
 	props: /*@__PURE__*/ mergeModels({
@@ -100,7 +100,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 			selectedFolder
 		});
 		const { settings } = useEditorSettings();
-		const canUseFileRoot = computed(() => state.value.hasEditor && state.value.structure === "composite");
+		const canUseFileRoot = computed(() => state.value.hasEditor && state.value.structure === "structured");
 		function toggleTreeRoot() {
 			settings.value.blocks.treeRoot = settings.value.blocks.treeRoot === "file" ? "folders" : "file";
 		}
@@ -173,7 +173,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 			if (!event.dataTransfer) return model.value.dragEnd();
 			event.dataTransfer.setData(DRAG_MIME, JSON.stringify(payload));
 			const editor = props.editor;
-			const found = payload.type === "composite" && editor && !editor.isDestroyed ? findBlockById(editor.state.doc, payload.blockId) : null;
+			const found = payload.type === "typedBlock" && editor && !editor.isDestroyed ? findBlockById(editor.state.doc, payload.blockId) : null;
 			const transfer = found && editor ? blockTransferOf(editor, found.pos) : null;
 			if (transfer) writeBlockTransfer(event.dataTransfer, transfer);
 			event.dataTransfer.effectAllowed = transfer ? "copyMove" : "move";
@@ -392,7 +392,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 							name: "i-lucide-chevron-right",
 							class: normalizeClass(["size-3.5 shrink-0 text-[var(--sk-muted)] transition-transform", row(item).open && "rotate-90"]),
 							onClick: ($event) => onChevronClick($event, item)
-						}, null, 8, ["class", "onClick"])) : item.type === "composite" || item.type === "heading" ? (openBlock(), createElementBlock("span", _hoisted_17)) : createCommentVNode("v-if", true),
+						}, null, 8, ["class", "onClick"])) : item.type === "typedBlock" || item.type === "heading" ? (openBlock(), createElementBlock("span", _hoisted_17)) : createCommentVNode("v-if", true),
 						createVNode(unref(UIcon), {
 							name: item.icon,
 							class: "size-4 shrink-0",
@@ -454,6 +454,13 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 								class: "size-3.5 shrink-0 text-[var(--sk-muted)]",
 								title: unref(t)("tree.summary")
 							}, null, 8, ["title"])) : createCommentVNode("v-if", true),
+							item.sourceMissing ? (openBlock(), createBlock(unref(UIcon), {
+								key: 2,
+								name: "i-lucide-unlink",
+								class: "size-3.5 shrink-0 text-[var(--sk-warning)]",
+								title: unref(t)("composites.derivation.sourceMissing"),
+								"data-source-missing": ""
+							}, null, 8, ["title"])) : createCommentVNode("v-if", true),
 							createElementVNode("div", {
 								class: "flex shrink-0",
 								onClick: _cache[11] || (_cache[11] = withModifiers(() => {}, ["stop"]))
@@ -479,7 +486,7 @@ const _sfc_main = /*@__PURE__*/ defineComponent({
 								])]),
 								_: 2
 							}, 1032, ["items"])) : createCommentVNode("v-if", true), createElementVNode("div", _hoisted_22, [
-								item.type === "composite" && item.blockId ? (openBlock(), createBlock(unref(UButton), {
+								item.type === "typedBlock" && item.blockId ? (openBlock(), createBlock(unref(UButton), {
 									key: 0,
 									icon: "i-lucide-focus",
 									size: "xs",