@mostra/protocol 0.0.0-stage → 0.1.0

package/dist/diagnostics/codes/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","names":[],"sources":["../../../src/diagnostics/codes/live.ts"],"mappings":";;;qBAMa;;YAOD,6BAA6B"}

package/dist/diagnostics/codes/live.js

@@ -0,0 +1,30 @@
+//#region src/diagnostics/codes/live.ts
+/** The codes of the LIVE area, in the order they were added. */
+const liveDiagnosticCodes = ["MOSTRA_LIVE_TOO_LARGE", "MOSTRA_LIVE_SOURCE_FAILED"];
+/** The LIVE area's catalog entries. */
+const liveDiagnostics = {
+	MOSTRA_LIVE_TOO_LARGE: {
+		severity: "error",
+		phase: "runtime",
+		title: "Live value too large",
+		hint: "Push or produce a smaller value: at most 4 MiB serialized.",
+		docs: {
+			explanation: "A live value, pushed or produced, is over 4 MiB once serialized (DATA_MODEL §5). It is refused and the last good value stays.",
+			fix: "Send a smaller window of the data, or split it across several live sources. For high-rate series, push single points in append mode and let the page keep the window."
+		}
+	},
+	MOSTRA_LIVE_SOURCE_FAILED: {
+		severity: "error",
+		phase: "runtime",
+		title: "Live source failed",
+		hint: "Read the message, fix the live source's loader or stream, and publish again; the last good value stays meanwhile.",
+		docs: {
+			explanation: "A live source's `load` or `stream` threw, or its value was outside the serializable types. Pages keep showing the last good value with `useLive`'s `error` set, and the producer tries again on its schedule (FAILURE_MODEL §6).",
+			fix: "Fix the producer in `live.ts`, or catch transient failures there and return the previous value."
+		}
+	}
+};
+//#endregion
+export { liveDiagnosticCodes, liveDiagnostics };
+
+//# sourceMappingURL=live.js.map

package/dist/diagnostics/codes/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","names":[],"sources":["../../../src/diagnostics/codes/live.ts"],"sourcesContent":["/**\n * Diagnostic codes of the LIVE area.\n */\nimport type { AreaCatalog } from \"../spec.ts\";\n\n/** The codes of the LIVE area, in the order they were added. */\nexport const liveDiagnosticCodes = [\n  \"MOSTRA_LIVE_TOO_LARGE\",\n  \"MOSTRA_LIVE_SOURCE_FAILED\",\n  // gen:codes\n] as const;\n\n/** The codes of the LIVE area. */\nexport type LiveDiagnosticCode = (typeof liveDiagnosticCodes)[number];\n\n/** The LIVE area's catalog entries. */\nexport const liveDiagnostics: AreaCatalog<LiveDiagnosticCode> = {\n  MOSTRA_LIVE_TOO_LARGE: {\n    severity: \"error\",\n    phase: \"runtime\",\n    title: \"Live value too large\",\n    hint: \"Push or produce a smaller value: at most 4 MiB serialized.\",\n    docs: {\n      explanation:\n        \"A live value, pushed or produced, is over 4 MiB once serialized (DATA_MODEL \\u00a75). It is refused and the last good value stays.\",\n      fix: \"Send a smaller window of the data, or split it across several live sources. For high-rate series, push single points in append mode and let the page keep the window.\",\n    },\n  },\n  MOSTRA_LIVE_SOURCE_FAILED: {\n    severity: \"error\",\n    phase: \"runtime\",\n    title: \"Live source failed\",\n    hint: \"Read the message, fix the live source's loader or stream, and publish again; the last good value stays meanwhile.\",\n    docs: {\n      explanation:\n        \"A live source's `load` or `stream` threw, or its value was outside the serializable types. Pages keep showing the last good value with `useLive`'s `error` set, and the producer tries again on its schedule (FAILURE_MODEL \\u00a76).\",\n      fix: \"Fix the producer in `live.ts`, or catch transient failures there and return the previous value.\",\n    },\n  },\n  // gen:entries\n};\n"],"mappings":";;AAMA,MAAa,sBAAsB,CACjC,yBACA,2BAEF;;AAMA,MAAa,kBAAmD;CAC9D,uBAAuB;EACrB,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,2BAA2B;EACzB,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;AAEF"}

package/dist/diagnostics/codes/manifest.d.ts

@@ -0,0 +1,8 @@
+import "../spec.js";
+//#region src/diagnostics/codes/manifest.d.ts
+/** The codes of the MANIFEST area, in the order they were added. */
+export declare const manifestDiagnosticCodes: readonly ["MOSTRA_MANIFEST_NOT_LITERAL", "MOSTRA_MANIFEST_INVALID", "MOSTRA_MANIFEST_UNKNOWN_KEY"];
+/** The codes of the MANIFEST area. */
+export type ManifestDiagnosticCode = (typeof manifestDiagnosticCodes)[number];
+//#endregion
+//# sourceMappingURL=manifest.d.ts.map

package/dist/diagnostics/codes/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","names":[],"sources":["../../../src/diagnostics/codes/manifest.ts"],"mappings":";;;qBAMa;;YAQD,iCAAiC"}

package/dist/diagnostics/codes/manifest.js

@@ -0,0 +1,44 @@
+//#region src/diagnostics/codes/manifest.ts
+/** The codes of the MANIFEST area, in the order they were added. */
+const manifestDiagnosticCodes = [
+	"MOSTRA_MANIFEST_NOT_LITERAL",
+	"MOSTRA_MANIFEST_INVALID",
+	"MOSTRA_MANIFEST_UNKNOWN_KEY"
+];
+/** The MANIFEST area's catalog entries. */
+const manifestDiagnostics = {
+	MOSTRA_MANIFEST_NOT_LITERAL: {
+		severity: "error",
+		phase: "manifest",
+		title: "Manifest isn't a literal",
+		hint: "Write the manifest as plain values: strings, numbers, booleans, null, arrays and objects, with no variables, calls, spreads or computed keys.",
+		docs: {
+			explanation: "Mostra reads an artifact's manifest without running its code: the `export const artifact = defineArtifact({...})` in a TSX entry, or the frontmatter of an MDX entry. It reports this code when the exported `artifact` isn't a `defineArtifact(...)` call with one object literal, or when a value inside it needs evaluation (an identifier, a function call, a spread, a computed key, a template literal with a placeholder). The location points at the first such value.",
+			fix: "Replace the value with the literal it stands for, for example `title: \"Q3 review\"` instead of `title: TITLE`. Keep computed values in the page code, where they can use anything. `as const` and `satisfies` on the object are fine."
+		}
+	},
+	MOSTRA_MANIFEST_INVALID: {
+		severity: "error",
+		phase: "manifest",
+		title: "Manifest value is invalid",
+		hint: "Fix the manifest field named in the message so it matches the manifest's documented shape.",
+		docs: {
+			explanation: "The manifest was read, but a field has a value the manifest doesn't allow: a missing `title`, a wrong type, an `id` that isn't an artifact ID (`art_` followed by a ULID), a `mode` this runtime doesn't build (`spa` is the only one), or frontmatter that isn't valid YAML. The message names the field and what was expected.",
+			fix: "Correct the field the message names. Leave `id` out to let Mostra bind the artifact to its source path at first publish, or keep the `id` that `mostra new` wrote. Every field except `title` is optional."
+		}
+	},
+	MOSTRA_MANIFEST_UNKNOWN_KEY: {
+		severity: "warning",
+		phase: "manifest",
+		title: "Unknown manifest key",
+		hint: "Remove the key or correct its spelling; a newer Mostra may support it.",
+		docs: {
+			explanation: "The manifest has a key this runtime doesn't know. Mostra ignores it, so manifests written for a newer release still publish, but a misspelled key (`familly`, `decription`) silently has no effect.",
+			fix: "Check the key against the manifest fields (`id`, `title`, `description`, `family`, `links`, `mode`, `submission`, `kit`, `terminals`, `demos`, `limits`, `verify`) and fix the spelling, or remove it."
+		}
+	}
+};
+//#endregion
+export { manifestDiagnosticCodes, manifestDiagnostics };
+
+//# sourceMappingURL=manifest.js.map

