@intentius/chant-lexicon-github 0.0.18

package/src/codegen/patches.ts

@@ -0,0 +1,46 @@
+/**
+ * Schema augmentation patches for GitHub Actions Workflow JSON Schema.
+ */
+
+export interface SchemaPatch {
+  description: string;
+  path: string;
+  apply(def: Record<string, unknown>): void;
+}
+
+/**
+ * Registry of known schema patches.
+ * Currently empty — the SchemaStore workflow schema is well-maintained.
+ */
+export const schemaPatches: SchemaPatch[] = [];
+
+/**
+ * Apply all registered patches to a parsed schema.
+ */
+export function applyPatches(schema: Record<string, unknown>): { applied: string[]; skipped: string[] } {
+  const applied: string[] = [];
+  const skipped: string[] = [];
+
+  for (const patch of schemaPatches) {
+    const segments = patch.path.split(".");
+    let target: Record<string, unknown> | undefined = schema;
+
+    for (const segment of segments) {
+      if (target && typeof target === "object" && segment in target) {
+        target = target[segment] as Record<string, unknown>;
+      } else {
+        target = undefined;
+        break;
+      }
+    }
+
+    if (target) {
+      patch.apply(target);
+      applied.push(patch.description);
+    } else {
+      skipped.push(`${patch.description} (path "${patch.path}" not found)`);
+    }
+  }
+
+  return { applied, skipped };
+}

package/src/composites/cache.ts

@@ -0,0 +1,25 @@
+import { Composite } from "@intentius/chant";
+
+export interface CacheActionProps {
+  path: string;
+  key: string;
+  restoreKeys?: string[];
+}
+
+export const CacheAction = Composite<CacheActionProps>((props) => {
+  const withObj: Record<string, string> = {
+    path: props.path,
+    key: props.key,
+  };
+  if (props.restoreKeys !== undefined) withObj["restore-keys"] = props.restoreKeys.join("\n");
+
+  const { createProperty } = require("@intentius/chant/runtime");
+  const StepClass = createProperty("GitHub::Actions::Step", "github");
+  const step = new StepClass({
+    name: "Cache",
+    uses: "actions/cache@v4",
+    with: withObj,
+  });
+
+  return { step };
+}, "Cache");

package/src/composites/checkout.ts

@@ -0,0 +1,31 @@
+import { Composite } from "@intentius/chant";
+
+export interface CheckoutProps {
+  ref?: string;
+  repository?: string;
+  fetchDepth?: number;
+  token?: string;
+  submodules?: boolean | string;
+  sshKey?: string;
+}
+
+export const Checkout = Composite<CheckoutProps>((props) => {
+  const withObj: Record<string, string> = {};
+  if (props.ref !== undefined) withObj.ref = props.ref;
+  if (props.repository !== undefined) withObj.repository = props.repository;
+  if (props.fetchDepth !== undefined) withObj["fetch-depth"] = String(props.fetchDepth);
+  if (props.token !== undefined) withObj.token = props.token;
+  if (props.submodules !== undefined) withObj.submodules = String(props.submodules);
+  if (props.sshKey !== undefined) withObj["ssh-key"] = props.sshKey;
+
+  // Import Step lazily to avoid circular dependency at module load time
+  const { createProperty } = require("@intentius/chant/runtime");
+  const StepClass = createProperty("GitHub::Actions::Step", "github");
+  const step = new StepClass({
+    name: "Checkout",
+    uses: "actions/checkout@v4",
+    ...(Object.keys(withObj).length > 0 ? { with: withObj } : {}),
+  });
+
+  return { step };
+}, "Checkout");