@vizejs/marquette 0.719.0 → 0.720.0

package/README.md

@@ -147,6 +147,61 @@ The canonical identifiers use the `native.*` namespace and are emitted in a
 stable order. The helper returns fresh values so an adapter may add private
 capabilities without changing the baseline used by another consumer.
 
+## Native build profiles
+
+Local and hosted native builders consume the same versioned profile. The
+profile selects the application marquette environment, lifecycle
+configuration, platform destinations, signing strategy, capability set, and
+optional update channel without embedding an executor, credentials, or secret
+values:
+
+```ts
+import { defineNativeBuildProfile } from "@vizejs/marquette/native-build";
+
+export default defineNativeBuildProfile({
+  format: "vize.native-build-profile",
+  formatVersion: 1,
+  profile: "production",
+  configuration: "production",
+  environment: "native",
+  targets: [
+    { platform: "android", destination: "store", signing: "automatic" },
+    { platform: "ios", destination: "store", signing: "manual" },
+  ],
+  capabilities: ["native.camera", "native.notifications"],
+  updates: { channel: "stable", runtimeVersion: "1.4.0" },
+});
+```
+
+Use `parseNativeBuildProfile` at an untrusted JSON boundary and
+`validateNativeBuildProfile` before scheduling a build. Parsing rejects
+unknown fields, including executor and secret fields. Validation produces
+stable path-ordered diagnostics for portable identifiers, duplicate targets,
+store signing and production policy, update compatibility, and capabilities.
+The published profile schema is available from
+`@vizejs/marquette/native-build/schema` and is embedded by the Rust contract
+crate for native hosts.
+
+## Typed navigation
+
+`@vizejs/marquette/navigation` derives programmatic navigation directly from
+the route literals in an application marquette. Full `:name` path segments
+accept one string or finite number. A `*name` segment preserves path separators
+while encoding each segment. The host adapter receives only a resolved route,
+environment, and encoded path.
+
+```ts
+import { createMarquetteNavigator } from "@vizejs/marquette/navigation";
+
+const navigation = createMarquetteNavigator(app, (target) => nativeHost.open(target));
+
+navigation.navigate("profile", { userId: "a user" });
+```
+
+Unknown routes and missing, extra, empty, or non-finite parameters are rejected
+before the target-specific adapter runs. Route identifiers, required parameter
+names, and the owning environment remain inferred from `app`.
+
 ## Test-run evidence
 
 Release-bound test-run evidence records live in their own lazy entries so
@@ -200,6 +255,8 @@ available from `@vizejs/marquette/test-run/schema`, the decision contract from
   `@vizejs/marquette/schema`.
 - The published adapter manifest schema is available from
   `@vizejs/marquette/adapter/schema`.
+- The published native build profile schema is available from
+  `@vizejs/marquette/native-build/schema`.
 - Every optional contract field documents its default in JSDoc.
 - Package builds enforce a 1 KiB gzip budget for authoring entries and 3 KiB
   or 4 KiB budgets for the validation entries.

package/dist/native-build-model-Bc13fH9p.mjs

@@ -0,0 +1,9 @@
+//#region src/native-build-model.ts
+/** Stable discriminator for serialized native build profiles. */
+const NATIVE_BUILD_PROFILE_FORMAT = "vize.native-build-profile";
+/** Current serialized native build profile version. */
+const NATIVE_BUILD_PROFILE_FORMAT_VERSION = 1;
+//#endregion
+export { NATIVE_BUILD_PROFILE_FORMAT_VERSION as n, NATIVE_BUILD_PROFILE_FORMAT as t };
+
+//# sourceMappingURL=native-build-model-Bc13fH9p.mjs.map

package/dist/native-build-model-Bc13fH9p.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-build-model-Bc13fH9p.mjs","names":[],"sources":["../src/native-build-model.ts"],"sourcesContent":["/** Stable discriminator for serialized native build profiles. */\nexport const NATIVE_BUILD_PROFILE_FORMAT = \"vize.native-build-profile\" as const;\n\n/** Current serialized native build profile version. */\nexport const NATIVE_BUILD_PROFILE_FORMAT_VERSION = 1 as const;\n\n/** Native application platforms understood by the managed build contract. */\nexport type NativeBuildPlatform = \"android\" | \"ios\";\n\n/** Intended lifecycle stage of a native build. */\nexport type NativeBuildConfiguration = \"development\" | \"preview\" | \"production\";\n\n/** Installation or distribution destination produced by one target. */\nexport type NativeBuildDestination = \"simulator\" | \"device\" | \"store\";\n\n/** How signing material is selected without embedding credentials in the profile. */\nexport type NativeBuildSigning = \"none\" | \"automatic\" | \"manual\";\n\n/** One platform and destination emitted from a native build profile. */\nexport interface NativeBuildTarget {\n  /** Native platform to build. */\n  readonly platform: NativeBuildPlatform;\n  /** Installation or distribution destination. */\n  readonly destination: NativeBuildDestination;\n  /**\n   * Signing selection implemented by the local or hosted executor.\n   *\n   * Credentials are supplied out of band and never serialized here.\n   *\n   * @default \"none\"\n   */\n  readonly signing?: NativeBuildSigning;\n}\n\n/** Over-the-air update selection attached to a native build. */\nexport interface NativeBuildUpdateSelection {\n  /** Portable rollout channel identifier. */\n  readonly channel: string;\n  /** Runtime compatibility version checked before applying an update. */\n  readonly runtimeVersion: string;\n}\n\n/**\n * Language-neutral profile consumed unchanged by local and hosted native builders.\n *\n * Execution location, credentials, and secret values deliberately stay outside\n * this record so the exact same profile can be admitted by either executor.\n */\nexport interface NativeBuildProfile {\n  /** Serialized record discriminator. */\n  readonly format: typeof NATIVE_BUILD_PROFILE_FORMAT;\n  /** Serialized contract version. */\n  readonly formatVersion: typeof NATIVE_BUILD_PROFILE_FORMAT_VERSION;\n  /** Stable profile identifier, such as `development` or `production`. */\n  readonly profile: string;\n  /** Intended lifecycle stage of the produced artifacts. */\n  readonly configuration: NativeBuildConfiguration;\n  /** Native environment identifier declared by the application marquette. */\n  readonly environment: string;\n  /** Non-empty platform and destination matrix. */\n  readonly targets: readonly NativeBuildTarget[];\n  /**\n   * Native capabilities required by every target in this profile.\n   *\n   * @default []\n   */\n  readonly capabilities?: readonly string[];\n  /** Optional over-the-air update compatibility selection. */\n  readonly updates?: NativeBuildUpdateSelection;\n}\n\n/** Stable validation code for a native build profile. */\nexport type NativeBuildProfileDiagnosticCode =\n  | \"invalid-format\"\n  | \"invalid-format-version\"\n  | \"invalid-profile-id\"\n  | \"invalid-environment-id\"\n  | \"missing-target\"\n  | \"duplicate-target\"\n  | \"store-requires-production\"\n  | \"store-requires-signing\"\n  | \"invalid-update-channel\"\n  | \"invalid-runtime-version\"\n  | \"invalid-capability-id\"\n  | \"duplicate-capability\";\n\n/** Deterministic semantic validation diagnostic for a native build profile. */\nexport interface NativeBuildProfileDiagnostic {\n  /** Stable machine-readable diagnostic code. */\n  readonly code: NativeBuildProfileDiagnosticCode;\n  /** JSON-style path of the invalid value. */\n  readonly path: string;\n  /** Human-readable explanation shared by every executor. */\n  readonly message: string;\n}\n"],"mappings":";;AACA,MAAa,8BAA8B;;AAG3C,MAAa,sCAAsC"}

