@greatcms/conformance 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UWENAYO Alain Pacifique
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+> Built with an AI coding assistant and reviewed by a human. Treat it as you would any new dependency.
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @greatcms/conformance
+
+What "reads the GreatCMS standard correctly" means, as a fixture site and the
+documents any reader must resolve it to. The fixture deliberately holds the
+awkward cases: a region with no content file, content written before a field
+was added, a block missing a defaulted field, a block that names no variant,
+a decorative empty alt, and a Markdown collection.
+
+```sh
+npx greatcms-conformance fixtures          # path to the fixture site
+npx greatcms-conformance verify ./out      # compare a reader's output
+npx greatcms-conformance verify --self     # verify the reference reader
+```
+
+A reader writes one JSON file per region to a folder, plus
+`entries/<collection>/<slug>.json` if it implements collections, and
+`verify` compares them with `expected/`. The repository's Python reader
+passes it, which is how the format stays language-agnostic.
+
+Documentation: https://greatcms.dev/docs/any-language/ · Source: https://github.com/uwenayoallain/thegreatcms

package/bin/greatcms-conformance.mjs

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+/** Language-agnostic conformance verifier. */
+
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, resolve } from "node:path";
+import {
+  FIXTURES_DIR,
+  readFixtureEntries,
+  readFixtureRegion,
+  runConformance,
+  verifyEntries,
+  verifyRegions,
+} from "../dist/index.js";
+
+const [, , command = "help", ...args] = process.argv;
+
+if (command === "fixtures") {
+  process.stdout.write(`${FIXTURES_DIR}\n`);
+  process.exit(0);
+}
+
+if (command !== "verify") {
+  process.stdout.write(
+    [
+      "greatcms-conformance: prove a tool reads the GreatCMS standard",
+      "",
+      "  fixtures              print the path to the fixture site",
+      "  verify <dir>          compare a reader's output against the expected documents",
+      "  verify --self         verify the reference reader in @greatcms/conformance",
+      "",
+      "<dir> holds one JSON file per region, named <region-id>.json, and: if the",
+      "reader implements collections: <dir>/entries/<collection>/<slug>.json,",
+      'each `{ "slug": …, "data": … }`. Collections are reported separately, so a',
+      "regions-only reader still gets a useful answer.",
+      "",
+    ].join("\n"),
+  );
+  process.exit(command === "help" ? 0 : 1);
+}
+
+const { regions, entries } = args[0] === "--self" ? selfCheck() : verifyDirectory(args[0]);
+
+const parts = [`${regions.checked} regions`];
+if (entries) parts.push(`${entries.checked} entries`);
+else parts.push("collections not implemented");
+
+if (regions.ok && (!entries || entries.ok)) {
+  process.stdout.write(`conformance: PASS (${parts.join(", ")})\n`);
+  process.exit(0);
+}
+
+const failures = [...regions.failures, ...(entries?.failures ?? [])];
+const count = `${failures.length} problem${failures.length === 1 ? "" : "s"}`;
+process.stderr.write(`conformance: FAIL (${count} across ${parts.join(", ")})\n\n`);
+for (const failure of failures) {
+  process.stderr.write(`  ${failure.regionId}: ${failure.reason}\n`);
+  if (failure.expected !== undefined) {
+    process.stderr.write(`    expected: ${JSON.stringify(failure.expected)}\n`);
+    process.stderr.write(`    actual:   ${JSON.stringify(failure.actual)}\n`);
+  }
+}
+process.stderr.write("\n");
+process.exit(1);
+
+function selfCheck() {
+  const found = {};
+  for (const name of ["blog", "guides"]) {
+    for (const entry of readFixtureEntries(name)) {
+      found[`${name}/${entry.slug}`] = entry;
+    }
+  }
+  return { regions: runConformance(readFixtureRegion), entries: verifyEntries(found) };
+}
+
+function verifyDirectory(dir) {
+  if (!dir) {
+    process.stderr.write("verify needs a directory, or --self\n");
+    process.exit(2);
+  }
+  const abs = resolve(dir);
+  if (!existsSync(abs) || !statSync(abs).isDirectory()) {
+    process.stderr.write(`Not a directory: ${abs}\n`);
+    process.exit(2);
+  }
+
+  const foundRegions = {};
+  for (const file of readdirSync(abs)) {
+    if (!file.endsWith(".json")) continue;
+    foundRegions[file.slice(0, -".json".length)] = readJson(join(abs, file));
+  }
+
+  // Collections are optional surface: a reader that only does regions is still
+  // worth verifying, and saying "not implemented" beats a misleading failure.
+  const entriesDir = join(abs, "entries");
+  if (!existsSync(entriesDir)) return { regions: verifyRegions(foundRegions), entries: null };
+
+  const foundEntries = {};
+  for (const collection of readdirSync(entriesDir)) {
+    const collectionDir = join(entriesDir, collection);
+    if (!statSync(collectionDir).isDirectory()) continue;
+    for (const file of readdirSync(collectionDir)) {
+      if (!file.endsWith(".json")) continue;
+      foundEntries[`${collection}/${file.slice(0, -".json".length)}`] = readJson(
+        join(collectionDir, file),
+      );
+    }
+  }
+
+  return { regions: verifyRegions(foundRegions), entries: verifyEntries(foundEntries) };
+}
+
+function readJson(path) {
+  try {
+    return JSON.parse(readFileSync(path, "utf8"));
+  } catch (err) {
+    process.stderr.write(`${path}: not valid JSON: ${err.message}\n`);
+    process.exit(2);
+  }
+}

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import { CmsConfig, CmsSchema, RegionDocument } from "@greatcms/spec";
+//#region src/index.d.ts
+declare const FIXTURES_DIR: string;
+declare const EXPECTED_DIR: string;
+declare function fixtureSchema(): CmsSchema;
+declare function fixtureConfig(): CmsConfig;
+/** The documents every conforming reader must produce, keyed by region id. */
+declare function expectedRegions(): Record<string, RegionDocument>;
+/** Reference implementation: read the fixture site off disk the way the standard says to. */
+declare function readFixtureRegion(regionId: string): RegionDocument | null;
+/** One collection entry, as every conforming reader must produce it. */
+interface ExpectedEntry {
+  slug: string;
+  data: Record<string, unknown>;
+}
+/**
+ * Entries a reader must produce, keyed `<collection>/<slug>`. Unlike a region,
+ * an entry is not layered over schema defaults: what is in the file is what it
+ * is. Defaults are an authoring convenience, not a read-time rule.
+ */
+declare function expectedEntries(): Record<string, ExpectedEntry>;
+/** Reference implementation for collections, matching the reader's rules. */
+declare function readFixtureEntries(name: string): ExpectedEntry[];
+interface Failure {
+  regionId: string;
+  reason: string;
+  expected?: unknown;
+  actual?: unknown;
+}
+interface ConformanceResult {
+  ok: boolean;
+  checked: number;
+  failures: Failure[];
+}
+/** Compares resolved documents against the expected set. */
+declare function verifyRegions(actual: Record<string, unknown>): ConformanceResult;
+/** Compares collection entries against the expected set. */
+declare function verifyEntries(actual: Record<string, unknown>): ConformanceResult;
+/** Runs the whole kit against a reader function. */
+declare function runConformance(readRegion: (regionId: string) => unknown): ConformanceResult;
+//#endregion
+export { ConformanceResult, EXPECTED_DIR, ExpectedEntry, FIXTURES_DIR, Failure, expectedEntries, expectedRegions, fixtureConfig, fixtureSchema, readFixtureEntries, readFixtureRegion, runConformance, verifyEntries, verifyRegions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;cAoBa;cACA;iBAEG,iBAAiB;iBAMjB,iBAAiB;;iBAKjB,mBAAmB,eAAe;;iBAWlC,kBAAkB,mBAAmB;;UAepC;EACf;EACA,MAAM;;;;;;;iBAQQ,mBAAmB,eAAe;;iBAelC,mBAAmB,eAAe;UAuBjC;EACf;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA,UAAU;;;iBAII,cAAc,QAAQ,0BAA0B;;iBA8BhD,cAAc,QAAQ,0BAA0B;;iBA8BhD,eAAe,aAAa,+BAA+B"}

package/dist/index.js

@@ -0,0 +1,169 @@
+import { readFileSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { entryExtension, parseConfig, parseFrontmatter, parseRegionFile, parseSchema, regionFilePath, resolveRegion } from "@greatcms/spec";
+//#region src/index.ts
+/** The conformance kit. */
+const packageRoot = fileURLToPath(new URL("..", import.meta.url));
+const FIXTURES_DIR = join(packageRoot, "fixtures");
+const EXPECTED_DIR = join(packageRoot, "expected");
+function fixtureSchema() {
+	return parseSchema(readFileSync(join(FIXTURES_DIR, ".cms/schema.yaml"), "utf8"), { file: ".cms/schema.yaml" });
+}
+function fixtureConfig() {
+	return parseConfig(readFileSync(join(FIXTURES_DIR, ".cms/config.yaml"), "utf8"));
+}
+/** The documents every conforming reader must produce, keyed by region id. */
+function expectedRegions() {
+	const dir = join(EXPECTED_DIR, "regions");
+	const out = {};
+	for (const file of readdirSync(dir).toSorted()) {
+		if (!file.endsWith(".json")) continue;
+		out[file.slice(0, -5)] = JSON.parse(readFileSync(join(dir, file), "utf8"));
+	}
+	return out;
+}
+/** Reference implementation: read the fixture site off disk the way the standard says to. */
+function readFixtureRegion(regionId) {
+	const schema = fixtureSchema();
+	const config = fixtureConfig();
+	const path = join(FIXTURES_DIR, regionFilePath(config, regionId));
+	let stored = null;
+	try {
+		stored = parseRegionFile(readFileSync(path, "utf8"), path);
+	} catch (err) {
+		if (err.code !== "ENOENT" && !/ENOENT/.test(String(err))) throw err;
+	}
+	return resolveRegion(schema, regionId, stored);
+}
+/**
+* Entries a reader must produce, keyed `<collection>/<slug>`. Unlike a region,
+* an entry is not layered over schema defaults: what is in the file is what it
+* is. Defaults are an authoring convenience, not a read-time rule.
+*/
+function expectedEntries() {
+	const root = join(EXPECTED_DIR, "entries");
+	const out = {};
+	for (const collection of readdirSync(root).toSorted()) {
+		const dir = join(root, collection);
+		for (const file of readdirSync(dir).toSorted()) {
+			if (!file.endsWith(".json")) continue;
+			const slug = file.slice(0, -5);
+			out[`${collection}/${slug}`] = JSON.parse(readFileSync(join(dir, file), "utf8"));
+		}
+	}
+	return out;
+}
+/** Reference implementation for collections, matching the reader's rules. */
+function readFixtureEntries(name) {
+	const def = fixtureSchema().collections[name];
+	if (!def) throw new Error(`Unknown collection "${name}".`);
+	const extension = `.${entryExtension(def.format)}`;
+	const dir = join(FIXTURES_DIR, def.path);
+	return readdirSync(dir).toSorted().filter((file) => file.endsWith(extension)).map((file) => {
+		const source = readFileSync(join(dir, file), "utf8");
+		const slug = file.slice(0, -extension.length);
+		if (def.format === "json") return {
+			slug,
+			data: JSON.parse(source)
+		};
+		const { data, body } = parseFrontmatter(source, file);
+		if (def.body) data[def.body] = body;
+		return {
+			slug,
+			data
+		};
+	});
+}
+/** Compares resolved documents against the expected set. */
+function verifyRegions(actual) {
+	const expected = expectedRegions();
+	const failures = [];
+	for (const [regionId, want] of Object.entries(expected)) {
+		if (!(regionId in actual)) {
+			failures.push({
+				regionId,
+				reason: "missing from output"
+			});
+			continue;
+		}
+		const got = stripMeta(actual[regionId]);
+		if (!deepEqual(stripMeta(want), got)) failures.push({
+			regionId,
+			reason: "does not match expected document",
+			expected: want,
+			actual: got
+		});
+	}
+	for (const regionId of Object.keys(actual)) if (!(regionId in expected)) failures.push({
+		regionId,
+		reason: "unexpected region in output"
+	});
+	return {
+		ok: failures.length === 0,
+		checked: Object.keys(expected).length,
+		failures
+	};
+}
+/** Compares collection entries against the expected set. */
+function verifyEntries(actual) {
+	const expected = expectedEntries();
+	const failures = [];
+	for (const [key, want] of Object.entries(expected)) {
+		if (!(key in actual)) {
+			failures.push({
+				regionId: key,
+				reason: "missing from output"
+			});
+			continue;
+		}
+		const got = stripMeta(actual[key]);
+		if (!deepEqual(stripMeta(want), got)) failures.push({
+			regionId: key,
+			reason: "does not match expected entry",
+			expected: want,
+			actual: got
+		});
+	}
+	for (const key of Object.keys(actual)) if (!(key in expected)) failures.push({
+		regionId: key,
+		reason: "unexpected entry in output"
+	});
+	return {
+		ok: failures.length === 0,
+		checked: Object.keys(expected).length,
+		failures
+	};
+}
+/** Runs the whole kit against a reader function. */
+function runConformance(readRegion) {
+	const actual = {};
+	for (const regionId of Object.keys(expectedRegions())) actual[regionId] = readRegion(regionId);
+	return verifyRegions(actual);
+}
+function stripMeta(value) {
+	if (Array.isArray(value)) return value.map(stripMeta);
+	if (value === null || typeof value !== "object") return value;
+	const out = {};
+	for (const [key, v] of Object.entries(value)) {
+		if (key === "_meta") continue;
+		out[key] = stripMeta(v);
+	}
+	return out;
+}
+function deepEqual(a, b) {
+	if (a === b) return true;
+	if (Array.isArray(a) || Array.isArray(b)) {
+		if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;
+		return a.every((item, i) => deepEqual(item, b[i]));
+	}
+	if (a === null || b === null || typeof a !== "object" || typeof b !== "object") return false;
+	const ka = Object.keys(a).toSorted();
+	const kb = Object.keys(b).toSorted();
+	if (ka.length !== kb.length || !ka.every((k, i) => k === kb[i])) return false;
+	return ka.every((k) => deepEqual(a[k], b[k]));
+}
+//#endregion
+export { EXPECTED_DIR, FIXTURES_DIR, expectedEntries, expectedRegions, fixtureConfig, fixtureSchema, readFixtureEntries, readFixtureRegion, runConformance, verifyEntries, verifyRegions };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/** The conformance kit. */\n\nimport { readFileSync, readdirSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  type CmsConfig,\n  type CmsSchema,\n  type RegionDocument,\n  entryExtension,\n  parseConfig,\n  parseFrontmatter,\n  parseRegionFile,\n  parseSchema,\n  regionFilePath,\n  resolveRegion,\n} from \"@greatcms/spec\";\n\nconst packageRoot = fileURLToPath(new URL(\"..\", import.meta.url));\n\nexport const FIXTURES_DIR = join(packageRoot, \"fixtures\");\nexport const EXPECTED_DIR = join(packageRoot, \"expected\");\n\nexport function fixtureSchema(): CmsSchema {\n  return parseSchema(readFileSync(join(FIXTURES_DIR, \".cms/schema.yaml\"), \"utf8\"), {\n    file: \".cms/schema.yaml\",\n  });\n}\n\nexport function fixtureConfig(): CmsConfig {\n  return parseConfig(readFileSync(join(FIXTURES_DIR, \".cms/config.yaml\"), \"utf8\"));\n}\n\n/** The documents every conforming reader must produce, keyed by region id. */\nexport function expectedRegions(): Record<string, RegionDocument> {\n  const dir = join(EXPECTED_DIR, \"regions\");\n  const out: Record<string, RegionDocument> = {};\n  for (const file of readdirSync(dir).toSorted()) {\n    if (!file.endsWith(\".json\")) continue;\n    out[file.slice(0, -\".json\".length)] = JSON.parse(readFileSync(join(dir, file), \"utf8\"));\n  }\n  return out;\n}\n\n/** Reference implementation: read the fixture site off disk the way the standard says to. */\nexport function readFixtureRegion(regionId: string): RegionDocument | null {\n  const schema = fixtureSchema();\n  const config = fixtureConfig();\n  const path = join(FIXTURES_DIR, regionFilePath(config, regionId));\n  let stored: RegionDocument | null = null;\n  try {\n    stored = parseRegionFile(readFileSync(path, \"utf8\"), path);\n  } catch (err) {\n    // A missing file is the normal case for a region nobody has edited yet.\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\" && !/ENOENT/.test(String(err))) throw err;\n  }\n  return resolveRegion(schema, regionId, stored);\n}\n\n/** One collection entry, as every conforming reader must produce it. */\nexport interface ExpectedEntry {\n  slug: string;\n  data: Record<string, unknown>;\n}\n\n/**\n * Entries a reader must produce, keyed `<collection>/<slug>`. Unlike a region,\n * an entry is not layered over schema defaults: what is in the file is what it\n * is. Defaults are an authoring convenience, not a read-time rule.\n */\nexport function expectedEntries(): Record<string, ExpectedEntry> {\n  const root = join(EXPECTED_DIR, \"entries\");\n  const out: Record<string, ExpectedEntry> = {};\n  for (const collection of readdirSync(root).toSorted()) {\n    const dir = join(root, collection);\n    for (const file of readdirSync(dir).toSorted()) {\n      if (!file.endsWith(\".json\")) continue;\n      const slug = file.slice(0, -\".json\".length);\n      out[`${collection}/${slug}`] = JSON.parse(readFileSync(join(dir, file), \"utf8\"));\n    }\n  }\n  return out;\n}\n\n/** Reference implementation for collections, matching the reader's rules. */\nexport function readFixtureEntries(name: string): ExpectedEntry[] {\n  const schema = fixtureSchema();\n  const def = schema.collections[name];\n  if (!def) throw new Error(`Unknown collection \"${name}\".`);\n\n  const extension = `.${entryExtension(def.format)}`;\n  const dir = join(FIXTURES_DIR, def.path);\n\n  return readdirSync(dir)\n    .toSorted()\n    .filter((file) => file.endsWith(extension))\n    .map((file) => {\n      const source = readFileSync(join(dir, file), \"utf8\");\n      const slug = file.slice(0, -extension.length);\n      if (def.format === \"json\") {\n        return { slug, data: JSON.parse(source) as Record<string, unknown> };\n      }\n      const { data, body } = parseFrontmatter(source, file);\n      if (def.body) data[def.body] = body;\n      return { slug, data };\n    });\n}\n\nexport interface Failure {\n  regionId: string;\n  reason: string;\n  expected?: unknown;\n  actual?: unknown;\n}\n\nexport interface ConformanceResult {\n  ok: boolean;\n  checked: number;\n  failures: Failure[];\n}\n\n/** Compares resolved documents against the expected set. */\nexport function verifyRegions(actual: Record<string, unknown>): ConformanceResult {\n  const expected = expectedRegions();\n  const failures: Failure[] = [];\n\n  for (const [regionId, want] of Object.entries(expected)) {\n    if (!(regionId in actual)) {\n      failures.push({ regionId, reason: \"missing from output\" });\n      continue;\n    }\n    const got = stripMeta(actual[regionId]);\n    if (!deepEqual(stripMeta(want), got)) {\n      failures.push({\n        regionId,\n        reason: \"does not match expected document\",\n        expected: want,\n        actual: got,\n      });\n    }\n  }\n\n  for (const regionId of Object.keys(actual)) {\n    if (!(regionId in expected)) {\n      failures.push({ regionId, reason: \"unexpected region in output\" });\n    }\n  }\n\n  return { ok: failures.length === 0, checked: Object.keys(expected).length, failures };\n}\n\n/** Compares collection entries against the expected set. */\nexport function verifyEntries(actual: Record<string, unknown>): ConformanceResult {\n  const expected = expectedEntries();\n  const failures: Failure[] = [];\n\n  for (const [key, want] of Object.entries(expected)) {\n    if (!(key in actual)) {\n      failures.push({ regionId: key, reason: \"missing from output\" });\n      continue;\n    }\n    const got = stripMeta(actual[key]);\n    if (!deepEqual(stripMeta(want), got)) {\n      failures.push({\n        regionId: key,\n        reason: \"does not match expected entry\",\n        expected: want,\n        actual: got,\n      });\n    }\n  }\n\n  for (const key of Object.keys(actual)) {\n    if (!(key in expected)) {\n      failures.push({ regionId: key, reason: \"unexpected entry in output\" });\n    }\n  }\n\n  return { ok: failures.length === 0, checked: Object.keys(expected).length, failures };\n}\n\n/** Runs the whole kit against a reader function. */\nexport function runConformance(readRegion: (regionId: string) => unknown): ConformanceResult {\n  const actual: Record<string, unknown> = {};\n  for (const regionId of Object.keys(expectedRegions())) {\n    actual[regionId] = readRegion(regionId);\n  }\n  return verifyRegions(actual);\n}\n\nfunction stripMeta(value: unknown): unknown {\n  if (Array.isArray(value)) return value.map(stripMeta);\n  if (value === null || typeof value !== \"object\") return value;\n  const out: Record<string, unknown> = {};\n  for (const [key, v] of Object.entries(value as Record<string, unknown>)) {\n    if (key === \"_meta\") continue;\n    out[key] = stripMeta(v);\n  }\n  return out;\n}\n\nfunction deepEqual(a: unknown, b: unknown): boolean {\n  if (a === b) return true;\n  if (Array.isArray(a) || Array.isArray(b)) {\n    if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length) return false;\n    return a.every((item, i) => deepEqual(item, b[i]));\n  }\n  if (a === null || b === null || typeof a !== \"object\" || typeof b !== \"object\") return false;\n  const ka = Object.keys(a as object).toSorted();\n  const kb = Object.keys(b as object).toSorted();\n  if (ka.length !== kb.length || !ka.every((k, i) => k === kb[i])) return false;\n  return ka.every((k) =>\n    deepEqual((a as Record<string, unknown>)[k], (b as Record<string, unknown>)[k]),\n  );\n}\n"],"mappings":"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"}