package/dist/diagnostics/codes/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","names":[],"sources":["../../../src/diagnostics/codes/manifest.ts"],"sourcesContent":["/**\n * Diagnostic codes of the MANIFEST area.\n */\nimport type { AreaCatalog } from \"../spec.ts\";\n\n/** The codes of the MANIFEST area, in the order they were added. */\nexport const manifestDiagnosticCodes = [\n  \"MOSTRA_MANIFEST_NOT_LITERAL\",\n  \"MOSTRA_MANIFEST_INVALID\",\n  \"MOSTRA_MANIFEST_UNKNOWN_KEY\",\n  // gen:codes\n] as const;\n\n/** The codes of the MANIFEST area. */\nexport type ManifestDiagnosticCode = (typeof manifestDiagnosticCodes)[number];\n\n/** The MANIFEST area's catalog entries. */\nexport const manifestDiagnostics: AreaCatalog<ManifestDiagnosticCode> = {\n  MOSTRA_MANIFEST_NOT_LITERAL: {\n    severity: \"error\",\n    phase: \"manifest\",\n    title: \"Manifest isn't a literal\",\n    hint: \"Write the manifest as plain values: strings, numbers, booleans, null, arrays and objects, with no variables, calls, spreads or computed keys.\",\n    docs: {\n      explanation:\n        \"Mostra reads an artifact's manifest without running its code: the `export const artifact = defineArtifact({...})` in a TSX entry, or the frontmatter of an MDX entry. It reports this code when the exported `artifact` isn't a `defineArtifact(...)` call with one object literal, or when a value inside it needs evaluation (an identifier, a function call, a spread, a computed key, a template literal with a placeholder). The location points at the first such value.\",\n      fix: 'Replace the value with the literal it stands for, for example `title: \"Q3 review\"` instead of `title: TITLE`. Keep computed values in the page code, where they can use anything. `as const` and `satisfies` on the object are fine.',\n    },\n  },\n  MOSTRA_MANIFEST_INVALID: {\n    severity: \"error\",\n    phase: \"manifest\",\n    title: \"Manifest value is invalid\",\n    hint: \"Fix the manifest field named in the message so it matches the manifest's documented shape.\",\n    docs: {\n      explanation:\n        \"The manifest was read, but a field has a value the manifest doesn't allow: a missing `title`, a wrong type, an `id` that isn't an artifact ID (`art_` followed by a ULID), a `mode` this runtime doesn't build (`spa` is the only one), or frontmatter that isn't valid YAML. The message names the field and what was expected.\",\n      fix: \"Correct the field the message names. Leave `id` out to let Mostra bind the artifact to its source path at first publish, or keep the `id` that `mostra new` wrote. Every field except `title` is optional.\",\n    },\n  },\n  MOSTRA_MANIFEST_UNKNOWN_KEY: {\n    severity: \"warning\",\n    phase: \"manifest\",\n    title: \"Unknown manifest key\",\n    hint: \"Remove the key or correct its spelling; a newer Mostra may support it.\",\n    docs: {\n      explanation:\n        \"The manifest has a key this runtime doesn't know. Mostra ignores it, so manifests written for a newer release still publish, but a misspelled key (`familly`, `decription`) silently has no effect.\",\n      fix: \"Check the key against the manifest fields (`id`, `title`, `description`, `family`, `links`, `mode`, `submission`, `kit`, `terminals`, `demos`, `limits`, `verify`) and fix the spelling, or remove it.\",\n    },\n  },\n  // gen:entries\n};\n"],"mappings":";;AAMA,MAAa,0BAA0B;CACrC;CACA;CACA;AAEF;;AAMA,MAAa,sBAA2D;CACtE,6BAA6B;EAC3B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,yBAAyB;EACvB,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,6BAA6B;EAC3B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;AAEF"}

package/dist/diagnostics/codes/network.d.ts

@@ -0,0 +1,8 @@
+import "../spec.js";
+//#region src/diagnostics/codes/network.d.ts
+/** The codes of the NETWORK area, in the order they were added. */
+export declare const networkDiagnosticCodes: readonly ["MOSTRA_NETWORK_REQUEST_FAILED", "MOSTRA_NETWORK_EXTERNAL_FAILED"];
+/** The codes of the NETWORK area. */
+export type NetworkDiagnosticCode = (typeof networkDiagnosticCodes)[number];
+//#endregion
+//# sourceMappingURL=network.d.ts.map

package/dist/diagnostics/codes/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","names":[],"sources":["../../../src/diagnostics/codes/network.ts"],"mappings":";;;qBAMa;;YAOD,gCAAgC"}

package/dist/diagnostics/codes/network.js

@@ -0,0 +1,30 @@
+//#region src/diagnostics/codes/network.ts
+/** The codes of the NETWORK area, in the order they were added. */
+const networkDiagnosticCodes = ["MOSTRA_NETWORK_REQUEST_FAILED", "MOSTRA_NETWORK_EXTERNAL_FAILED"];
+/** The NETWORK area's catalog entries. */
+const networkDiagnostics = {
+	MOSTRA_NETWORK_REQUEST_FAILED: {
+		severity: "error",
+		phase: "network",
+		title: "Request for the page's own resource failed",
+		hint: "Check the path: a file the page loads from the artifact itself failed to load.",
+		docs: {
+			explanation: "A resource the page loaded from the artifact's own origin (the document, a script, a style, an image, a font, or a fetch by artifact code) failed or answered 4xx or 5xx. Requests the browser makes on its own, such as `/favicon.ico`, and Mostra's own protocol aren't counted.",
+			fix: "Put the file in `public/` (served at the root) or import it from the code so the build includes it, and check the path's spelling."
+		}
+	},
+	MOSTRA_NETWORK_EXTERNAL_FAILED: {
+		severity: "warning",
+		phase: "network",
+		title: "Request to another origin failed",
+		hint: "A request to another origin failed while verify ran; check the URL and whether that service was reachable.",
+		docs: {
+			explanation: "A request the page made to another origin failed or answered 4xx or 5xx. It may be the environment (no network, a service that is down, a request the service refuses from this origin) rather than the code, so it is a warning.",
+			fix: "Check the URL and the service. If the page depends on it, show a fallback when it fails."
+		}
+	}
+};
+//#endregion
+export { networkDiagnosticCodes, networkDiagnostics };
+
+//# sourceMappingURL=network.js.map

