@powerhousedao/powerhouse-vetra-packages 6.1.0-dev.2 → 6.1.0-dev.21

package/dist/browser/{dist-DQgJ8n4d.js → document-drive-oqv68jDU.js}

@@ -1,5 +1,4 @@
-import { a as boolean, c as literal, f as string, g as ZodError, i as array, l as number, m as unknown, p as union, r as any, s as lazy, t as _enum, u as object, w as __toESM, x as __commonJSMin } from "./schemas-Bqem6NRm.js";
-import { r as pascalCase } from "./dist-BXygvBtd.js";
+import { E as __commonJSMin, _ as string, c as any, f as lazy, h as object, k as __toESM, l as array, m as number, n as constantCase, o as _enum, p as literal, r as pascalCase, u as boolean, v as union, x as ZodError, y as unknown } from "./dist-CXoKspdx.js";
 //#endregion
 //#region ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/esm/wrapper.js
 var import_safe_stable_stringify = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -590,7 +589,7 @@ function isBE() {
 	return new Uint8Array(new Uint16Array([65279]).buffer)[0] === 254;
 }
 //#endregion
-//#region ../shared/dist/utils-bCWnsmtD.js
+//#region ../shared/dist/utils-DKOFCM0Q.js
 const hashBrowser = (data, algorithm = "sha1", encoding = "base64", _params) => {
 	if (!["sha1"].includes(algorithm)) throw new Error(`Hashing algorithm not supported: "${algorithm}". Available: sha1`);
 	if (!["base64", "hex"].includes(encoding)) throw new Error(`Hash encoding not supported: "${encoding}". Available: base64, hex`);
@@ -4368,16 +4367,72 @@ function isDocumentAction(action) {
 	].includes(action.type);
 }
 /**
-* Important note: it is the responsibility of the caller to set the document type
-* on the header.
+* The document-scope operations a reactor mints on `create`, so a standalone
+* document carries its initial state when exported outside a reactor.
 */