package/expected/entries/blog/empty-frontmatter.json

@@ -0,0 +1,6 @@
+{
+  "slug": "empty-frontmatter",
+  "data": {
+    "content": "\nAn entry whose frontmatter is empty.\n"
+  }
+}

package/expected/entries/blog/publish-from-anywhere.json

@@ -0,0 +1,11 @@
+{
+  "slug": "publish-from-anywhere",
+  "data": {
+    "title": "Publish from anywhere",
+    "date": "2026-08-12",
+    "tags": ["release", "git"],
+    "related": ["yaml-scalars"],
+    "draft": false,
+    "content": "\nContent lives in the repository, so a publish is a commit and a deploy is whatever\nCI you already had.\n\nThe CMS never becomes a runtime dependency of your site.\n"
+  }
+}

package/expected/entries/blog/yaml-scalars.json

@@ -0,0 +1,9 @@
+{
+  "slug": "yaml-scalars",
+  "data": {
+    "title": "Answers, not booleans",
+    "date": "2026-10-03",
+    "tags": ["no", "on", "off", "y", "1:30"],
+    "content": "\nYAML 1.1 reads most of those tags as booleans or numbers. This standard reads YAML 1.2.\n"
+  }
+}

package/expected/entries/guides/measuring-latency.json

@@ -0,0 +1,8 @@
+{
+  "slug": "measuring-latency",
+  "data": {
+    "title": "Measuring latency",
+    "date": "2026-08-14",
+    "content": "\nimport Chart from \"../../components/Chart.astro\";\n\nLatency fell once the reads stopped crossing a network.\n\n<Chart data={[240, 120, 18]} caption=\"p99, in milliseconds\" />\n\nThe prose around the component is ordinary Markdown. A reader stores this body\nbyte for byte: it does not parse the JSX, resolve the import, or care whether\n`Chart` exists.\n"
+  }
+}

