@intentius/chant-lexicon-gitlab 0.19.1 → 0.21.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/generated/index.d.ts

@@ -1,22 +1,22 @@
 export declare const Default: new (props: Record<string, unknown>, attributes?: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, string>;
 export declare const Job: new (props: Record<string, unknown>, attributes?: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, string>;
 export declare const Workflow: new (props: Record<string, unknown>, attributes?: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, string>;
-export declare const AllowFailure: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Artifacts: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const AutoCancel: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Cache: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Environment: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Image: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Include: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Inherit: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Need: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Parallel: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Release: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Retry: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Rule: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Service: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const Trigger: new (props: Record<string, unknown>) => Record<string, unknown>;
-export declare const WorkflowRule: new (props: Record<string, unknown>) => Record<string, unknown>;
+export declare const AllowFailure: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Artifacts: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const AutoCancel: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Cache: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Environment: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Image: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Include: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Inherit: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Need: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Parallel: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Release: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Retry: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Rule: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Service: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const Trigger: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
+export declare const WorkflowRule: new (props: Record<string, unknown>) => import("packages/core/src").Declarable & Record<string, unknown>;
 export { reference } from "../intrinsics.js";
 export { CI } from "../variables.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/generated/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,+IAAsD,CAAC;AAC3E,eAAO,MAAM,GAAG,+IAAkD,CAAC;AACnE,eAAO,MAAM,QAAQ,+IAAuD,CAAC;AAE7E,eAAO,MAAM,YAAY,iEAAuD,CAAC;AACjF,eAAO,MAAM,SAAS,iEAAoD,CAAC;AAC3E,eAAO,MAAM,UAAU,iEAAqD,CAAC;AAC7E,eAAO,MAAM,KAAK,iEAAgD,CAAC;AACnE,eAAO,MAAM,WAAW,iEAAsD,CAAC;AAC/E,eAAO,MAAM,KAAK,iEAAgD,CAAC;AACnE,eAAO,MAAM,OAAO,iEAAkD,CAAC;AACvE,eAAO,MAAM,OAAO,iEAAkD,CAAC;AACvE,eAAO,MAAM,IAAI,iEAA+C,CAAC;AACjE,eAAO,MAAM,QAAQ,iEAAmD,CAAC;AACzE,eAAO,MAAM,OAAO,iEAAkD,CAAC;AACvE,eAAO,MAAM,KAAK,iEAAgD,CAAC;AACnE,eAAO,MAAM,IAAI,iEAA+C,CAAC;AACjE,eAAO,MAAM,OAAO,iEAAkD,CAAC;AACvE,eAAO,MAAM,OAAO,iEAAkD,CAAC;AACvE,eAAO,MAAM,YAAY,iEAAuD,CAAC;AAGjF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,+IAAsD,CAAC;AAC3E,eAAO,MAAM,GAAG,+IAAkD,CAAC;AACnE,eAAO,MAAM,QAAQ,+IAAuD,CAAC;AAE7E,eAAO,MAAM,YAAY,0GAAuD,CAAC;AACjF,eAAO,MAAM,SAAS,0GAAoD,CAAC;AAC3E,eAAO,MAAM,UAAU,0GAAqD,CAAC;AAC7E,eAAO,MAAM,KAAK,0GAAgD,CAAC;AACnE,eAAO,MAAM,WAAW,0GAAsD,CAAC;AAC/E,eAAO,MAAM,KAAK,0GAAgD,CAAC;AACnE,eAAO,MAAM,OAAO,0GAAkD,CAAC;AACvE,eAAO,MAAM,OAAO,0GAAkD,CAAC;AACvE,eAAO,MAAM,IAAI,0GAA+C,CAAC;AACjE,eAAO,MAAM,QAAQ,0GAAmD,CAAC;AACzE,eAAO,MAAM,OAAO,0GAAkD,CAAC;AACvE,eAAO,MAAM,KAAK,0GAAgD,CAAC;AACnE,eAAO,MAAM,IAAI,0GAA+C,CAAC;AACjE,eAAO,MAAM,OAAO,0GAAkD,CAAC;AACvE,eAAO,MAAM,OAAO,0GAAkD,CAAC;AACvE,eAAO,MAAM,YAAY,0GAAuD,CAAC;AAGjF,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "cf4c631d450e76b04223d13f7614578125d8b92d973523be77404b0377ce73d5",
+    "manifest.json": "89e556afc19a0b88869af7f5691376181399d6ba9a1a8154cd288bd41ab3075a",
     "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": "2998b4d0b1a747b421f961155f006f2b84b30a950d1b63cfcb13477a582aefda"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "gitlab",
-  "version": "0.19.1",
+  "version": "0.21.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.21.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.21.0",
+    "@intentius/chant-lexicon-github": "^0.21.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,
       },
     ];
   },

package/src/serializer.ts

@@ -8,7 +8,7 @@
  */
 
 import type { Declarable } from "@intentius/chant/declarable";
-import { isPropertyDeclarable } from "@intentius/chant/declarable";
+import { isPropertyDeclarable, isResourceDeclarable } from "@intentius/chant/declarable";
 import type { Serializer } from "@intentius/chant/serializer";
 import type { LexiconOutput } from "@intentius/chant/lexicon-output";
 import { walkValue, type SerializerVisitor } from "@intentius/chant/serializer-walker";
@@ -23,7 +23,7 @@ function gitlabVisitor(entityNames: Map<Declarable, string>): SerializerVisitor
     attrRef: (name, _attr) => name,
     resourceRef: (name) => name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase(),
     propertyDeclarable: (entity, walk) => {
-      if (!("props" in entity) || typeof entity.props !== "object" || entity.props === null) {
+      if (!isResourceDeclarable(entity) || typeof entity.props !== "object" || entity.props === null) {
         return undefined;
       }
       const props = entity.props as Record<string, unknown>;
@@ -123,7 +123,7 @@ export const gitlabSerializer: Serializer = {
     // Emit stages (collect from jobs)
     const stages = new Set<string>();
     for (const [, entity] of jobs) {
-      const props = (entity as unknown as Record<string, unknown>).props as Record<string, unknown> | undefined;
+      const props = isResourceDeclarable(entity) ? (entity.props as Record<string, unknown> | undefined) : undefined;
       if (props?.stage && typeof props.stage === "string") {
         stages.add(props.stage);
       }
@@ -135,7 +135,7 @@ export const gitlabSerializer: Serializer = {
     // Emit defaults
     for (const [, entity] of defaults) {
       const converted = toYAMLValue(
-        (entity as unknown as Record<string, unknown>).props,
+        (isResourceDeclarable(entity) ? entity.props : undefined),
         entityNames,
       ) as Record<string, unknown> | undefined;
       if (converted) {
@@ -146,7 +146,7 @@ export const gitlabSerializer: Serializer = {
     // Emit workflow
     for (const [, entity] of workflows) {
       const converted = toYAMLValue(
-        (entity as unknown as Record<string, unknown>).props,
+        (isResourceDeclarable(entity) ? entity.props : undefined),
         entityNames,
       ) as Record<string, unknown> | undefined;
       if (converted) {
@@ -157,7 +157,7 @@ export const gitlabSerializer: Serializer = {
     // Emit jobs
     for (const [name, entity] of jobs) {
       const converted = toYAMLValue(
-        (entity as unknown as Record<string, unknown>).props,
+        (isResourceDeclarable(entity) ? entity.props : undefined),
         entityNames,
       ) as Record<string, unknown> | undefined;
       if (converted) {