package/dist/native-build-model-D8hXpun_.d.mts

@@ -0,0 +1,77 @@
+//#region src/native-build-model.d.ts
+/** Stable discriminator for serialized native build profiles. */
+declare const NATIVE_BUILD_PROFILE_FORMAT: "vize.native-build-profile";
+/** Current serialized native build profile version. */
+declare const NATIVE_BUILD_PROFILE_FORMAT_VERSION: 1;
+/** Native application platforms understood by the managed build contract. */
+type NativeBuildPlatform = "android" | "ios";
+/** Intended lifecycle stage of a native build. */
+type NativeBuildConfiguration = "development" | "preview" | "production";
+/** Installation or distribution destination produced by one target. */
+type NativeBuildDestination = "simulator" | "device" | "store";
+/** How signing material is selected without embedding credentials in the profile. */
+type NativeBuildSigning = "none" | "automatic" | "manual";
+/** One platform and destination emitted from a native build profile. */
+interface NativeBuildTarget {
+  /** Native platform to build. */
+  readonly platform: NativeBuildPlatform;
+  /** Installation or distribution destination. */
+  readonly destination: NativeBuildDestination;
+  /**
+   * Signing selection implemented by the local or hosted executor.
+   *
+   * Credentials are supplied out of band and never serialized here.
+   *
+   * @default "none"
+   */
+  readonly signing?: NativeBuildSigning;
+}
+/** Over-the-air update selection attached to a native build. */
+interface NativeBuildUpdateSelection {
+  /** Portable rollout channel identifier. */
+  readonly channel: string;
+  /** Runtime compatibility version checked before applying an update. */
+  readonly runtimeVersion: string;
+}
+/**
+ * Language-neutral profile consumed unchanged by local and hosted native builders.
+ *
+ * Execution location, credentials, and secret values deliberately stay outside
+ * this record so the exact same profile can be admitted by either executor.
+ */
+interface NativeBuildProfile {
+  /** Serialized record discriminator. */
+  readonly format: typeof NATIVE_BUILD_PROFILE_FORMAT;
+  /** Serialized contract version. */
+  readonly formatVersion: typeof NATIVE_BUILD_PROFILE_FORMAT_VERSION;
+  /** Stable profile identifier, such as `development` or `production`. */
+  readonly profile: string;
+  /** Intended lifecycle stage of the produced artifacts. */
+  readonly configuration: NativeBuildConfiguration;
+  /** Native environment identifier declared by the application marquette. */
+  readonly environment: string;
+  /** Non-empty platform and destination matrix. */
+  readonly targets: readonly NativeBuildTarget[];
+  /**
+   * Native capabilities required by every target in this profile.
+   *
+   * @default []
+   */
+  readonly capabilities?: readonly string[];
+  /** Optional over-the-air update compatibility selection. */
+  readonly updates?: NativeBuildUpdateSelection;
+}
+/** Stable validation code for a native build profile. */
+type NativeBuildProfileDiagnosticCode = "invalid-format" | "invalid-format-version" | "invalid-profile-id" | "invalid-environment-id" | "missing-target" | "duplicate-target" | "store-requires-production" | "store-requires-signing" | "invalid-update-channel" | "invalid-runtime-version" | "invalid-capability-id" | "duplicate-capability";
+/** Deterministic semantic validation diagnostic for a native build profile. */
+interface NativeBuildProfileDiagnostic {
+  /** Stable machine-readable diagnostic code. */
+  readonly code: NativeBuildProfileDiagnosticCode;
+  /** JSON-style path of the invalid value. */
+  readonly path: string;
+  /** Human-readable explanation shared by every executor. */
+  readonly message: string;
+}
+//#endregion
+export { NativeBuildPlatform as a, NativeBuildProfileDiagnosticCode as c, NativeBuildUpdateSelection as d, NativeBuildDestination as i, NativeBuildSigning as l, NATIVE_BUILD_PROFILE_FORMAT_VERSION as n, NativeBuildProfile as o, NativeBuildConfiguration as r, NativeBuildProfileDiagnostic as s, NATIVE_BUILD_PROFILE_FORMAT as t, NativeBuildTarget as u };
+//# sourceMappingURL=native-build-model-D8hXpun_.d.mts.map

package/dist/native-build-model-D8hXpun_.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-build-model-D8hXpun_.d.mts","names":[],"sources":["../src/native-build-model.ts"],"mappings":";;cACa,2BAAA;;cAGA,mCAAA;;KAGD,mBAAA;AAHZ;AAAA,KAMY,wBAAA;;KAGA,sBAAA;AATiD;AAAA,KAYjD,kBAAA;;UAGK,iBAAA;EAZc;EAAA,SAcpB,QAAA,EAAU,mBAAA;EAXT;EAAA,SAaD,WAAA,EAAa,sBAAA;;;AAbY;AAGpC;;;;WAkBW,OAAA,GAAU,kBAAA;AAAA;;UAIJ,0BAAA;EAnBa;EAAA,SAqBnB,OAAA;EAlBM;EAAA,SAoBN,cAAc;AAAA;;;;;;;UASR,kBAAA;EAzBN;EAAA,SA2BA,MAAA,SAAe,2BAAA;EAnBf;EAAA,SAqBA,aAAA,SAAsB,mCAAA;EArBM;EAAA,SAuB5B,OAAA;EAnBM;EAAA,SAqBN,aAAA,EAAe,wBAAA;;WAEf,WAAA;EAnBc;EAAA,SAqBd,OAAA,WAAkB,iBAAA;EAZM;;;;;EAAA,SAkBxB,YAAA;EAEU;EAAA,SAAV,OAAA,GAAU,0BAAA;AAAA;;KAIT,gCAAA;;UAeK,4BAAA;EAjCN;EAAA,SAmCA,IAAA,EAAM,gCAAgC;EAjCvB;EAAA,SAmCf,IAAA;EA/BA;EAAA,SAiCA,OAAA;AAAA"}