package/expected/regions/about.intro.json

@@ -0,0 +1,6 @@
+{
+  "body": {
+    "html": "<p>We have not written this yet.</p>"
+  },
+  "heading": "About us"
+}

package/expected/regions/home.body.json

@@ -0,0 +1,39 @@
+{
+  "blocks": [
+    {
+      "_type": "hero",
+      "heading": "Hybrid by default",
+      "image": {
+        "alt": "Diagram of a page with one managed section",
+        "src": "/media/hybrid.webp",
+        "width": 900,
+        "height": 600
+      }
+    },
+    {
+      "_type": "text",
+      "body": {
+        "html": "<p>Manage the <strong>hero</strong> and leave the rest of the page as code.</p>"
+      }
+    },
+    {
+      "_type": "cta",
+      "label": "Read the spec",
+      "link": {
+        "href": "https://example.com/spec",
+        "external": true
+      },
+      "style": "secondary",
+      "_variant": "inline"
+    },
+    {
+      "_type": "cta",
+      "label": "Browse the examples",
+      "link": {
+        "href": "/examples"
+      },
+      "style": "primary",
+      "_variant": "panel"
+    }
+  ]
+}

package/expected/regions/home.cards.json

@@ -0,0 +1,9 @@
+{
+  "cards": [
+    {
+      "_type": "card",
+      "title": "First card",
+      "tone": "plain"
+    }
+  ]
+}

