@intentius/chant-lexicon-gitlab 0.19.1 → 0.20.0

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

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiFH;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA41B9E"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/codegen/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiFH;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAw2B9E"}

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

@@ -1 +1 @@
-{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/codegen/package.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,kCAAkC,CAAC;AAG1C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAI9C;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqCtF"}
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../src/codegen/package.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,kCAAkC,CAAC;AAG1C,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAI9C;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAkCtF"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "cf4c631d450e76b04223d13f7614578125d8b92d973523be77404b0377ce73d5",
+    "manifest.json": "3db621ca961d22beae382f9bdb854d0a7cfa39e70a6e8709ae937878eba4364e",
     "meta.json": "931fc3246a55645b1493080bbeb160e5d205e42349e8bdca96ca243adb5f0da3",
     "types/index.d.ts": "5cd2e99f135a929b72bdd822d00d780d39b1cd407ba0cfb3d511c7ac9d667b58",
     "rules/artifact-no-expiry.ts": "3f3cabf9792cbf8207e53a25f506715466b19ec25e9c3b4d0d77fed6b2eb4542",
@@ -52,5 +52,5 @@
     "skills/chant-gitlab-migrate.md": "4853d04980560b379e5b0f7267dcb0a1e5d5879cb9e9931681ce76b2a5fe69d8",
     "skills/chant-gitlab-patterns.md": "6d9a44e9e8de4c3820be9d65381b0d2ede4cb3626aaaf0011e21838a9fbf556e"
   },
-  "composite": "6d2bb6e726004a6d6e4dec7213ccd100df28fe9a7730de4e17643e3bf10e2a93"
+  "composite": "c5454e5652d3d9d30b0ecd15053b50529baf1bc4902175d3e9341dee7cb5dbed"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "gitlab",
-  "version": "0.19.1",
+  "version": "0.20.0",
   "chantVersion": ">=0.1.0",
   "namespace": "GitLab",
   "intrinsics": [
@@ -8,7 +8,7 @@
       "name": "reference",
       "description": "!reference tag — reference another job's properties",
       "outputKey": "!reference",
-      "isTag": true
+      "isTag": false
     }
   ],
   "pseudoParameters": {}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiC,MAAM,0BAA0B,CAAC;AAmB7F,eAAO,MAAM,YAAY,EAAE,aAsgB1B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAiC,MAAM,0BAA0B,CAAC;AAmB7F,eAAO,MAAM,YAAY,EAAE,aA4gB1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-gitlab",
-  "version": "0.19.1",
+  "version": "0.20.0",
   "description": "GitLab CI lexicon for chant — declarative IaC in TypeScript",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -67,8 +67,8 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.19.1",
-    "@intentius/chant-lexicon-github": "^0.19.1",
+    "@intentius/chant": "^0.20.0",
+    "@intentius/chant-lexicon-github": "^0.20.0",
     "typescript": "^5.9.3"
   },
   "peerDependenciesMeta": {

package/src/codegen/docs.ts

@@ -98,7 +98,15 @@ export async function generateDocs(opts?: { verbose?: boolean }): Promise<void>
     overview,
     outputFormat,
     serviceFromType,
-    suppressPages: ["intrinsics", "rules"],
+    // "intrinsics" is no longer suppressed (chant #1067) — the reference
+    // table at that slug is now generated from the plugin's own
+    // `intrinsics()` registration (docsPipeline's generateIntrinsics, same
+    // mechanism azure/helm already use), so its "Folds?" column can never
+    // drift from the registration the way #1062's foldability matrix
+    // depends on. The hand-written `reference()` usage guide moves to a
+    // separate "intrinsics-guide" page below — content unchanged, just no
+    // longer sharing a slug with generated data.
+    suppressPages: ["rules"],
     examplesDir: join(pkgDir, "examples"),
     extraPages: [
       {
@@ -299,10 +307,14 @@ Jobs can override any default property individually.
 `,
       },
       {
-        slug: "intrinsics",
-        title: "Intrinsic Functions",
-        description: "GitLab CI/CD intrinsic functions and their chant syntax",
-        content: `The GitLab lexicon provides one intrinsic function: \`reference()\`, which maps to GitLab's \`!reference\` YAML tag.
+        slug: "intrinsics-guide",
+        title: "Intrinsics Guide",
+        description: "Worked examples for the GitLab reference() intrinsic and its chant syntax",
+        content: `See [Intrinsic Functions](../intrinsics/) for the generated reference table (name, description, output key, whether it's a tagged template, whether \`chant build --fold\` can fold it). This page is the worked-example companion.
+
+The GitLab lexicon provides one intrinsic function: \`reference()\`, which maps to GitLab's \`!reference\` YAML tag.
+
+\`reference()\` is a plain function call, not a TypeScript tagged template — like any function call used as a value, it's outside the subset [\`chant build --fold\`](/chant/concepts/typescript-as-data/#folded-vs-run) can reduce. A file that calls \`reference()\` anywhere in a resource's properties falls back to the normal run path under \`--fold\`.
 
 ## \`reference()\` — reuse job properties
 

package/src/codegen/package.ts

@@ -31,14 +31,11 @@ export async function packageLexicon(opts: PackageOptions = {}): Promise<Package
       generate: (genOpts) => generate({ verbose: genOpts.verbose, force: genOpts.force }),
 
       buildManifest: (_genResult) => {
-        const intrinsics: IntrinsicDef[] = [
-          {
-            name: "reference",
-            description: "!reference tag — reference another job's properties",
-            outputKey: "!reference",
-            isTag: true,
-          },
-        ];
+        // Derived from the plugin's own registration (chant #1067) — this
+        // used to be a hand-maintained array independent of ../plugin.ts
+        // (despite the comment claiming otherwise), free to drift from the
+        // real registration without anything noticing.
+        const intrinsics: IntrinsicDef[] = gitlabPlugin.intrinsics?.() ?? [];
 
         return {
           name: "gitlab",

package/src/plugin.test.ts

@@ -26,7 +26,11 @@ describe("gitlabPlugin", () => {
     expect(intrinsics).toHaveLength(1);
     expect(intrinsics[0].name).toBe("reference");
     expect(intrinsics[0].outputKey).toBe("!reference");
-    expect(intrinsics[0].isTag).toBe(true);
+    // #1039: `reference(...)` is authored as a plain call, not a JS tagged
+    // template — `isTag` must be false so the static folder doesn't mistake
+    // `reference`...`` for a registered tag. The `!reference` YAML tag still
+    // renders fine (via `ReferenceIntrinsic.toYAML()`, unrelated to `isTag`).
+    expect(intrinsics[0].isTag).toBe(false);
   });
 
   // -----------------------------------------------------------------------

package/src/plugin.ts

@@ -51,9 +51,15 @@ export const gitlabPlugin: LexiconPlugin = {
     return [
       {
         name: "reference",
+        // Authored as a plain call — `reference("job", "script")` — not a JS
+        // tagged template, so `isTag` (chant #1039: "authored as a tagged
+        // template", consumed by the static folder to recognize `Tag`...``)
+        // must be false. The `!reference` YAML tag it produces is rendered
+        // via `ReferenceIntrinsic.toYAML()` (see ../serializer.ts's generic
+        // `toYAML` duck-typing) — independent of this flag.
         description: "!reference tag — reference another job's properties",
         outputKey: "!reference",
-        isTag: true,
+        isTag: false,
       },
     ];
   },