package/dist/native-build-profile.schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://vize.dev/schemas/native-build-profile-v1.json",
+  "title": "Vize native build profile",
+  "description": "A native build profile consumed unchanged by local and hosted executors.",
+  "$ref": "#/$defs/profile",
+  "$defs": {
+    "identifier": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]*$"
+    },
+    "runtimeVersion": {
+      "type": "string",
+      "pattern": "^[0-9A-Za-z][0-9A-Za-z._+-]*$"
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["platform", "destination"],
+      "properties": {
+        "platform": {
+          "enum": ["android", "ios"]
+        },
+        "destination": {
+          "enum": ["simulator", "device", "store"]
+        },
+        "signing": {
+          "enum": ["none", "automatic", "manual"],
+          "default": "none"
+        }
+      }
+    },
+    "updates": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["channel", "runtimeVersion"],
+      "properties": {
+        "channel": {
+          "$ref": "#/$defs/identifier"
+        },
+        "runtimeVersion": {
+          "$ref": "#/$defs/runtimeVersion"
+        }
+      }
+    },
+    "profile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["format", "formatVersion", "profile", "configuration", "environment", "targets"],
+      "properties": {
+        "format": {
+          "const": "vize.native-build-profile"
+        },
+        "formatVersion": {
+          "const": 1
+        },
+        "profile": {
+          "$ref": "#/$defs/identifier"
+        },
+        "configuration": {
+          "enum": ["development", "preview", "production"]
+        },
+        "environment": {
+          "$ref": "#/$defs/identifier"
+        },
+        "targets": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/target"
+          }
+        },
+        "capabilities": {
+          "type": "array",
+          "default": [],
+          "items": {
+            "$ref": "#/$defs/identifier"
+          }
+        },
+        "updates": {
+          "$ref": "#/$defs/updates"
+        }
+      }
+    }
+  }
+}

package/dist/native-build-validate.d.mts

@@ -0,0 +1,15 @@
+import { o as NativeBuildProfile, s as NativeBuildProfileDiagnostic } from "./native-build-model-D8hXpun_.mjs";
+
+//#region src/native-build-validate.d.ts
+/** Validates a native build profile without mutating it. */
+declare function validateNativeBuildProfile(profile: NativeBuildProfile): NativeBuildProfileDiagnostic[];
+/**
+ * Parses an untrusted native build profile with strict structural checks.
+ *
+ * Unknown fields and mismatched primitive or enum values throw before a local
+ * or hosted executor can inspect semantic diagnostics.
+ */
+declare function parseNativeBuildProfile(value: unknown): NativeBuildProfile;
+//#endregion
+export { parseNativeBuildProfile, validateNativeBuildProfile };
+//# sourceMappingURL=native-build-validate.d.mts.map

package/dist/native-build-validate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-build-validate.d.mts","names":[],"sources":["../src/native-build-validate.ts"],"mappings":";;;;iBA8BgB,0BAAA,CACd,OAAA,EAAS,kBAAA,GACR,4BAA4B;AAF/B;;;;;;AAAA,iBAuIgB,uBAAA,CAAwB,KAAA,YAAiB,kBAAkB"}

package/dist/native-build-validate.mjs

@@ -0,0 +1,140 @@
+import "./native-build-model-Bc13fH9p.mjs";
+//#region src/native-build-validate.ts
+const IDENTIFIER = /^[a-z0-9][a-z0-9._-]*$/;
+const RUNTIME_VERSION = /^[0-9A-Za-z][0-9A-Za-z._+-]*$/;
+const CONFIGURATIONS = new Set([
+	"development",
+	"preview",
+	"production"
+]);
+const PLATFORMS = new Set(["android", "ios"]);
+const DESTINATIONS = new Set([
+	"simulator",
+	"device",
+	"store"
+]);
+const SIGNING_MODES = new Set([
+	"none",
+	"automatic",
+	"manual"
+]);
+const DIAGNOSTIC_ORDER = {
+	"invalid-format": 0,
+	"invalid-format-version": 1,
+	"invalid-profile-id": 2,
+	"invalid-environment-id": 3,
+	"missing-target": 4,
+	"duplicate-target": 5,
+	"store-requires-production": 6,
+	"store-requires-signing": 7,
+	"invalid-update-channel": 8,
+	"invalid-runtime-version": 9,
+	"invalid-capability-id": 10,
+	"duplicate-capability": 11
+};
+/** Validates a native build profile without mutating it. */
+function validateNativeBuildProfile(profile) {
+	const diagnostics = [];
+	if (profile.format !== "vize.native-build-profile") diagnostics.push(diagnostic("invalid-format", "format", "unsupported native build profile format"));
+	if (profile.formatVersion !== 1) diagnostics.push(diagnostic("invalid-format-version", "formatVersion", "unsupported native build profile format version"));
+	if (!IDENTIFIER.test(profile.profile)) diagnostics.push(diagnostic("invalid-profile-id", "profile", "profile must be a lowercase portable identifier"));
+	if (!IDENTIFIER.test(profile.environment)) diagnostics.push(diagnostic("invalid-environment-id", "environment", "environment must be a lowercase portable identifier"));
+	if (profile.targets.length === 0) diagnostics.push(diagnostic("missing-target", "targets", "native build profile must declare a target"));
+	const seenTargets = /* @__PURE__ */ new Set();
+	for (const [index, target] of profile.targets.entries()) {
+		const path = `targets.${index}`;
+		const key = `${target.platform}:${target.destination}`;
+		if (seenTargets.has(key)) diagnostics.push(diagnostic("duplicate-target", path, "platform and destination must be unique within the native build profile"));
+		seenTargets.add(key);
+		if (target.destination === "store" && profile.configuration !== "production") diagnostics.push(diagnostic("store-requires-production", path, "store targets require the production configuration"));
+		if (target.destination === "store" && (target.signing ?? "none") === "none") diagnostics.push(diagnostic("store-requires-signing", `${path}.signing`, "store targets require automatic or manual signing"));
+	}
+	if (profile.updates !== void 0) {
+		if (!IDENTIFIER.test(profile.updates.channel)) diagnostics.push(diagnostic("invalid-update-channel", "updates.channel", "update channel must be a lowercase portable identifier"));
+		if (!RUNTIME_VERSION.test(profile.updates.runtimeVersion)) diagnostics.push(diagnostic("invalid-runtime-version", "updates.runtimeVersion", "runtime version must be a portable non-empty version token"));
+	}
+	const seenCapabilities = /* @__PURE__ */ new Set();
+	for (const [index, capability] of (profile.capabilities ?? []).entries()) {
+		const path = `capabilities.${index}`;
+		if (!IDENTIFIER.test(capability)) diagnostics.push(diagnostic("invalid-capability-id", path, "capability id must be a lowercase portable identifier"));
+		if (seenCapabilities.has(capability)) diagnostics.push(diagnostic("duplicate-capability", path, "capability id must be unique within the native build profile"));
+		seenCapabilities.add(capability);
+	}
+	return diagnostics.sort((left, right) => compareText(left.path, right.path) || DIAGNOSTIC_ORDER[left.code] - DIAGNOSTIC_ORDER[right.code] || compareText(left.message, right.message));
+}
+/**
+* Parses an untrusted native build profile with strict structural checks.
+*
+* Unknown fields and mismatched primitive or enum values throw before a local
+* or hosted executor can inspect semantic diagnostics.
+*/
+function parseNativeBuildProfile(value) {
+	assertRecord(value, "profile");
+	assertKnownFields(value, [
+		"format",
+		"formatVersion",
+		"profile",
+		"configuration",
+		"environment",
+		"targets",
+		"capabilities",
+		"updates"
+	], "profile");
+	assertString(value.format, "format");
+	if (typeof value.formatVersion !== "number" || !Number.isSafeInteger(value.formatVersion) || value.formatVersion < 0) throw new TypeError("formatVersion must be a safe integer");
+	assertString(value.profile, "profile");
+	assertEnum(value.configuration, CONFIGURATIONS, "configuration");
+	assertString(value.environment, "environment");
+	if (!Array.isArray(value.targets)) throw new TypeError("targets must be an array");
+	for (const [index, target] of value.targets.entries()) {
+		const path = `targets.${index}`;
+		assertRecord(target, path);
+		assertKnownFields(target, [
+			"platform",
+			"destination",
+			"signing"
+		], path);
+		assertEnum(target.platform, PLATFORMS, `${path}.platform`);
+		assertEnum(target.destination, DESTINATIONS, `${path}.destination`);
+		if (target.signing !== void 0) assertEnum(target.signing, SIGNING_MODES, `${path}.signing`);
+	}
+	if (value.capabilities !== void 0) {
+		if (!Array.isArray(value.capabilities)) throw new TypeError("capabilities must be an array");
+		for (const [index, capability] of value.capabilities.entries()) assertString(capability, `capabilities.${index}`);
+	}
+	if (value.updates !== void 0) {
+		assertRecord(value.updates, "updates");
+		assertKnownFields(value.updates, ["channel", "runtimeVersion"], "updates");
+		assertString(value.updates.channel, "updates.channel");
+		assertString(value.updates.runtimeVersion, "updates.runtimeVersion");
+	}
+	return value;
+}
+function diagnostic(code, path, message) {
+	return {
+		code,
+		path,
+		message
+	};
+}
+function assertRecord(value, path) {
+	if (value == null || typeof value !== "object" || Array.isArray(value)) throw new TypeError(`${path} must be an object`);
+}
+function assertKnownFields(value, expected, path) {
+	const known = new Set(expected);
+	const unknown = Object.keys(value).find((field) => !known.has(field));
+	if (unknown !== void 0) throw new TypeError(`${path} has unknown field ${unknown}`);
+}
+function assertString(value, path) {
+	if (typeof value !== "string") throw new TypeError(`${path} must be a string`);
+}
+function assertEnum(value, expected, path) {
+	if (typeof value !== "string" || !expected.has(value)) throw new TypeError(`${path} must be a supported string value`);
+}
+function compareText(left, right) {
+	return left < right ? -1 : left > right ? 1 : 0;
+}
+//#endregion
+export { parseNativeBuildProfile, validateNativeBuildProfile };
+
+//# sourceMappingURL=native-build-validate.mjs.map