package/expected/regions/home.decor.json

@@ -0,0 +1,6 @@
+{
+  "image": {
+    "alt": "",
+    "src": "/media/swirl.svg"
+  }
+}

package/expected/regions/home.featured.json

@@ -0,0 +1,4 @@
+{
+  "guides": [],
+  "post": "publish-from-anywhere"
+}

package/expected/regions/home.hero.json

@@ -0,0 +1,14 @@
+{
+  "cta": {
+    "href": "/get-started",
+    "label": "Get started"
+  },
+  "heading": "Publish from anywhere",
+  "image": {
+    "alt": "A person editing a page on a laptop",
+    "height": 800,
+    "src": "/media/hero.webp",
+    "width": 1200
+  },
+  "subtitle": "Content in Git, deploys on commit."
+}

package/expected/regions/home.notice.json

@@ -0,0 +1,5 @@
+{
+  "badge": "New",
+  "dismissible": true,
+  "message": "We ship on every commit."
+}

package/expected/regions/home.seo.json

@@ -0,0 +1,6 @@
+{
+  "seo": {
+    "title": "Home",
+    "description": "A site managed by GreatCMS"
+  }
+}

package/expected/regions/home.showcase.json

@@ -0,0 +1,21 @@
+{
+  "blocks": [
+    {
+      "heading": "What you get",
+      "_type": "grid",
+      "cards": [
+        {
+          "tone": "plain",
+          "_type": "card",
+          "title": "Content lives in Git",
+          "body": "Every publish is a commit, so history and rollback come free."
+        },
+        {
+          "tone": "accent",
+          "_type": "card",
+          "title": "Nothing at runtime"
+        }
+      ]
+    }
+  ]
+}

