stylegallery 0.1.0 → 0.1.2

package/scripts/test-validate-vocabulary.mjs

@@ -1,174 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-
-const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const validator = path.join(root, "scripts", "validate-vocabulary.mjs");
-
-const glossary = [
-  "# Controlled Vocabulary",
-  "",
-  "## Canonical Terms",
-  "",
-  "- Canonical: `domain`",
-  "  - Concept: top-level knowledge ownership",
-  "- Canonical: `category`",
-  "  - Concept: domain-local browse placement",
-  "- Canonical: `pattern`",
-  "  - Concept: reusable spatial primitive",
-  "- Canonical: `recipe`",
-  "  - Concept: screen composition",
-  "- Canonical: `gate`",
-  "  - Concept: quality decision contract",
-  "- Canonical: `claim`",
-  "  - Concept: review assertion",
-  "- Canonical: `evidence family`",
-  "  - Concept: evidence class",
-  "- Canonical: `scroll ownership`",
-  "  - Concept: scroll responsibility",
-  "- Canonical: `harmony`",
-  "  - Concept: content layout fit",
-  "- Canonical: `debt`",
-  "  - Concept: accepted unresolved risk",
-  "- Canonical: `consumer reference`",
-  "  - Concept: optional consumer record handoff",
-  "- Canonical: `maturity`",
-  "  - Concept: consumer reference lifecycle",
-  "- Canonical: `artifact mode`",
-  "  - Concept: consumer reference storage role",
-  "",
-  "## Aliases",
-  "",
-  "- Alias: `primitive` -> `pattern`",
-  "",
-  "## Deprecated Terms",
-  "",
-  "- Deprecated: `component` -> `pattern`",
-  "  - Reason: In Layout, component implies visual or framework ownership.",
-  "",
-  "## Local-Only Terms",
-  "",
-  "- Local-only: `OKF`",
-  "- Local-only: `consumer component`",
-  "",
-  "## Scannability Checklist",
-  "",
-  "- Use headings for decision boundaries.",
-  "",
-  "## Vale Proposal",
-  "",
-  "Prose linting should wait until the vocabulary is stable.",
-  "",
-].join("\n");
-
-const files = {
-  "README.md": "# layout-gallery\n\n[Controlled vocabulary](guides/vocabulary.md)\n",
-  "GUIDE.md": "# Guide\n\n[Controlled vocabulary](guides/vocabulary.md)\n",
-  "index.md": "# Index\n\n[Controlled vocabulary](guides/vocabulary.md)\n",
-  "quality/index.md": "# Quality\n\n[Controlled vocabulary](../guides/vocabulary.md)\n",
-  "guides/vocabulary.md": glossary,
-};
-
-const cases = [
-  {
-    name: "missing_domain_term",
-    mutate: {
-      "guides/vocabulary.md": glossary.replace("- Canonical: `domain`\n  - Concept: top-level knowledge ownership\n", ""),
-    },
-    expect: "guides/vocabulary.md: missing canonical term domain",
-  },
-  {
-    name: "missing_category_term",
-    mutate: {
-      "guides/vocabulary.md": glossary.replace("- Canonical: `category`\n  - Concept: domain-local browse placement\n", ""),
-    },
-    expect: "guides/vocabulary.md: missing canonical term category",
-  },
-  {
-    name: "missing_required_term",
-    mutate: {
-      "guides/vocabulary.md": glossary.replace("- Canonical: `debt`\n  - Concept: accepted unresolved risk\n", ""),
-    },
-    expect: "guides/vocabulary.md: missing canonical term debt",
-  },
-  {
-    name: "missing_consumer_reference_term",
-    mutate: {
-      "guides/vocabulary.md": glossary.replace("- Canonical: `consumer reference`\n  - Concept: optional consumer record handoff\n", ""),
-    },
-    expect: "guides/vocabulary.md: missing canonical term consumer reference",
-  },
-  {
-    name: "duplicate_concept",
-    mutate: {
-      "guides/vocabulary.md": glossary.replace(
-        "- Canonical: `pattern`\n  - Concept: reusable spatial primitive",
-        "- Canonical: `pattern`\n  - Concept: reusable spatial primitive\n- Canonical: `layout primitive`\n  - Concept: reusable spatial primitive",
-      ),
-    },
-    expect: "guides/vocabulary.md: concept \"reusable spatial primitive\" has multiple canonical terms: pattern, layout primitive",
-  },
-  {
-    name: "missing_vale_boundary",
-    mutate: {
-      "guides/vocabulary.md": glossary.replace("Prose linting should wait until the vocabulary is stable.", "Enable Vale immediately."),
-    },
-    expect: "guides/vocabulary.md: missing Prose linting should wait until the vocabulary is stable.",
-  },
-  {
-    name: "paraphrased_navigation_label",
-    mutate: {
-      "README.md": files["README.md"].replace("[Controlled vocabulary]", "[Vocabulary guide]"),
-    },
-    expectWarning: "README.md: recommended link label missing [Controlled vocabulary](guides/vocabulary.md)",
-  },
-  {
-    name: "success_path",
-    expect: null,
-  },
-];
-
-function writeFixture(testCase) {
-  const dir = fs.mkdtempSync(path.join(os.tmpdir(), `layout-gallery-vocabulary-${testCase.name}-`));
-  const entries = { ...files, ...(testCase.mutate ?? {}) };
-  for (const [relative, content] of Object.entries(entries)) {
-    const target = path.join(dir, relative);
-    fs.mkdirSync(path.dirname(target), { recursive: true });
-    fs.writeFileSync(target, content);
-  }
-  return dir;
-}
-
-function runCase(testCase) {
-  const dir = writeFixture(testCase);
-  const result = spawnSync(process.execPath, [validator, "--json"], {
-    cwd: dir,
-    encoding: "utf8",
-  });
-  fs.rmSync(dir, { force: true, recursive: true });
-  const output = JSON.parse(result.stdout);
-  const passed = testCase.expectWarning
-    ? output.ok && output.warnings?.includes(testCase.expectWarning)
-    : testCase.expect
-      ? !output.ok && output.failures.includes(testCase.expect)
-      : output.ok;
-  return {
-    name: testCase.name,
-    ok: passed,
-    expected: testCase.expectWarning ?? testCase.expect ?? "ok:true",
-    actual: output,
-  };
-}
-
-const results = cases.map(runCase);
-const report = {
-  ok: results.every((result) => result.ok),
-  results,
-};
-
-console.log(JSON.stringify(report, null, 2));
-process.exitCode = report.ok ? 0 : 1;