package/dist/native-build-validate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-build-validate.mjs","names":[],"sources":["../src/native-build-validate.ts"],"sourcesContent":["import {\n  NATIVE_BUILD_PROFILE_FORMAT,\n  NATIVE_BUILD_PROFILE_FORMAT_VERSION,\n  type NativeBuildProfile,\n  type NativeBuildProfileDiagnostic,\n  type NativeBuildProfileDiagnosticCode,\n} from \"./native-build-model.js\";\n\nconst IDENTIFIER = /^[a-z0-9][a-z0-9._-]*$/;\nconst RUNTIME_VERSION = /^[0-9A-Za-z][0-9A-Za-z._+-]*$/;\nconst CONFIGURATIONS = new Set([\"development\", \"preview\", \"production\"]);\nconst PLATFORMS = new Set([\"android\", \"ios\"]);\nconst DESTINATIONS = new Set([\"simulator\", \"device\", \"store\"]);\nconst SIGNING_MODES = new Set([\"none\", \"automatic\", \"manual\"]);\nconst DIAGNOSTIC_ORDER: Record<NativeBuildProfileDiagnosticCode, number> = {\n  \"invalid-format\": 0,\n  \"invalid-format-version\": 1,\n  \"invalid-profile-id\": 2,\n  \"invalid-environment-id\": 3,\n  \"missing-target\": 4,\n  \"duplicate-target\": 5,\n  \"store-requires-production\": 6,\n  \"store-requires-signing\": 7,\n  \"invalid-update-channel\": 8,\n  \"invalid-runtime-version\": 9,\n  \"invalid-capability-id\": 10,\n  \"duplicate-capability\": 11,\n};\n\n/** Validates a native build profile without mutating it. */\nexport function validateNativeBuildProfile(\n  profile: NativeBuildProfile,\n): NativeBuildProfileDiagnostic[] {\n  const diagnostics: NativeBuildProfileDiagnostic[] = [];\n  if (profile.format !== NATIVE_BUILD_PROFILE_FORMAT) {\n    diagnostics.push(\n      diagnostic(\"invalid-format\", \"format\", \"unsupported native build profile format\"),\n    );\n  }\n  if (profile.formatVersion !== NATIVE_BUILD_PROFILE_FORMAT_VERSION) {\n    diagnostics.push(\n      diagnostic(\n        \"invalid-format-version\",\n        \"formatVersion\",\n        \"unsupported native build profile format version\",\n      ),\n    );\n  }\n  if (!IDENTIFIER.test(profile.profile)) {\n    diagnostics.push(\n      diagnostic(\n        \"invalid-profile-id\",\n        \"profile\",\n        \"profile must be a lowercase portable identifier\",\n      ),\n    );\n  }\n  if (!IDENTIFIER.test(profile.environment)) {\n    diagnostics.push(\n      diagnostic(\n        \"invalid-environment-id\",\n        \"environment\",\n        \"environment must be a lowercase portable identifier\",\n      ),\n    );\n  }\n  if (profile.targets.length === 0) {\n    diagnostics.push(\n      diagnostic(\"missing-target\", \"targets\", \"native build profile must declare a target\"),\n    );\n  }\n\n  const seenTargets = new Set<string>();\n  for (const [index, target] of profile.targets.entries()) {\n    const path = `targets.${index}`;\n    const key = `${target.platform}:${target.destination}`;\n    if (seenTargets.has(key)) {\n      diagnostics.push(\n        diagnostic(\n          \"duplicate-target\",\n          path,\n          \"platform and destination must be unique within the native build profile\",\n        ),\n      );\n    }\n    seenTargets.add(key);\n    if (target.destination === \"store\" && profile.configuration !== \"production\") {\n      diagnostics.push(\n        diagnostic(\n          \"store-requires-production\",\n          path,\n          \"store targets require the production configuration\",\n        ),\n      );\n    }\n    if (target.destination === \"store\" && (target.signing ?? \"none\") === \"none\") {\n      diagnostics.push(\n        diagnostic(\n          \"store-requires-signing\",\n          `${path}.signing`,\n          \"store targets require automatic or manual signing\",\n        ),\n      );\n    }\n  }\n\n  if (profile.updates !== undefined) {\n    if (!IDENTIFIER.test(profile.updates.channel)) {\n      diagnostics.push(\n        diagnostic(\n          \"invalid-update-channel\",\n          \"updates.channel\",\n          \"update channel must be a lowercase portable identifier\",\n        ),\n      );\n    }\n    if (!RUNTIME_VERSION.test(profile.updates.runtimeVersion)) {\n      diagnostics.push(\n        diagnostic(\n          \"invalid-runtime-version\",\n          \"updates.runtimeVersion\",\n          \"runtime version must be a portable non-empty version token\",\n        ),\n      );\n    }\n  }\n\n  const seenCapabilities = new Set<string>();\n  for (const [index, capability] of (profile.capabilities ?? []).entries()) {\n    const path = `capabilities.${index}`;\n    if (!IDENTIFIER.test(capability)) {\n      diagnostics.push(\n        diagnostic(\n          \"invalid-capability-id\",\n          path,\n          \"capability id must be a lowercase portable identifier\",\n        ),\n      );\n    }\n    if (seenCapabilities.has(capability)) {\n      diagnostics.push(\n        diagnostic(\n          \"duplicate-capability\",\n          path,\n          \"capability id must be unique within the native build profile\",\n        ),\n      );\n    }\n    seenCapabilities.add(capability);\n  }\n\n  return diagnostics.sort(\n    (left, right) =>\n      compareText(left.path, right.path) ||\n      DIAGNOSTIC_ORDER[left.code] - DIAGNOSTIC_ORDER[right.code] ||\n      compareText(left.message, right.message),\n  );\n}\n\n/**\n * Parses an untrusted native build profile with strict structural checks.\n *\n * Unknown fields and mismatched primitive or enum values throw before a local\n * or hosted executor can inspect semantic diagnostics.\n */\nexport function parseNativeBuildProfile(value: unknown): NativeBuildProfile {\n  assertRecord(value, \"profile\");\n  assertKnownFields(\n    value,\n    [\n      \"format\",\n      \"formatVersion\",\n      \"profile\",\n      \"configuration\",\n      \"environment\",\n      \"targets\",\n      \"capabilities\",\n      \"updates\",\n    ],\n    \"profile\",\n  );\n  assertString(value.format, \"format\");\n  if (\n    typeof value.formatVersion !== \"number\" ||\n    !Number.isSafeInteger(value.formatVersion) ||\n    value.formatVersion < 0\n  ) {\n    throw new TypeError(\"formatVersion must be a safe integer\");\n  }\n  assertString(value.profile, \"profile\");\n  assertEnum(value.configuration, CONFIGURATIONS, \"configuration\");\n  assertString(value.environment, \"environment\");\n  if (!Array.isArray(value.targets)) throw new TypeError(\"targets must be an array\");\n  for (const [index, target] of value.targets.entries()) {\n    const path = `targets.${index}`;\n    assertRecord(target, path);\n    assertKnownFields(target, [\"platform\", \"destination\", \"signing\"], path);\n    assertEnum(target.platform, PLATFORMS, `${path}.platform`);\n    assertEnum(target.destination, DESTINATIONS, `${path}.destination`);\n    if (target.signing !== undefined) {\n      assertEnum(target.signing, SIGNING_MODES, `${path}.signing`);\n    }\n  }\n  if (value.capabilities !== undefined) {\n    if (!Array.isArray(value.capabilities)) {\n      throw new TypeError(\"capabilities must be an array\");\n    }\n    for (const [index, capability] of value.capabilities.entries()) {\n      assertString(capability, `capabilities.${index}`);\n    }\n  }\n  if (value.updates !== undefined) {\n    assertRecord(value.updates, \"updates\");\n    assertKnownFields(value.updates, [\"channel\", \"runtimeVersion\"], \"updates\");\n    assertString(value.updates.channel, \"updates.channel\");\n    assertString(value.updates.runtimeVersion, \"updates.runtimeVersion\");\n  }\n  return value as unknown as NativeBuildProfile;\n}\n\nfunction diagnostic(\n  code: NativeBuildProfileDiagnosticCode,\n  path: string,\n  message: string,\n): NativeBuildProfileDiagnostic {\n  return { code, path, message };\n}\n\nfunction assertRecord(value: unknown, path: string): asserts value is Record<string, unknown> {\n  if (value == null || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new TypeError(`${path} must be an object`);\n  }\n}\n\nfunction assertKnownFields(\n  value: Record<string, unknown>,\n  expected: readonly string[],\n  path: string,\n): void {\n  const known = new Set(expected);\n  const unknown = Object.keys(value).find((field) => !known.has(field));\n  if (unknown !== undefined) throw new TypeError(`${path} has unknown field ${unknown}`);\n}\n\nfunction assertString(value: unknown, path: string): asserts value is string {\n  if (typeof value !== \"string\") throw new TypeError(`${path} must be a string`);\n}\n\nfunction assertEnum(value: unknown, expected: ReadonlySet<string>, path: string): void {\n  if (typeof value !== \"string\" || !expected.has(value)) {\n    throw new TypeError(`${path} must be a supported string value`);\n  }\n}\n\nfunction compareText(left: string, right: string): number {\n  return left < right ? -1 : left > right ? 1 : 0;\n}\n"],"mappings":"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"}