package/fixtures/.cms/config.yaml

@@ -0,0 +1,12 @@
+version: 1
+
+content:
+  regions: content/cms
+  media: public/media
+
+mediaUrlPrefix: /media
+
+publish:
+  branch: main
+  draftBranchPrefix: cms/draft
+  commitMessage: "content: update {summary}"

package/fixtures/.cms/schema.yaml

@@ -0,0 +1,141 @@
+# Conformance fixture site.
+#
+# Any tool claiming to read the GreatCMS standard must resolve this repo into
+# the documents under `expected/`. It deliberately exercises the awkward cases:
+# a region with no content file, a region edited before a field was added, a
+# blocks region, and a Markdown collection.
+
+version: 1
+
+site:
+  name: Conformance Fixture
+
+blocks:
+  hero:
+    label: Hero
+    fields:
+      heading: { type: text, required: true, max: 80 }
+      image: { type: image }
+
+  text:
+    label: Text
+    fields:
+      body: { type: richtext }
+
+  cta:
+    label: Call to action
+    variants: [{ value: panel, label: Panel }, { value: inline, label: Inline link }]
+    fields:
+      label: { type: text, required: true }
+      link: { type: link, required: true }
+      style: { type: select, options: [primary, secondary], default: primary }
+
+  card:
+    label: Card
+    fields:
+      title: { type: text, required: true }
+      body: { type: text }
+      tone: { type: select, options: [plain, accent], default: plain }
+
+  # A block whose own field is a list of blocks. Nesting is the point: a
+  # conforming reader must apply defaults at every depth, not only the top.
+  grid:
+    label: Card grid
+    fields:
+      heading: { type: text, default: What you get }
+      cards: { type: blocks, allow: [card], max: 4 }
+
+regions:
+  # Fully edited: content file overrides every default.
+  home.hero:
+    label: Home hero
+    fields:
+      heading: { type: text, required: true, max: 80 }
+      subtitle: { type: text, default: Default subtitle }
+      image: { type: image }
+      cta: { type: link }
+    default:
+      heading: Welcome
+
+  # Edited before `badge` existed: proves new schema fields still render.
+  home.notice:
+    fields:
+      message: { type: text, required: true }
+      badge: { type: text, default: New }
+      dismissible: { type: boolean, default: true }
+
+  # Never edited: proves a site builds before the CMS has touched it.
+  about.intro:
+    fields:
+      heading: { type: text, default: About us }
+      body: { type: richtext, default: { html: "<p>We have not written this yet.</p>" } }
+
+  # Block list with nested groups and lists.
+  home.body:
+    type: blocks
+    allow: [hero, text, cta]
+    max: 8
+
+  # Decorative image: empty alt is valid here and only here.
+  home.decor:
+    fields:
+      image: { type: image, alt: decorative-allowed }
+
+  # Blocks inside blocks, with a default that has to reach two levels down.
+  home.showcase:
+    type: blocks
+    allow: [grid]
+
+  # Region default over a group: objects merge deeply, so `description` survives.
+  home.seo:
+    fields:
+      seo:
+        type: group
+        fields:
+          title: { type: text, default: Untitled }
+          description: { type: text, default: A site managed by GreatCMS }
+    default:
+      seo: { title: Home }
+
+  # Never edited, and its default blocks still need their own field defaults.
+  home.cards:
+    fields:
+      cards:
+        type: blocks
+        allow: [card]
+        default:
+          - { _type: card, title: First card }
+
+  # References store slugs as written; a multiple one nobody filled in is `[]`.
+  home.featured:
+    fields:
+      post: { type: reference, collection: blog }
+      guides: { type: reference, collection: guides, multiple: true }
+
+collections:
+  # MDX: stored exactly like Markdown, read exactly like Markdown. The
+  # difference is the extension, and that an editor must not reformat the body.
+  guides:
+    label: Guides
+    path: content/guides
+    format: mdx
+    body: content
+    slug: title
+    fields:
+      title: { type: text, required: true, max: 120 }
+      date: { type: date, required: true }
+      content: { type: richtext }
+
+  blog:
+    label: Blog
+    path: content/blog
+    format: markdown
+    body: content
+    slug: title
+    fields:
+      title: { type: text, required: true, max: 120 }
+      date: { type: date, required: true }
+      tags: { type: list, of: { type: text }, max: 5 }
+      related: { type: reference, collection: blog, multiple: true }
+      draft: { type: boolean, default: false }
+      content: { type: richtext }