package/scripts/test-validate-webpage-workflow.mjs

@@ -1,293 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-
-const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const validator = path.join(root, "scripts", "validate-webpage-workflow.mjs");
-
-const files = {
-  "README.md": "# layout-gallery\n\n- [Webpage Generation Workflow](guides/webpage-generation-workflow.md)\n",
-  "GUIDE.md": [
-    "# Layout Planning Guide",
-    "",
-    "- [Webpage generation workflow](guides/webpage-generation-workflow.md)",
-    "- content-to-layout match",
-    "- harmony evaluation",
-    "- GPT Image reference",
-    "- implementation handoff",
-    "",
-  ].join("\n"),
-  "guides/layout-brief.md": [
-    "# Layout Brief Template",
-    "",
-    "## Webpage Generation Intake",
-    "",
-    "Content-to-layout match:",
-    "Harmony evaluation:",
-    "GPT Image reference:",
-    "Required preconditions before prompt:",
-    "Image review extract-vs-ignore:",
-    "Implementation handoff:",
-    "Consumer reference: not_applicable",
-    "Consumer reference reason: This blank planning template has no consumer record.",
-    "Accepted image debt:",
-    "",
-    "## Minimum Required Fields By Use Case",
-    "",
-    "Homepage:",
-    "Dashboard:",
-    "Article:",
-    "Form:",
-    "Command surface:",
-    "",
-    "## Rejected Alternatives",
-    "",
-    "Rejected pattern or recipe:",
-    "Reason rejected:",
-    "",
-  ].join("\n"),
-  "guides/decision-tree.md": [
-    "# Layout Decision Tree",
-    "",
-    "Rejected alternatives:",
-    "",
-  ].join("\n"),
-  "guides/webpage-generation-workflow.md": [
-    "---",
-    "type: Planning Guide",
-    "---",
-    "",
-    "# Webpage Generation Workflow",
-    "",
-    "## Use Cases",
-    "## Content-to-Layout Match",
-    "## Harmony Evaluation",
-    "## GPT Image Reference",
-    "Required preconditions before prompt:",
-    "Extract from image:",
-    "Ignore from image:",
-    "## Implementation Handoff",
-    "Implementation debt:",
-    "Final implementation proof:",
-    "Consumer reference: not_applicable",
-    "Consumer reference reason: This generic workflow has no consumer record.",
-    "[Consumer Reference Receiver Contract](../consumer-reference/contract.md)",
-    "## Workflow Route Examples",
-    "",
-    "### Homepage Route",
-    "Content blocks -> Section jobs -> Recipe -> Pattern stack -> Scroll owner -> Constraints -> Harmony evaluation -> GPT Image reference -> Implementation handoff",
-    "",
-    "### Dashboard Route",
-    "Content blocks -> Section jobs -> Recipe -> Pattern stack -> Scroll owner -> Constraints -> Harmony evaluation -> GPT Image reference -> Implementation handoff",
-    "",
-    "### Article Route",
-    "Content blocks -> Section jobs -> Recipe -> Pattern stack -> Scroll owner -> Constraints -> Harmony evaluation -> GPT Image reference -> Implementation handoff",
-    "",
-    "### Form Route",
-    "Content blocks -> Section jobs -> Recipe -> Pattern stack -> Scroll owner -> Constraints -> Harmony evaluation -> GPT Image reference -> Implementation handoff",
-    "",
-    "### Command Surface Route",
-    "Content blocks -> Section jobs -> Recipe -> Pattern stack -> Scroll owner -> Constraints -> Harmony evaluation -> GPT Image reference -> Implementation handoff",
-    "",
-  ].join("\n"),
-  "recipes/index.md": "# Layout Recipes\n\n- [Homepage](homepage.md)\n",
-  "recipes/homepage.md": [
-    "---",
-    "type: Layout Recipe",
-    "screen_type: Homepage",
-    "---",
-    "",
-    "# Homepage",
-    "",
-    "## Recommended Pattern Stack",
-    "## Content-To-Layout Matching",
-    "## GPT Image Reference",
-    "Required preconditions before prompt:",
-    "Image review extract-vs-ignore:",
-    "",
-  ].join("\n"),
-  "quality/gates/index.md": "# Gate Contracts\n\n- [Harmony evaluation gate](harmony-evaluation.md)\n",
-  "quality/gates/harmony-evaluation.md": [
-    "---",
-    "type: Quality Gate",
-    "---",
-    "",
-    "# Harmony Evaluation Gate",
-    "",
-    "## Required Contract",
-    "",
-    "Content-to-layout match:",
-    "Overall harmony:",
-    "GPT Image reference:",
-    "Implementation handoff:",
-    "Rejected alternatives:",
-    "Do not generate a GPT Image reference before harmony evaluation approves the semantic order, section jobs, pattern stack, scroll owner, and constraints.",
-    "Source order, accessibility, brand correctness, and usability cannot be inferred from the image.",
-    "Final implementation proof:",
-    "",
-  ].join("\n"),
-  "design-engineering/consumer-migration-readiness.md": [
-    "---",
-    "lifecycle: experimental",
-    "provenance_kind: local",
-    "---",
-    "# Consumer Migration Readiness",
-    "## Migration Dimension Contract",
-    "`behavior_inventory`",
-    "`route_parity`",
-    "`field_parity`",
-    "`action_parity`",
-    "`state_transitions`",
-    "`contract_precedence`",
-    "`direct_mutation`",
-    "`indirect_mutation`",
-    "`persistence_round_trip`",
-    "`reset_boundary`",
-    "`exact_time_boundary`",
-    "`defaults_tri_state_mapping`",
-    "`atomic_batch_behavior`",
-    "Consumer migration conformance: declared",
-    "Passing this method does not prove complete accessibility, product correctness, usability, visual quality, independent adoption, cross-browser equivalence, or owner approval.",
-  ].join("\n"),
-  "consumer-reference/contract.md": [
-    "### Migration-Only Extension",
-    "This field is migration-only.",
-    "Do not add it to generic blank handoffs",
-    "Consumer migration conformance: declared",
-  ].join("\n"),
-  "quality/gates/consumer-migration-evidence.md": [
-    "# Consumer Migration Evidence Gate",
-    "## Required Contract",
-    "## Blocking Conditions",
-    "thirteen migration dimensions",
-    "Decision: pass | block",
-  ].join("\n"),
-};
-
-const cases = [
-  {
-    name: "missing_workflow_file",
-    omit: ["guides/webpage-generation-workflow.md"],
-    expect: "guides/webpage-generation-workflow.md: missing file",
-  },
-  {
-    name: "missing_harmony_anchor",
-    mutate: {
-      "quality/gates/harmony-evaluation.md": files["quality/gates/harmony-evaluation.md"].replace("Overall harmony:", "Overall fit:"),
-    },
-    expect: "quality/gates/harmony-evaluation.md: missing Overall harmony:",
-  },
-  {
-    name: "missing_route_examples",
-    mutate: {
-      "guides/webpage-generation-workflow.md": files["guides/webpage-generation-workflow.md"].replace("## Workflow Route Examples", "## Workflow Routes"),
-    },
-    expect: "guides/webpage-generation-workflow.md: missing ## Workflow Route Examples",
-  },
-  {
-    name: "missing_image_proof_boundary",
-    mutate: {
-      "quality/gates/harmony-evaluation.md": files["quality/gates/harmony-evaluation.md"].replace(
-        "Source order, accessibility, brand correctness, and usability cannot be inferred from the image.",
-        "Generated image alone is enough for source order and access decisions.",
-      ),
-    },
-    expect: "quality/gates/harmony-evaluation.md: missing Source order, accessibility, brand correctness, and usability cannot be inferred from the image.",
-  },
-  {
-    name: "misordered_gpt_image_route",
-    mutate: {
-      "guides/webpage-generation-workflow.md": files["guides/webpage-generation-workflow.md"].replace(
-        "Content blocks -> Section jobs -> Recipe -> Pattern stack -> Scroll owner -> Constraints -> Harmony evaluation -> GPT Image reference -> Implementation handoff",
-        "Content blocks -> Section jobs -> Recipe -> Pattern stack -> GPT Image reference -> Harmony evaluation -> Scroll owner -> Constraints -> Implementation handoff",
-      ),
-    },
-    expect: "guides/webpage-generation-workflow.md: route Homepage places GPT Image reference before Harmony evaluation",
-  },
-  {
-    name: "missing_rejected_alternatives",
-    mutate: {
-      "guides/layout-brief.md": files["guides/layout-brief.md"].replace("## Rejected Alternatives", "## Alternatives"),
-    },
-    expect: "guides/layout-brief.md: missing ## Rejected Alternatives",
-  },
-  {
-    name: "missing_consumer_reference_reason",
-    mutate: {
-      "guides/webpage-generation-workflow.md": files["guides/webpage-generation-workflow.md"].replace("Consumer reference reason: This generic workflow has no consumer record.", ""),
-    },
-    expect: "guides/webpage-generation-workflow.md: missing Consumer reference reason:",
-  },
-  {
-    name: "missing_migration_dimension",
-    mutate: {
-      "design-engineering/consumer-migration-readiness.md": files["design-engineering/consumer-migration-readiness.md"].replace("`atomic_batch_behavior`", "`batch_behavior`"),
-    },
-    expect: "design-engineering/consumer-migration-readiness.md: missing `atomic_batch_behavior`",
-  },
-  {
-    name: "migration_field_in_ordinary_handoff",
-    mutate: {
-      "guides/webpage-generation-workflow.md": `${files["guides/webpage-generation-workflow.md"]}\nConsumer migration conformance: declared\n`,
-    },
-    expect: "guides/webpage-generation-workflow.md: ordinary handoff must not declare consumer migration conformance",
-  },
-  {
-    name: "paraphrased_navigation_label",
-    mutate: {
-      "README.md": files["README.md"].replace("[Webpage Generation Workflow]", "[Webpage planning workflow]"),
-    },
-    expectWarning: "README.md: recommended link label missing [Webpage Generation Workflow](guides/webpage-generation-workflow.md)",
-  },
-  {
-    name: "success_path",
-    expect: null,
-  },
-];
-
-function writeFixture(testCase) {
-  const dir = fs.mkdtempSync(path.join(os.tmpdir(), `layout-gallery-webpage-workflow-${testCase.name}-`));
-  const omitted = new Set(testCase.omit ?? []);
-  const entries = { ...files, ...(testCase.mutate ?? {}) };
-  for (const [relative, content] of Object.entries(entries)) {
-    if (omitted.has(relative)) continue;
-    const target = path.join(dir, relative);
-    fs.mkdirSync(path.dirname(target), { recursive: true });
-    fs.writeFileSync(target, content);
-  }
-  return dir;
-}
-
-function runCase(testCase) {
-  const dir = writeFixture(testCase);
-  const result = spawnSync(process.execPath, [validator, "--json"], {
-    cwd: dir,
-    encoding: "utf8",
-  });
-  fs.rmSync(dir, { force: true, recursive: true });
-  const output = JSON.parse(result.stdout);
-  const passed = testCase.expectWarning
-    ? output.ok && output.warnings?.includes(testCase.expectWarning)
-    : testCase.expect
-      ? !output.ok && output.failures.includes(testCase.expect)
-      : output.ok;
-  return {
-    name: testCase.name,
-    ok: passed,
-    expected: testCase.expectWarning ?? testCase.expect ?? "ok:true",
-    actual: output,
-  };
-}
-
-const results = cases.map(runCase);
-const report = {
-  ok: results.every((result) => result.ok),
-  results,
-};
-
-console.log(JSON.stringify(report, null, 2));
-process.exitCode = report.ok ? 0 : 1;

