feat(schema): support multiple API versions from a single schema file

Makefile

@@ -110,7 +110,7 @@ build-cli: build-cli-linux-amd build-cli-linux-arm build-cli-mac-intel build-cli
 docs-and-schema: ## Generate the Zarf Documentation and Schema
 	go generate ./src/pkg/schema
 	ZARF_CONFIG=hack/empty-config.toml go run main.go internal gen-cli-docs
-	cp src/pkg/schema/zarf-v1alpha1-schema.json zarf.schema.json
+	cp src/pkg/schema/zarf.schema.json zarf.schema.json
 	hack/cots/update-gitea.sh
 
 init-package-with-agent: build build-local-agent-image init-package

site/.gitignore

@@ -22,4 +22,5 @@ pnpm-debug.log*
 
 # zarf specific
 src/assets/zarf.schema.json
+src/assets/zarf-v1alpha1-schema.json
 src/content/docs/ref/Examples

site/package.json

@@ -6,10 +6,10 @@
   "scripts": {
     "lint": "markdownlint-cli2 . --config ../.markdownlint-cli2.jsonc",
     "lint:fix": "markdownlint-cli2 --fix . --config ../.markdownlint-cli2.jsonc",
-    "predev": "cp ../zarf.schema.json ./src/assets/zarf.schema.json && node hack/copy-examples.js",
+    "predev": "cp ../src/pkg/schema/zarf-v1alpha1-schema.json ./src/assets/zarf-v1alpha1-schema.json && node hack/copy-examples.js",
     "dev": "astro dev",
     "start": "astro dev",
-    "prebuild": "cp ../zarf.schema.json ./src/assets/zarf.schema.json && node hack/copy-examples.js",
+    "prebuild": "cp ../src/pkg/schema/zarf-v1alpha1-schema.json ./src/assets/zarf-v1alpha1-schema.json && node hack/copy-examples.js",
     "build": "rm -rf dist && astro check && astro build",
     "preview": "astro preview",
     "astro": "astro",

site/src/components/SchemaItemProperties.astro

@@ -11,7 +11,7 @@ const includesElement = (key: string) => {
   }
 };
 
-const json = await import("../assets/zarf.schema.json");
+const json = await import("../assets/zarf-v1alpha1-schema.json");
 
 // @ts-expect-error - We don't import a TS type for the schema, but we know it's structured correctly
 const itemSchema = json["$defs"][item];

site/src/components/SchemaReference.astro

@@ -1,5 +1,13 @@
 ---
-const json = await import("../assets/zarf.schema.json");
+interface Props {
+  path: string;
+}
+const { path } = Astro.props;
+const schemas = import.meta.glob<{ default: Record<string, any> }>("../assets/*.json");
+const loader = schemas[`../assets/${path}`];
+if (!loader) throw new Error(`Schema not found: ${path}`);
+const mod = await loader();
+const json = mod.default;
 const defs = json["$defs"] as Record<string, any>;
 
 // BFS walk from root properties to produce natural reading order.

site/src/content/docs/schema/v1alpha1-package.mdx

@@ -8,4 +8,4 @@ import SchemaReference from '@components/SchemaReference.astro';
 
 [JSON Schema source](https://github.com/zarf-dev/zarf/blob/main/src/pkg/schema/zarf-v1alpha1-schema.json)
 
-<SchemaReference />
+<SchemaReference path="zarf-v1alpha1-schema.json" />