@ecsplico/editor 3.6.0 → 4.1.0

package/dist/features/composites/block-types.d.ts

@@ -0,0 +1,119 @@
+import { Translate } from "../../i18n/index.js";
+import { BlockTypeData } from "../../core/capabilities.js";
+import { PropertyDefinition } from "../../core/properties.js";
+import { AiContextBlockType } from "../../core/feature.js";
+//#region src/features/composites/block-types.d.ts
+/** Media block types a Block type's `source` capability may name. */
+export declare const SOURCE_MEDIA_TYPES: readonly ["image", "audio", "video", "file"];
+/**
+ * What a Block type tells the model beyond its properties. `purpose` goes into every AI request's block model (chat, generate
+ * tasks); `instructions`, `instructionsField` and `contentTemplate` are read only by the AI fill of a Typed block (`fillComposite`).
+ */
+export interface BlockTypeAi {
+  /** One or two German sentences: what a Typed block of this type is for and what its body holds. */
+  purpose: string;
+  /** Default instruction for filling the body of a Typed block of this type (what to write, structure, tone). */
+  instructions?: string;
+  /** Key of a `textarea` property of this type; a Typed block whose value is non-empty replaces `instructions` with it. */
+  instructionsField?: string;
+  /** AI content template: target text as Markdown; `{key}` placeholders are replaced by the Typed block's `meta[key]` before it goes to the model, unknown ones stay. */
+  contentTemplate?: string;
+}
+/** Config of the `properties` capability: the Property definitions of the type (its Block properties live in the Typed block's `meta`). */
+export interface PropertiesConfig {
+  definitions: readonly PropertyDefinition[];
+}
+/** Config of the `source` capability: the media block types the type's source may be; `sourceOf` returns the first body child of one of these. */
+export interface SourceConfig {
+  media: readonly SourceMedia[];
+}
+/**
+ * Config of the `import` capability: the media an imported file may have for the type to take it (a recording takes audio and
+ * video, a figure an image). Absent or empty: the type takes every imported file no other type takes, text and Markdown included.
+ */
+export interface ImportConfig {
+  media?: readonly SourceMedia[];
+}
+/**
+ * Config of the built-in `container` capability. `accepts`: the Block types the type accepts as nested Typed blocks, a list of type ids
+ * or `'all'`; absent: none (the built-in Folder and Document types declare `'all'`). Content that is no Typed block (paragraphs,
+ * lists, ...) is always allowed. Only new moves are checked; documents that already nest against it stay as they are.
+ * `nestedAfterContent`: the nested Typed blocks of a Typed block of this type follow its own content, and a merge keeps that order:
+ * `mergeCompositeWithNext` merging A = [Ca, Na] and B = [Cb, Nb] (C the leading blocks of the body that are not Typed blocks, N the
+ * rest from the first nested Typed block on) gives [Ca, Cb, Na, Nb] instead of [Ca, Na, Cb, Nb]. Default `false`.
+ * `root`: the type stands for the file of a document tree: the document tree takes it as the Block type of the store's document rows
+ * (its filter lists it with its label and icon). Set on the built-in Document type; default `false`.
+ */
+export interface ContainerConfig {
+  accepts?: readonly string[] | 'all';
+  nestedAfterContent?: boolean;
+  root?: boolean;
+}
+/** The media block types a `source` capability's `media` names. */
+export type SourceMedia = (typeof SOURCE_MEDIA_TYPES)[number];
+/**
+ * A Block type: what the `blockType` attribute of a Typed block selects. Data: its presentation (label, icon, chrome placeholders) and
+ * the capabilities it lists with their config (`capabilities`), each declared by the Feature that owns the mechanism
+ * (`properties`, `source`, `bibliography`, `basket`, `ai-brief`, `references`; the built-in `container`). A capability a type does
+ * not list is absent from its Typed blocks; no field on the type itself switches a behaviour.
+ */
+export interface BlockType extends BlockTypeData {
+  label: string;
+  icon: string;
+  /** Placeholder of the empty title row; absent: none. */
+  titlePlaceholder?: string;
+  /** Placeholder of the empty description row; absent: none. */
+  descriptionPlaceholder?: string;
+  /**
+   * How much of the chrome the type shows. Absent: all of it. `tags: false` hides the tag row of this type (the node stays in the schema, empty).
+   * `tone`: a CSS colour or `var(...)` that sets the type apart: a Typed block of this type gets `data-block-type-tone` and `--sk-block-type-tone` on its wrapper
+   * (a tinted surface and a left border in the tone) and its tree rows tint the type icon with it. Absent: the type looks as before.
+   * `controls: false` makes the chrome of a Typed block of this type read-only although the editor is editable (for a type whose attributes a
+   * host guard refuses to change): no basket menu, status menu, title-visibility toggle, tag editing or drag handle on the type icon, and a
+   * read-only details popover; an existing basket, status and tags still show as chips. Default `true`.
+   */
+  chrome?: {
+    tags?: boolean;
+    tone?: string;
+    controls?: boolean;
+  };
+}
+/** The Property definitions of `type` (its `properties` capability); none when it does not list the capability. */
+export declare const propertiesOf: (type: BlockTypeData) => readonly PropertyDefinition[];
+/** The media block types `type`'s source may be (its `source` capability); undefined when it keeps no source. */
+export declare const sourceMediaOf: (type: BlockTypeData) => readonly SourceMedia[] | undefined;
+/** The AI brief of `type` (its `ai-brief` capability); undefined when it has none: the AI fill of a Typed block is not offered for it. */
+export declare const aiBriefOf: (type: BlockTypeData) => BlockTypeAi | undefined;
+/** The Block types as the AI chat model learns them: id, label, Property definitions as fields and the `ai-brief` purpose. The editor's `aiContext` and the server's own resolution (`EditorServerOptions.blockTypes`) both build it here. */
+export declare const aiBlockTypesOf: (blockTypes: readonly BlockType[]) => AiContextBlockType[];
+/** The nested Typed blocks `type` accepts (the `accepts` of its `container` config); undefined: none. */
+export declare const acceptsOf: (type: BlockTypeData) => readonly string[] | "all" | undefined;
+/** Whether the nested Typed blocks of `type` follow its own content (the `nestedAfterContent` of its `container` config). */
+export declare const nestedAfterContentOf: (type: BlockTypeData) => boolean;
+/** Whether `type` stands for the file of a document tree (the `root` of its `container` config): the Block type of the store's document rows. */
+export declare const isRootBlockType: (type: BlockTypeData) => boolean;
+/**
+ * The built-in Block types in the language of `t`. The default set is produced from the translator (labels, placeholders, property
+ * labels and status choices are catalog messages), so it is built per translator and memoized; hosts that pass their own
+ * types (`compositeFeature({ blockTypes })`, `Composite.configure({ blockTypes })`) keep their labels untouched. Ids, property keys and
+ * stored values (`open`, `doing`, `done`) do not depend on the language.
+ */
+export declare function defaultBlockTypes(t: Translate): readonly BlockType[];
+/** Block type `id` from `blockTypes`; an unknown id gets the `section` type's presentation (else the first type's) under its own id and label. */
+export declare function blockTypeOf(blockTypes: readonly BlockType[], id: string): BlockType;
+/**
+ * Whether a Typed block of type `parentType` accepts one of type `childType` as nested Typed block. The `accepts` of the type's
+ * `container` config in `blockTypes` decides; without one (or for a type `blockTypes` does not list) it accepts none. The built-in Folder and
+ * Document types declare `accepts: 'all'` themselves.
+ */
+export declare function acceptsChild(blockTypes: readonly BlockType[], parentType: string, childType: string): boolean;
+/** Whether a Typed block of type `parentType` accepts at least one Block type an imported file can become (one that lists `import`), i.e. whether files can be imported into it. */
+export declare function acceptsImport(blockTypes: readonly BlockType[], parentType: string): boolean;
+/**
+ * The Block type an imported file of media `media` (null: text, Markdown or another file the media pipeline does not know) becomes:
+ * the first type in `blockTypes` whose `import` capability names `media`, else the first that lists `import` without media (the
+ * catch-all). Undefined when no type takes the file; the import then inserts its blocks as they are.
+ */
+export declare function importTypeOf(blockTypes: readonly BlockType[], media: SourceMedia | null): string | undefined;
+//#endregion
+//# sourceMappingURL=block-types.d.ts.map