package/dist/native-build.d.mts

@@ -0,0 +1,12 @@
+import { a as NativeBuildPlatform, c as NativeBuildProfileDiagnosticCode, d as NativeBuildUpdateSelection, i as NativeBuildDestination, l as NativeBuildSigning, n as NATIVE_BUILD_PROFILE_FORMAT_VERSION, o as NativeBuildProfile, r as NativeBuildConfiguration, s as NativeBuildProfileDiagnostic, t as NATIVE_BUILD_PROFILE_FORMAT, u as NativeBuildTarget } from "./native-build-model-D8hXpun_.mjs";
+
+//#region src/native-build.d.ts
+/**
+ * Preserves literal profile, environment, platform, and capability types.
+ *
+ * The function returns its input unchanged so authoring has no runtime cost.
+ */
+declare function defineNativeBuildProfile<const Profile extends NativeBuildProfile>(profile: Profile): Profile;
+//#endregion
+export { NATIVE_BUILD_PROFILE_FORMAT, NATIVE_BUILD_PROFILE_FORMAT_VERSION, type NativeBuildConfiguration, type NativeBuildDestination, type NativeBuildPlatform, type NativeBuildProfile, type NativeBuildProfileDiagnostic, type NativeBuildProfileDiagnosticCode, type NativeBuildSigning, type NativeBuildTarget, type NativeBuildUpdateSelection, defineNativeBuildProfile };
+//# sourceMappingURL=native-build.d.mts.map

package/dist/native-build.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-build.d.mts","names":[],"sources":["../src/native-build.ts"],"mappings":";;;;AAqBA;;;;iBAAgB,wBAAA,uBAA+C,kBAAA,EAC7D,OAAA,EAAS,OAAA,GACR,OAAA"}

package/dist/native-build.mjs

@@ -0,0 +1,14 @@
+import { n as NATIVE_BUILD_PROFILE_FORMAT_VERSION, t as NATIVE_BUILD_PROFILE_FORMAT } from "./native-build-model-Bc13fH9p.mjs";
+//#region src/native-build.ts
+/**
+* Preserves literal profile, environment, platform, and capability types.
+*
+* The function returns its input unchanged so authoring has no runtime cost.
+*/
+function defineNativeBuildProfile(profile) {
+	return profile;
+}
+//#endregion
+export { NATIVE_BUILD_PROFILE_FORMAT, NATIVE_BUILD_PROFILE_FORMAT_VERSION, defineNativeBuildProfile };
+
+//# sourceMappingURL=native-build.mjs.map