package/dist/diagnostics/codes/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","names":[],"sources":["../../../src/diagnostics/codes/network.ts"],"sourcesContent":["/**\n * Diagnostic codes of the NETWORK area.\n */\nimport type { AreaCatalog } from \"../spec.ts\";\n\n/** The codes of the NETWORK area, in the order they were added. */\nexport const networkDiagnosticCodes = [\n  \"MOSTRA_NETWORK_REQUEST_FAILED\",\n  \"MOSTRA_NETWORK_EXTERNAL_FAILED\",\n  // gen:codes\n] as const;\n\n/** The codes of the NETWORK area. */\nexport type NetworkDiagnosticCode = (typeof networkDiagnosticCodes)[number];\n\n/** The NETWORK area's catalog entries. */\nexport const networkDiagnostics: AreaCatalog<NetworkDiagnosticCode> = {\n  MOSTRA_NETWORK_REQUEST_FAILED: {\n    severity: \"error\",\n    phase: \"network\",\n    title: \"Request for the page's own resource failed\",\n    hint: \"Check the path: a file the page loads from the artifact itself failed to load.\",\n    docs: {\n      explanation:\n        \"A resource the page loaded from the artifact's own origin (the document, a script, a style, an image, a font, or a fetch by artifact code) failed or answered 4xx or 5xx. Requests the browser makes on its own, such as `/favicon.ico`, and Mostra's own protocol aren't counted.\",\n      fix: \"Put the file in `public/` (served at the root) or import it from the code so the build includes it, and check the path's spelling.\",\n    },\n  },\n  MOSTRA_NETWORK_EXTERNAL_FAILED: {\n    severity: \"warning\",\n    phase: \"network\",\n    title: \"Request to another origin failed\",\n    hint: \"A request to another origin failed while verify ran; check the URL and whether that service was reachable.\",\n    docs: {\n      explanation:\n        \"A request the page made to another origin failed or answered 4xx or 5xx. It may be the environment (no network, a service that is down, a request the service refuses from this origin) rather than the code, so it is a warning.\",\n      fix: \"Check the URL and the service. If the page depends on it, show a fallback when it fails.\",\n    },\n  },\n  // gen:entries\n};\n"],"mappings":";;AAMA,MAAa,yBAAyB,CACpC,iCACA,gCAEF;;AAMA,MAAa,qBAAyD;CACpE,+BAA+B;EAC7B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,gCAAgC;EAC9B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;AAEF"}

package/dist/diagnostics/codes/platform.d.ts

@@ -0,0 +1,8 @@
+import "../spec.js";
+//#region src/diagnostics/codes/platform.d.ts
+/** The codes of the PLATFORM area, in the order they were added. */
+export declare const platformDiagnosticCodes: readonly ["MOSTRA_PLATFORM_UNSUPPORTED"];
+/** The codes of the PLATFORM area. */
+export type PlatformDiagnosticCode = (typeof platformDiagnosticCodes)[number];
+//#endregion
+//# sourceMappingURL=platform.d.ts.map

package/dist/diagnostics/codes/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","names":[],"sources":["../../../src/diagnostics/codes/platform.ts"],"mappings":";;;qBAOa;;YAMD,iCAAiC"}

package/dist/diagnostics/codes/platform.js

@@ -0,0 +1,18 @@
+//#region src/diagnostics/codes/platform.ts
+/** The codes of the PLATFORM area, in the order they were added. */
+const platformDiagnosticCodes = ["MOSTRA_PLATFORM_UNSUPPORTED"];
+/** The PLATFORM area's catalog entries. */
+const platformDiagnostics = { MOSTRA_PLATFORM_UNSUPPORTED: {
+	severity: "error",
+	phase: "platform",
+	title: "Unsupported platform",
+	hint: "Run Mostra on macOS or Linux, on an x64 or arm64 machine.",
+	docs: {
+		explanation: "Mostra 1.0 runs on macOS and Linux, on x64 and arm64. On any other operating system or architecture, Windows included, every entry point stops with this code before it creates or changes anything, because the process model, sockets and storage are built and tested only on those platforms. The message names the platform that was detected.",
+		fix: "Run Mostra on a macOS or Linux machine with an x64 or arm64 processor. Windows support is planned for a release after 1.0."
+	}
+} };
+//#endregion
+export { platformDiagnosticCodes, platformDiagnostics };
+
+//# sourceMappingURL=platform.js.map

package/dist/diagnostics/codes/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","names":[],"sources":["../../../src/diagnostics/codes/platform.ts"],"sourcesContent":["/**\n * Diagnostic codes of the PLATFORM area: the operating systems and architectures Mostra runs on\n * (D35, RT-07).\n */\nimport type { AreaCatalog } from \"../spec.ts\";\n\n/** The codes of the PLATFORM area, in the order they were added. */\nexport const platformDiagnosticCodes = [\n  \"MOSTRA_PLATFORM_UNSUPPORTED\",\n  // gen:codes\n] as const;\n\n/** The codes of the PLATFORM area. */\nexport type PlatformDiagnosticCode = (typeof platformDiagnosticCodes)[number];\n\n/** The PLATFORM area's catalog entries. */\nexport const platformDiagnostics: AreaCatalog<PlatformDiagnosticCode> = {\n  MOSTRA_PLATFORM_UNSUPPORTED: {\n    severity: \"error\",\n    phase: \"platform\",\n    title: \"Unsupported platform\",\n    hint: \"Run Mostra on macOS or Linux, on an x64 or arm64 machine.\",\n    docs: {\n      explanation:\n        \"Mostra 1.0 runs on macOS and Linux, on x64 and arm64. On any other operating system or architecture, Windows included, every entry point stops with this code before it creates or changes anything, because the process model, sockets and storage are built and tested only on those platforms. The message names the platform that was detected.\",\n      fix: \"Run Mostra on a macOS or Linux machine with an x64 or arm64 processor. Windows support is planned for a release after 1.0.\",\n    },\n  },\n  // gen:entries\n};\n"],"mappings":";;AAOA,MAAa,0BAA0B,CACrC,6BAEF;;AAMA,MAAa,sBAA2D,EACtE,6BAA6B;CAC3B,UAAU;CACV,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;EACJ,aACE;EACF,KAAK;CACP;AACF,EAEF"}

package/dist/diagnostics/codes/publish.d.ts

@@ -0,0 +1,8 @@
+import "../spec.js";
+//#region src/diagnostics/codes/publish.d.ts
+/** The codes of the PUBLISH area, in the order they were added. */
+export declare const publishDiagnosticCodes: readonly ["MOSTRA_PUBLISH_ID_CONFLICT", "MOSTRA_PUBLISH_SOURCE_CHANGED", "MOSTRA_PUBLISH_VERIFY_FAILED"];
+/** The codes of the PUBLISH area. */
+export type PublishDiagnosticCode = (typeof publishDiagnosticCodes)[number];
+//#endregion
+//# sourceMappingURL=publish.d.ts.map

package/dist/diagnostics/codes/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","names":[],"sources":["../../../src/diagnostics/codes/publish.ts"],"mappings":";;;qBAMa;;YAQD,gCAAgC"}

package/dist/diagnostics/codes/publish.js