-function baseCreateDocument(createState, initialState) {
+function createDocumentScopeOperations(header, state) {
+	const createInput = {
+		model: header.documentType,
+		version: 0,
+		documentId: header.id,
+		signing: {
+			signature: header.id,
+			publicKey: header.sig.publicKey,
+			nonce: header.sig.nonce,
+			createdAtUtcIso: header.createdAtUtcIso,
+			documentType: header.documentType
+		},
+		slug: header.slug,
+		name: header.name,
+		branch: header.branch,
+		meta: header.meta,
+		protocolVersions: header.protocolVersions ?? { "base-reducer": 2 }
+	};
+	const upgradeInput = {
+		model: header.documentType,
+		fromVersion: 0,
+		toVersion: state.document.version,
+		documentId: header.id,
+		initialState: state
+	};
+	return [{
+		id: generateId(),
+		type: "CREATE_DOCUMENT",
+		scope: "document",
+		timestampUtcMs: header.createdAtUtcIso,
+		input: createInput
+	}, {
+		id: generateId(),
+		type: "UPGRADE_DOCUMENT",
+		scope: "document",
+		timestampUtcMs: header.createdAtUtcIso,
+		input: upgradeInput
+	}].map((action, index) => ({
+		...action,
+		action,
+		id: deriveOperationId(header.id, "document", header.branch, action.id),
+		hash: "",
+		error: void 0,
+		index,
+		skip: 0
+	}));
+}
+/**
+* Creates a new document. When `documentType` is given the header is stamped
+* with it and the document-scope operations are seeded.
+*/
+function baseCreateDocument(createState, initialState, documentType = "") {
 	const state = createState(initialState);
+	const header = createPresignedHeader(generateId(), documentType);
 	return {
-		header: createPresignedHeader(),
+		header,
 		state,
 		initialState: state,
-		operations: {
+		operations: documentType ? {
+			global: [],
+			local: [],
+			document: createDocumentScopeOperations(header, state)
+		} : {
 			global: [],
 			local: []
 		},
@@ -5075,6 +5130,15 @@ const RESERVED_OPERATION_NAMES = [
 	"NOOP"
 ];
 /**
+* Operation names become the literal action `type` string at runtime and the
+* key for codegen's action union. They must be SCREAMING_SNAKE_CASE so the
+* generated TypeScript is valid.
+*/
+const OPERATION_NAME_PATTERN = /^[A-Z][A-Z0-9_]*$/;
+function isValidOperationNameFormat(name) {
+	return OPERATION_NAME_PATTERN.test(name);
+}
+/**
 * Check if name conflicts with base reducer actions (case-insensitive).
 */
 function isReservedOperationName(name) {
@@ -5104,6 +5168,11 @@ function getAllOperationNames(state, excludeOperationId) {
 */
 function validateOperationName(name, state, excludeOperationId) {
 	if (!name) return;
+	if (!isValidOperationNameFormat(name)) {
+		const suggestion = constantCase(name);
+		const hint = suggestion && suggestion !== name && isValidOperationNameFormat(suggestion) ? ` Did you mean "${suggestion}"?` : "";
+		throw new Error(`Operation name "${name}" is invalid. Names must be SCREAMING_SNAKE_CASE (matching ${OPERATION_NAME_PATTERN.source}).${hint}`);
+	}
 	const upperName = name.toUpperCase();
 	if (isReservedOperationName(name)) throw new Error(`Operation name "${name}" is reserved. Please use a different name.`);
 	if (getAllOperationNames(state, excludeOperationId).includes(upperName)) throw new Error(`Operation name "${name}" is already used by another operation. Operation names must be unique across all modules.`);
@@ -5199,6 +5268,60 @@ function findOperationOrThrow(state, operationId) {
 	}
 	throw new Error(`Operation "${operationId}" not found in the latest specification`);
 }
+/**
+* Find an operation error by id across all operations in the latest
+* specification, or throw. Throws on a duplicate id too: setters act on a
+* single error, so an ambiguous id must fail loudly rather than mutate an
+* arbitrary match.
+*/
+function findOperationErrorOrThrow(state, errorId) {
+	const matches = state.specifications[state.specifications.length - 1]?.modules.flatMap((mod) => mod.operations.flatMap((op) => op.errors.filter((e) => e.id === errorId))) ?? [];
+	if (matches.length === 0) throw new Error(`Operation error "${errorId}" not found in the latest specification`);
+	if (matches.length > 1) throw new Error(`Operation error "${errorId}" is duplicated in the latest specification`);
+	return matches[0];
+}
+/**
+* Find an operation example (code example) by id across all operations in the
+* latest specification, or throw. Throws on a duplicate id for the same reason
+* as findOperationErrorOrThrow.
+*/
+function findOperationExampleOrThrow(state, exampleId) {
+	const matches = state.specifications[state.specifications.length - 1]?.modules.flatMap((mod) => mod.operations.flatMap((op) => op.examples.filter((e) => e.id === exampleId))) ?? [];
+	if (matches.length === 0) throw new Error(`Operation example "${exampleId}" not found in the latest specification`);
+	if (matches.length > 1) throw new Error(`Operation example "${exampleId}" is duplicated in the latest specification`);
+	return matches[0];
+}
+/**
+* Assert no module in the latest specification already uses `id`. Modules are
+* targeted by id by the setter/delete/reorder reducers, so a duplicate id makes
+* those operations ambiguous.
+*/
+function assertModuleIdUnique(state, id) {
+	if (state.specifications[state.specifications.length - 1]?.modules.some((m) => m.id === id)) throw new Error(`Module "${id}" already exists in the latest specification`);
+}
+/**
+* Assert no operation in the latest specification already uses `id`. Operations
+* are targeted by id across all modules, so the id must be unique document-wide.
+*/
+function assertOperationIdUnique(state, id) {
+	if (state.specifications[state.specifications.length - 1]?.modules.some((m) => m.operations.some((o) => o.id === id))) throw new Error(`Operation "${id}" already exists in the latest specification`);
+}
+/**
+* Assert no operation error in the latest specification already uses `id`.
+* Error ids are targeted document-wide by the setter/delete reducers, so the id
+* must be unique to keep those operations unambiguous.
+*/
+function assertOperationErrorIdUnique(state, id) {
+	if (state.specifications[state.specifications.length - 1]?.modules.some((m) => m.operations.some((o) => o.errors.some((e) => e.id === id)))) throw new Error(`Operation error "${id}" already exists in the latest specification`);
+}
+/**
+* Assert no operation example in the latest specification already uses `id`.
+* Example ids are targeted document-wide by the update/delete reducers, so the
+* id must be unique to keep those operations unambiguous.
+*/
+function assertOperationExampleIdUnique(state, id) {
+	if (state.specifications[state.specifications.length - 1]?.modules.some((m) => m.operations.some((o) => o.examples.some((e) => e.id === id)))) throw new Error(`Operation example "${id}" already exists in the latest specification`);
+}
 function validateOperations(operations) {
 	const errors = [];
 	const scopes = Object.keys(operations);
@@ -5221,10 +5344,22 @@ function validateOperations(operations) {
 	}
 	return errors;
 }
-function sorter(order) {
-	const mapping = {};
-	order.forEach((key, index) => mapping[key] = index);
-	return (a, b) => (mapping[b.id] || 999999) - (mapping[a.id] || 999999);
+/**
+* Reorder `items` by the position of their id in `order`. Ids not listed in
+* `order` keep their relative position after the listed ones. Throws if `order`
+* references an id that isn't present, so a stale or mistyped id fails loudly
+* instead of silently producing an arbitrary order.
+*/
+function orderBy(items, order) {
+	const ids = new Set(items.map((item) => item.id));
+	for (const id of order) if (!ids.has(id)) throw new Error(`Cannot reorder: unknown id "${id}"`);
+	const rank = new Map(order.map((id, index) => [id, index]));
+	return items.map((item, index) => ({
+		item,
+		index
+	})).sort((a, b) => {
+		return (rank.get(a.item.id) ?? Number.MAX_SAFE_INTEGER) - (rank.get(b.item.id) ?? Number.MAX_SAFE_INTEGER) || a.index - b.index;
+	}).map(({ item }) => item);
 }
 const documentModelHeaderReducer = {
 	setModelNameOperation(state, action) {
@@ -5256,6 +5391,7 @@ const documentModelHeaderReducer = {
 };
 const documentModelModuleReducer = {
 	addModuleOperation(state, action) {
+		assertModuleIdUnique(state, action.input.id);
 		state.specifications[state.specifications.length - 1].modules.push({
 			id: action.input.id,
 			name: action.input.name,
@@ -5264,24 +5400,28 @@ const documentModelModuleReducer = {
 		});
 	},
 	setModuleNameOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) if (latestSpec.modules[i].id === action.input.id) latestSpec.modules[i].name = action.input.name || "";
+		const targetModule = findModuleOrThrow(state, action.input.id);
+		targetModule.name = action.input.name || "";
 	},
 	setModuleDescriptionOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) if (latestSpec.modules[i].id === action.input.id) latestSpec.modules[i].description = action.input.description || "";
+		const targetModule = findModuleOrThrow(state, action.input.id);
+		targetModule.description = action.input.description || "";
 	},
 	deleteModuleOperation(state, action) {
+		findModuleOrThrow(state, action.input.id);
 		const latestSpec = state.specifications[state.specifications.length - 1];
 		latestSpec.modules = latestSpec.modules.filter((m) => m.id != action.input.id);
 	},
 	reorderModulesOperation(state, action) {
-		state.specifications[state.specifications.length - 1].modules.sort(sorter(action.input.order));
+		const latestSpec = state.specifications[state.specifications.length - 1];
+		latestSpec.modules = orderBy(latestSpec.modules, action.input.order);
 	}
 };
 const documentModelOperationErrorReducer = {
 	addOperationErrorOperation(state, action) {
-		findOperationOrThrow(state, action.input.operationId).errors.push({
+		const targetOp = findOperationOrThrow(state, action.input.operationId);
+		assertOperationErrorIdUnique(state, action.input.id);
+		targetOp.errors.push({
 			id: action.input.id,
 			name: action.input.errorName || "",
 			code: action.input.errorCode || "",
@@ -5290,54 +5430,58 @@ const documentModelOperationErrorReducer = {
 		});
 	},
 	setOperationErrorCodeOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) for (let k = 0; k < latestSpec.modules[i].operations[j].errors.length; k++) if (latestSpec.modules[i].operations[j].errors[k].id == action.input.id) latestSpec.modules[i].operations[j].errors[k].code = action.input.errorCode || "";
+		const error = findOperationErrorOrThrow(state, action.input.id);
+		error.code = action.input.errorCode || "";
 	},
 	setOperationErrorNameOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) for (let k = 0; k < latestSpec.modules[i].operations[j].errors.length; k++) if (latestSpec.modules[i].operations[j].errors[k].id == action.input.id) latestSpec.modules[i].operations[j].errors[k].name = action.input.errorName || "";
+		const error = findOperationErrorOrThrow(state, action.input.id);
+		error.name = action.input.errorName || "";
 	},
 	setOperationErrorDescriptionOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) for (let k = 0; k < latestSpec.modules[i].operations[j].errors.length; k++) if (latestSpec.modules[i].operations[j].errors[k].id == action.input.id) latestSpec.modules[i].operations[j].errors[k].description = action.input.errorDescription || "";
+		const error = findOperationErrorOrThrow(state, action.input.id);
+		error.description = action.input.errorDescription || "";
 	},
 	setOperationErrorTemplateOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) for (let k = 0; k < latestSpec.modules[i].operations[j].errors.length; k++) if (latestSpec.modules[i].operations[j].errors[k].id == action.input.id) latestSpec.modules[i].operations[j].errors[k].template = action.input.errorTemplate || "";
+		const error = findOperationErrorOrThrow(state, action.input.id);
+		error.template = action.input.errorTemplate || "";
 	},
 	deleteOperationErrorOperation(state, action) {
 		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) latestSpec.modules[i].operations[j].errors = latestSpec.modules[i].operations[j].errors.filter((e) => e.id != action.input.id);
+		if (!latestSpec.modules.some((mod) => mod.operations.some((op) => op.errors.some((e) => e.id === action.input.id)))) throw new Error(`Operation error "${action.input.id}" not found in the latest specification`);
+		for (const mod of latestSpec.modules) for (const op of mod.operations) op.errors = op.errors.filter((e) => e.id != action.input.id);
 	},
 	reorderOperationErrorsOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) if (latestSpec.modules[i].operations[j].id == action.input.operationId) latestSpec.modules[i].operations[j].errors.sort(sorter(action.input.order));