package/dist/features/composites/block-types.js

@@ -0,0 +1,343 @@
+import { blockTypeConfigOf, listsCapability } from "../../core/capabilities.js";
+import { createTranslator } from "../../i18n/index.js";
+//#region src/features/composites/block-types.ts
+/** Media block types a Block type's `source` capability may name. */
+const SOURCE_MEDIA_TYPES = [
+	"image",
+	"audio",
+	"video",
+	"file"
+];
+/** The Property definitions of `type` (its `properties` capability); none when it does not list the capability. */
+const propertiesOf = (type) => blockTypeConfigOf(type, "properties")?.definitions ?? [];
+/** The media block types `type`'s source may be (its `source` capability); undefined when it keeps no source. */
+const sourceMediaOf = (type) => blockTypeConfigOf(type, "source")?.media;
+/** The AI brief of `type` (its `ai-brief` capability); undefined when it has none: the AI fill of a Typed block is not offered for it. */
+const aiBriefOf = (type) => blockTypeConfigOf(type, "ai-brief");
+/** The Block types as the AI chat model learns them: id, label, Property definitions as fields and the `ai-brief` purpose. The editor's `aiContext` and the server's own resolution (`EditorServerOptions.blockTypes`) both build it here. */
+const aiBlockTypesOf = (blockTypes) => blockTypes.map((type) => {
+	const purpose = aiBriefOf(type)?.purpose;
+	return {
+		id: type.id,
+		label: type.label,
+		fields: propertiesOf(type),
+		...purpose && { purpose }
+	};
+});
+/** The nested Typed blocks `type` accepts (the `accepts` of its `container` config); undefined: none. */
+const acceptsOf = (type) => blockTypeConfigOf(type, "container")?.accepts;
+/** Whether the nested Typed blocks of `type` follow its own content (the `nestedAfterContent` of its `container` config). */
+const nestedAfterContentOf = (type) => blockTypeConfigOf(type, "container")?.nestedAfterContent === true;
+/** Whether `type` stands for the file of a document tree (the `root` of its `container` config): the Block type of the store's document rows. */
+const isRootBlockType = (type) => blockTypeConfigOf(type, "container")?.root === true;
+/**
+* The built-in Block types in the language of `t`. The default set is produced from the translator (labels, placeholders, property
+* labels and status choices are catalog messages), so it is built per translator and memoized; hosts that pass their own
+* types (`compositeFeature({ blockTypes })`, `Composite.configure({ blockTypes })`) keep their labels untouched. Ids, property keys and
+* stored values (`open`, `doing`, `done`) do not depend on the language.
+*/
+function defaultBlockTypes(t) {
+	let blockTypes = DEFAULT_BLOCK_TYPES.get(t);
+	if (!blockTypes) DEFAULT_BLOCK_TYPES.set(t, blockTypes = buildDefaultBlockTypes(t));
+	return blockTypes;
+}
+const DEFAULT_BLOCK_TYPES = /* @__PURE__ */ new WeakMap();
+const container = (accepts, extra = {}) => ({
+	id: "container",
+	config: {
+		accepts,
+		...extra
+	}
+});
+const properties = (definitions) => ({
+	id: "properties",
+	config: { definitions }
+});
+const source = (...media) => ({
+	id: "source",
+	config: { media }
+});
+const aiBrief = (config) => ({
+	id: "ai-brief",
+	config
+});
+const importing = (...media) => ({
+	id: "import",
+	config: { media }
+});
+const EXPORT = { id: "export" };
+const BIBLIOGRAPHY = { id: "bibliography" };
+const BASKET = { id: "basket" };
+function buildDefaultBlockTypes(t) {
+	const presentation = (id) => ({
+		id,
+		label: t(`composites.kind.${id}.label`),
+		titlePlaceholder: t(`composites.kind.${id}.title`),
+		descriptionPlaceholder: t(`composites.kind.${id}.description`)
+	});
+	return [
+		{
+			...presentation("section"),
+			icon: "i-lucide-layers",
+			capabilities: [container("all"), BASKET]
+		},
+		{
+			...presentation("task"),
+			icon: "i-lucide-square-check",
+			capabilities: [BASKET, properties([
+				{
+					key: "status",
+					label: t("composites.kind.task.field.status"),
+					type: "select",
+					options: [
+						{
+							value: "open",
+							label: t("composites.kind.task.status.open")
+						},
+						{
+							value: "doing",
+							label: t("composites.kind.task.status.doing")
+						},
+						{
+							value: "done",
+							label: t("composites.kind.task.status.done")
+						}
+					]
+				},
+				{
+					key: "due",
+					label: t("composites.kind.task.field.due"),
+					type: "date"
+				},
+				{
+					key: "assignee",
+					label: t("composites.kind.task.field.assignee"),
+					type: "text"
+				}
+			])]
+		},
+		{
+			...presentation("note"),
+			icon: "i-lucide-sticky-note",
+			capabilities: [BASKET, aiBrief({ purpose: "Eigene Notiz zu einer Quelle oder einem Thema: Zusammenfassung, Gedanken, offene Fragen." })]
+		},
+		{
+			...presentation("document"),
+			icon: "i-lucide-file-text",
+			capabilities: [
+				container("all", { root: true }),
+				source(...SOURCE_MEDIA_TYPES),
+				importing(),
+				EXPORT,
+				BASKET,
+				properties([
+					{
+						key: "filename",
+						label: t("composites.kind.document.field.filename"),
+						type: "text"
+					},
+					{
+						key: "mimeType",
+						label: t("composites.kind.document.field.mimeType"),
+						type: "text"
+					},
+					{
+						key: "size",
+						label: t("composites.kind.document.field.size"),
+						type: "number"
+					},
+					{
+						key: "importedAt",
+						label: t("composites.kind.document.field.importedAt"),
+						type: "date"
+					}
+				])
+			]
+		},
+		{
+			...presentation("recording"),
+			icon: "i-lucide-mic",
+			capabilities: [
+				container("all"),
+				source("audio", "video"),
+				importing("audio", "video"),
+				BASKET,
+				properties([
+					...importProperties(t, "recording"),
+					{
+						key: "recordedAt",
+						label: t("composites.kind.recording.field.recordedAt"),
+						type: "date"
+					},
+					{
+						key: "participants",
+						label: t("composites.kind.recording.field.participants"),
+						type: "text"
+					},
+					{
+						key: "durationSeconds",
+						label: t("composites.kind.recording.field.durationSeconds"),
+						type: "number"
+					}
+				]),
+				aiBrief({ purpose: "Aufnahme (Audio oder Video) als Quelle; der Inhalt hält lesbare Fassungen wie das Transkript und eigene Notizen." })
+			]
+		},
+		{
+			...presentation("paper"),
+			icon: "i-lucide-scroll-text",
+			capabilities: [
+				container("all"),
+				source("file"),
+				BIBLIOGRAPHY,
+				BASKET,
+				properties([
+					...importProperties(t, "paper"),
+					{
+						key: "bib",
+						label: t("composites.kind.paper.field.bib"),
+						type: "bibliography"
+					},
+					{
+						key: "doi",
+						label: t("composites.kind.paper.field.doi"),
+						type: "text"
+					}
+				]),
+				aiBrief({ purpose: "Wissenschaftliche Arbeit als Quelle (PDF) mit Literaturangabe; der Inhalt hält Volltext, Zusammenfassungen und Notizen." })
+			]
+		},
+		{
+			...presentation("book"),
+			icon: "i-lucide-book",
+			capabilities: [
+				container("all"),
+				source("file"),
+				BIBLIOGRAPHY,
+				BASKET,
+				properties([
+					...importProperties(t, "book"),
+					{
+						key: "bib",
+						label: t("composites.kind.book.field.bib"),
+						type: "bibliography"
+					},
+					{
+						key: "isbn",
+						label: t("composites.kind.book.field.isbn"),
+						type: "text"
+					}
+				]),
+				aiBrief({ purpose: "Buch als Quelle (PDF) mit Literaturangabe; der Inhalt hält den Volltext, gegliedert in Kapitel, und Notizen." })
+			]
+		},
+		{
+			...presentation("figure"),
+			icon: "i-lucide-image",
+			capabilities: [
+				container("all"),
+				source("image"),
+				importing("image"),
+				BASKET,
+				properties([...importProperties(t, "figure"), {
+					key: "credit",
+					label: t("composites.kind.figure.field.credit"),
+					type: "text"
+				}]),
+				aiBrief({ purpose: "Bild als Quelle; der Inhalt hält die Bildbeschreibung und eigene Notizen." })
+			]
+		},
+		{
+			...presentation("rendition"),
+			icon: "i-lucide-captions",
+			capabilities: [
+				container("all"),
+				BASKET,
+				properties([{
+					key: "derivation",
+					label: t("composites.kind.rendition.field.derivation"),
+					type: "derivation"
+				}, {
+					key: "language",
+					label: t("composites.kind.rendition.field.language"),
+					type: "text"
+				}]),
+				aiBrief({
+					purpose: "Lesbare Fassung einer Quelle (Transkript, Volltext, Beschreibung, Übersetzung)",
+					instructions: "Übertrage den Inhalt vollständig und gut lesbar; nichts weglassen, nichts hinzuerfinden."
+				})
+			]
+		},
+		{
+			...presentation("folder"),
+			icon: "i-lucide-folder",
+			capabilities: [container("all"), BASKET]
+		}
+	];
+}
+/** The four Property definitions the import of a file fills in (`wrapImport` of `composite-media`), shared by every source-holding Block type. */
+function importProperties(t, type) {
+	return [
+		{
+			key: "filename",
+			label: t(`composites.kind.${type}.field.filename`),
+			type: "text"
+		},
+		{
+			key: "mimeType",
+			label: t(`composites.kind.${type}.field.mimeType`),
+			type: "text"
+		},
+		{
+			key: "size",
+			label: t(`composites.kind.${type}.field.size`),
+			type: "number"
+		},
+		{
+			key: "importedAt",
+			label: t(`composites.kind.${type}.field.importedAt`),
+			type: "date"
+		}
+	];
+}
+/** The built-in Block types in the default language, for server-side and context-free code (`Composite`'s default option, an editor without a context). */
+const fallbackBlockTypes = () => defaultBlockTypes(DEFAULT_TRANSLATE);
+const DEFAULT_TRANSLATE = createTranslator();
+/** Block type `id` from `blockTypes`; an unknown id gets the `section` type's presentation (else the first type's) under its own id and label. */
+function blockTypeOf(blockTypes, id) {
+	const known = blockTypes.find((type) => type.id === id);
+	if (known) return known;
+	return {
+		...blockTypes.find((type) => type.id === "section") ?? blockTypes[0] ?? fallbackBlockTypes()[0],
+		id,
+		label: id
+	};
+}
+/**
+* Whether a Typed block of type `parentType` accepts one of type `childType` as nested Typed block. The `accepts` of the type's
+* `container` config in `blockTypes` decides; without one (or for a type `blockTypes` does not list) it accepts none. The built-in Folder and
+* Document types declare `accepts: 'all'` themselves.
+*/
+function acceptsChild(blockTypes, parentType, childType) {
+	const type = blockTypes.find((candidate) => candidate.id === parentType);
+	const accepts = type && acceptsOf(type);
+	if (accepts === void 0) return false;
+	return accepts === "all" || accepts.includes(childType);
+}
+/** Whether a Typed block of type `parentType` accepts at least one Block type an imported file can become (one that lists `import`), i.e. whether files can be imported into it. */
+function acceptsImport(blockTypes, parentType) {
+	return blockTypes.some((type) => listsCapability(type, "import") && acceptsChild(blockTypes, parentType, type.id));
+}
+/**
+* The Block type an imported file of media `media` (null: text, Markdown or another file the media pipeline does not know) becomes:
+* the first type in `blockTypes` whose `import` capability names `media`, else the first that lists `import` without media (the
+* catch-all). Undefined when no type takes the file; the import then inserts its blocks as they are.
+*/
+function importTypeOf(blockTypes, media) {
+	const importing = blockTypes.filter((type) => listsCapability(type, "import"));
+	return ((media && importing.find((type) => blockTypeConfigOf(type, "import")?.media?.includes(media))) ?? importing.find((type) => !blockTypeConfigOf(type, "import")?.media?.length))?.id;
+}
+//#endregion
+export { SOURCE_MEDIA_TYPES, acceptsChild, acceptsImport, acceptsOf, aiBlockTypesOf, aiBriefOf, blockTypeOf, defaultBlockTypes, fallbackBlockTypes, importTypeOf, isRootBlockType, nestedAfterContentOf, propertiesOf, sourceMediaOf };
+
+//# sourceMappingURL=block-types.js.map