@@ -0,0 +1,44 @@
+//#region src/diagnostics/codes/publish.ts
+/** The codes of the PUBLISH area, in the order they were added. */
+const publishDiagnosticCodes = [
+	"MOSTRA_PUBLISH_ID_CONFLICT",
+	"MOSTRA_PUBLISH_SOURCE_CHANGED",
+	"MOSTRA_PUBLISH_VERIFY_FAILED"
+];
+/** The PUBLISH area's catalog entries. */
+const publishDiagnostics = {
+	MOSTRA_PUBLISH_ID_CONFLICT: {
+		severity: "error",
+		phase: "publish",
+		title: "Artifact ID claimed by two sources",
+		hint: "Give one of the two sources a different `id`, or delete the `id` line from the copy so it becomes a new artifact.",
+		docs: {
+			explanation: "An artifact's `id` names exactly one source. Mostra reports this code when a manifest claims an `id` that is already bound to another source path whose entry still claims it, which usually means a directory was copied. A source that moved, so that the old path no longer claims the `id`, is rebound instead. The message names both paths.",
+			fix: "Decide which source is the artifact. In the other one, remove the `id` from the manifest (it is then bound to its own path at its first publish) or replace it with a new ID from `mostra new`."
+		}
+	},
+	MOSTRA_PUBLISH_SOURCE_CHANGED: {
+		severity: "error",
+		phase: "publish",
+		title: "Source changed during the publish",
+		hint: "Publish again once the artifact's files have stopped changing.",
+		docs: {
+			explanation: "Publishing reads the entry's manifest twice: once to find the artifact, and again from the snapshot it builds. Mostra reports this code when the two disagree about which artifact the source is, because the manifest `id` or the source's binding changed while the publish ran, for example when an editor saved the entry mid-publish or another publish rebound the path. Nothing was published.",
+			fix: "Wait until the files are saved and nothing else is publishing the same source, then publish again. If the manifest `id` was changed on purpose, the next publish uses the new one."
+		}
+	},
+	MOSTRA_PUBLISH_VERIFY_FAILED: {
+		severity: "error",
+		phase: "publish",
+		title: "Verify found errors",
+		hint: "Run `mostra verify` to see the errors and fix them, or publish with `--force` to record them in the version.",
+		docs: {
+			explanation: "Publish runs verify (or reuses the verdict it cached for the same source and environment) and refuses when the verdict has errors (D41). The message lists their codes. Nothing was published. With `--force`, publish goes ahead and records the codes in the version, where hosts read them; a source that doesn't build can't be published either way.",
+			fix: "Fix the errors `mostra verify` reports and publish again, or publish with `--force` if the version must ship as it is."
+		}
+	}
+};
+//#endregion
+export { publishDiagnosticCodes, publishDiagnostics };
+
+//# sourceMappingURL=publish.js.map

package/dist/diagnostics/codes/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","names":[],"sources":["../../../src/diagnostics/codes/publish.ts"],"sourcesContent":["/**\n * Diagnostic codes of the PUBLISH area.\n */\nimport type { AreaCatalog } from \"../spec.ts\";\n\n/** The codes of the PUBLISH area, in the order they were added. */\nexport const publishDiagnosticCodes = [\n  \"MOSTRA_PUBLISH_ID_CONFLICT\",\n  \"MOSTRA_PUBLISH_SOURCE_CHANGED\",\n  \"MOSTRA_PUBLISH_VERIFY_FAILED\",\n  // gen:codes\n] as const;\n\n/** The codes of the PUBLISH area. */\nexport type PublishDiagnosticCode = (typeof publishDiagnosticCodes)[number];\n\n/** The PUBLISH area's catalog entries. */\nexport const publishDiagnostics: AreaCatalog<PublishDiagnosticCode> = {\n  MOSTRA_PUBLISH_ID_CONFLICT: {\n    severity: \"error\",\n    phase: \"publish\",\n    title: \"Artifact ID claimed by two sources\",\n    hint: \"Give one of the two sources a different `id`, or delete the `id` line from the copy so it becomes a new artifact.\",\n    docs: {\n      explanation:\n        \"An artifact's `id` names exactly one source. Mostra reports this code when a manifest claims an `id` that is already bound to another source path whose entry still claims it, which usually means a directory was copied. A source that moved, so that the old path no longer claims the `id`, is rebound instead. The message names both paths.\",\n      fix: \"Decide which source is the artifact. In the other one, remove the `id` from the manifest (it is then bound to its own path at its first publish) or replace it with a new ID from `mostra new`.\",\n    },\n  },\n  MOSTRA_PUBLISH_SOURCE_CHANGED: {\n    severity: \"error\",\n    phase: \"publish\",\n    title: \"Source changed during the publish\",\n    hint: \"Publish again once the artifact's files have stopped changing.\",\n    docs: {\n      explanation:\n        \"Publishing reads the entry's manifest twice: once to find the artifact, and again from the snapshot it builds. Mostra reports this code when the two disagree about which artifact the source is, because the manifest `id` or the source's binding changed while the publish ran, for example when an editor saved the entry mid-publish or another publish rebound the path. Nothing was published.\",\n      fix: \"Wait until the files are saved and nothing else is publishing the same source, then publish again. If the manifest `id` was changed on purpose, the next publish uses the new one.\",\n    },\n  },\n  MOSTRA_PUBLISH_VERIFY_FAILED: {\n    severity: \"error\",\n    phase: \"publish\",\n    title: \"Verify found errors\",\n    hint: \"Run `mostra verify` to see the errors and fix them, or publish with `--force` to record them in the version.\",\n    docs: {\n      explanation:\n        \"Publish runs verify (or reuses the verdict it cached for the same source and environment) and refuses when the verdict has errors (D41). The message lists their codes. Nothing was published. With `--force`, publish goes ahead and records the codes in the version, where hosts read them; a source that doesn't build can't be published either way.\",\n      fix: \"Fix the errors `mostra verify` reports and publish again, or publish with `--force` if the version must ship as it is.\",\n    },\n  },\n  // gen:entries\n};\n"],"mappings":";;AAMA,MAAa,yBAAyB;CACpC;CACA;CACA;AAEF;;AAMA,MAAa,qBAAyD;CACpE,4BAA4B;EAC1B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,+BAA+B;EAC7B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,8BAA8B;EAC5B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;AAEF"}

package/dist/diagnostics/codes/regression.d.ts

@@ -0,0 +1,8 @@
+import "../spec.js";
+//#region src/diagnostics/codes/regression.d.ts
+/** The codes of the REGRESSION area, in the order they were added. */
+export declare const regressionDiagnosticCodes: readonly ["MOSTRA_REGRESSION_ARIA", "MOSTRA_REGRESSION_PIXELS", "MOSTRA_REGRESSION_FIELD_REMOVED", "MOSTRA_REGRESSION_ACTION_REMOVED", "MOSTRA_REGRESSION_LIVE_REMOVED", "MOSTRA_REGRESSION_PAGE_REMOVED"];
+/** The codes of the REGRESSION area. */
+export type RegressionDiagnosticCode = (typeof regressionDiagnosticCodes)[number];
+//#endregion
+//# sourceMappingURL=regression.d.ts.map

package/dist/diagnostics/codes/regression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regression.d.ts","names":[],"sources":["../../../src/diagnostics/codes/regression.ts"],"mappings":";;;qBAMa;;YAWD,mCAAmC"}

package/dist/diagnostics/codes/regression.js