+		const targetOp = findOperationOrThrow(state, action.input.operationId);
+		targetOp.errors = orderBy(targetOp.errors, action.input.order);
 	}
 };
 const documentModelOperationExampleReducer = {
 	addOperationExampleOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) if (latestSpec.modules[i].operations[j].id == action.input.operationId) latestSpec.modules[i].operations[j].examples.push({
+		const targetOp = findOperationOrThrow(state, action.input.operationId);
+		assertOperationExampleIdUnique(state, action.input.id);
+		targetOp.examples.push({
 			id: action.input.id,
 			value: action.input.example
 		});
 	},
 	updateOperationExampleOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) for (let k = 0; k < latestSpec.modules[i].operations[j].examples.length; k++) if (latestSpec.modules[i].operations[j].examples[k].id == action.input.id) latestSpec.modules[i].operations[j].examples[k].value = action.input.example;
+		const example = findOperationExampleOrThrow(state, action.input.id);
+		example.value = action.input.example;
 	},
 	deleteOperationExampleOperation(state, action) {
 		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) latestSpec.modules[i].operations[j].examples = latestSpec.modules[i].operations[j].examples.filter((e) => e.id != action.input.id);
+		if (!latestSpec.modules.some((mod) => mod.operations.some((op) => op.examples.some((e) => e.id === action.input.id)))) throw new Error(`Operation example "${action.input.id}" not found in the latest specification`);
+		for (const mod of latestSpec.modules) for (const op of mod.operations) op.examples = op.examples.filter((e) => e.id != action.input.id);
 	},
 	reorderOperationExamplesOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) if (latestSpec.modules[i].operations[j].id == action.input.operationId) latestSpec.modules[i].operations[j].examples.sort(sorter(action.input.order));