package/dist/native-build.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-build.mjs","names":[],"sources":["../src/native-build.ts"],"sourcesContent":["export {\n  NATIVE_BUILD_PROFILE_FORMAT,\n  NATIVE_BUILD_PROFILE_FORMAT_VERSION,\n  type NativeBuildConfiguration,\n  type NativeBuildDestination,\n  type NativeBuildPlatform,\n  type NativeBuildProfile,\n  type NativeBuildProfileDiagnostic,\n  type NativeBuildProfileDiagnosticCode,\n  type NativeBuildSigning,\n  type NativeBuildTarget,\n  type NativeBuildUpdateSelection,\n} from \"./native-build-model.js\";\n\nimport type { NativeBuildProfile } from \"./native-build-model.js\";\n\n/**\n * Preserves literal profile, environment, platform, and capability types.\n *\n * The function returns its input unchanged so authoring has no runtime cost.\n */\nexport function defineNativeBuildProfile<const Profile extends NativeBuildProfile>(\n  profile: Profile,\n): Profile {\n  return profile;\n}\n"],"mappings":";;;;;;;AAqBA,SAAgB,yBACd,SACS;CACT,OAAO;AACT"}

package/dist/navigation.d.mts

@@ -0,0 +1,40 @@
+import { _ as RouteId, f as MarquetteRoute, t as ApplicationMarquette } from "./model-B_mM8AeH.mjs";
+
+//#region src/navigation.d.ts
+/** Scalar accepted by one authored route-path parameter. */
+type NavigationParameter = string | number;
+type DeclaredRoute<Marquette extends ApplicationMarquette> = Marquette extends {
+  readonly routes: readonly (infer Route extends MarquetteRoute)[];
+} ? Route : never;
+type RouteFor<Marquette extends ApplicationMarquette, Id extends RouteId<Marquette>> = Extract<DeclaredRoute<Marquette>, {
+  readonly id: Id;
+}>;
+type RoutePath<Marquette extends ApplicationMarquette, Id extends RouteId<Marquette>> = RouteFor<Marquette, Id>["path"];
+type SegmentParameter<Segment extends string> = Segment extends `:${infer Name}` ? Name extends "" ? never : Name : Segment extends `*${infer Name}` ? Name extends "" ? never : Name : never;
+type PathParameter<Path extends string> = Path extends `${infer Segment}/${infer Rest}` ? SegmentParameter<Segment> | PathParameter<Rest> : SegmentParameter<Path>;
+/** Exact route parameters inferred from full `:name` and `*name` path segments. */
+type NavigationParameters<Marquette extends ApplicationMarquette, Id extends RouteId<Marquette>> = { readonly [Name in PathParameter<RoutePath<Marquette, Id>>]: NavigationParameter };
+type NavigationArguments<Marquette extends ApplicationMarquette, Id extends RouteId<Marquette>> = [PathParameter<RoutePath<Marquette, Id>>] extends [never] ? [] : [parameters: NavigationParameters<Marquette, Id>];
+/** Target passed to a host adapter after route parameters are encoded. */
+type ResolvedNavigationTarget<Marquette extends ApplicationMarquette, Id extends RouteId<Marquette> = RouteId<Marquette>> = Id extends RouteId<Marquette> ? {
+  /** Authored route identifier. */readonly route: Id; /** Environment that owns the target view. */
+  readonly environment: RouteFor<Marquette, Id>["environment"]; /** Resolved path with every parameter percent-encoded. */
+  readonly path: `/${string}`;
+} : never;
+/** Programmatic navigation surface inferred from one application marquette. */
+interface MarquetteNavigator<Marquette extends ApplicationMarquette, Result> {
+  /** Resolve and deliver one route to the target-specific host adapter. */
+  readonly navigate: <const Id extends RouteId<Marquette>>(route: Id, ...arguments_: NavigationArguments<Marquette, Id>) => Result;
+}
+/**
+ * Creates a target-neutral, fully inferred programmatic navigator.
+ *
+ * A `:name` segment accepts one scalar and is encoded as one path segment. A
+ * `*name` segment also accepts a scalar, but preserves `/` between its encoded
+ * segments. Unknown routes, missing parameters, extra parameters, empty
+ * strings, and non-finite numbers fail before the host adapter runs.
+ */
+declare function createMarquetteNavigator<const Marquette extends ApplicationMarquette, Result>(marquette: Marquette, visit: (target: ResolvedNavigationTarget<Marquette>) => Result): MarquetteNavigator<Marquette, Result>;
+//#endregion
+export { MarquetteNavigator, NavigationParameter, NavigationParameters, ResolvedNavigationTarget, createMarquetteNavigator };
+//# sourceMappingURL=navigation.d.mts.map

package/dist/navigation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.mts","names":[],"sources":["../src/navigation.ts"],"mappings":";;;;KAGY,mBAAA;AAAA,KAEP,aAAA,mBAAgC,oBAAA,IAAwB,SAAA;EAAA,SAClD,MAAA,gCAAsC,cAAA;AAAA,IAE7C,KAAA;AAAA,KAGC,QAAA,mBAA2B,oBAAA,aAAiC,OAAA,CAAQ,SAAA,KAAc,OAAA,CACrF,aAAA,CAAc,SAAA;EAAA,SACH,EAAA,EAAI,EAAA;AAAA;AAAA,KAGZ,SAAA,mBAA4B,oBAAA,aAAiC,OAAA,CAAQ,SAAA,KAAc,QAAA,CACtF,SAAA,EACA,EAAA;AAAA,KAGG,gBAAA,2BAA2C,OAAA,4BAC5C,IAAA,sBAEE,IAAA,GACF,OAAO,4BACL,IAAA,sBAEE,IAAA;AAAA,KAGH,aAAA,wBAAqC,IAAA,4CACtC,gBAAA,CAAiB,OAAA,IAAW,aAAA,CAAc,IAAA,IAC1C,gBAAA,CAAiB,IAAA;;KAGT,oBAAA,mBACQ,oBAAA,aACP,OAAA,CAAQ,SAAA,yBAED,aAAA,CAAc,SAAA,CAAU,SAAA,EAAW,EAAA,KAAO,mBAAA;AAAA,KAGzD,mBAAA,mBAAsC,oBAAA,aAAiC,OAAA,CAAQ,SAAA,MAClF,aAAA,CAAc,SAAA,CAAU,SAAA,EAAW,EAAA,4BAGhC,UAAA,EAAY,oBAAA,CAAqB,SAAA,EAAW,EAAA;;KAGrC,wBAAA,mBACQ,oBAAA,aACP,OAAA,CAAQ,SAAA,IAAa,OAAA,CAAQ,SAAA,KAExC,EAAA,SAAW,OAAA,CAAQ,SAAA;EAhD4B,0CAmDhC,KAAA,EAAO,EAAA,EAjDf;EAAA,SAmDQ,WAAA,EAAa,QAAA,CAAS,SAAA,EAAW,EAAA,kBAhD7C;EAAA,SAkDY,IAAA;AAAA;;UAKA,kBAAA,mBAAqC,oBAAA;EAvDW;EAAA,SAyDtD,QAAA,oBAA4B,OAAA,CAAQ,SAAA,GAC3C,KAAA,EAAO,EAAA,KACJ,UAAA,EAAY,mBAAA,CAAoB,SAAA,EAAW,EAAA,MAC3C,MAAA;AAAA;;;;;;;;;iBAWS,wBAAA,yBAAiD,oBAAA,UAC/D,SAAA,EAAW,SAAA,EACX,KAAA,GAAQ,MAAA,EAAQ,wBAAA,CAAyB,SAAA,MAAe,MAAA,GACvD,kBAAA,CAAmB,SAAA,EAAW,MAAA"}