package/fixtures/content/blog/empty-frontmatter.md

@@ -0,0 +1,4 @@
+---
+---
+
+An entry whose frontmatter is empty.

package/fixtures/content/blog/publish-from-anywhere.md

@@ -0,0 +1,14 @@
+---
+title: Publish from anywhere
+date: 2026-08-12
+tags:
+  - release
+  - git
+related: [yaml-scalars]
+draft: false
+---
+
+Content lives in the repository, so a publish is a commit and a deploy is whatever
+CI you already had.
+
+The CMS never becomes a runtime dependency of your site.

package/fixtures/content/blog/yaml-scalars.md

@@ -0,0 +1,7 @@
+---
+title: Answers, not booleans
+date: 2026-10-03
+tags: [no, on, off, y, 1:30]
+---
+
+YAML 1.1 reads most of those tags as booleans or numbers. This standard reads YAML 1.2.

package/fixtures/content/cms/home.body.json

@@ -0,0 +1,42 @@
+{
+  "blocks": [
+    {
+      "_type": "hero",
+      "heading": "Hybrid by default",
+      "image": {
+        "alt": "Diagram of a page with one managed section",
+        "src": "/media/hybrid.webp",
+        "width": 900,
+        "height": 600
+      }
+    },
+    {
+      "_type": "text",
+      "body": {
+        "html": "<p>Manage the <strong>hero</strong> and leave the rest of the page as code.</p>"
+      }
+    },
+    {
+      "_type": "cta",
+      "label": "Read the spec",
+      "link": {
+        "href": "https://example.com/spec",
+        "external": true
+      },
+      "style": "secondary",
+      "_variant": "inline"
+    },
+    {
+      "_type": "cta",
+      "label": "Browse the examples",
+      "link": {
+        "href": "/examples"
+      }
+    }
+  ],
+  "_meta": {
+    "updatedAt": "2026-08-12T18:05:00.000Z",
+    "updatedBy": "conformance-fixture",
+    "version": 1
+  }
+}