package/dist/features/composites/block-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-types.js","names":[],"sources":["../../../src/features/composites/block-types.ts"],"sourcesContent":["// Vue-free and server-importable: the Block type registry of Typed blocks (node `typedBlock`, type id in `attrs.blockType`).\nimport { type BlockTypeCapability, type BlockTypeData, blockTypeConfigOf, listsCapability } from '../../core/capabilities'\nimport type { AiContextBlockType } from '../../core/feature'\nimport type { PropertyDefinition } from '../../core/properties'\nimport { createTranslator, type Translate } from '../../i18n'\n\n/** Media block types a Block type's `source` capability may name. */\nexport const SOURCE_MEDIA_TYPES = ['image', 'audio', 'video', 'file'] as const\n\n/**\n * What a Block type tells the model beyond its properties. `purpose` goes into every AI request's block model (chat, generate\n * tasks); `instructions`, `instructionsField` and `contentTemplate` are read only by the AI fill of a Typed block (`fillComposite`).\n */\nexport interface BlockTypeAi {\n  /** One or two German sentences: what a Typed block of this type is for and what its body holds. */\n  purpose: string\n  /** Default instruction for filling the body of a Typed block of this type (what to write, structure, tone). */\n  instructions?: string\n  /** Key of a `textarea` property of this type; a Typed block whose value is non-empty replaces `instructions` with it. */\n  instructionsField?: string\n  /** AI content template: target text as Markdown; `{key}` placeholders are replaced by the Typed block's `meta[key]` before it goes to the model, unknown ones stay. */\n  contentTemplate?: string\n}\n\n/** Config of the `properties` capability: the Property definitions of the type (its Block properties live in the Typed block's `meta`). */\nexport interface PropertiesConfig {\n  definitions: readonly PropertyDefinition[]\n}\n\n/** Config of the `source` capability: the media block types the type's source may be; `sourceOf` returns the first body child of one of these. */\nexport interface SourceConfig {\n  media: readonly SourceMedia[]\n}\n\n/**\n * Config of the `import` capability: the media an imported file may have for the type to take it (a recording takes audio and\n * video, a figure an image). Absent or empty: the type takes every imported file no other type takes, text and Markdown included.\n */\nexport interface ImportConfig {\n  media?: readonly SourceMedia[]\n}\n\n/**\n * Config of the built-in `container` capability. `accepts`: the Block types the type accepts as nested Typed blocks, a list of type ids\n * or `'all'`; absent: none (the built-in Folder and Document types declare `'all'`). Content that is no Typed block (paragraphs,\n * lists, ...) is always allowed. Only new moves are checked; documents that already nest against it stay as they are.\n * `nestedAfterContent`: the nested Typed blocks of a Typed block of this type follow its own content, and a merge keeps that order:\n * `mergeCompositeWithNext` merging A = [Ca, Na] and B = [Cb, Nb] (C the leading blocks of the body that are not Typed blocks, N the\n * rest from the first nested Typed block on) gives [Ca, Cb, Na, Nb] instead of [Ca, Na, Cb, Nb]. Default `false`.\n * `root`: the type stands for the file of a document tree: the document tree takes it as the Block type of the store's document rows\n * (its filter lists it with its label and icon). Set on the built-in Document type; default `false`.\n */\nexport interface ContainerConfig {\n  accepts?: readonly string[] | 'all'\n  nestedAfterContent?: boolean\n  root?: boolean\n}\n\n/** The media block types a `source` capability's `media` names. */\nexport type SourceMedia = (typeof SOURCE_MEDIA_TYPES)[number]\n\n/**\n * A Block type: what the `blockType` attribute of a Typed block selects. Data: its presentation (label, icon, chrome placeholders) and\n * the capabilities it lists with their config (`capabilities`), each declared by the Feature that owns the mechanism\n * (`properties`, `source`, `bibliography`, `basket`, `ai-brief`, `references`; the built-in `container`). A capability a type does\n * not list is absent from its Typed blocks; no field on the type itself switches a behaviour.\n */\nexport interface BlockType extends BlockTypeData {\n  label: string\n  icon: string\n  /** Placeholder of the empty title row; absent: none. */\n  titlePlaceholder?: string\n  /** Placeholder of the empty description row; absent: none. */\n  descriptionPlaceholder?: string\n  /**\n   * How much of the chrome the type shows. Absent: all of it. `tags: false` hides the tag row of this type (the node stays in the schema, empty).\n   * `tone`: a CSS colour or `var(...)` that sets the type apart: a Typed block of this type gets `data-block-type-tone` and `--sk-block-type-tone` on its wrapper\n   * (a tinted surface and a left border in the tone) and its tree rows tint the type icon with it. Absent: the type looks as before.\n   * `controls: false` makes the chrome of a Typed block of this type read-only although the editor is editable (for a type whose attributes a\n   * host guard refuses to change): no basket menu, status menu, title-visibility toggle, tag editing or drag handle on the type icon, and a\n   * read-only details popover; an existing basket, status and tags still show as chips. Default `true`.\n   */\n  chrome?: { tags?: boolean, tone?: string, controls?: boolean }\n}\n\n/** The Property definitions of `type` (its `properties` capability); none when it does not list the capability. */\nexport const propertiesOf = (type: BlockTypeData): readonly PropertyDefinition[] => blockTypeConfigOf<PropertiesConfig>(type, 'properties')?.definitions ?? []\n\n/** The media block types `type`'s source may be (its `source` capability); undefined when it keeps no source. */\nexport const sourceMediaOf = (type: BlockTypeData): readonly SourceMedia[] | undefined => blockTypeConfigOf<SourceConfig>(type, 'source')?.media\n\n/** The AI brief of `type` (its `ai-brief` capability); undefined when it has none: the AI fill of a Typed block is not offered for it. */\nexport const aiBriefOf = (type: BlockTypeData): BlockTypeAi | undefined => blockTypeConfigOf<BlockTypeAi>(type, 'ai-brief')\n\n/** The Block types as the AI chat model learns them: id, label, Property definitions as fields and the `ai-brief` purpose. The editor's `aiContext` and the server's own resolution (`EditorServerOptions.blockTypes`) both build it here. */\nexport const aiBlockTypesOf = (blockTypes: readonly BlockType[]): AiContextBlockType[] =>\n  blockTypes.map((type) => {\n    const purpose = aiBriefOf(type)?.purpose\n    return { id: type.id, label: type.label, fields: propertiesOf(type), ...(purpose && { purpose }) }\n  })\n\n/** The nested Typed blocks `type` accepts (the `accepts` of its `container` config); undefined: none. */\nexport const acceptsOf = (type: BlockTypeData): readonly string[] | 'all' | undefined => blockTypeConfigOf<ContainerConfig>(type, 'container')?.accepts\n\n/** Whether the nested Typed blocks of `type` follow its own content (the `nestedAfterContent` of its `container` config). */\nexport const nestedAfterContentOf = (type: BlockTypeData): boolean => blockTypeConfigOf<ContainerConfig>(type, 'container')?.nestedAfterContent === true\n\n/** Whether `type` stands for the file of a document tree (the `root` of its `container` config): the Block type of the store's document rows. */\nexport const isRootBlockType = (type: BlockTypeData): boolean => blockTypeConfigOf<ContainerConfig>(type, 'container')?.root === true\n\n/**\n * The built-in Block types in the language of `t`. The default set is produced from the translator (labels, placeholders, property\n * labels and status choices are catalog messages), so it is built per translator and memoized; hosts that pass their own\n * types (`compositeFeature({ blockTypes })`, `Composite.configure({ blockTypes })`) keep their labels untouched. Ids, property keys and\n * stored values (`open`, `doing`, `done`) do not depend on the language.\n */\nexport function defaultBlockTypes(t: Translate): readonly BlockType[] {\n  let blockTypes = DEFAULT_BLOCK_TYPES.get(t)\n  if (!blockTypes) DEFAULT_BLOCK_TYPES.set(t, blockTypes = buildDefaultBlockTypes(t))\n  return blockTypes\n}\n\nconst DEFAULT_BLOCK_TYPES = new WeakMap<Translate, readonly BlockType[]>()\n\nconst container = (accepts: ContainerConfig['accepts'], extra: Omit<ContainerConfig, 'accepts'> = {}): BlockTypeCapability => ({ id: 'container', config: { accepts, ...extra } satisfies ContainerConfig })\nconst properties = (definitions: PropertyDefinition[]): BlockTypeCapability => ({ id: 'properties', config: { definitions } satisfies PropertiesConfig })\nconst source = (...media: SourceMedia[]): BlockTypeCapability => ({ id: 'source', config: { media } satisfies SourceConfig })\nconst aiBrief = (config: BlockTypeAi): BlockTypeCapability => ({ id: 'ai-brief', config })\nconst importing = (...media: SourceMedia[]): BlockTypeCapability => ({ id: 'import', config: { media } satisfies ImportConfig })\nconst EXPORT: BlockTypeCapability = { id: 'export' }\nconst BIBLIOGRAPHY: BlockTypeCapability = { id: 'bibliography' }\nconst BASKET: BlockTypeCapability = { id: 'basket' }\n\nfunction buildDefaultBlockTypes(t: Translate): readonly BlockType[] {\n  const presentation = (id: 'section' | 'task' | 'note' | 'document' | 'recording' | 'paper' | 'book' | 'figure' | 'rendition' | 'folder') => ({\n    id,\n    label: t(`composites.kind.${id}.label`),\n    titlePlaceholder: t(`composites.kind.${id}.title`),\n    descriptionPlaceholder: t(`composites.kind.${id}.description`),\n  })\n  return [\n    { ...presentation('section'), icon: 'i-lucide-layers', capabilities: [container('all'), BASKET] },\n    { ...presentation('task'), icon: 'i-lucide-square-check', capabilities: [BASKET, properties([\n      { key: 'status', label: t('composites.kind.task.field.status'), type: 'select', options: [\n        { value: 'open', label: t('composites.kind.task.status.open') },\n        { value: 'doing', label: t('composites.kind.task.status.doing') },\n        { value: 'done', label: t('composites.kind.task.status.done') },\n      ] },\n      { key: 'due', label: t('composites.kind.task.field.due'), type: 'date' },\n      { key: 'assignee', label: t('composites.kind.task.field.assignee'), type: 'text' },\n    ])] },\n    // i18n-ignore: model-facing kind purpose (German prompt text, not UI)\n    { ...presentation('note'), icon: 'i-lucide-sticky-note', capabilities: [BASKET, aiBrief({ purpose: 'Eigene Notiz zu einer Quelle oder einem Thema: Zusammenfassung, Gedanken, offene Fragen.' })] },\n    { ...presentation('document'), icon: 'i-lucide-file-text', capabilities: [container('all', { root: true }), source(...SOURCE_MEDIA_TYPES), importing(), EXPORT, BASKET, properties([\n      { key: 'filename', label: t('composites.kind.document.field.filename'), type: 'text' },\n      { key: 'mimeType', label: t('composites.kind.document.field.mimeType'), type: 'text' },\n      { key: 'size', label: t('composites.kind.document.field.size'), type: 'number' },\n      { key: 'importedAt', label: t('composites.kind.document.field.importedAt'), type: 'date' },\n    ])] },\n    // i18n-ignore-start: model-facing kind purposes and instructions (German prompt text, not UI)\n    { ...presentation('recording'), icon: 'i-lucide-mic', capabilities: [container('all'), source('audio', 'video'), importing('audio', 'video'), BASKET, properties([\n      ...importProperties(t, 'recording'),\n      { key: 'recordedAt', label: t('composites.kind.recording.field.recordedAt'), type: 'date' },\n      { key: 'participants', label: t('composites.kind.recording.field.participants'), type: 'text' },\n      { key: 'durationSeconds', label: t('composites.kind.recording.field.durationSeconds'), type: 'number' },\n    ]), aiBrief({ purpose: 'Aufnahme (Audio oder Video) als Quelle; der Inhalt hält lesbare Fassungen wie das Transkript und eigene Notizen.' })] },\n    { ...presentation('paper'), icon: 'i-lucide-scroll-text', capabilities: [container('all'), source('file'), BIBLIOGRAPHY, BASKET, properties([\n      ...importProperties(t, 'paper'),\n      { key: 'bib', label: t('composites.kind.paper.field.bib'), type: 'bibliography' },\n      { key: 'doi', label: t('composites.kind.paper.field.doi'), type: 'text' },\n    ]), aiBrief({ purpose: 'Wissenschaftliche Arbeit als Quelle (PDF) mit Literaturangabe; der Inhalt hält Volltext, Zusammenfassungen und Notizen.' })] },\n    { ...presentation('book'), icon: 'i-lucide-book', capabilities: [container('all'), source('file'), BIBLIOGRAPHY, BASKET, properties([\n      ...importProperties(t, 'book'),\n      { key: 'bib', label: t('composites.kind.book.field.bib'), type: 'bibliography' },\n      { key: 'isbn', label: t('composites.kind.book.field.isbn'), type: 'text' },\n    ]), aiBrief({ purpose: 'Buch als Quelle (PDF) mit Literaturangabe; der Inhalt hält den Volltext, gegliedert in Kapitel, und Notizen.' })] },\n    { ...presentation('figure'), icon: 'i-lucide-image', capabilities: [container('all'), source('image'), importing('image'), BASKET, properties([\n      ...importProperties(t, 'figure'),\n      { key: 'credit', label: t('composites.kind.figure.field.credit'), type: 'text' },\n    ]), aiBrief({ purpose: 'Bild als Quelle; der Inhalt hält die Bildbeschreibung und eigene Notizen.' })] },\n    { ...presentation('rendition'), icon: 'i-lucide-captions', capabilities: [container('all'), BASKET, properties([\n      { key: 'derivation', label: t('composites.kind.rendition.field.derivation'), type: 'derivation' },\n      { key: 'language', label: t('composites.kind.rendition.field.language'), type: 'text' },\n    ]), aiBrief({\n      purpose: 'Lesbare Fassung einer Quelle (Transkript, Volltext, Beschreibung, Übersetzung)',\n      instructions: 'Übertrage den Inhalt vollständig und gut lesbar; nichts weglassen, nichts hinzuerfinden.',\n    })] },\n    // i18n-ignore-end\n    { ...presentation('folder'), icon: 'i-lucide-folder', capabilities: [container('all'), BASKET] },\n  ]\n}\n\n/** The four Property definitions the import of a file fills in (`wrapImport` of `composite-media`), shared by every source-holding Block type. */\nfunction importProperties(t: Translate, type: 'recording' | 'paper' | 'book' | 'figure'): PropertyDefinition[] {\n  return [\n    { key: 'filename', label: t(`composites.kind.${type}.field.filename`), type: 'text' },\n    { key: 'mimeType', label: t(`composites.kind.${type}.field.mimeType`), type: 'text' },\n    { key: 'size', label: t(`composites.kind.${type}.field.size`), type: 'number' },\n    { key: 'importedAt', label: t(`composites.kind.${type}.field.importedAt`), type: 'date' },\n  ]\n}\n\n/** The built-in Block types in the default language, for server-side and context-free code (`Composite`'s default option, an editor without a context). */\nexport const fallbackBlockTypes = (): readonly BlockType[] => defaultBlockTypes(DEFAULT_TRANSLATE)\n\nconst DEFAULT_TRANSLATE = createTranslator()\n\n/** Block type `id` from `blockTypes`; an unknown id gets the `section` type's presentation (else the first type's) under its own id and label. */\nexport function blockTypeOf(blockTypes: readonly BlockType[], id: string): BlockType {\n  const known = blockTypes.find(type => type.id === id)\n  if (known) return known\n  const base = blockTypes.find(type => type.id === 'section') ?? blockTypes[0] ?? fallbackBlockTypes()[0]!\n  return { ...base, id, label: id }\n}\n\n/**\n * Whether a Typed block of type `parentType` accepts one of type `childType` as nested Typed block. The `accepts` of the type's\n * `container` config in `blockTypes` decides; without one (or for a type `blockTypes` does not list) it accepts none. The built-in Folder and\n * Document types declare `accepts: 'all'` themselves.\n */\nexport function acceptsChild(blockTypes: readonly BlockType[], parentType: string, childType: string): boolean {\n  const type = blockTypes.find(candidate => candidate.id === parentType)\n  const accepts = type && acceptsOf(type)\n  if (accepts === undefined) return false\n  return accepts === 'all' || accepts.includes(childType)\n}\n\n/** Whether a Typed block of type `parentType` accepts at least one Block type an imported file can become (one that lists `import`), i.e. whether files can be imported into it. */\nexport function acceptsImport(blockTypes: readonly BlockType[], parentType: string): boolean {\n  return blockTypes.some(type => listsCapability(type, 'import') && acceptsChild(blockTypes, parentType, type.id))\n}\n\n/**\n * The Block type an imported file of media `media` (null: text, Markdown or another file the media pipeline does not know) becomes:\n * the first type in `blockTypes` whose `import` capability names `media`, else the first that lists `import` without media (the\n * catch-all). Undefined when no type takes the file; the import then inserts its blocks as they are.\n */\nexport function importTypeOf(blockTypes: readonly BlockType[], media: SourceMedia | null): string | undefined {\n  const importing = blockTypes.filter(type => listsCapability(type, 'import'))\n  const named = media && importing.find(type => blockTypeConfigOf<ImportConfig>(type, 'import')?.media?.includes(media))\n  return (named ?? importing.find(type => !blockTypeConfigOf<ImportConfig>(type, 'import')?.media?.length))?.id\n}\n"],"mappings":"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"}