package/dist/navigation.mjs

@@ -0,0 +1,51 @@
+//#region src/navigation.ts
+/**
+* Creates a target-neutral, fully inferred programmatic navigator.
+*
+* A `:name` segment accepts one scalar and is encoded as one path segment. A
+* `*name` segment also accepts a scalar, but preserves `/` between its encoded
+* segments. Unknown routes, missing parameters, extra parameters, empty
+* strings, and non-finite numbers fail before the host adapter runs.
+*/
+function createMarquetteNavigator(marquette, visit) {
+	const routes = new Map((marquette.routes ?? []).map((route) => [route.id, route]));
+	const navigate = (routeId, parameters = {}) => {
+		const route = routes.get(routeId);
+		if (route == null) throw new Error(`Unknown navigation route "${routeId}".`);
+		return visit({
+			route: route.id,
+			environment: route.environment,
+			path: resolveNavigationPath(routeId, route.path, parameters)
+		});
+	};
+	return { navigate };
+}
+function resolveNavigationPath(routeId, template, parameters) {
+	const expected = parameterSegments(template);
+	const expectedNames = new Set(expected.map(({ name }) => name));
+	for (const { name } of expected) if (!Object.hasOwn(parameters, name)) throw new Error(`Missing navigation parameter "${name}" for route "${routeId}".`);
+	const extra = Object.keys(parameters).filter((name) => !expectedNames.has(name)).sort()[0];
+	if (extra != null) throw new Error(`Unexpected navigation parameter "${extra}" for route "${routeId}".`);
+	return template.split("/").map((segment) => {
+		const parameter = expected.find(({ authored }) => authored === segment);
+		if (parameter == null) return segment;
+		const value = parameters[parameter.name];
+		return encodeParameter(routeId, parameter.name, value, parameter.rest);
+	}).join("/");
+}
+function parameterSegments(template) {
+	return template.split("/").filter((segment) => (segment.startsWith(":") || segment.startsWith("*")) && segment.length > 1).map((authored) => ({
+		authored,
+		name: authored.slice(1),
+		rest: authored.startsWith("*")
+	}));
+}
+function encodeParameter(routeId, name, value, rest) {
+	if (typeof value !== "string" && typeof value !== "number" || typeof value === "string" && value.length === 0 || typeof value === "number" && !Number.isFinite(value)) throw new Error(`Invalid navigation parameter "${name}" for route "${routeId}".`);
+	const text = String(value);
+	return rest ? text.split("/").map(encodeURIComponent).join("/") : encodeURIComponent(text);
+}
+//#endregion
+export { createMarquetteNavigator };
+
+//# sourceMappingURL=navigation.mjs.map