+		const targetOp = findOperationOrThrow(state, action.input.operationId);
+		targetOp.examples = orderBy(targetOp.examples, action.input.order);
 	}
 };
 const documentModelOperationReducer = {
 	addOperationOperation(state, action) {
 		validateOperationName(action.input.name, state);
+		assertOperationIdUnique(state, action.input.id);
 		findModuleOrThrow(state, action.input.moduleId).operations.push({
 			id: action.input.id,
 			name: action.input.name,
@@ -5352,8 +5496,8 @@ const documentModelOperationReducer = {
 	},
 	setOperationNameOperation(state, action) {
 		if (action.input.name) validateOperationName(action.input.name, state, action.input.id);
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) if (latestSpec.modules[i].operations[j].id == action.input.id) latestSpec.modules[i].operations[j].name = action.input.name || "";
+		const targetOp = findOperationOrThrow(state, action.input.id);
+		targetOp.name = action.input.name || "";
 	},
 	setOperationScopeOperation(state, action) {
 		const targetOp = findOperationOrThrow(state, action.input.id);
@@ -5363,40 +5507,39 @@ const documentModelOperationReducer = {
 		targetOp.scope = action.input.scope || "global";
 	},
 	setOperationSchemaOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) if (latestSpec.modules[i].operations[j].id == action.input.id) latestSpec.modules[i].operations[j].schema = action.input.schema || "";
+		const targetOp = findOperationOrThrow(state, action.input.id);
+		targetOp.schema = action.input.schema || "";
 	},
 	setOperationDescriptionOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) if (latestSpec.modules[i].operations[j].id == action.input.id) latestSpec.modules[i].operations[j].description = action.input.description || "";
+		const targetOp = findOperationOrThrow(state, action.input.id);
+		targetOp.description = action.input.description || "";
 	},
 	setOperationTemplateOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) if (latestSpec.modules[i].operations[j].id == action.input.id) latestSpec.modules[i].operations[j].template = action.input.template || "";
+		const targetOp = findOperationOrThrow(state, action.input.id);
+		targetOp.template = action.input.template || "";
 	},
 	setOperationReducerOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) for (let j = 0; j < latestSpec.modules[i].operations.length; j++) if (latestSpec.modules[i].operations[j].id == action.input.id) latestSpec.modules[i].operations[j].reducer = action.input.reducer || "";
+		const targetOp = findOperationOrThrow(state, action.input.id);
+		targetOp.reducer = action.input.reducer || "";
 	},
 	moveOperationOperation(state, action) {
-		const moveOperations = [];
+		const targetModule = findModuleOrThrow(state, action.input.newModuleId);
 		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) latestSpec.modules[i].operations = latestSpec.modules[i].operations.filter((operation) => {
-			if (operation.id == action.input.operationId) {
-				moveOperations.push(operation);
-				return false;
-			}
-			return true;
-		});
-		for (let i = 0; i < latestSpec.modules.length; i++) if (latestSpec.modules[i].id == action.input.newModuleId) latestSpec.modules[i].operations.push(...moveOperations);
+		const matches = latestSpec.modules.flatMap((mod) => mod.operations.filter((op) => op.id === action.input.operationId));
+		if (matches.length === 0) throw new Error(`Operation "${action.input.operationId}" not found in the latest specification`);
+		if (matches.length > 1) throw new Error(`Operation "${action.input.operationId}" is duplicated in the latest specification`);
+		const moved = matches[0];
+		for (const mod of latestSpec.modules) mod.operations = mod.operations.filter((op) => op.id !== action.input.operationId);
+		targetModule.operations.push(moved);
 	},
 	deleteOperationOperation(state, action) {
+		findOperationOrThrow(state, action.input.id);
 		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) latestSpec.modules[i].operations = latestSpec.modules[i].operations.filter((operation) => operation.id != action.input.id);
