@intentius/chant-lexicon-forgejo 0.37.2 → 0.39.0

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

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

package/dist/config.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The `forgejo` namespace in `chant.config.ts` (#1344).
+ *
+ * ```ts
+ * import type { ChantConfig } from "@intentius/chant/config";
+ * import "@intentius/chant-lexicon-forgejo";   // brings the `forgejo` key into ChantConfig
+ *
+ * export default {
+ *   lexicons: ["forgejo"],
+ *   forgejo: {
+ *     runnerLabels: { "ubuntu-latest": "docker" },
+ *     actionsRoot: "https://code.forgejo.org",
+ *   },
+ * } satisfies ChantConfig;
+ * ```
+ *
+ * One schema, three consumers: core validates the namespace against it at load,
+ * the type below is derived from it, and that derived type is what augments
+ * `ChantConfig` — so an unknown key fails at build time and at compile time for
+ * the same reason, rather than being silently ignored at both.
+ */
+import { z } from "zod";
+import type { ChantConfig } from "@intentius/chant/config";
+/**
+ * `strictObject`, not `object`. Core applies `.strict()` to the top level of a
+ * declared namespace itself, but nested objects are the lexicon's own to make
+ * strict — and `runnerLabels` is exactly where a typo would otherwise land.
+ */
+export declare const forgejoConfigSchema: z.ZodObject<{
+    /**
+     * GitHub-hosted runner label → Forgejo label. A label with no mapping falls
+     * back to the default Forgejo label and is flagged by WFJ011.
+     */
+    runnerLabels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Root the common `actions/*` refs are rewritten under. */
+    actionsRoot: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ForgejoConfig = z.infer<typeof forgejoConfigSchema>;
+declare module "@intentius/chant/config" {
+    interface ChantConfig {
+        forgejo?: ForgejoConfig;
+    }
+}
+/**
+ * Compile-time proof that the augmentation above reaches `ChantConfig` (#1344).
+ *
+ * Without it this line is `Property 'forgejo' does not exist on type
+ * 'ChantConfig'` — which is exactly the error a user's `chant.config.ts` got.
+ * It lives here rather than in a test because the root tsconfig excludes test
+ * files from typechecking, so a compile-time claim asserted in one is checked
+ * by nothing.
+ */
+export type ForgejoConfigNamespace = NonNullable<ChantConfig["forgejo"]>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;;OAGG;;IAEH,4DAA4D;;kBAE5D,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,OAAO,QAAQ,yBAAyB,CAAC;IACvC,UAAU,WAAW;QACnB,OAAO,CAAC,EAAE,aAAa,CAAC;KACzB;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -5,4 +5,6 @@ export { transform, detectGitHubWorkflow, type MigrateOptions, type MigrationRes
 export { analyzeForgejoSecurity, renderSecurityPosture, type SecurityFate, type SecurityRecord, } from "./migrate/from-github/security.js";
 export { resolveActionRef, DEFAULT_ACTIONS_ROOT, KNOWN_ACTIONS, type ActionTarget, type ActionResolveOptions, type ActionResolveResult, } from "./actions.js";
 export * from "@intentius/chant-lexicon-github";
+export { forgejoConfigSchema } from "./config.js";
+export type { ForgejoConfig } from "./config.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AAInB,cAAc,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AAInB,cAAc,iCAAiC,CAAC;AAKhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/integrity.json

@@ -1,7 +1,7 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "f66dd50d917a3468191e71bd35a81dcfa44e1ccd058b70d5dc143061780cbd5e",
+    "manifest.json": "05ae7449e80d9c4a6f85058e32c1e5f2a5631997279502de1e2690ad325493fc",
     "meta.json": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
     "types/index.d.ts": "66204549b2a864ab5489e3f02c1878e73ab4b3c9d938cfb480b66f71543a43de",
     "rules/delegate-to-github.ts": "1060cda40f4b73d6cca3ba3fa13b80b4886147d4034c88584c2d80c5510dbe5e",
@@ -9,5 +9,5 @@
     "rules/wfj011.ts": "fcb8bf6685d744af20ad804ce929488257995c74b9a3353b2eacae3768d1c83e",
     "skills/chant-forgejo.md": "a1a560429db736c187e0b34cf8dd9efc6ad771afefcbf6f802d160d3d5274257"
   },
-  "composite": "3b909700fad85d4139088988700172fb5fb7996cde47f0738de054fbd693d6b4"
+  "composite": "187583ff073a5cefff3d5f009293904ec3397a411d6231c7aa5218fb80ce2768"
 }

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "name": "forgejo",
-  "version": "0.37.2",
+  "version": "0.39.0",
   "chantVersion": ">=0.1.0",
   "namespace": "Forgejo",
   "intrinsics": [],

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAoC,MAAM,0BAA0B,CAAC;AAiBhG,eAAO,MAAM,aAAa,EAAE,aA6L3B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAoC,MAAM,0BAA0B,CAAC;AAkBhG,eAAO,MAAM,aAAa,EAAE,aA8L3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant-lexicon-forgejo",
-  "version": "0.37.2",
+  "version": "0.39.0",
   "description": "Forgejo / Codeberg / Gitea Actions lexicon for chant — a thin GitHub Actions dialect",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -53,8 +53,9 @@
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@intentius/chant": "^0.37.2",
-    "@intentius/chant-lexicon-github": "^0.37.2"
+    "zod": "^4.3.6",
+    "@intentius/chant": "^0.39.0",
+    "@intentius/chant-lexicon-github": "^0.39.0"
   },
   "scripts": {
     "generate": "tsx src/codegen/generate-cli.ts",

package/src/codegen/docs.ts

@@ -110,7 +110,9 @@ chant build src -o .forgejo/workflows/ci.yml
 Override the runner-label map and the actions root in \`chant.config.ts\`:
 
 \`\`\`ts
-import type { ChantConfig } from "@intentius/chant";
+import type { ChantConfig } from "@intentius/chant/config";
+// Brings the \`forgejo\` key into ChantConfig (chant #1344).
+import "@intentius/chant-lexicon-forgejo";
 
 export default {
   lexicons: ["forgejo"],

package/src/config-augmentation.test.ts

@@ -0,0 +1,55 @@
+/**
+ * The documented `chant.config.ts` example compiles (#1344).
+ *
+ * It did not: `ChantConfig` is a closed interface, so `satisfies ChantConfig`
+ * on a config carrying a `forgejo` key was `error TS2353: Object literal may
+ * only specify known properties`. The lexicon augments `ChantConfig` with the
+ * type derived from its own schema, so importing the package — which a project
+ * configuring forgejo does anyway — brings the key into the interface.
+ */
+
+import { describe, test, expect } from "vitest";
+import type { ChantConfig } from "@intentius/chant/config";
+import { forgejoConfigSchema, type ForgejoConfig } from "./config";
+
+describe("the forgejo config namespace (#1344)", () => {
+  test("the documented example typechecks as a ChantConfig", () => {
+    // The compile-time assertion is the point; the runtime one keeps vitest happy.
+    const config = {
+      lexicons: ["forgejo"],
+      forgejo: {
+        runnerLabels: { "ubuntu-latest": "docker", "ubuntu-22.04": "ubuntu-lts" },
+        actionsRoot: "https://code.forgejo.org",
+      },
+    } satisfies ChantConfig;
+    expect(config.forgejo.actionsRoot).toBe("https://code.forgejo.org");
+  });
+
+  test("an empty namespace is valid — every key is optional", () => {
+    expect(forgejoConfigSchema.safeParse({}).success).toBe(true);
+  });
+
+  test("the schema accepts the documented shape", () => {
+    const parsed = forgejoConfigSchema.safeParse({
+      runnerLabels: { "ubuntu-latest": "docker" },
+      actionsRoot: "https://code.forgejo.org",
+    });
+    expect(parsed.success).toBe(true);
+  });
+
+  test("a typo is rejected rather than silently defaulted", () => {
+    // `runnerLabel` used to be accepted and ignored: the dialect fell back to
+    // its defaults and said nothing.
+    const parsed = forgejoConfigSchema.strict().safeParse({ runnerLabel: { a: "b" } });
+    expect(parsed.success).toBe(false);
+  });
+
+  test("a wrong value type is rejected", () => {
+    expect(forgejoConfigSchema.safeParse({ actionsRoot: 42 }).success).toBe(false);
+  });
+
+  test("the exported type is derived from the schema, not written twice", () => {
+    const value: ForgejoConfig = { actionsRoot: "https://example.test" };
+    expect(forgejoConfigSchema.safeParse(value).success).toBe(true);
+  });
+});

package/src/config.ts

@@ -0,0 +1,58 @@
+/**
+ * The `forgejo` namespace in `chant.config.ts` (#1344).
+ *
+ * ```ts
+ * import type { ChantConfig } from "@intentius/chant/config";
+ * import "@intentius/chant-lexicon-forgejo";   // brings the `forgejo` key into ChantConfig
+ *
+ * export default {
+ *   lexicons: ["forgejo"],
+ *   forgejo: {
+ *     runnerLabels: { "ubuntu-latest": "docker" },
+ *     actionsRoot: "https://code.forgejo.org",
+ *   },
+ * } satisfies ChantConfig;
+ * ```
+ *
+ * One schema, three consumers: core validates the namespace against it at load,
+ * the type below is derived from it, and that derived type is what augments
+ * `ChantConfig` — so an unknown key fails at build time and at compile time for
+ * the same reason, rather than being silently ignored at both.
+ */
+
+import { z } from "zod";
+import type { ChantConfig } from "@intentius/chant/config";
+
+/**
+ * `strictObject`, not `object`. Core applies `.strict()` to the top level of a
+ * declared namespace itself, but nested objects are the lexicon's own to make
+ * strict — and `runnerLabels` is exactly where a typo would otherwise land.
+ */
+export const forgejoConfigSchema = z.strictObject({
+  /**
+   * GitHub-hosted runner label → Forgejo label. A label with no mapping falls
+   * back to the default Forgejo label and is flagged by WFJ011.
+   */
+  runnerLabels: z.record(z.string(), z.string()).optional(),
+  /** Root the common `actions/*` refs are rewritten under. */
+  actionsRoot: z.string().optional(),
+});
+
+export type ForgejoConfig = z.infer<typeof forgejoConfigSchema>;
+
+declare module "@intentius/chant/config" {
+  interface ChantConfig {
+    forgejo?: ForgejoConfig;
+  }
+}
+
+/**
+ * Compile-time proof that the augmentation above reaches `ChantConfig` (#1344).
+ *
+ * Without it this line is `Property 'forgejo' does not exist on type
+ * 'ChantConfig'` — which is exactly the error a user's `chant.config.ts` got.
+ * It lives here rather than in a test because the root tsconfig excludes test
+ * files from typechecking, so a compile-time claim asserted in one is checked
+ * by nothing.
+ */
+export type ForgejoConfigNamespace = NonNullable<ChantConfig["forgejo"]>;

package/src/index.ts

@@ -48,3 +48,9 @@ export {
 // Reuse the entire github authoring surface: generated entities, expression
 // system, context variables, and composites.
 export * from "@intentius/chant-lexicon-github";
+
+// The `forgejo` chant.config namespace (#1344). Exported as a type and, by
+// virtue of this module being part of the program, as the `ChantConfig`
+// augmentation that makes `forgejo: { … }` typecheck in a project config.
+export { forgejoConfigSchema } from "./config";
+export type { ForgejoConfig } from "./config";

package/src/plugin.ts

@@ -21,12 +21,14 @@ import { generateForgejoPipeline } from "./components/generate-pipeline";
 import { forgejoLintRules } from "./lint/rules/delegate-to-github";
 import { forgejoCompletions } from "./lsp/completions";
 import { forgejoHover } from "./lsp/hover";
+import { forgejoConfigSchema } from "./config";
 
 const reuseNote =
   "forgejo reuses the github lexicon's entities — run `chant generate` in the github lexicon instead.";
 
 export const forgejoPlugin: LexiconPlugin = {
   name: "forgejo",
+  configSchema: forgejoConfigSchema,
   auditCatalog: () => forgejoAuditCatalog,
   serializer: forgejoSerializer,