package/fixtures/content/cms/home.decor.json

@@ -0,0 +1,6 @@
+{
+  "image": {
+    "alt": "",
+    "src": "/media/swirl.svg"
+  }
+}

package/fixtures/content/cms/home.featured.json

@@ -0,0 +1,8 @@
+{
+  "post": "publish-from-anywhere",
+  "_meta": {
+    "updatedAt": "2026-10-01T09:30:00.000Z",
+    "updatedBy": "conformance-fixture",
+    "version": 1
+  }
+}

package/fixtures/content/cms/home.hero.json

@@ -0,0 +1,19 @@
+{
+  "cta": {
+    "href": "/get-started",
+    "label": "Get started"
+  },
+  "heading": "Publish from anywhere",
+  "image": {
+    "alt": "A person editing a page on a laptop",
+    "height": 800,
+    "src": "/media/hero.webp",
+    "width": 1200
+  },
+  "subtitle": "Content in Git, deploys on commit.",
+  "_meta": {
+    "updatedAt": "2026-08-12T18:00:00.000Z",
+    "updatedBy": "conformance-fixture",
+    "version": 1
+  }
+}

package/fixtures/content/cms/home.notice.json

@@ -0,0 +1,8 @@
+{
+  "message": "We ship on every commit.",
+  "_meta": {
+    "updatedAt": "2026-07-01T09:30:00.000Z",
+    "updatedBy": "conformance-fixture",
+    "version": 1
+  }
+}