@@ -0,0 +1,77 @@
+//#region src/diagnostics/codes/regression.ts
+/** The codes of the REGRESSION area, in the order they were added. */
+const regressionDiagnosticCodes = [
+	"MOSTRA_REGRESSION_ARIA",
+	"MOSTRA_REGRESSION_PIXELS",
+	"MOSTRA_REGRESSION_FIELD_REMOVED",
+	"MOSTRA_REGRESSION_ACTION_REMOVED",
+	"MOSTRA_REGRESSION_LIVE_REMOVED",
+	"MOSTRA_REGRESSION_PAGE_REMOVED"
+];
+/** The REGRESSION area's catalog entries. */
+const regressionDiagnostics = {
+	MOSTRA_REGRESSION_ARIA: {
+		severity: "warning",
+		phase: "regression",
+		title: "Controls or landmarks gone since the last passing version",
+		hint: "Observed only: the last passing version had these controls or landmarks and this source doesn't; a change that removed them on purpose needs nothing more.",
+		docs: {
+			explanation: "Verify compared this source's accessibility snapshot with the newest version whose verdict passed, rendered in the same run with the same data. The controls or landmarks the message lists (by role and name) were there and aren't now. A redesign may remove them on purpose.",
+			fix: "If they should be gone, nothing needs to change. If not, look at what removed them."
+		}
+	},
+	MOSTRA_REGRESSION_PIXELS: {
+		severity: "warning",
+		phase: "regression",
+		title: "Page looks different from the last passing version",
+		hint: "Observed only: this share of the viewport's pixels differs from the last passing version; an intended visual change shows here too and needs nothing more.",
+		docs: {
+			explanation: "Verify rendered the newest version whose verdict passed and this source at the same viewport, clock and data, and the share of pixels the message gives differs between them. Any intended visual change shows here too.",
+			fix: "If the change is one you made on purpose, nothing needs to change. To see where it is, read the ARIA snapshots, or look at the diff image the message names if you can view images."
+		}
+	},
+	MOSTRA_REGRESSION_FIELD_REMOVED: {
+		severity: "warning",
+		phase: "contract",
+		title: "Field gone since the last passing version",
+		hint: "Observed only: answers saved under this field ID won't carry over to this version; a field removed on purpose needs nothing more.",
+		docs: {
+			explanation: "A field ID the last passing version used is gone from this source. Viewers' answers under it become orphans when they switch (D42): kept, shown read-only and delivered, but not editable. The message gives how many saved answers it affects.",
+			fix: "If the field was renamed by mistake, keep its old ID. If it was removed on purpose, nothing needs to change."
+		}
+	},
+	MOSTRA_REGRESSION_ACTION_REMOVED: {
+		severity: "warning",
+		phase: "contract",
+		title: "Server function gone since the last passing version",
+		hint: "Observed only: the last passing version had this server function and this source doesn't; one removed on purpose needs nothing more.",
+		docs: {
+			explanation: "A `\"use server\"` export the last passing version had is gone. Pages of the older version still call it while they are open, and keyed runs started by it can't be started again.",
+			fix: "If it was renamed by mistake, keep its name. If it was removed on purpose, nothing needs to change."
+		}
+	},
+	MOSTRA_REGRESSION_LIVE_REMOVED: {
+		severity: "warning",
+		phase: "contract",
+		title: "Live source gone since the last passing version",
+		hint: "Observed only: the last passing version had this live source and this source doesn't; one removed on purpose needs nothing more.",
+		docs: {
+			explanation: "A live source (`live.ts` export) the last passing version had is gone, so its producer stops and hosts that push to it push to a key no page reads.",
+			fix: "If it was renamed by mistake, keep its name. If it was removed on purpose, nothing needs to change."
+		}
+	},
+	MOSTRA_REGRESSION_PAGE_REMOVED: {
+		severity: "warning",
+		phase: "contract",
+		title: "Page route gone since the last passing version",
+		hint: "Observed only: the last passing version had this page route and this source doesn't; one removed on purpose needs nothing more.",
+		docs: {
+			explanation: "A route of `pages/` the last passing version had is gone, so links and bookmarks to it now open the artifact's fallback page.",
+			fix: "If it was renamed by mistake, keep its path. If it was removed on purpose, nothing needs to change."
+		}
+	}
+};
+//#endregion
+export { regressionDiagnosticCodes, regressionDiagnostics };
+
+//# sourceMappingURL=regression.js.map

package/dist/diagnostics/codes/regression.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regression.js","names":[],"sources":["../../../src/diagnostics/codes/regression.ts"],"sourcesContent":["/**\n * Diagnostic codes of the REGRESSION area.\n */\nimport type { AreaCatalog } from \"../spec.ts\";\n\n/** The codes of the REGRESSION area, in the order they were added. */\nexport const regressionDiagnosticCodes = [\n  \"MOSTRA_REGRESSION_ARIA\",\n  \"MOSTRA_REGRESSION_PIXELS\",\n  \"MOSTRA_REGRESSION_FIELD_REMOVED\",\n  \"MOSTRA_REGRESSION_ACTION_REMOVED\",\n  \"MOSTRA_REGRESSION_LIVE_REMOVED\",\n  \"MOSTRA_REGRESSION_PAGE_REMOVED\",\n  // gen:codes\n] as const;\n\n/** The codes of the REGRESSION area. */\nexport type RegressionDiagnosticCode = (typeof regressionDiagnosticCodes)[number];\n\n/** The REGRESSION area's catalog entries. */\nexport const regressionDiagnostics: AreaCatalog<RegressionDiagnosticCode> = {\n  MOSTRA_REGRESSION_ARIA: {\n    severity: \"warning\",\n    phase: \"regression\",\n    title: \"Controls or landmarks gone since the last passing version\",\n    hint: \"Observed only: the last passing version had these controls or landmarks and this source doesn't; a change that removed them on purpose needs nothing more.\",\n    docs: {\n      explanation:\n        \"Verify compared this source's accessibility snapshot with the newest version whose verdict passed, rendered in the same run with the same data. The controls or landmarks the message lists (by role and name) were there and aren't now. A redesign may remove them on purpose.\",\n      fix: \"If they should be gone, nothing needs to change. If not, look at what removed them.\",\n    },\n  },\n  MOSTRA_REGRESSION_PIXELS: {\n    severity: \"warning\",\n    phase: \"regression\",\n    title: \"Page looks different from the last passing version\",\n    hint: \"Observed only: this share of the viewport's pixels differs from the last passing version; an intended visual change shows here too and needs nothing more.\",\n    docs: {\n      explanation:\n        \"Verify rendered the newest version whose verdict passed and this source at the same viewport, clock and data, and the share of pixels the message gives differs between them. Any intended visual change shows here too.\",\n      fix: \"If the change is one you made on purpose, nothing needs to change. To see where it is, read the ARIA snapshots, or look at the diff image the message names if you can view images.\",\n    },\n  },\n  MOSTRA_REGRESSION_FIELD_REMOVED: {\n    severity: \"warning\",\n    phase: \"contract\",\n    title: \"Field gone since the last passing version\",\n    hint: \"Observed only: answers saved under this field ID won't carry over to this version; a field removed on purpose needs nothing more.\",\n    docs: {\n      explanation:\n        \"A field ID the last passing version used is gone from this source. Viewers' answers under it become orphans when they switch (D42): kept, shown read-only and delivered, but not editable. The message gives how many saved answers it affects.\",\n      fix: \"If the field was renamed by mistake, keep its old ID. If it was removed on purpose, nothing needs to change.\",\n    },\n  },\n  MOSTRA_REGRESSION_ACTION_REMOVED: {\n    severity: \"warning\",\n    phase: \"contract\",\n    title: \"Server function gone since the last passing version\",\n    hint: \"Observed only: the last passing version had this server function and this source doesn't; one removed on purpose needs nothing more.\",\n    docs: {\n      explanation:\n        'A `\"use server\"` export the last passing version had is gone. Pages of the older version still call it while they are open, and keyed runs started by it can\\'t be started again.',\n      fix: \"If it was renamed by mistake, keep its name. If it was removed on purpose, nothing needs to change.\",\n    },\n  },\n  MOSTRA_REGRESSION_LIVE_REMOVED: {\n    severity: \"warning\",\n    phase: \"contract\",\n    title: \"Live source gone since the last passing version\",\n    hint: \"Observed only: the last passing version had this live source and this source doesn't; one removed on purpose needs nothing more.\",\n    docs: {\n      explanation:\n        \"A live source (`live.ts` export) the last passing version had is gone, so its producer stops and hosts that push to it push to a key no page reads.\",\n      fix: \"If it was renamed by mistake, keep its name. If it was removed on purpose, nothing needs to change.\",\n    },\n  },\n  MOSTRA_REGRESSION_PAGE_REMOVED: {\n    severity: \"warning\",\n    phase: \"contract\",\n    title: \"Page route gone since the last passing version\",\n    hint: \"Observed only: the last passing version had this page route and this source doesn't; one removed on purpose needs nothing more.\",\n    docs: {\n      explanation:\n        \"A route of `pages/` the last passing version had is gone, so links and bookmarks to it now open the artifact's fallback page.\",\n      fix: \"If it was renamed by mistake, keep its path. If it was removed on purpose, nothing needs to change.\",\n    },\n  },\n  // gen:entries\n};\n"],"mappings":";;AAMA,MAAa,4BAA4B;CACvC;CACA;CACA;CACA;CACA;CACA;AAEF;;AAMA,MAAa,wBAA+D;CAC1E,wBAAwB;EACtB,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,0BAA0B;EACxB,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,iCAAiC;EAC/B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,kCAAkC;EAChC,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,gCAAgC;EAC9B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,gCAAgC;EAC9B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;AAEF"}