+		for (const mod of latestSpec.modules) mod.operations = mod.operations.filter((operation) => operation.id != action.input.id);
 	},
 	reorderModuleOperationsOperation(state, action) {
-		const latestSpec = state.specifications[state.specifications.length - 1];
-		for (let i = 0; i < latestSpec.modules.length; i++) if (latestSpec.modules[i].id == action.input.moduleId) latestSpec.modules[i].operations.sort(sorter(action.input.order));
+		const targetModule = findModuleOrThrow(state, action.input.moduleId);
+		targetModule.operations = orderBy(targetModule.operations, action.input.order);
 	}
 };
 const documentModelStateSchemaReducer = {
@@ -5421,18 +5564,22 @@ const documentModelStateSchemaReducer = {
 	updateStateExampleOperation(state, action) {
 		const latestSpec = state.specifications[state.specifications.length - 1];
 		if (!Object.keys(latestSpec.state).includes(action.input.scope)) throw new Error(`Invalid scope: ${action.input.scope}`);
-		const examples = latestSpec.state[action.input.scope].examples;
-		for (let i = 0; i < examples.length; i++) if (examples[i].id == action.input.id) examples[i].value = action.input.newExample;
+		const example = latestSpec.state[action.input.scope].examples.find((e) => e.id == action.input.id);
+		if (!example) throw new Error(`State example "${action.input.id}" not found in scope "${action.input.scope}"`);
+		example.value = action.input.newExample;
 	},
 	deleteStateExampleOperation(state, action) {
 		const latestSpec = state.specifications[state.specifications.length - 1];
-		if (Object.keys(latestSpec.state).includes(action.input.scope)) latestSpec.state[action.input.scope].examples = latestSpec.state[action.input.scope].examples.filter((e) => e.id != action.input.id);
-		else throw new Error(`Invalid scope: ${action.input.scope}`);
+		if (!Object.keys(latestSpec.state).includes(action.input.scope)) throw new Error(`Invalid scope: ${action.input.scope}`);
+		const scopeState = latestSpec.state[action.input.scope];
+		if (!scopeState.examples.some((e) => e.id == action.input.id)) throw new Error(`State example "${action.input.id}" not found in scope "${action.input.scope}"`);
+		scopeState.examples = scopeState.examples.filter((e) => e.id != action.input.id);
 	},
 	reorderStateExamplesOperation(state, action) {
 		const latestSpec = state.specifications[state.specifications.length - 1];
-		if (Object.keys(latestSpec.state).includes(action.input.scope)) latestSpec.state[action.input.scope].examples.sort(sorter(action.input.order));
-		else throw new Error(`Invalid scope: ${action.input.scope}`);
+		if (!Object.keys(latestSpec.state).includes(action.input.scope)) throw new Error(`Invalid scope: ${action.input.scope}`);
+		const scopeState = latestSpec.state[action.input.scope];
+		scopeState.examples = orderBy(scopeState.examples, action.input.order);
 	}
 };
 const documentModelVersioningReducer = {
@@ -5831,6 +5978,211 @@ function createState(baseState, globalState, localState) {
 	};
 }
 //#endregion
+//#region ../document-model/dist/index.js
+const isStateOfType$1 = (state) => {
+	return isDocumentModelState(state);
+};
+const assertIsStateOfType$1 = (state) => {
+	assertIsDocumentModelState(state);
+};
+const isDocumentOfType$1 = (document) => {
+	return isDocumentModelDocument(document);
+};
+const assertIsDocumentOfType$1 = (document) => {
+	assertIsDocumentModelDocument(document);
+};
+const documentModelCreateState = (state) => {
+	return {
+		...defaultBaseState(),
+		global: {
+			...documentModelInitialGlobalState,
+			...state?.global ?? {}
+		},
+		local: {
+			...documentModelInitialLocalState,
+			...state?.local ?? {}
+		}
+	};
+};
+function documentModelCreateDocument(state) {
+	return baseCreateDocument(documentModelCreateState, state, documentModelDocumentType);
+}
+const utils = {
+	fileExtension: documentModelFileExtension,
+	createState: documentModelCreateState,
+	createDocument: documentModelCreateDocument,
+	loadFromInput: documentModelLoadFromInput,
+	saveToFileHandle: documentModelSaveToFileHandle,
+	isStateOfType: isStateOfType$1,
+	assertIsStateOfType: assertIsStateOfType$1,
+	isDocumentOfType: isDocumentOfType$1,
+	assertIsDocumentOfType: assertIsDocumentOfType$1
+};
+const documentModelDocumentModelModule = {
+	reducer: documentModelReducer,
+	documentModel: createState(defaultBaseState(), documentModelGlobalState),
+	actions,
+	utils
+};
+(class PHDocumentController {
+	module;
+	_document;
+	listeners = [];
+	constructor(module, initialDocument) {
+		this.module = module;
+		this._document = initialDocument ?? module.utils.createDocument();
+		for (const actionType in this.module.actions) Object.defineProperty(this, actionType, { value: (input) => {
+			const action = this.module.actions[actionType](input);
+			this._document = this.module.reducer(this._document, action);
+			this.notifyListeners();
+			return this;
+		} });
+	}
+	get document() {
+		return this._document;
+	}
+	get header() {
+		return this.document.header;
+	}
+	get state() {
+		return this.document.state;
+	}
+	get initialState() {
+		return this.document.initialState;
+	}
+	get operations() {
+		return this.document.operations;
+	}
+	get clipboard() {
+		return this.document.clipboard;
+	}
+	onChange(listener) {
+		this.listeners.push(listener);
+		return () => {
+			this.listeners = this.listeners.filter((l) => l !== listener);
+		};
+	}
+	notifyListeners() {
+		if (this.listeners.length === 0) return;
+		const event = { document: this._document };
+		for (const listener of this.listeners) listener(event);
+	}
+	static forDocumentModel(module) {
+		return class extends PHDocumentController {
+			constructor(initialDocument) {
+				super(module, initialDocument);
+			}
+		};
+	}
+}).forDocumentModel(documentModelDocumentModelModule);
+const tokenSub = /@([a-zA-Z0-9_]+)/g;
+const dtf = new Intl.DateTimeFormat(void 0, {
+	hour12: false,
+	hour: "2-digit",
+	minute: "2-digit",
+	second: "2-digit",
+	fractionalSecondDigits: 2
+});
+const stringify = (value, includeStack) => {
+	if (value === null || value === void 0) return "null";
+	if (typeof value === "string") return value;
+	if (value instanceof Error) {
+		const base = `${value.name}: ${value.message}`;
+		return includeStack && value.stack ? `${base}\n${value.stack}` : base;
+	}
+	if (typeof value === "object") try {
+		return JSON.stringify(value);
+	} catch {
+		return Object.prototype.toString.call(value);
+	}
+	if (typeof value === "function") {
+		const name = value.name;
+		return name ? `${name}()` : "anonymous()";
+	}
+	return String(value);
+};
+const formatMessage = (tagString, message, replacements, includeStack) => {
+	const meta = {};
+	const uniqueTokens = [];
+	let results;
+	while ((results = tokenSub.exec(message)) !== null) {
+		const tokenName = results[1];
+		if (uniqueTokens.indexOf(tokenName) === -1) {
+			uniqueTokens.push(tokenName);
+			meta[tokenName] = replacements[uniqueTokens.length - 1];
+		}
+	}
+	for (const [key, value] of Object.entries(meta)) message = message.replaceAll(`@${key}`, stringify(value, includeStack));
+	const extras = replacements.slice(uniqueTokens.length);
+	if (extras.length > 0) message = `${message} ${extras.map((v) => stringify(v, includeStack)).join(" ")}`;
+	if (tagString.length > 0) message = `${tagString} ${message}`;
+	const now = /* @__PURE__ */ new Date();
+	meta["timestamp"] = dtf.format(now);
+	return [message, meta];
+};
+const LOG_LEVELS = {
+	verbose: 0,
+	debug: 1,
+	info: 2,
+	warn: 3,
+	error: 4
+};
+const logger = new class ConsoleLogger {
+	#tags;
+	#tagString;
+	#level = LOG_LEVELS.info;
+	errorHandler;
+	constructor(tags, handler) {
+		this.#tags = tags || [];
+		this.#tagString = this.#tags.map((tag) => `[${tag}]`).join("");
+		this.errorHandler = handler ?? (() => {});
+	}
+	get level() {
+		return Object.keys(LOG_LEVELS).find((key) => LOG_LEVELS[key] === this.#level);
+	}
+	set level(value) {
+		this.#level = LOG_LEVELS[value];
+	}
+	child(tags) {
+		const logger = new ConsoleLogger([...this.#tags, ...tags], this.errorHandler);
+		logger.level = this.level;
+		return logger;
+	}
+	get #includeStack() {
+		return this.#level <= LOG_LEVELS.debug;
+	}
+	verbose(message, ...replacements) {
+		if (this.#level <= LOG_LEVELS.verbose) {
+			const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements, this.#includeStack);
+			console.debug(`[${meta["timestamp"]}] ${formattedMessage}`);
+		}
+	}
+	debug(message, ...replacements) {
+		if (this.#level <= LOG_LEVELS.debug) {
+			const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements, this.#includeStack);
+			console.debug(`[${meta["timestamp"]}] ${formattedMessage}`);
+		}
+	}
+	info(message, ...replacements) {
+		if (this.#level <= LOG_LEVELS.info) {
+			const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements, this.#includeStack);
+			console.info(`[${meta["timestamp"]}] ${formattedMessage}`);
+		}
+	}
+	warn(message, ...replacements) {
+		if (this.#level <= LOG_LEVELS.warn) {
+			const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements, this.#includeStack);
+			console.warn(`[${meta["timestamp"]}] ${formattedMessage}`);
+		}
+	}
+	error(message, ...replacements) {
+		if (this.#level <= LOG_LEVELS.error) {
+			const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements, this.#includeStack);
+			console.error(`[${meta["timestamp"]}] ${formattedMessage}`);
+		}
+	}
+}();
+//#endregion
 //#region ../shared/dist/document-drive/index.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -6436,12 +6788,12 @@ function handleTargetNameCollisions(params) {
 	return targetNodeChildrenNames.includes(srcName) ? `${srcName} (copy) ${getNextCopyNumber(targetNodeChildrenNames, srcName)}` : srcName;
 }
 const isValidName = (name) => {
-	return /^[a-zA-Z0-9-_.\s()]+$/.test(name);
+	return name.trim().length > 0 && !/[\u0000-\u001F\u007F]/.test(name);
 };
 const nodeReducer = {
 	addFileOperation(state, action, dispatch) {
 		if (state.nodes.find((node) => node.id === action.input.id)) throw new Error(`Node with id ${action.input.id} already exists!`);
-		if (!isValidName(action.input.name)) throw new Error(`Invalid name: '${action.input.name}'. Names must be valid URL characters.`);
+		if (!isValidName(action.input.name)) throw new Error(`Invalid name: '${action.input.name}'. Names must not be empty or contain control characters.`);
 		const name = handleTargetNameCollisions({
 			nodes: state.nodes,
 			srcName: action.input.name,
@@ -6467,7 +6819,7 @@ const nodeReducer = {
 	},
 	addFolderOperation(state, action) {
 		if (state.nodes.find((node) => node.id === action.input.id)) throw new Error(`Node with id ${action.input.id} already exists!`);
-		if (!isValidName(action.input.name)) throw new Error(`Invalid name: '${action.input.name}'. Names must be valid URL characters.`);
+		if (!isValidName(action.input.name)) throw new Error(`Invalid name: '${action.input.name}'. Names must not be empty or contain control characters.`);
 		const name = handleTargetNameCollisions({
 			nodes: state.nodes,
 			srcName: action.input.name,
@@ -6495,7 +6847,7 @@ const nodeReducer = {
 		});
 	},
 	updateFileOperation(state, action) {
-		if (action.input.name && !isValidName(action.input.name)) throw new Error(`Invalid name: '${action.input.name}'. Names must be valid URL characters.`);
+		if (action.input.name && !isValidName(action.input.name)) throw new Error(`Invalid name: '${action.input.name}'. Names must not be empty or contain control characters.`);
 		state.nodes = state.nodes.map((node) => node.id === action.input.id ? {
 			...node,
 			name: handleTargetNameCollisions({
@@ -6509,7 +6861,7 @@ const nodeReducer = {
 		state.nodes.sort((a, b) => a.id.localeCompare(b.id));
 	},
 	updateNodeOperation(state, action) {
-		if (action.input.name && !isValidName(action.input.name)) throw new Error(`Invalid name: '${action.input.name}'. Names must be valid URL characters.`);
+		if (action.input.name && !isValidName(action.input.name)) throw new Error(`Invalid name: '${action.input.name}'. Names must not be empty or contain control characters.`);
 		state.nodes = state.nodes.map((node) => node.id === action.input.id ? {
 			...node,
 			name: handleTargetNameCollisions({
@@ -6666,10 +7018,7 @@ const driveCreateState = (state) => {
 	};
 };
 const driveCreateDocument = (state) => {
-	const document = baseCreateDocument(driveCreateState, state);
-	document.header.documentType = driveDocumentType;
-	document.header.id = generateId();
-	return document;
+	return baseCreateDocument(driveCreateState, state, driveDocumentType);
 };
 const driveSaveToFileHandle = (document, input) => {
 	return baseSaveToFileHandle(document, input);
@@ -6677,16 +7026,16 @@ const driveSaveToFileHandle = (document, input) => {
 const driveLoadFromInput = (input) => {
 	return baseLoadFromInput(input, driveDocumentReducer);
 };
-const isStateOfType$1 = (state) => {
+const isStateOfType = (state) => {
 	return isDriveState(state);
 };
-const assertIsStateOfType$1 = (state) => {
+const assertIsStateOfType = (state) => {
 	assertIsDriveState(state);
 };
-const isDocumentOfType$1 = (document) => {
+const isDocumentOfType = (document) => {
 	return isDriveDocument(document);
 };
-const assertIsDocumentOfType$1 = (document) => {
+const assertIsDocumentOfType = (document) => {
 	assertIsDriveDocument(document);
 };
 const driveDocumentModelModule = {
@@ -6699,220 +7048,13 @@ const driveDocumentModelModule = {
 		createDocument: driveCreateDocument,
 		loadFromInput: driveLoadFromInput,
 		saveToFileHandle: driveSaveToFileHandle,
-		isStateOfType: isStateOfType$1,
-		assertIsStateOfType: assertIsStateOfType$1,
-		isDocumentOfType: isDocumentOfType$1,
-		assertIsDocumentOfType: assertIsDocumentOfType$1
+		isStateOfType,
+		assertIsStateOfType,
+		isDocumentOfType,
+		assertIsDocumentOfType
 	}
 };
 //#endregion
-//#region ../document-model/dist/index.js
-const isStateOfType = (state) => {
-	return isDocumentModelState(state);
-};
-const assertIsStateOfType = (state) => {
-	assertIsDocumentModelState(state);
-};
-const isDocumentOfType = (document) => {
-	return isDocumentModelDocument(document);
-};
-const assertIsDocumentOfType = (document) => {
-	assertIsDocumentModelDocument(document);
-};
-const documentModelCreateState = (state) => {
-	return {
-		...defaultBaseState(),
-		global: {
-			...documentModelInitialGlobalState,
-			...state?.global ?? {}
-		},
-		local: {
-			...documentModelInitialLocalState,
-			...state?.local ?? {}
-		}
-	};
-};
-function documentModelCreateDocument(state) {
-	const document = baseCreateDocument(documentModelCreateState, state);
-	document.header.documentType = documentModelDocumentType;
-	return document;
-}
-const utils = {
-	fileExtension: documentModelFileExtension,
-	createState: documentModelCreateState,
-	createDocument: documentModelCreateDocument,
-	loadFromInput: documentModelLoadFromInput,
-	saveToFileHandle: documentModelSaveToFileHandle,
-	isStateOfType,
-	assertIsStateOfType,
-	isDocumentOfType,
-	assertIsDocumentOfType
-};
-const documentModelDocumentModelModule = {
-	reducer: documentModelReducer,
-	documentModel: createState(defaultBaseState(), documentModelGlobalState),
-	actions,
-	utils
-};
-(class PHDocumentController {
-	module;
-	_document;
-	listeners = [];
-	constructor(module, initialDocument) {
-		this.module = module;
-		this._document = initialDocument ?? module.utils.createDocument();
-		for (const actionType in this.module.actions) Object.defineProperty(this, actionType, { value: (input) => {
-			const action = this.module.actions[actionType](input);
-			this._document = this.module.reducer(this._document, action);
-			this.notifyListeners();
-			return this;
-		} });
-	}
-	get document() {
-		return this._document;
-	}
-	get header() {
-		return this.document.header;
-	}
-	get state() {
-		return this.document.state;
-	}
-	get initialState() {
-		return this.document.initialState;
-	}
-	get operations() {
-		return this.document.operations;
-	}
-	get clipboard() {
-		return this.document.clipboard;
-	}
-	onChange(listener) {
-		this.listeners.push(listener);
-		return () => {
-			this.listeners = this.listeners.filter((l) => l !== listener);
-		};
-	}
-	notifyListeners() {
-		if (this.listeners.length === 0) return;
-		const event = { document: this._document };
-		for (const listener of this.listeners) listener(event);
-	}
-	static forDocumentModel(module) {
-		return class extends PHDocumentController {
-			constructor(initialDocument) {
-				super(module, initialDocument);
-			}
-		};
-	}
-}).forDocumentModel(documentModelDocumentModelModule);
-const tokenSub = /@([a-zA-Z0-9_]+)/g;
-const dtf = new Intl.DateTimeFormat(void 0, {
-	hour12: false,
-	hour: "2-digit",
-	minute: "2-digit",
-	second: "2-digit",
-	fractionalSecondDigits: 2
-});
-const stringify = (value, includeStack) => {
-	if (value === null || value === void 0) return "null";
-	if (typeof value === "string") return value;
-	if (value instanceof Error) {
-		const base = `${value.name}: ${value.message}`;
-		return includeStack && value.stack ? `${base}\n${value.stack}` : base;
-	}
-	if (typeof value === "object") try {
-		return JSON.stringify(value);
-	} catch {
-		return String(value);
-	}
-	if (typeof value === "function") {
-		const name = value.name;
-		return name ? `${name}()` : "anonymous()";
-	}
-	return String(value);
-};
-const formatMessage = (tagString, message, replacements, includeStack) => {
-	const meta = {};
-	const uniqueTokens = [];
-	let results;
-	while ((results = tokenSub.exec(message)) !== null) {
-		const tokenName = results[1];
-		if (uniqueTokens.indexOf(tokenName) === -1) {
-			uniqueTokens.push(tokenName);
-			meta[tokenName] = replacements[uniqueTokens.length - 1];
-		}
-	}
-	for (const [key, value] of Object.entries(meta)) message = message.replaceAll(`@${key}`, stringify(value, includeStack));
-	const extras = replacements.slice(uniqueTokens.length);
-	if (extras.length > 0) message = `${message} ${extras.map((v) => stringify(v, includeStack)).join(" ")}`;
-	if (tagString.length > 0) message = `${tagString} ${message}`;
-	const now = /* @__PURE__ */ new Date();
-	meta["timestamp"] = dtf.format(now);
-	return [message, meta];
-};
-const LOG_LEVELS = {
-	verbose: 0,
-	debug: 1,
-	info: 2,
-	warn: 3,
-	error: 4
-};
-const logger = new class ConsoleLogger {
-	#tags;
-	#tagString;
-	#level = LOG_LEVELS.info;
-	errorHandler;
-	constructor(tags, handler) {
-		this.#tags = tags || [];
-		this.#tagString = this.#tags.map((tag) => `[${tag}]`).join("");
-		this.errorHandler = handler ?? (() => {});
-	}
-	get level() {
-		return Object.keys(LOG_LEVELS).find((key) => LOG_LEVELS[key] === this.#level);
-	}
-	set level(value) {
-		this.#level = LOG_LEVELS[value];
-	}
-	child(tags) {
-		const logger = new ConsoleLogger([...this.#tags, ...tags], this.errorHandler);
-		logger.level = this.level;
-		return logger;
-	}
-	get #includeStack() {
-		return this.#level <= LOG_LEVELS.debug;
-	}
-	verbose(message, ...replacements) {
-		if (this.#level <= LOG_LEVELS.verbose) {
-			const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements, this.#includeStack);
-			console.debug(`[${meta["timestamp"]}] ${formattedMessage}`);
-		}
-	}
-	debug(message, ...replacements) {
-		if (this.#level <= LOG_LEVELS.debug) {
-			const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements, this.#includeStack);
-			console.debug(`[${meta["timestamp"]}] ${formattedMessage}`);
-		}
-	}
-	info(message, ...replacements) {
-		if (this.#level <= LOG_LEVELS.info) {
-			const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements, this.#includeStack);
-			console.info(`[${meta["timestamp"]}] ${formattedMessage}`);
-		}
-	}
-	warn(message, ...replacements) {
-		if (this.#level <= LOG_LEVELS.warn) {
-			const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements, this.#includeStack);
-			console.warn(`[${meta["timestamp"]}] ${formattedMessage}`);
-		}
-	}
-	error(message, ...replacements) {
-		if (this.#level <= LOG_LEVELS.error) {
-			const [formattedMessage, meta] = formatMessage(this.#tagString, message, replacements, this.#includeStack);
-			console.error(`[${meta["timestamp"]}] ${formattedMessage}`);
-		}
-	}
-}();
-//#endregion
-export { replayDocument as A, setOperationDescription as B, defaultBaseState as C, documentModelDocumentType as D, deleteOperationError as E, setModelExtension as F, undo as G, setOperationName as H, setModelId as I, validateStateSchemaName as J, validateInitialState as K, setModelName as L, setAuthorWebsite as M, setInitialState as N, isDocumentAction as O, setModelDescription as P, setModuleName as R, createZip as S, deleteOperation as T, setOperationSchema as U, setOperationErrorName as V, setStateSchema as W, generateId as Y, baseSaveToFileHandle as _, driveDocumentModelModule as a, createReducer as b, isFileNode as c, updateNode as d, addModule as f, baseLoadFromInput as g, baseCreateDocument as h, copyNode as i, setAuthorName as j, redo as k, isFolderNode as l, addOperationError as m, logger as n, generateNodesCopy as o, addOperation as p, validateModules as q, addFolder as r, handleTargetNameCollisions as s, documentModelDocumentModelModule as t, moveNode as u, buildSignedAction as v, deleteModule as w, createState as x, createPresignedHeader as y, setName as z };
+export { replayDocument as A, setOperationDescription as B, defaultBaseState as C, documentModelDocumentType as D, deleteOperationError as E, setModelExtension as F, undo as G, setOperationName as H, setModelId as I, validateStateSchemaName as J, validateInitialState as K, setModelName as L, setAuthorWebsite as M, setInitialState as N, isDocumentAction as O, setModelDescription as P, setModuleName as R, createZip as S, deleteOperation as T, setOperationSchema as U, setOperationErrorName as V, setStateSchema as W, generateId as Y, baseSaveToFileHandle as _, handleTargetNameCollisions as a, createReducer as b, moveNode as c, logger as d, addModule as f, baseLoadFromInput as g, baseCreateDocument as h, generateNodesCopy as i, setAuthorName as j, redo as k, updateNode as l, addOperationError as m, copyNode as n, isFileNode as o, addOperation as p, validateModules as q, driveDocumentModelModule as r, isFolderNode as s, addFolder as t, documentModelDocumentModelModule as u, buildSignedAction as v, deleteModule as w, createState as x, createPresignedHeader as y, setName as z };
 
-//# sourceMappingURL=dist-DQgJ8n4d.js.map
+//# sourceMappingURL=document-drive-oqv68jDU.js.map