package/dist/navigation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.mjs","names":[],"sources":["../src/navigation.ts"],"sourcesContent":["import type { ApplicationMarquette, MarquetteRoute, RouteId } from \"./model.js\";\n\n/** Scalar accepted by one authored route-path parameter. */\nexport type NavigationParameter = string | number;\n\ntype DeclaredRoute<Marquette extends ApplicationMarquette> = Marquette extends {\n  readonly routes: readonly (infer Route extends MarquetteRoute)[];\n}\n  ? Route\n  : never;\n\ntype RouteFor<Marquette extends ApplicationMarquette, Id extends RouteId<Marquette>> = Extract<\n  DeclaredRoute<Marquette>,\n  { readonly id: Id }\n>;\n\ntype RoutePath<Marquette extends ApplicationMarquette, Id extends RouteId<Marquette>> = RouteFor<\n  Marquette,\n  Id\n>[\"path\"];\n\ntype SegmentParameter<Segment extends string> = Segment extends `:${infer Name}`\n  ? Name extends \"\"\n    ? never\n    : Name\n  : Segment extends `*${infer Name}`\n    ? Name extends \"\"\n      ? never\n      : Name\n    : never;\n\ntype PathParameter<Path extends string> = Path extends `${infer Segment}/${infer Rest}`\n  ? SegmentParameter<Segment> | PathParameter<Rest>\n  : SegmentParameter<Path>;\n\n/** Exact route parameters inferred from full `:name` and `*name` path segments. */\nexport type NavigationParameters<\n  Marquette extends ApplicationMarquette,\n  Id extends RouteId<Marquette>,\n> = {\n  readonly [Name in PathParameter<RoutePath<Marquette, Id>>]: NavigationParameter;\n};\n\ntype NavigationArguments<Marquette extends ApplicationMarquette, Id extends RouteId<Marquette>> = [\n  PathParameter<RoutePath<Marquette, Id>>,\n] extends [never]\n  ? []\n  : [parameters: NavigationParameters<Marquette, Id>];\n\n/** Target passed to a host adapter after route parameters are encoded. */\nexport type ResolvedNavigationTarget<\n  Marquette extends ApplicationMarquette,\n  Id extends RouteId<Marquette> = RouteId<Marquette>,\n> =\n  Id extends RouteId<Marquette>\n    ? {\n        /** Authored route identifier. */\n        readonly route: Id;\n        /** Environment that owns the target view. */\n        readonly environment: RouteFor<Marquette, Id>[\"environment\"];\n        /** Resolved path with every parameter percent-encoded. */\n        readonly path: `/${string}`;\n      }\n    : never;\n\n/** Programmatic navigation surface inferred from one application marquette. */\nexport interface MarquetteNavigator<Marquette extends ApplicationMarquette, Result> {\n  /** Resolve and deliver one route to the target-specific host adapter. */\n  readonly navigate: <const Id extends RouteId<Marquette>>(\n    route: Id,\n    ...arguments_: NavigationArguments<Marquette, Id>\n  ) => Result;\n}\n\n/**\n * Creates a target-neutral, fully inferred programmatic navigator.\n *\n * A `:name` segment accepts one scalar and is encoded as one path segment. A\n * `*name` segment also accepts a scalar, but preserves `/` between its encoded\n * segments. Unknown routes, missing parameters, extra parameters, empty\n * strings, and non-finite numbers fail before the host adapter runs.\n */\nexport function createMarquetteNavigator<const Marquette extends ApplicationMarquette, Result>(\n  marquette: Marquette,\n  visit: (target: ResolvedNavigationTarget<Marquette>) => Result,\n): MarquetteNavigator<Marquette, Result> {\n  const routes = new Map<string, MarquetteRoute>(\n    (marquette.routes ?? []).map((route) => [route.id, route]),\n  );\n\n  const navigate = (\n    routeId: string,\n    parameters: Readonly<Record<string, NavigationParameter>> = {},\n  ): Result => {\n    const route = routes.get(routeId);\n    if (route == null) throw new Error(`Unknown navigation route \"${routeId}\".`);\n\n    return visit({\n      route: route.id,\n      environment: route.environment,\n      path: resolveNavigationPath(routeId, route.path, parameters),\n    } as ResolvedNavigationTarget<Marquette>);\n  };\n\n  return {\n    navigate: navigate as MarquetteNavigator<Marquette, Result>[\"navigate\"],\n  };\n}\n\nfunction resolveNavigationPath(\n  routeId: string,\n  template: `/${string}`,\n  parameters: Readonly<Record<string, NavigationParameter>>,\n): `/${string}` {\n  const expected = parameterSegments(template);\n  const expectedNames = new Set(expected.map(({ name }) => name));\n\n  for (const { name } of expected) {\n    if (!Object.hasOwn(parameters, name)) {\n      throw new Error(`Missing navigation parameter \"${name}\" for route \"${routeId}\".`);\n    }\n  }\n\n  const extra = Object.keys(parameters)\n    .filter((name) => !expectedNames.has(name))\n    .sort()[0];\n  if (extra != null) {\n    throw new Error(`Unexpected navigation parameter \"${extra}\" for route \"${routeId}\".`);\n  }\n\n  const segments = template.split(\"/\").map((segment) => {\n    const parameter = expected.find(({ authored }) => authored === segment);\n    if (parameter == null) return segment;\n    const value = parameters[parameter.name];\n    return encodeParameter(routeId, parameter.name, value, parameter.rest);\n  });\n  return segments.join(\"/\") as `/${string}`;\n}\n\nfunction parameterSegments(\n  template: string,\n): { readonly authored: string; readonly name: string; readonly rest: boolean }[] {\n  return template\n    .split(\"/\")\n    .filter((segment) => (segment.startsWith(\":\") || segment.startsWith(\"*\")) && segment.length > 1)\n    .map((authored) => ({\n      authored,\n      name: authored.slice(1),\n      rest: authored.startsWith(\"*\"),\n    }));\n}\n\nfunction encodeParameter(routeId: string, name: string, value: unknown, rest: boolean): string {\n  if (\n    (typeof value !== \"string\" && typeof value !== \"number\") ||\n    (typeof value === \"string\" && value.length === 0) ||\n    (typeof value === \"number\" && !Number.isFinite(value))\n  ) {\n    throw new Error(`Invalid navigation parameter \"${name}\" for route \"${routeId}\".`);\n  }\n  const text = String(value);\n  return rest ? text.split(\"/\").map(encodeURIComponent).join(\"/\") : encodeURIComponent(text);\n}\n"],"mappings":";;;;;;;;;AAkFA,SAAgB,yBACd,WACA,OACuC;CACvC,MAAM,SAAS,IAAI,KAChB,UAAU,UAAU,CAAC,GAAG,KAAK,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAC3D;CAEA,MAAM,YACJ,SACA,aAA4D,CAAC,MAClD;EACX,MAAM,QAAQ,OAAO,IAAI,OAAO;EAChC,IAAI,SAAS,MAAM,MAAM,IAAI,MAAM,6BAA6B,QAAQ,GAAG;EAE3E,OAAO,MAAM;GACX,OAAO,MAAM;GACb,aAAa,MAAM;GACnB,MAAM,sBAAsB,SAAS,MAAM,MAAM,UAAU;EAC7D,CAAwC;CAC1C;CAEA,OAAO,EACK,SACZ;AACF;AAEA,SAAS,sBACP,SACA,UACA,YACc;CACd,MAAM,WAAW,kBAAkB,QAAQ;CAC3C,MAAM,gBAAgB,IAAI,IAAI,SAAS,KAAK,EAAE,WAAW,IAAI,CAAC;CAE9D,KAAK,MAAM,EAAE,UAAU,UACrB,IAAI,CAAC,OAAO,OAAO,YAAY,IAAI,GACjC,MAAM,IAAI,MAAM,iCAAiC,KAAK,eAAe,QAAQ,GAAG;CAIpF,MAAM,QAAQ,OAAO,KAAK,UAAU,EACjC,QAAQ,SAAS,CAAC,cAAc,IAAI,IAAI,CAAC,EACzC,KAAK,EAAE;CACV,IAAI,SAAS,MACX,MAAM,IAAI,MAAM,oCAAoC,MAAM,eAAe,QAAQ,GAAG;CAStF,OANiB,SAAS,MAAM,GAAG,EAAE,KAAK,YAAY;EACpD,MAAM,YAAY,SAAS,MAAM,EAAE,eAAe,aAAa,OAAO;EACtE,IAAI,aAAa,MAAM,OAAO;EAC9B,MAAM,QAAQ,WAAW,UAAU;EACnC,OAAO,gBAAgB,SAAS,UAAU,MAAM,OAAO,UAAU,IAAI;CACvE,CACc,EAAE,KAAK,GAAG;AAC1B;AAEA,SAAS,kBACP,UACgF;CAChF,OAAO,SACJ,MAAM,GAAG,EACT,QAAQ,aAAa,QAAQ,WAAW,GAAG,KAAK,QAAQ,WAAW,GAAG,MAAM,QAAQ,SAAS,CAAC,EAC9F,KAAK,cAAc;EAClB;EACA,MAAM,SAAS,MAAM,CAAC;EACtB,MAAM,SAAS,WAAW,GAAG;CAC/B,EAAE;AACN;AAEA,SAAS,gBAAgB,SAAiB,MAAc,OAAgB,MAAuB;CAC7F,IACG,OAAO,UAAU,YAAY,OAAO,UAAU,YAC9C,OAAO,UAAU,YAAY,MAAM,WAAW,KAC9C,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,GAEpD,MAAM,IAAI,MAAM,iCAAiC,KAAK,eAAe,QAAQ,GAAG;CAElF,MAAM,OAAO,OAAO,KAAK;CACzB,OAAO,OAAO,KAAK,MAAM,GAAG,EAAE,IAAI,kBAAkB,EAAE,KAAK,GAAG,IAAI,mBAAmB,IAAI;AAC3F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizejs/marquette",
-  "version": "0.719.0",
+  "version": "0.720.0",
   "description": "Typed application marquettes for every Vize target",
   "keywords": [
     "application-contract",
@@ -41,6 +41,21 @@
       "import": "./dist/adapter.mjs",
       "default": "./dist/adapter.mjs"
     },
+    "./native-build": {
+      "types": "./dist/native-build.d.mts",
+      "import": "./dist/native-build.mjs",
+      "default": "./dist/native-build.mjs"
+    },
+    "./native-build/validate": {
+      "types": "./dist/native-build-validate.d.mts",
+      "import": "./dist/native-build-validate.mjs",
+      "default": "./dist/native-build-validate.mjs"
+    },
+    "./navigation": {
+      "types": "./dist/navigation.d.mts",
+      "import": "./dist/navigation.mjs",
+      "default": "./dist/navigation.mjs"
+    },
     "./test-run": {
       "types": "./dist/test-run.d.mts",
       "import": "./dist/test-run.mjs",
@@ -73,6 +88,7 @@
     },
     "./schema": "./dist/application-contract.schema.json",
     "./adapter/schema": "./dist/adapter-capability-manifest.schema.json",
+    "./native-build/schema": "./dist/native-build-profile.schema.json",
     "./test-run/schema": "./dist/test-run-evidence.schema.json",
     "./test-run/admission/schema": "./dist/test-run-admission.schema.json",
     "./test-run/check/schema": "./dist/test-run-check.schema.json",