package/dist/diagnostics/codes/runtime.d.ts

@@ -0,0 +1,8 @@
+import "../spec.js";
+//#region src/diagnostics/codes/runtime.d.ts
+/** The codes of the RUNTIME area, in the order they were added. */
+export declare const runtimeDiagnosticCodes: readonly ["MOSTRA_RUNTIME_WORKER_CRASHED", "MOSTRA_RUNTIME_WORKER_PARKED", "MOSTRA_RUNTIME_PAGE_ERROR", "MOSTRA_RUNTIME_BLANK", "MOSTRA_RUNTIME_NOT_READY"];
+/** The codes of the RUNTIME area. */
+export type RuntimeDiagnosticCode = (typeof runtimeDiagnosticCodes)[number];
+//#endregion
+//# sourceMappingURL=runtime.d.ts.map

package/dist/diagnostics/codes/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","names":[],"sources":["../../../src/diagnostics/codes/runtime.ts"],"mappings":";;;qBAMa;;YAUD,gCAAgC"}

package/dist/diagnostics/codes/runtime.js

@@ -0,0 +1,66 @@
+//#region src/diagnostics/codes/runtime.ts
+/** The codes of the RUNTIME area, in the order they were added. */
+const runtimeDiagnosticCodes = [
+	"MOSTRA_RUNTIME_WORKER_CRASHED",
+	"MOSTRA_RUNTIME_WORKER_PARKED",
+	"MOSTRA_RUNTIME_PAGE_ERROR",
+	"MOSTRA_RUNTIME_BLANK",
+	"MOSTRA_RUNTIME_NOT_READY"
+];
+/** The RUNTIME area's catalog entries. */
+const runtimeDiagnostics = {
+	MOSTRA_RUNTIME_WORKER_CRASHED: {
+		severity: "error",
+		phase: "runtime",
+		title: "Artifact server code crashed",
+		hint: "Read the cause and the worker's last output, fix the server code, and publish again.",
+		docs: {
+			explanation: "The artifact version's worker process exited while serving a call: it threw outside any call, ran out of its heap (1 GiB by default), or kept its event loop blocked past the watchdog (10 s by default). Other artifacts and the gateway keep working (RT-04). Mostra appends `worker.crashed` with the cause and starts the worker again on the next request, waiting longer after each crash (1 s up to 60 s). `verify` reports it too when the source's server code crashes, fails to load or hangs while the page renders, even when the page handled the failed call.",
+			fix: "Fix the crash in the server code. A long synchronous computation can raise `limits.watchdogMs` in the manifest, and a large data set `limits.heapMb`; both are stability limits, not security ones."
+		}
+	},
+	MOSTRA_RUNTIME_WORKER_PARKED: {
+		severity: "error",
+		phase: "runtime",
+		title: "Artifact server code keeps crashing",
+		hint: "Fix the server code and publish again, which clears the park; the message names the last crash's cause.",
+		docs: {
+			explanation: "The artifact version's worker crashed more than 5 times in 10 minutes, so Mostra stopped starting it (FAILURE_MODEL §2). Calls, runs and live sources of that version answer this code until the park clears, and the shell tells the viewer that the artifact's server code keeps crashing.",
+			fix: "Find the cause in the message and the worker's output, fix it, and publish again: a new publish, `verify` or a restart of the instance clears the park."
+		}
+	},
+	MOSTRA_RUNTIME_PAGE_ERROR: {
+		severity: "error",
+		phase: "runtime",
+		title: "Uncaught error in the page",
+		hint: "Fix the error the message names; it was thrown in the page and nothing caught it.",
+		docs: {
+			explanation: "The artifact's page threw an error that nothing caught, or a promise rejected with nothing handling it, while verify rendered it or while the smoke test used a control (the message says which). A viewer's page would meet the same error.",
+			fix: "Find the stack's first frame in the artifact's code and fix the error there, or catch it where the page can recover."
+		}
+	},
+	MOSTRA_RUNTIME_BLANK: {
+		severity: "error",
+		phase: "runtime",
+		title: "Page rendered nothing",
+		hint: "Make the page render something visible; check its first render and its imports.",
+		docs: {
+			explanation: "After the page reported ready, no element had a visible box (text, image, SVG, canvas or video) and the screenshot was one uniform color. Usually the page threw during its first render, rendered nothing until data arrived, or hid everything with CSS.",
+			fix: "Look at the other diagnostics for an error during the first render, and make the page show content (or a loading state) right away."
+		}
+	},
+	MOSTRA_RUNTIME_NOT_READY: {
+		severity: "error",
+		phase: "runtime",
+		title: "Page never became ready",
+		hint: "Make sure the entry's default export renders; check the other diagnostics for an error at load.",
+		docs: {
+			explanation: "The page never reported `mostra/ready`: the client runtime didn't mount it within the time verify allows, usually because the entry threw while loading or a module failed to load.",
+			fix: "Fix the load error the other diagnostics report. A page that waits for data should render a loading state first."
+		}
+	}
+};
+//#endregion
+export { runtimeDiagnosticCodes, runtimeDiagnostics };
+
+//# sourceMappingURL=runtime.js.map