package/scripts/validate-baseline-manifest.mjs

@@ -1,44 +0,0 @@
-#!/usr/bin/env node
-
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import Ajv2020 from "ajv/dist/2020.js";
-import { readJson, validateCalibration, validateManifest } from "./baseline-contract.mjs";
-
-const repositoryRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const options = { calibration: "consumer-reference/baselines/calibration.json", json: false, manifest: "consumer-reference/baselines/manifest.json" };
-const failures = [];
-for (let index = 2; index < process.argv.length; index += 1) {
-  const argument = process.argv[index];
-  if (argument === "--json") options.json = true;
-  else if (argument === "--manifest" || argument === "--calibration") {
-    const value = process.argv[index + 1];
-    if (!value) failures.push({ code: "argument_value_required", message: `${argument} requires a value`, path: "<cli>" });
-    else {
-      options[argument.slice(2)] = value;
-      index += 1;
-    }
-  } else failures.push({ code: "argument_unknown", message: `unsupported argument ${argument}`, path: "<cli>" });
-}
-
-const manifestPath = path.resolve(repositoryRoot, options.manifest);
-const calibrationPath = path.resolve(repositoryRoot, options.calibration);
-const manifestSchemaPath = path.join(repositoryRoot, "consumer-reference/schema/baseline-manifest.schema.json");
-const calibrationSchemaPath = path.join(repositoryRoot, "consumer-reference/schema/calibration-record.schema.json");
-const manifest = readJson(manifestPath, failures);
-const calibration = readJson(calibrationPath, failures);
-const manifestSchema = readJson(manifestSchemaPath, failures);
-const calibrationSchema = readJson(calibrationSchemaPath, failures);
-const ajv = new Ajv2020({ allErrors: true, strict: false });
-for (const [kind, value, schema, file] of [["manifest", manifest, manifestSchema, manifestPath], ["calibration", calibration, calibrationSchema, calibrationPath]]) {
-  if (value === undefined || schema === undefined) continue;
-  const validate = ajv.compile(schema);
-  if (!validate(value)) for (const error of validate.errors ?? []) failures.push({ code: `baseline_${kind}_schema_invalid`, message: `${error.instancePath || "/"} ${error.message}`, path: file });
-}
-if (manifest !== undefined) failures.push(...validateManifest(manifest, manifestPath, repositoryRoot));
-if (calibration !== undefined) failures.push(...validateCalibration(calibration, calibrationPath));
-const uniqueFailures = [...new Map(failures.map((failure) => [`${failure.code}:${failure.path}:${failure.message}`, failure])).values()];
-const result = { failures: uniqueFailures, ok: uniqueFailures.length === 0, warnings: [] };
-if (options.json) process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-else if (!result.ok) process.stderr.write(`${result.failures.map((failure) => `${failure.code}: ${failure.message}`).join("\n")}\n`);
-if (!result.ok) process.exitCode = 1;

