@intentius/chant-lexicon-k3d 0.0.1

package/dist/meta.json

@@ -0,0 +1,184 @@
+{
+  "Cluster": {
+    "resourceType": "K3d::Cluster",
+    "kind": "resource",
+    "lexicon": "k3d",
+    "constraints": {
+      "apiVersion": {
+        "default": "k3d.io/v1alpha5",
+        "enum": [
+          "k3d.io/v1alpha5"
+        ]
+      },
+      "kind": {
+        "default": "Simple",
+        "enum": [
+          "Simple"
+        ]
+      },
+      "servers": {
+        "minimum": 1
+      },
+      "agents": {
+        "minimum": 0
+      },
+      "subnet": {
+        "default": "auto"
+      }
+    }
+  },
+  "EnvVar": {
+    "resourceType": "K3d::EnvVar",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "File": {
+    "resourceType": "K3d::File",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "HostAlias": {
+    "resourceType": "K3d::HostAlias",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "K3dOptions": {
+    "resourceType": "K3d::K3dOptions",
+    "kind": "property",
+    "lexicon": "k3d",
+    "constraints": {
+      "wait": {
+        "default": true
+      },
+      "disableLoadbalancer": {
+        "default": false
+      },
+      "disableImageVolume": {
+        "default": false
+      },
+      "disableRollback": {
+        "default": false
+      }
+    }
+  },
+  "K3sExtraArg": {
+    "resourceType": "K3d::K3sExtraArg",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "K3sOptions": {
+    "resourceType": "K3d::K3sOptions",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "KubeAPI": {
+    "resourceType": "K3d::KubeAPI",
+    "kind": "property",
+    "lexicon": "k3d",
+    "constraints": {
+      "host": {
+        "format": "hostname"
+      },
+      "hostIP": {
+        "format": "ipv4"
+      }
+    }
+  },
+  "KubeconfigOptions": {
+    "resourceType": "K3d::KubeconfigOptions",
+    "kind": "property",
+    "lexicon": "k3d",
+    "constraints": {
+      "updateDefaultKubeconfig": {
+        "default": true
+      },
+      "switchCurrentContext": {
+        "default": true
+      }
+    }
+  },
+  "LoadbalancerOptions": {
+    "resourceType": "K3d::LoadbalancerOptions",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "Metadata": {
+    "resourceType": "K3d::Metadata",
+    "kind": "property",
+    "lexicon": "k3d",
+    "constraints": {
+      "name": {
+        "format": "hostname"
+      }
+    }
+  },
+  "NodeLabel": {
+    "resourceType": "K3d::NodeLabel",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "Options": {
+    "resourceType": "K3d::Options",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "Port": {
+    "resourceType": "K3d::Port",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "Registries": {
+    "resourceType": "K3d::Registries",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "RegistryCreate": {
+    "resourceType": "K3d::RegistryCreate",
+    "kind": "property",
+    "lexicon": "k3d",
+    "constraints": {
+      "host": {
+        "default": "0.0.0.0"
+      },
+      "hostPort": {
+        "default": "random"
+      },
+      "image": {
+        "default": "docker.io/library/registry:2"
+      },
+      "enforcePortMatch": {
+        "default": false
+      }
+    }
+  },
+  "RegistryProxy": {
+    "resourceType": "K3d::RegistryProxy",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "RuntimeLabel": {
+    "resourceType": "K3d::RuntimeLabel",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "RuntimeOptions": {
+    "resourceType": "K3d::RuntimeOptions",
+    "kind": "property",
+    "lexicon": "k3d",
+    "constraints": {
+      "hostPidMode": {
+        "default": false
+      }
+    }
+  },
+  "Ulimit": {
+    "resourceType": "K3d::Ulimit",
+    "kind": "property",
+    "lexicon": "k3d"
+  },
+  "Volume": {
+    "resourceType": "K3d::Volume",
+    "kind": "property",
+    "lexicon": "k3d"
+  }
+}

package/dist/op/activities/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * k3d Op activities — resolved by the core activity registry when a project's
+ * `chant.config.ts` lists the `k3d` lexicon. Relocated from the k8s lexicon
+ * (chant #1410) so the local-cluster tooling lives with its product:
+ *   - k3dUp / k3dDown — boot/tear down a local k3d cluster. Since #1411 the
+ *     kubeconfig default is safe: the caller's default kubeconfig and current
+ *     context are left alone unless explicitly requested, and `k3dUp` returns
+ *     `{ context, kubeconfigPath? }` so later steps know what to talk to.
+ *
+ * The step builders (k3dUp, k3dDown) stay in core, re-exported from the
+ * temporal Op-authoring barrel like the other core builders. The activities are
+ * dependency-light — they shell out to the k3d CLI and do not import the k3d
+ * declarable surface — so a Temporal worker loads them cheaply.
+ */
+export { k3dUp, k3dDown, k3dUpCommand, k3dDownCommand, k3dExistsCommand, k3dKubeconfigWriteCommand, k3dContextName, } from "./k3d.js";
+export type { K3dUpArgs, K3dDownArgs, K3dUpResult } from "./k3d.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/op/activities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/op/activities/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,KAAK,EACL,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,GACf,MAAM,OAAO,CAAC;AACf,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC"}

package/dist/op/activities/k3d.d.ts

@@ -0,0 +1,93 @@
+export interface K3dUpArgs {
+    /** Cluster name (`k3d cluster create <name>`). */
+    name: string;
+    /** Number of server (control-plane) nodes. */
+    servers?: number;
+    /** Number of agent (worker) nodes. */
+    agents?: number;
+    /** k3s image, e.g. `rancher/k3s:v1.31.4-k3s1`. */
+    image?: string;
+    /** Port mappings, e.g. `["8080:80@loadbalancer"]`. */
+    ports?: string[];
+    /** Create a managed local registry with this name (`--registry-create`). */
+    registryCreate?: string;
+    /** Path to a k3d config file (`--config`). */
+    configFile?: string;
+    /** Readiness timeout for `--wait`. Default: `120s`. */
+    timeout?: string;
+    /**
+     * Merge the new cluster into the caller's default kubeconfig
+     * (`--kubeconfig-update-default=<bool>`). Chant's default is `false` —
+     * deliberately the opposite of upstream k3d's `true`: a tool that reconciles
+     * infrastructure must not repoint the caller's shell. The context-hijack
+     * false-failure during #1394's scoping is the receipt. When the default
+     * kubeconfig is left alone, {@link k3dUp} writes a dedicated kubeconfig and
+     * returns its path so later steps can still reach the cluster.
+     *
+     * With a `configFile` and this arg unset, no flag is passed at all — the
+     * declared config's own `options.kubeconfig` governs (k3d gives CLI flags
+     * precedence over config, so a declared `true` keeps working).
+     */
+    updateDefaultKubeconfig?: boolean;
+    /**
+     * Switch the caller's current kubectl context to the new cluster
+     * (`--kubeconfig-switch-context=<bool>`). Chant's default is `false` — see
+     * {@link K3dUpArgs.updateDefaultKubeconfig} for why chant inverts upstream's
+     * default. Same `configFile` rule: unset alongside a `configFile`, no flag
+     * is passed and the config governs.
+     */
+    switchCurrentContext?: boolean;
+}
+export interface K3dDownArgs {
+    /** Cluster name to delete. */
+    name: string;
+}
+/** What {@link k3dUp} resolved for talking to the cluster. */
+export interface K3dUpResult {
+    /** kubectl context name for the cluster — always `k3d-<name>`. */
+    context: string;
+    /**
+     * Path of the dedicated kubeconfig (`k3d kubeconfig write <name>`), present
+     * whenever the caller did not explicitly merge into the default kubeconfig —
+     * without it the context exists nowhere a later `kubectl` step could find it.
+     */
+    kubeconfigPath?: string;
+}
+/** `k3d cluster list <name> --no-headers` — non-empty stdout means the cluster exists. */
+export declare function k3dExistsCommand(name: string): string;
+/** kubectl context name k3d assigns a cluster: `k3d-<name>`. */
+export declare function k3dContextName(name: string): string;
+/** `k3d kubeconfig write <name>` — prints the path of the written kubeconfig. */
+export declare function k3dKubeconfigWriteCommand(name: string): string;
+/**
+ * Build the `k3d cluster create` command.
+ *
+ * Kubeconfig behavior: upstream k3d merges the new cluster into the default
+ * kubeconfig and switches the current context. Chant defaults both to `false`
+ * (see {@link K3dUpArgs.updateDefaultKubeconfig}) — but only forces its
+ * defaults when no `configFile` is given. Each kubeconfig flag is emitted when
+ * the caller set it explicitly, or when there is no `configFile`; with a
+ * `configFile` and the arg unset, the flag is omitted so the declared config's
+ * `options.kubeconfig` governs.
+ */
+export declare function k3dUpCommand(args: K3dUpArgs): string;
+/** Build the `k3d cluster delete` command. */
+export declare function k3dDownCommand(args: K3dDownArgs): string;
+/**
+ * Create a local k3d cluster (vanilla Kubernetes in Docker). Idempotent: if a
+ * cluster of the same name already exists it is left as-is. Uses longInfra
+ * profile — 20m timeout, heartbeat every 15s (creation may pull the k3s image).
+ *
+ * Unlike the upstream CLI, this does NOT touch the caller's default kubeconfig
+ * or current context unless asked (see {@link K3dUpArgs.updateDefaultKubeconfig}).
+ * It returns the context name and, when the default kubeconfig was left alone,
+ * the path of a dedicated kubeconfig — pass those to the steps that apply
+ * manifests afterwards.
+ */
+export declare function k3dUp(args: K3dUpArgs, signal?: AbortSignal): Promise<K3dUpResult>;
+/**
+ * Delete a local k3d cluster. Uses fastIdempotent profile — 5m timeout.
+ * `k3d cluster delete` is a no-op success when the cluster is already gone.
+ */
+export declare function k3dDown(args: K3dDownArgs, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=k3d.d.ts.map

package/dist/op/activities/k3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k3d.d.ts","sourceRoot":"","sources":["../../../src/op/activities/k3d.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;;OAYG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,iFAAiF;AACjF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAiBpD;AAED,8CAA8C;AAC9C,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAExD;AAyBD;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBvF;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpF"}

package/dist/package-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=package-cli.d.ts.map

package/dist/package-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-cli.d.ts","sourceRoot":"","sources":["../src/package-cli.ts"],"names":[],"mappings":""}

package/dist/plugin.d.ts

@@ -0,0 +1,8 @@
+import type { LexiconPlugin } from "@intentius/chant/lexicon";
+/**
+ * k3d lexicon plugin.
+ *
+ * Implements all required LexiconPlugin lifecycle methods.
+ */
+export declare const k3dPlugin: LexiconPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAiC,MAAM,0BAA0B,CAAC;AAa7F;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,aA+FvB,CAAC"}

package/dist/serializer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * k3d SimpleConfig YAML serializer.
+ *
+ * Emits the config file `k3d cluster create --config` consumes verbatim —
+ * the walk-away artifact that justifies a lexicon here at all. One YAML
+ * document per declared Cluster: the first is the primary output, any
+ * further clusters land in files[] keyed `<name>.k3d.yaml`.
+ *
+ * Three things are non-negotiable in the output (#1408):
+ *
+ *   - `apiVersion` and `kind` are literal schema properties, not derived
+ *     from a type name. They default when undeclared and are never dropped.
+ *   - Booleans stay booleans and zero stays zero. `agents: 0` is the normal
+ *     local shape and `updateDefaultKubeconfig: "false"` is truthy.
+ *   - `nodeFilters` pass through untouched — they are k3d's own syntax
+ *     (`server:0`, `agent:*`, `loadbalancer`) and rewriting them here would
+ *     be inventing a dialect.
+ *
+ * ## The kubeconfig default is chant's, not upstream's
+ *
+ * When a declaration says nothing about `options.kubeconfig`, the emitted
+ * config pins `updateDefaultKubeconfig: false` and `switchCurrentContext:
+ * false` — the opposite of k3d's own defaults, chosen deliberately (#1411):
+ * a tool that reconciles infrastructure must not rewrite ~/.kube/config or
+ * repoint the caller's shell as a side effect. Injecting the values into the
+ * artifact rather than relying on activity flags means the emitted YAML says
+ * on its face what creating the cluster will do, and `k3d --config` applied
+ * by hand behaves identically. A declaration that sets `options.kubeconfig`
+ * itself — either key — is passed through exactly as written; upstream
+ * defaults then apply to whatever it left unset, because a partially
+ * explicit block is the author taking the wheel.
+ */
+import type { Serializer } from "@intentius/chant/serializer";
+export declare const k3dSerializer: Serializer;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAsC,MAAM,6BAA6B,CAAC;AA8IlG,eAAO,MAAM,aAAa,EAAE,UAwB3B,CAAC"}

package/dist/spec/fetch.d.ts

@@ -0,0 +1,39 @@
+/**
+ * k3d SimpleConfig schema fetching — downloads the JSON Schema and
+ * caches it locally.
+ */
+/**
+ * Pinned upstream k3d release.
+ *
+ * The schema is fetched from the tagged source tree, not a moving branch:
+ * https://raw.githubusercontent.com/k3d-io/k3d/v5.9.0/pkg/config/v1alpha5/schema.json
+ *
+ * v1alpha5 is the config apiVersion this lexicon models. Older config
+ * versions (v1alpha2..v1alpha4) each ship their own migrate.go upstream —
+ * k3d migrates old configs itself, so modelling superseded versions here
+ * would duplicate upstream's job. Bump this constant (and re-generate)
+ * when adopting a newer k3d release.
+ */
+export declare const K3D_VERSION = "v5.9.0";
+/**
+ * Get the cache file path for the k3d schema.
+ */
+export declare function getCachePath(): string;
+/**
+ * Fetch the k3d SimpleConfig JSON Schema.
+ * Uses local file caching with 24-hour TTL.
+ */
+export declare function fetchConfigSchema(force?: boolean): Promise<Buffer>;
+/**
+ * Fetch the config schema as a Map<typeName, Buffer> compatible with the
+ * generatePipeline fetchSchemas callback.
+ *
+ * Single document keyed by "K3d::Cluster" — the parse step splits it into
+ * multiple entities.
+ */
+export declare function fetchSchemas(force?: boolean): Promise<Map<string, Buffer>>;
+/**
+ * Clear the cached schema file.
+ */
+export declare function clearCache(): void;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/spec/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/spec/fetch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,WAAW,CAAC;AAIpC;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAQxE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAKhF;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}

package/dist/testdata/load-fixtures.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Test fixture loader for the k3d lexicon.
+ *
+ * The fixture is a verbatim copy of the pinned upstream schema
+ * (see src/spec/fetch.ts for the pin), committed so codegen tests
+ * run offline.
+ */
+/**
+ * Load the pinned SimpleConfig schema fixture for offline testing.
+ */
+export declare function loadSchemaFixture(): Buffer;
+/**
+ * Load the schema fixture as a Map compatible with generatePipeline.
+ */
+export declare function loadSchemaFixtureMap(): Map<string, Buffer>;
+//# sourceMappingURL=load-fixtures.d.ts.map

package/dist/testdata/load-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-fixtures.d.ts","sourceRoot":"","sources":["../../src/testdata/load-fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAI1D"}

package/dist/types/index.d.ts

@@ -0,0 +1,189 @@
+// Code generated by chant k3d generate. DO NOT EDIT.
+
+// --- k3d Entity classes ---
+
+export declare class Cluster {
+  constructor(props: {
+    apiVersion: "k3d.io/v1alpha5";
+    kind: "Simple";
+    agents?: number;
+    env?: EnvVar[];
+    files?: File[];
+    /** Additional IP to multiple hostnames mappings */
+    hostAliases?: HostAlias[];
+    image?: string;
+    kubeAPI?: KubeAPI;
+    metadata?: Metadata;
+    network?: string;
+    options?: Options;
+    ports?: Port[];
+    registries?: Registries;
+    servers?: number;
+    subnet?: string;
+    token?: string;
+    volumes?: Volume[];
+  });
+}
+
+export declare class EnvVar {
+  constructor(props: {
+    envVar?: string;
+    nodeFilters?: string[];
+  });
+}
+
+export declare class File {
+  constructor(props: {
+    destination: string;
+    source: string;
+    description?: string;
+    nodeFilters?: string[];
+  });
+}
+
+export declare class HostAlias {
+  constructor(props: {
+    hostnames?: string[];
+    ip?: string;
+  });
+}
+
+export declare class K3dOptions {
+  constructor(props: {
+    disableImageVolume?: boolean;
+    disableLoadbalancer?: boolean;
+    disableRollback?: boolean;
+    loadbalancer?: LoadbalancerOptions;
+    timeout?: string;
+    wait?: boolean;
+  });
+}
+
+export declare class K3sExtraArg {
+  constructor(props: {
+    arg?: string;
+    nodeFilters?: string[];
+  });
+}
+
+export declare class K3sOptions {
+  constructor(props: {
+    extraArgs?: K3sExtraArg[];
+    nodeLabels?: NodeLabel[];
+  });
+}
+
+export declare class KubeAPI {
+  constructor(props: {
+    host?: string;
+    hostIP?: string;
+    hostPort?: string;
+  });
+}
+
+export declare class KubeconfigOptions {
+  constructor(props: {
+    switchCurrentContext?: boolean;
+    updateDefaultKubeconfig?: boolean;
+  });
+}
+
+export declare class LoadbalancerOptions {
+  constructor(props: {
+    configOverrides?: any[];
+  });
+}
+
+export declare class Metadata {
+  constructor(props: {
+    /** Name of the cluster (must be a valid hostname and will be prefixed with 'k3d-'). Example: 'mycluster'. */
+    name?: string;
+  });
+}
+
+export declare class NodeLabel {
+  constructor(props: {
+    label?: string;
+    nodeFilters?: string[];
+  });
+}
+
+export declare class Options {
+  constructor(props: {
+    k3d?: K3dOptions;
+    k3s?: K3sOptions;
+    kubeconfig?: KubeconfigOptions;
+    runtime?: RuntimeOptions;
+  });
+}
+
+export declare class Port {
+  constructor(props: {
+    nodeFilters?: string[];
+    port?: string;
+  });
+}
+
+export declare class Registries {
+  constructor(props: {
+    /** Reference a K3s registry configuration file or at it's contents here. */
+    config?: string;
+    /** Create a new container image registry alongside the cluster. */
+    create?: RegistryCreate;
+    /** Connect another container image registry to the cluster. */
+    use?: string[];
+  });
+}
+
+export declare class RegistryCreate {
+  constructor(props: {
+    enforcePortMatch?: boolean;
+    host?: string;
+    hostPort?: string;
+    image?: string;
+    name?: string;
+    proxy?: RegistryProxy;
+    volumes?: string[];
+  });
+}
+
+export declare class RegistryProxy {
+  constructor(props: {
+    password?: string;
+    remoteURL?: string;
+    username?: string;
+  });
+}
+
+export declare class RuntimeLabel {
+  constructor(props: {
+    label?: string;
+    nodeFilters?: string[];
+  });
+}
+
+export declare class RuntimeOptions {
+  constructor(props: {
+    agentsMemory?: string;
+    gpuRequest?: string;
+    hostPidMode?: boolean;
+    labels?: RuntimeLabel[];
+    serversMemory?: string;
+    ulimits?: Ulimit[];
+  });
+}
+
+export declare class Ulimit {
+  constructor(props: {
+    hard?: number;
+    name?: string;
+    soft?: number;
+  });
+}
+
+export declare class Volume {
+  constructor(props: {
+    nodeFilters?: string[];
+    volume?: string;
+  });
+}

package/dist/validate-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=validate-cli.d.ts.map

package/dist/validate-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-cli.d.ts","sourceRoot":"","sources":["../src/validate-cli.ts"],"names":[],"mappings":""}

package/dist/validate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Validate generated lexicon-k3d artifacts.
+ *
+ * Thin wrapper around the core validation framework
+ * with k3d-specific configuration.
+ */
+import { type ValidateResult } from "@intentius/chant/codegen/validate";
+export type { ValidateCheck, ValidateResult } from "@intentius/chant/codegen/validate";
+/**
+ * Validate the generated lexicon-k3d artifacts.
+ */
+export declare function validate(opts?: {
+    basePath?: string;
+}): Promise<ValidateResult>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAElG,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAKvF;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAQpF"}