package/dist/diagnostics/codes/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":[],"sources":["../../../src/diagnostics/codes/runtime.ts"],"sourcesContent":["/**\n * Diagnostic codes of the RUNTIME area.\n */\nimport type { AreaCatalog } from \"../spec.ts\";\n\n/** The codes of the RUNTIME area, in the order they were added. */\nexport const runtimeDiagnosticCodes = [\n  \"MOSTRA_RUNTIME_WORKER_CRASHED\",\n  \"MOSTRA_RUNTIME_WORKER_PARKED\",\n  \"MOSTRA_RUNTIME_PAGE_ERROR\",\n  \"MOSTRA_RUNTIME_BLANK\",\n  \"MOSTRA_RUNTIME_NOT_READY\",\n  // gen:codes\n] as const;\n\n/** The codes of the RUNTIME area. */\nexport type RuntimeDiagnosticCode = (typeof runtimeDiagnosticCodes)[number];\n\n/** The RUNTIME area's catalog entries. */\nexport const runtimeDiagnostics: AreaCatalog<RuntimeDiagnosticCode> = {\n  MOSTRA_RUNTIME_WORKER_CRASHED: {\n    severity: \"error\",\n    phase: \"runtime\",\n    title: \"Artifact server code crashed\",\n    hint: \"Read the cause and the worker's last output, fix the server code, and publish again.\",\n    docs: {\n      explanation:\n        \"The artifact version's worker process exited while serving a call: it threw outside any call, ran out of its heap (1 GiB by default), or kept its event loop blocked past the watchdog (10 s by default). Other artifacts and the gateway keep working (RT-04). Mostra appends `worker.crashed` with the cause and starts the worker again on the next request, waiting longer after each crash (1 s up to 60 s). `verify` reports it too when the source's server code crashes, fails to load or hangs while the page renders, even when the page handled the failed call.\",\n      fix: \"Fix the crash in the server code. A long synchronous computation can raise `limits.watchdogMs` in the manifest, and a large data set `limits.heapMb`; both are stability limits, not security ones.\",\n    },\n  },\n  MOSTRA_RUNTIME_WORKER_PARKED: {\n    severity: \"error\",\n    phase: \"runtime\",\n    title: \"Artifact server code keeps crashing\",\n    hint: \"Fix the server code and publish again, which clears the park; the message names the last crash's cause.\",\n    docs: {\n      explanation:\n        \"The artifact version's worker crashed more than 5 times in 10 minutes, so Mostra stopped starting it (FAILURE_MODEL \\u00a72). Calls, runs and live sources of that version answer this code until the park clears, and the shell tells the viewer that the artifact's server code keeps crashing.\",\n      fix: \"Find the cause in the message and the worker's output, fix it, and publish again: a new publish, `verify` or a restart of the instance clears the park.\",\n    },\n  },\n  MOSTRA_RUNTIME_PAGE_ERROR: {\n    severity: \"error\",\n    phase: \"runtime\",\n    title: \"Uncaught error in the page\",\n    hint: \"Fix the error the message names; it was thrown in the page and nothing caught it.\",\n    docs: {\n      explanation:\n        \"The artifact's page threw an error that nothing caught, or a promise rejected with nothing handling it, while verify rendered it or while the smoke test used a control (the message says which). A viewer's page would meet the same error.\",\n      fix: \"Find the stack's first frame in the artifact's code and fix the error there, or catch it where the page can recover.\",\n    },\n  },\n  MOSTRA_RUNTIME_BLANK: {\n    severity: \"error\",\n    phase: \"runtime\",\n    title: \"Page rendered nothing\",\n    hint: \"Make the page render something visible; check its first render and its imports.\",\n    docs: {\n      explanation:\n        \"After the page reported ready, no element had a visible box (text, image, SVG, canvas or video) and the screenshot was one uniform color. Usually the page threw during its first render, rendered nothing until data arrived, or hid everything with CSS.\",\n      fix: \"Look at the other diagnostics for an error during the first render, and make the page show content (or a loading state) right away.\",\n    },\n  },\n  MOSTRA_RUNTIME_NOT_READY: {\n    severity: \"error\",\n    phase: \"runtime\",\n    title: \"Page never became ready\",\n    hint: \"Make sure the entry's default export renders; check the other diagnostics for an error at load.\",\n    docs: {\n      explanation:\n        \"The page never reported `mostra/ready`: the client runtime didn't mount it within the time verify allows, usually because the entry threw while loading or a module failed to load.\",\n      fix: \"Fix the load error the other diagnostics report. A page that waits for data should render a loading state first.\",\n    },\n  },\n  // gen:entries\n};\n"],"mappings":";;AAMA,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACA;AAEF;;AAMA,MAAa,qBAAyD;CACpE,+BAA+B;EAC7B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,8BAA8B;EAC5B,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,2BAA2B;EACzB,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,sBAAsB;EACpB,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,0BAA0B;EACxB,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;AAEF"}

package/dist/diagnostics/codes/secret.d.ts

@@ -0,0 +1,8 @@
+import "../spec.js";
+//#region src/diagnostics/codes/secret.d.ts
+/** The codes of the SECRET area, in the order they were added. */
+export declare const secretDiagnosticCodes: readonly ["MOSTRA_SECRET_MISSING"];
+/** The codes of the SECRET area. */
+export type SecretDiagnosticCode = (typeof secretDiagnosticCodes)[number];
+//#endregion
+//# sourceMappingURL=secret.d.ts.map

package/dist/diagnostics/codes/secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.d.ts","names":[],"sources":["../../../src/diagnostics/codes/secret.ts"],"mappings":";;;qBAMa;;YAMD,+BAA+B"}

package/dist/diagnostics/codes/secret.js

@@ -0,0 +1,18 @@
+//#region src/diagnostics/codes/secret.ts
+/** The codes of the SECRET area, in the order they were added. */
+const secretDiagnosticCodes = ["MOSTRA_SECRET_MISSING"];
+/** The SECRET area's catalog entries. */
+const secretDiagnostics = { MOSTRA_SECRET_MISSING: {
+	severity: "error",
+	phase: "runtime",
+	title: "Secret not set",
+	hint: "Set the secret with `mostra secret set NAME`, reading the value from stdin.",
+	docs: {
+		explanation: "Server code called `secret(name)` for a secret that neither the host's `secrets` port, the artifact's own secrets nor the home's shared secrets hold (D44). The call throws, and an action run fails with this code.",
+		fix: "Set the secret for the artifact (`mostra secret set NAME --artifact <path|id>`) or for every artifact of the home (`mostra secret set NAME`), passing the value on stdin, then run the action again. Secret values never go into the artifact's source."
+	}
+} };
+//#endregion
+export { secretDiagnosticCodes, secretDiagnostics };
+
+//# sourceMappingURL=secret.js.map