package/fixtures/content/cms/home.showcase.json

@@ -0,0 +1,24 @@
+{
+  "blocks": [
+    {
+      "_type": "grid",
+      "cards": [
+        {
+          "_type": "card",
+          "title": "Content lives in Git",
+          "body": "Every publish is a commit, so history and rollback come free."
+        },
+        {
+          "_type": "card",
+          "title": "Nothing at runtime",
+          "tone": "accent"
+        }
+      ]
+    }
+  ],
+  "_meta": {
+    "updatedAt": "2026-08-15T09:30:00.000Z",
+    "updatedBy": "conformance-fixture",
+    "version": 1
+  }
+}

package/fixtures/content/guides/measuring-latency.mdx

@@ -0,0 +1,14 @@
+---
+title: Measuring latency
+date: 2026-08-14
+---
+
+import Chart from "../../components/Chart.astro";
+
+Latency fell once the reads stopped crossing a network.
+
+<Chart data={[240, 120, 18]} caption="p99, in milliseconds" />
+
+The prose around the component is ordinary Markdown. A reader stores this body
+byte for byte: it does not parse the JSX, resolve the import, or care whether
+`Chart` exists.

package/package.json

@@ -1,6 +1,60 @@
 {
   "name": "@greatcms/conformance",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Fixtures and a verifier that define what reading the GreatCMS standard correctly means, in any language.",
+  "keywords": [
+    "cms",
+    "conformance",
+    "fixtures",
+    "testing"
+  ],
+  "homepage": "https://greatcms.dev",
+  "bugs": {
+    "url": "https://github.com/uwenayoallain/thegreatcms/issues"
+  },
+  "license": "MIT",
+  "author": "UWENAYO Alain Pacifique",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/uwenayoallain/thegreatcms.git",
+    "directory": "packages/conformance"
+  },
+  "bin": {
+    "greatcms-conformance": "./bin/greatcms-conformance.mjs"
+  },
+  "files": [
+    "dist",
+    "fixtures",
+    "expected",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./fixtures/*": "./fixtures/*"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@greatcms/spec": "0.1.1"
+  },
+  "devDependencies": {
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  }
 }