@powerhousedao/shared 6.1.0-dev.2 → 6.1.0-dev.21

package/dist/document-model/index.js

@@ -1,10 +1,10 @@
-import { a as buildOperationSignatureParams, c as hex2ab, i as buildOperationSignatureMessage, n as generateId, o as getUnixTimestamp, r as ab2hex, s as hashBrowser, t as deriveOperationId } from "../utils-bCWnsmtD.js";
+import { a as buildOperationSignatureParams, c as hex2ab, i as buildOperationSignatureMessage, n as generateId, o as getUnixTimestamp, r as ab2hex, s as hashBrowser, t as deriveOperationId } from "../utils-DKOFCM0Q.js";
 import { generateMock } from "./mock.js";
 import { ZodError, z } from "zod";
 import { stringify } from "safe-stable-stringify";
 import { strFromU8, strToU8, unzip, zip } from "fflate";
 import { castDraft, create, unsafe } from "mutative";
-import { pascalCase } from "change-case";
+import { constantCase, pascalCase } from "change-case";
 //#region document-model/errors.ts
 const FileSystemError = /* @__PURE__ */ new Error("File system not available.");
 var InvalidActionInputError = class extends Error {
@@ -1648,16 +1648,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: []
 		},
@@ -2676,6 +2732,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) {
@@ -2705,6 +2770,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.`);
@@ -2800,6 +2870,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);
@@ -2824,10 +2948,22 @@ function validateOperations(operations) {
 }
 //#endregion
 //#region document-model/reducers.ts
-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) {
@@ -2859,6 +2995,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,
@@ -2867,24 +3004,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 || "",
@@ -2893,54 +3034,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,
@@ -2955,8 +3100,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);
@@ -2966,40 +3111,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 = {
@@ -3024,18 +3168,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 = {
@@ -3485,6 +3633,6 @@ function createState(baseState, globalState, localState) {
 	};
 }
 //#endregion
-export { AddChangeLogItemInputSchema, AddModuleInputSchema, AddOperationErrorInputSchema, AddOperationExampleInputSchema, AddOperationInputSchema, AddStateExampleInputSchema, AuthorSchema, BaseDocumentHeaderSchema, BaseDocumentStateSchema, CodeExampleSchema, ConfigEntrySchema, ConfigEntryTypeSchema, DeleteChangeLogItemInputSchema, DeleteModuleInputSchema, DeleteOperationErrorInputSchema, DeleteOperationExampleInputSchema, DeleteOperationInputSchema, DeleteStateExampleInputSchema, DocumentActionSchema, DocumentFileSchema, DocumentModelGlobalStateSchema, DocumentModelHeaderSchema, DocumentModelInputSchema, DocumentModelPHStateSchema, DocumentModelSchema, DocumentSpecificationSchema, FileSystemError, HASH_ALGORITHM_SHA1, HASH_ALGORITHM_SHA256, HASH_ALGORITHM_SHA512, HASH_ENCODING_BASE64, HASH_ENCODING_HEX, HashMismatchError, IntegrityIssueSubType, IntegrityIssueType, InvalidActionInputError, InvalidActionInputZodError, LoadStateActionInputSchema, LoadStateActionSchema, LoadStateActionStateInputSchema, Load_StateSchema, ManifestSchema, ModuleSchema, MoveOperationInputSchema, OperationErrorSchema, OperationScopeSchema, OperationSpecificationSchema, PowerhouseModuleSchema, PowerhouseModulesSchema, PruneActionInputSchema, PruneActionSchema, PruneSchema, PublisherSchema, RESERVED_OPERATION_NAMES, RedoActionInputSchema, RedoActionSchema, RedoSchema, ReorderChangeLogItemsInputSchema, ReorderModuleOperationsInputSchema, ReorderModulesInputSchema, ReorderOperationErrorsInputSchema, ReorderOperationExamplesInputSchema, ReorderStateExamplesInputSchema, ScopeStateSchema, SetAuthorNameInputSchema, SetAuthorWebsiteInputSchema, SetInitialStateInputSchema, SetModelDescriptionInputSchema, SetModelExtensionInputSchema, SetModelIdInputSchema, SetModelNameInputSchema, SetModuleDescriptionInputSchema, SetModuleNameInputSchema, SetNameActionInputSchema, SetNameActionSchema, SetOperationDescriptionInputSchema, SetOperationErrorCodeInputSchema, SetOperationErrorDescriptionInputSchema, SetOperationErrorNameInputSchema, SetOperationErrorTemplateInputSchema, SetOperationNameInputSchema, SetOperationReducerInputSchema, SetOperationSchemaInputSchema, SetOperationScopeInputSchema, SetOperationTemplateInputSchema, SetPreferredEditorActionInputSchema, SetPreferredEditorActionSchema, SetStateSchemaInputSchema, Set_NameSchema, Set_PreferredEditorSchema, StateSchema, UndoActionInputSchema, UndoActionSchema, UndoSchema, UpdateChangeLogItemInputSchema, UpdateOperationExampleInputSchema, UpdateStateExampleInputSchema, ab2hex, actionContext, actionFromAction, actionSigner, actions, addChangeLogItem, addModule, addOperation, addOperationError, addOperationExample, addStateExample, addUndo, assertIsDocumentModelDocument, assertIsDocumentModelState, attachBranch, baseActions, baseCreateDocument, baseLoadFromInput, baseReducer, baseSaveToFileHandle, buildOperationSignature, buildOperationSignatureMessage, buildOperationSignatureParams, buildSignedAction, checkCleanedOperationsIntegrity, checkOperationsIntegrity, createAction, createAuthState, createBaseState, createDocumentState, createGlobalState, createLocalState, createMinimalZip, createPresignedHeader, createReducer, createSignedHeader, createSignedHeaderForSigner, createState, createVerificationSigner, createZip, defaultAuthState, defaultBaseState, defaultDocumentState, defaultGlobalState, defaultLocalState, defaultPHState, definedNonNullAnySchema, deleteChangeLogItem, deleteModule, deleteOperation, deleteOperationError, deleteOperationExample, deleteStateExample, deriveOperationId, diffOperations, documentModelActions, documentModelDocumentType, documentModelFileExtension, documentModelGlobalState, documentModelHeaderReducer, documentModelInitialGlobalState, documentModelInitialLocalState, documentModelLoadFromInput, documentModelModuleReducer, documentModelOperationErrorReducer, documentModelOperationExampleReducer, documentModelOperationReducer, documentModelReducer, documentModelSaveToFileHandle, documentModelStateReducer, documentModelStateSchemaReducer, documentModelVersioningReducer, fetchFileBrowser, filterDocumentOperationsResultingState, filterDuplicatedOperations, findModuleOrThrow, findOperationOrThrow, garbageCollect, garbageCollectDocumentOperations, garbageCollectV2, generateId, generateMock, getAllOperationNames, getDocumentLastModified, getFileBrowser, getUnixTimestamp, groupOperationsByScope, hashBrowser, hashDocumentStateForScope, hex2ab, isDefinedNonNullAny, isDocumentAction, isDocumentModelDocument, isDocumentModelState, isNoopOperation, isReservedOperationName, isUndo, isUndoRedo, loadState, loadStateOperation, mapSkippedOperations, mapSkippedOperationsV2, merge, moveOperation, nextSkipNumber, noop, operationExampleCreators, operationFromAction, operationFromOperation, operationWithContext, operationsAreEqual, parseResultingState, precedes, prepareOperations, processUndoRedo, prune, pruneOperation, readFileBrowser, readOnly, redo, redoOperation, releaseNewVersion, removeExistingOperations, reorderChangeLogItems, reorderModuleOperations, reorderModules, reorderOperationErrors, reorderOperationExamples, reorderStateExamples, replayDocument, replayOperations, reshuffleByTimestamp, reshuffleByTimestampAndIndex, setAuthorName, setAuthorWebsite, setInitialState, setModelDescription, setModelExtension, setModelId, setModelName, setModuleDescription, setModuleName, setName, setNameOperation, setOperationDescription, setOperationErrorCode, setOperationErrorDescription, setOperationErrorName, setOperationErrorTemplate, setOperationName, setOperationReducer, setOperationSchema, setOperationScope, setOperationTemplate, setPreferredEditor, setPreferredEditorOperation, setStateSchema, sign, skipHeaderOperations, sortMappedOperations, sortOperations, split, undo, undoOperation, undoOperationV2, updateChangeLogItem, updateDocument, updateHeaderRevision, updateOperationExample, updateStateExample, validateHeader, validateInitialState, validateModule, validateModuleOperation, validateModules, validateOperationName, validateOperations, validateStateSchemaName, verify, verifyOperationSignature, writeFileBrowser };
+export { AddChangeLogItemInputSchema, AddModuleInputSchema, AddOperationErrorInputSchema, AddOperationExampleInputSchema, AddOperationInputSchema, AddStateExampleInputSchema, AuthorSchema, BaseDocumentHeaderSchema, BaseDocumentStateSchema, CodeExampleSchema, ConfigEntrySchema, ConfigEntryTypeSchema, DeleteChangeLogItemInputSchema, DeleteModuleInputSchema, DeleteOperationErrorInputSchema, DeleteOperationExampleInputSchema, DeleteOperationInputSchema, DeleteStateExampleInputSchema, DocumentActionSchema, DocumentFileSchema, DocumentModelGlobalStateSchema, DocumentModelHeaderSchema, DocumentModelInputSchema, DocumentModelPHStateSchema, DocumentModelSchema, DocumentSpecificationSchema, FileSystemError, HASH_ALGORITHM_SHA1, HASH_ALGORITHM_SHA256, HASH_ALGORITHM_SHA512, HASH_ENCODING_BASE64, HASH_ENCODING_HEX, HashMismatchError, IntegrityIssueSubType, IntegrityIssueType, InvalidActionInputError, InvalidActionInputZodError, LoadStateActionInputSchema, LoadStateActionSchema, LoadStateActionStateInputSchema, Load_StateSchema, ManifestSchema, ModuleSchema, MoveOperationInputSchema, OPERATION_NAME_PATTERN, OperationErrorSchema, OperationScopeSchema, OperationSpecificationSchema, PowerhouseModuleSchema, PowerhouseModulesSchema, PruneActionInputSchema, PruneActionSchema, PruneSchema, PublisherSchema, RESERVED_OPERATION_NAMES, RedoActionInputSchema, RedoActionSchema, RedoSchema, ReorderChangeLogItemsInputSchema, ReorderModuleOperationsInputSchema, ReorderModulesInputSchema, ReorderOperationErrorsInputSchema, ReorderOperationExamplesInputSchema, ReorderStateExamplesInputSchema, ScopeStateSchema, SetAuthorNameInputSchema, SetAuthorWebsiteInputSchema, SetInitialStateInputSchema, SetModelDescriptionInputSchema, SetModelExtensionInputSchema, SetModelIdInputSchema, SetModelNameInputSchema, SetModuleDescriptionInputSchema, SetModuleNameInputSchema, SetNameActionInputSchema, SetNameActionSchema, SetOperationDescriptionInputSchema, SetOperationErrorCodeInputSchema, SetOperationErrorDescriptionInputSchema, SetOperationErrorNameInputSchema, SetOperationErrorTemplateInputSchema, SetOperationNameInputSchema, SetOperationReducerInputSchema, SetOperationSchemaInputSchema, SetOperationScopeInputSchema, SetOperationTemplateInputSchema, SetPreferredEditorActionInputSchema, SetPreferredEditorActionSchema, SetStateSchemaInputSchema, Set_NameSchema, Set_PreferredEditorSchema, StateSchema, UndoActionInputSchema, UndoActionSchema, UndoSchema, UpdateChangeLogItemInputSchema, UpdateOperationExampleInputSchema, UpdateStateExampleInputSchema, ab2hex, actionContext, actionFromAction, actionSigner, actions, addChangeLogItem, addModule, addOperation, addOperationError, addOperationExample, addStateExample, addUndo, assertIsDocumentModelDocument, assertIsDocumentModelState, assertModuleIdUnique, assertOperationErrorIdUnique, assertOperationExampleIdUnique, assertOperationIdUnique, attachBranch, baseActions, baseCreateDocument, baseLoadFromInput, baseReducer, baseSaveToFileHandle, buildOperationSignature, buildOperationSignatureMessage, buildOperationSignatureParams, buildSignedAction, checkCleanedOperationsIntegrity, checkOperationsIntegrity, createAction, createAuthState, createBaseState, createDocumentState, createGlobalState, createLocalState, createMinimalZip, createPresignedHeader, createReducer, createSignedHeader, createSignedHeaderForSigner, createState, createVerificationSigner, createZip, defaultAuthState, defaultBaseState, defaultDocumentState, defaultGlobalState, defaultLocalState, defaultPHState, definedNonNullAnySchema, deleteChangeLogItem, deleteModule, deleteOperation, deleteOperationError, deleteOperationExample, deleteStateExample, deriveOperationId, diffOperations, documentModelActions, documentModelDocumentType, documentModelFileExtension, documentModelGlobalState, documentModelHeaderReducer, documentModelInitialGlobalState, documentModelInitialLocalState, documentModelLoadFromInput, documentModelModuleReducer, documentModelOperationErrorReducer, documentModelOperationExampleReducer, documentModelOperationReducer, documentModelReducer, documentModelSaveToFileHandle, documentModelStateReducer, documentModelStateSchemaReducer, documentModelVersioningReducer, fetchFileBrowser, filterDocumentOperationsResultingState, filterDuplicatedOperations, findModuleOrThrow, findOperationErrorOrThrow, findOperationExampleOrThrow, findOperationOrThrow, garbageCollect, garbageCollectDocumentOperations, garbageCollectV2, generateId, generateMock, getAllOperationNames, getDocumentLastModified, getFileBrowser, getUnixTimestamp, groupOperationsByScope, hashBrowser, hashDocumentStateForScope, hex2ab, isDefinedNonNullAny, isDocumentAction, isDocumentModelDocument, isDocumentModelState, isNoopOperation, isReservedOperationName, isUndo, isUndoRedo, isValidOperationNameFormat, loadState, loadStateOperation, mapSkippedOperations, mapSkippedOperationsV2, merge, moveOperation, nextSkipNumber, noop, operationExampleCreators, operationFromAction, operationFromOperation, operationWithContext, operationsAreEqual, parseResultingState, precedes, prepareOperations, processUndoRedo, prune, pruneOperation, readFileBrowser, readOnly, redo, redoOperation, releaseNewVersion, removeExistingOperations, reorderChangeLogItems, reorderModuleOperations, reorderModules, reorderOperationErrors, reorderOperationExamples, reorderStateExamples, replayDocument, replayOperations, reshuffleByTimestamp, reshuffleByTimestampAndIndex, setAuthorName, setAuthorWebsite, setInitialState, setModelDescription, setModelExtension, setModelId, setModelName, setModuleDescription, setModuleName, setName, setNameOperation, setOperationDescription, setOperationErrorCode, setOperationErrorDescription, setOperationErrorName, setOperationErrorTemplate, setOperationName, setOperationReducer, setOperationSchema, setOperationScope, setOperationTemplate, setPreferredEditor, setPreferredEditorOperation, setStateSchema, sign, skipHeaderOperations, sortMappedOperations, sortOperations, split, undo, undoOperation, undoOperationV2, updateChangeLogItem, updateDocument, updateHeaderRevision, updateOperationExample, updateStateExample, validateHeader, validateInitialState, validateModule, validateModuleOperation, validateModules, validateOperationName, validateOperations, validateStateSchemaName, verify, verifyOperationSignature, writeFileBrowser };
 
 //# sourceMappingURL=index.js.map