package/scripts/validate-catalog.mjs

@@ -1,65 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "node:fs";
-import path from "node:path";
-import { patterns } from "./pattern-data.mjs";
-
-const args = new Set(process.argv.slice(2));
-const json = args.has("--json");
-const root = process.cwd();
-const failures = [];
-
-function slugDir(category) {
-  return category.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/(^-|-$)/g, "");
-}
-
-function read(relative) {
-  return fs.readFileSync(path.join(root, relative), "utf8");
-}
-
-function requireIncludes(relative, text) {
-  if (!read(relative).includes(text)) failures.push(`${relative}: missing ${text}`);
-}
-
-const expectedFiles = new Set();
-const expectedCategories = new Set();
-
-for (const [slug, category, problem] of patterns) {
-  const dir = slugDir(category);
-  const file = `patterns/${dir}/${slug}.md`;
-  expectedFiles.add(file);
-  expectedCategories.add(category);
-  if (!fs.existsSync(path.join(root, file))) failures.push(`missing pattern file: ${file}`);
-  requireIncludes("CATALOG.md", `- [${slug}](${file}) - ${category}: ${problem}`);
-  requireIncludes(`patterns/${dir}/index.md`, `- [${slug}](${slug}.md) - ${problem}`);
-}
-
-for (const category of expectedCategories) {
-  const dir = slugDir(category);
-  requireIncludes("patterns/index.md", `- [${category}](${dir}/index.md)`);
-}
-
-const actualFiles = fs.readdirSync(path.join(root, "patterns"), { recursive: true })
-  .filter((entry) => typeof entry === "string" && entry.endsWith(".md") && !entry.endsWith("index.md"))
-  .map((entry) => `patterns/${entry}`);
-
-for (const file of actualFiles) {
-  if (!expectedFiles.has(file)) failures.push(`unexpected pattern file: ${file}`);
-}
-
-const result = {
-  actualPatternCount: actualFiles.length,
-  expectedPatternCount: expectedFiles.size,
-  failures,
-  ok: failures.length === 0,
-};
-
-if (json) {
-  console.log(JSON.stringify(result, null, 2));
-} else if (result.ok) {
-  console.log(`ok: ${actualFiles.length} cataloged patterns`);
-} else {
-  console.error(result.failures.join("\n"));
-}
-
-process.exitCode = result.ok ? 0 : 1;