package/dist/diagnostics/codes/secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.js","names":[],"sources":["../../../src/diagnostics/codes/secret.ts"],"sourcesContent":["/**\n * Diagnostic codes of the SECRET area.\n */\nimport type { AreaCatalog } from \"../spec.ts\";\n\n/** The codes of the SECRET area, in the order they were added. */\nexport const secretDiagnosticCodes = [\n  \"MOSTRA_SECRET_MISSING\",\n  // gen:codes\n] as const;\n\n/** The codes of the SECRET area. */\nexport type SecretDiagnosticCode = (typeof secretDiagnosticCodes)[number];\n\n/** The SECRET area's catalog entries. */\nexport const secretDiagnostics: AreaCatalog<SecretDiagnosticCode> = {\n  MOSTRA_SECRET_MISSING: {\n    severity: \"error\",\n    phase: \"runtime\",\n    title: \"Secret not set\",\n    hint: \"Set the secret with `mostra secret set NAME`, reading the value from stdin.\",\n    docs: {\n      explanation:\n        \"Server code called `secret(name)` for a secret that neither the host's `secrets` port, the artifact's own secrets nor the home's shared secrets hold (D44). The call throws, and an action run fails with this code.\",\n      fix: \"Set the secret for the artifact (`mostra secret set NAME --artifact <path|id>`) or for every artifact of the home (`mostra secret set NAME`), passing the value on stdin, then run the action again. Secret values never go into the artifact's source.\",\n    },\n  },\n  // gen:entries\n};\n"],"mappings":";;AAMA,MAAa,wBAAwB,CACnC,uBAEF;;AAMA,MAAa,oBAAuD,EAClE,uBAAuB;CACrB,UAAU;CACV,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;EACJ,aACE;EACF,KAAK;CACP;AACF,EAEF"}

package/dist/diagnostics/codes/smoke.d.ts

@@ -0,0 +1,8 @@
+import "../spec.js";
+//#region src/diagnostics/codes/smoke.d.ts
+/** The codes of the SMOKE area, in the order they were added. */
+export declare const smokeDiagnosticCodes: readonly ["MOSTRA_SMOKE_NO_EFFECT", "MOSTRA_SMOKE_BUDGET"];
+/** The codes of the SMOKE area. */
+export type SmokeDiagnosticCode = (typeof smokeDiagnosticCodes)[number];
+//#endregion
+//# sourceMappingURL=smoke.d.ts.map

package/dist/diagnostics/codes/smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.d.ts","names":[],"sources":["../../../src/diagnostics/codes/smoke.ts"],"mappings":";;;qBAMa;;YAOD,8BAA8B"}

package/dist/diagnostics/codes/smoke.js

@@ -0,0 +1,30 @@
+//#region src/diagnostics/codes/smoke.ts
+/** The codes of the SMOKE area, in the order they were added. */
+const smokeDiagnosticCodes = ["MOSTRA_SMOKE_NO_EFFECT", "MOSTRA_SMOKE_BUDGET"];
+/** The SMOKE area's catalog entries. */
+const smokeDiagnostics = {
+	MOSTRA_SMOKE_NO_EFFECT: {
+		severity: "warning",
+		phase: "smoke",
+		title: "Control showed no effect",
+		hint: "Observed only: using this control twice changed nothing verify could see; a control that acts on something verify can't observe needs no change.",
+		docs: {
+			explanation: "Verify's smoke test clicked or hovered the control the message names, once among the other controls and again after them, and saw no change either time: no change to the page, no request, no saved field, no navigation and no error. Controls that are disabled or already active (the selected tab) are skipped, and those that open on hover are hovered. A control can still be fine: it may act on something verify can't observe, such as the clipboard or a sound.",
+			fix: "Read the control's handler. If it does what it should, nothing needs to change; if it is meant to change the page, look at why it doesn't."
+		}
+	},
+	MOSTRA_SMOKE_BUDGET: {
+		severity: "hint",
+		phase: "smoke",
+		title: "Smoke test stopped at its budget",
+		hint: "Nothing to fix: the smoke test stops after 200 interactions or 60 s.",
+		docs: {
+			explanation: "The page has more controls than the smoke test uses in one run, so it stopped at its budget. The controls it used are counted in `smoke.interactions`.",
+			fix: "Nothing is required."
+		}
+	}
+};
+//#endregion
+export { smokeDiagnosticCodes, smokeDiagnostics };
+
+//# sourceMappingURL=smoke.js.map

package/dist/diagnostics/codes/smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.js","names":[],"sources":["../../../src/diagnostics/codes/smoke.ts"],"sourcesContent":["/**\n * Diagnostic codes of the SMOKE area.\n */\nimport type { AreaCatalog } from \"../spec.ts\";\n\n/** The codes of the SMOKE area, in the order they were added. */\nexport const smokeDiagnosticCodes = [\n  \"MOSTRA_SMOKE_NO_EFFECT\",\n  \"MOSTRA_SMOKE_BUDGET\",\n  // gen:codes\n] as const;\n\n/** The codes of the SMOKE area. */\nexport type SmokeDiagnosticCode = (typeof smokeDiagnosticCodes)[number];\n\n/** The SMOKE area's catalog entries. */\nexport const smokeDiagnostics: AreaCatalog<SmokeDiagnosticCode> = {\n  MOSTRA_SMOKE_NO_EFFECT: {\n    severity: \"warning\",\n    phase: \"smoke\",\n    title: \"Control showed no effect\",\n    hint: \"Observed only: using this control twice changed nothing verify could see; a control that acts on something verify can't observe needs no change.\",\n    docs: {\n      explanation:\n        \"Verify's smoke test clicked or hovered the control the message names, once among the other controls and again after them, and saw no change either time: no change to the page, no request, no saved field, no navigation and no error. Controls that are disabled or already active (the selected tab) are skipped, and those that open on hover are hovered. A control can still be fine: it may act on something verify can't observe, such as the clipboard or a sound.\",\n      fix: \"Read the control's handler. If it does what it should, nothing needs to change; if it is meant to change the page, look at why it doesn't.\",\n    },\n  },\n  MOSTRA_SMOKE_BUDGET: {\n    severity: \"hint\",\n    phase: \"smoke\",\n    title: \"Smoke test stopped at its budget\",\n    hint: \"Nothing to fix: the smoke test stops after 200 interactions or 60 s.\",\n    docs: {\n      explanation:\n        \"The page has more controls than the smoke test uses in one run, so it stopped at its budget. The controls it used are counted in `smoke.interactions`.\",\n      fix: \"Nothing is required.\",\n    },\n  },\n  // gen:entries\n};\n"],"mappings":";;AAMA,MAAa,uBAAuB,CAClC,0BACA,qBAEF;;AAMA,MAAa,mBAAqD;CAChE,wBAAwB;EACtB,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;CACA,qBAAqB;EACnB,UAAU;EACV,OAAO;EACP,OAAO;EACP,MAAM;EACN,MAAM;GACJ,aACE;GACF,KAAK;EACP;CACF;AAEF"}

package/dist/diagnostics/codes/submit.d.ts

@@ -0,0 +1,8 @@
+import "../spec.js";
+//#region src/diagnostics/codes/submit.d.ts
+/** The codes of the SUBMIT area, in the order they were added. */
+export declare const submitDiagnosticCodes: readonly ["MOSTRA_SUBMIT_ALREADY", "MOSTRA_SUBMIT_REVISION_MOVED", "MOSTRA_SUBMIT_POLICY_NONE", "MOSTRA_SUBMIT_NOT_FOUND", "MOSTRA_SUBMIT_VIEW_INVALID", "MOSTRA_SUBMIT_SIGNAL_INVALID", "MOSTRA_SUBMIT_CHANNEL_DENIED", "MOSTRA_SUBMIT_BLOCKED"];
+/** The codes of the SUBMIT area. */
+export type SubmitDiagnosticCode = (typeof submitDiagnosticCodes)[number];
+//#endregion
+//# sourceMappingURL=submit.d.ts.map

package/dist/diagnostics/codes/submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submit.d.ts","names":[],"sources":["../../../src/diagnostics/codes/submit.ts"],"mappings":";;;qBAMa;;YAaD,+BAA+B"}