@intentius/chant-lexicon-docker 0.37.0 → 0.38.0

package/dist/codegen/docs.d.ts

@@ -1,5 +1,10 @@
 /**
  * Docker lexicon docs generation.
+ *
+ * The docker site is hand-authored under docs/src/content/docs/, unlike every
+ * other lexicon's generated Starlight site. The rules table is the exception:
+ * a hand-maintained one can fall behind the rules in src/lint/ without anything
+ * catching it, so it is generated from source here (#1312).
  */
 export declare function generateDocs(opts?: {
     verbose?: boolean;

package/dist/codegen/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9E"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2B9E"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "f11c869972afd4ef2b352b93dcc42eba59cd88a1bfa31367ff1a4260e1208b4a",
+    "manifest.json": "9ac606d292f87c00d17538aba347ac4d22e1e091435cd229f21195543ee46500",
     "meta.json": "ae27dc809e705d37a645ee83b9789c50051282f7891d21d6b9e6ce8d111624ff",
     "types/index.d.ts": "758f989ff86af54284d7f841a2db2259038d51ce1f3ed839a5d8e83fa20d95b8",
     "rules/no-latest-tag.ts": "efd060453d8ca3d5b85c3972906c6650b6f63eb5f67cb6cdb0f16a41cad91228",
@@ -15,5 +15,5 @@
     "skills/chant-docker.md": "3ff0708e3c76e245f202948949c768464563af2b60cc9aa2ca52f494ef8357f1",
     "skills/chant-docker-patterns.md": "ad1b0196d8150b2df579a699ff107f604340c799c04f3460ebf65003e287b12a"
   },
-  "composite": "60662403f5abe4718c201c8e733a13732ebcfffa49a613aa6af6393d0b498765"
+  "composite": "fe7a6cda6d999b04f449ad59f43faf6b1dcb717778d14784257c5c6fa57a6b75"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "docker",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "chantVersion": ">=0.1.0",
   "namespace": "Docker",
   "intrinsics": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-docker",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "description": "Docker lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -67,7 +67,7 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.37.0",
+    "@intentius/chant": "^0.38.0",
     "typescript": "^5.9.3"
   }
 }

package/src/codegen/docs.ts

@@ -1,12 +1,42 @@
 /**
  * Docker lexicon docs generation.
+ *
+ * The docker site is hand-authored under docs/src/content/docs/, unlike every
+ * other lexicon's generated Starlight site. The rules table is the exception:
+ * a hand-maintained one can fall behind the rules in src/lint/ without anything
+ * catching it, so it is generated from source here (#1312).
  */
 
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { writeFileSync } from "fs";
+import { generateRulesPage, type DocsConfig } from "@intentius/chant/codegen/docs";
+
 export async function generateDocs(opts?: { verbose?: boolean }): Promise<void> {
+  const pkgDir = dirname(dirname(dirname(fileURLToPath(import.meta.url))));
+
   if (opts?.verbose) {
     console.error("Generating Docker lexicon docs...");
   }
-  // Docs are currently hand-authored in docs/src/content/docs/
+
+  const config = {
+    name: "docker",
+    displayName: "Docker",
+    description: "Typed constructors for Docker Compose files and Dockerfiles",
+    distDir: join(pkgDir, "dist"),
+    outDir: join(pkgDir, "docs"),
+  } as DocsConfig;
+
+  const rules = generateRulesPage(config, join(pkgDir, "src"));
+  if (rules) {
+    const out = join(pkgDir, "docs", "src", "content", "docs", "rules.mdx");
+    writeFileSync(out, rules);
+    if (opts?.verbose) {
+      console.error(`Wrote ${out}`);
+    }
+  }
+
+  // Every other page is hand-authored in docs/src/content/docs/.
   // Future: auto-generate entity reference pages from lexicon-docker.json
-  console.error("Docker docs: see docs/src/content/docs/overview.mdx");
+  console.error("Docker docs: rules.mdx generated; prose pages are hand-authored");
 }