package/dist/features/composites/capabilities.js

@@ -0,0 +1,109 @@
+import { isBlockContainer } from "../../core/schema/node-flags.js";
+import { listsCapability } from "../../core/capabilities.js";
+import { DERIVATION_KEY, derivationOf } from "../../core/derivation.js";
+import { PROPERTY_TYPES } from "../../core/properties.js";
+import { SOURCE_MEDIA_TYPES } from "./block-types.js";
+import { BASKET_KEY } from "./meta-keys.js";
+import { basketOf } from "./baskets.js";
+import { bibOf } from "./bibliography.js";
+import { sourceIn } from "./source.js";
+import { carriesProperties } from "./properties.js";
+import { z } from "zod";
+//#region src/features/composites/capabilities.ts
+const propertyDefinitionSchema = z.strictObject({
+	key: z.string().min(1),
+	label: z.string(),
+	type: z.enum(PROPERTY_TYPES),
+	options: z.array(z.strictObject({
+		value: z.string(),
+		label: z.string()
+	})).optional(),
+	targets: z.array(z.string()).optional()
+}).superRefine((definition, ctx) => {
+	if (definition.type === "multiselect" && !definition.options?.length) ctx.addIssue({
+		code: "custom",
+		message: "a multiselect property needs options",
+		path: ["options"]
+	});
+});
+const propertiesConfigSchema = z.strictObject({ definitions: z.array(propertyDefinitionSchema) });
+const sourceConfigSchema = z.strictObject({ media: z.array(z.enum(SOURCE_MEDIA_TYPES)).min(1) });
+const importConfigSchema = z.strictObject({ media: z.array(z.enum(SOURCE_MEDIA_TYPES)).optional() });
+const aiBriefConfigSchema = z.strictObject({
+	purpose: z.string(),
+	instructions: z.string().optional(),
+	instructionsField: z.string().optional(),
+	contentTemplate: z.string().optional()
+});
+/**
+* The capabilities of the composites feature, in the order Block types usually list them. None is structural: each applies to a
+* Typed block whose Block type lists it (`references` also to one with a `reference` property), and only to a node that can hold
+* its data (`meta` attribute, container body).
+*/
+function compositeBlockCapabilities() {
+	return [
+		{
+			id: "properties",
+			configSchema: propertiesConfigSchema,
+			appliesTo: (node, ctx) => carriesProperties(node) && listsCapability(ctx.blockTypeOf(node), "properties"),
+			read: (node, ctx) => {
+				const definitions = ctx.configOf(node, "properties")?.definitions ?? [];
+				const meta = node.attrs.meta;
+				if (!meta || typeof meta !== "object") return {};
+				return Object.fromEntries(definitions.flatMap(({ key }) => key in meta ? [[key, meta[key]]] : []));
+			}
+		},
+		{
+			id: "source",
+			configSchema: sourceConfigSchema,
+			appliesTo: (node, ctx) => isBlockContainer(node) && listsCapability(ctx.blockTypeOf(node), "source"),
+			read: (node, ctx) => {
+				const media = ctx.configOf(node, "source")?.media;
+				return media ? sourceIn(node, media) : null;
+			},
+			storage: { childTypes: SOURCE_MEDIA_TYPES }
+		},
+		{
+			id: "bibliography",
+			appliesTo: (node, ctx) => carriesProperties(node) && listsCapability(ctx.blockTypeOf(node), "bibliography"),
+			read: (node) => bibOf(node),
+			storage: { metaKeys: ["bib"] }
+		},
+		{
+			id: "basket",
+			appliesTo: (node, ctx) => carriesProperties(node) && listsCapability(ctx.blockTypeOf(node), "basket"),
+			read: (node) => basketOf(node),
+			storage: { metaKeys: [BASKET_KEY] }
+		},
+		{
+			id: "ai-brief",
+			configSchema: aiBriefConfigSchema,
+			appliesTo: (node, ctx) => listsCapability(ctx.blockTypeOf(node), "ai-brief")
+		},
+		{
+			id: "references",
+			appliesTo: (node, ctx) => carriesProperties(node) && (listsCapability(ctx.blockTypeOf(node), "references") || (ctx.configOf(node, "properties")?.definitions.some((definition) => definition.type === "reference") ?? false)),
+			storage: { childTypes: ["reference"] }
+		},
+		{
+			id: "import",
+			configSchema: importConfigSchema,
+			appliesTo: (node, ctx) => isBlockContainer(node) && listsCapability(ctx.blockTypeOf(node), "import")
+		},
+		{
+			id: "export",
+			appliesTo: (node, ctx) => isBlockContainer(node) && listsCapability(ctx.blockTypeOf(node), "export")
+		},
+		{
+			id: "derived",
+			perNode: true,
+			appliesTo: (node) => carriesProperties(node) && derivationOf(node) !== null,
+			read: (node) => derivationOf(node),
+			storage: { metaKeys: [DERIVATION_KEY] }
+		}
+	];
+}
+//#endregion
+export { compositeBlockCapabilities };
+
+//# sourceMappingURL=capabilities.js.map

package/dist/features/composites/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","names":[],"sources":["../../../src/features/composites/capabilities.ts"],"sourcesContent":["// Vue-free and server-importable: the block capabilities the composites feature owns. A Block type (`block-types.ts`) lists them\n// with their config; each answers \"does a Typed block of this type have it\" from the type alone (`appliesTo` is memoised per\n// node type and Block type id) and, where there is per-block data, reads it through `read`: the source child, the basket, the\n// bibliography record, the Block properties. The capability describes; the node, the node views and the commands stay with the feature.\nimport { z } from 'zod'\nimport { type BlockCapability, listsCapability } from '../../core/capabilities'\nimport { isBlockContainer } from '../../core/schema/node-flags'\nimport { basketOf } from './baskets'\nimport { bibOf } from './bibliography'\nimport { type ImportConfig, type PropertiesConfig, type SourceConfig, SOURCE_MEDIA_TYPES } from './block-types'\nimport { derivationOf } from '../../core/derivation'\nimport { PROPERTY_TYPES, type PropertyDefinition } from '../../core/properties'\nimport { sourceIn } from './source'\nimport { BASKET_KEY, BIB_KEY, DERIVATION_KEY } from './meta-keys'\nimport { carriesProperties } from './properties'\n\nconst propertyDefinitionSchema: z.ZodType<PropertyDefinition> = z.strictObject({\n  key: z.string().min(1),\n  label: z.string(),\n  type: z.enum(PROPERTY_TYPES),\n  options: z.array(z.strictObject({ value: z.string(), label: z.string() })).optional(),\n  targets: z.array(z.string()).optional(),\n}).superRefine((definition, ctx) => {\n  // i18n-ignore: developer-facing Block type config error, not UI text\n  if (definition.type === 'multiselect' && !definition.options?.length) ctx.addIssue({ code: 'custom', message: 'a multiselect property needs options', path: ['options'] })\n})\n\nconst propertiesConfigSchema: z.ZodType<PropertiesConfig> = z.strictObject({ definitions: z.array(propertyDefinitionSchema) })\n\nconst sourceConfigSchema: z.ZodType<SourceConfig> = z.strictObject({ media: z.array(z.enum(SOURCE_MEDIA_TYPES)).min(1) })\n\nconst importConfigSchema: z.ZodType<ImportConfig> = z.strictObject({ media: z.array(z.enum(SOURCE_MEDIA_TYPES)).optional() })\n\nconst aiBriefConfigSchema = z.strictObject({\n  purpose: z.string(),\n  instructions: z.string().optional(),\n  instructionsField: z.string().optional(),\n  contentTemplate: z.string().optional(),\n})\n\n/**\n * The capabilities of the composites feature, in the order Block types usually list them. None is structural: each applies to a\n * Typed block whose Block type lists it (`references` also to one with a `reference` property), and only to a node that can hold\n * its data (`meta` attribute, container body).\n */\nexport function compositeBlockCapabilities(): BlockCapability[] {\n  return [\n    {\n      id: 'properties',\n      configSchema: propertiesConfigSchema,\n      // The node type carries property values (`meta` attribute, whatever it is called) and the Block type declares Property definitions;\n      // the Block properties are the `meta` values of the keys the definitions name.\n      appliesTo: (node, ctx) => carriesProperties(node) && listsCapability(ctx.blockTypeOf(node), 'properties'),\n      read: (node, ctx) => {\n        const definitions = ctx.configOf<PropertiesConfig>(node, 'properties')?.definitions ?? []\n        const meta: unknown = node.attrs.meta\n        if (!meta || typeof meta !== 'object') return {}\n        return Object.fromEntries(definitions.flatMap(({ key }) => key in meta ? [[key, (meta as Record<string, unknown>)[key]]] : []))\n      },\n    },\n    {\n      id: 'source',\n      configSchema: sourceConfigSchema,\n      // The Typed block holds its original as a media block in the body, so the type must give it a container body.\n      appliesTo: (node, ctx) => isBlockContainer(node) && listsCapability(ctx.blockTypeOf(node), 'source'),\n      // The source block itself (with its asset and hash), or null while the body holds none: the capability is the type's, the child is the block's.\n      read: (node, ctx) => {\n        const media = ctx.configOf<SourceConfig>(node, 'source')?.media\n        return media ? sourceIn(node, media) : null\n      },\n      storage: { childTypes: SOURCE_MEDIA_TYPES },\n    },\n    {\n      id: 'bibliography',\n      appliesTo: (node, ctx) => carriesProperties(node) && listsCapability(ctx.blockTypeOf(node), 'bibliography'),\n      // The CSL-JSON item, or null while the block has none.\n      read: node => bibOf(node),\n      storage: { metaKeys: [BIB_KEY] },\n    },\n    {\n      id: 'basket',\n      appliesTo: (node, ctx) => carriesProperties(node) && listsCapability(ctx.blockTypeOf(node), 'basket'),\n      // The id of the basket the block is in, or null.\n      read: node => basketOf(node),\n      storage: { metaKeys: [BASKET_KEY] },\n    },\n    {\n      id: 'ai-brief',\n      configSchema: aiBriefConfigSchema,\n      appliesTo: (node, ctx) => listsCapability(ctx.blockTypeOf(node), 'ai-brief'),\n    },\n    {\n      id: 'references',\n      // Listed explicitly, or implied by a property that points to another Typed block.\n      appliesTo: (node, ctx) => carriesProperties(node) && (listsCapability(ctx.blockTypeOf(node), 'references') || (ctx.configOf<PropertiesConfig>(node, 'properties')?.definitions.some(definition => definition.type === 'reference') ?? false)),\n      storage: { childTypes: ['reference'] },\n    },\n    {\n      id: 'import',\n      configSchema: importConfigSchema,\n      // An imported file's blocks go into the container body of a Typed block of this type, which keeps the file's name, type and size as Block properties.\n      appliesTo: (node, ctx) => isBlockContainer(node) && listsCapability(ctx.blockTypeOf(node), 'import'),\n    },\n    {\n      id: 'export',\n      // The Typed block's contents can be downloaded as a Markdown file (the block action „Exportieren“).\n      appliesTo: (node, ctx) => isBlockContainer(node) && listsCapability(ctx.blockTypeOf(node), 'export'),\n    },\n    {\n      id: 'derived',\n      // The block was made from another block or an asset (`meta.derivation`). Read from the node, not from the Block type: any Typed block can be derived.\n      perNode: true,\n      appliesTo: node => carriesProperties(node) && derivationOf(node) !== null,\n      // The Derivation: method, original (asset name or block id), model, time and hashes. Where the original is now is `derivationState` / `derivedOf`.\n      read: node => derivationOf(node),\n      storage: { metaKeys: [DERIVATION_KEY] },\n    },\n  ]\n}\n"],"mappings":"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"}