infra-kit 0.1.102 → 0.1.105

package/dist/entry/index.d.ts

@@ -0,0 +1,2 @@
+export { defineConfig } from '../lib/package-config/package-config';
+export type { InfraKitPackageConfig, InfraKitPackageConfigInput } from '../lib/package-config/package-config';

package/dist/index.js

@@ -0,0 +1,2 @@
+var r=e=>e;export{r as defineConfig};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/lib/package-config/package-config.ts"],
+  "sourcesContent": ["/**\n * Validation rules for a single workspace package, declared in its\n * `infra-kit.config.js`. Every field is optional: a key left unset falls back to\n * the active baseline ({@link DEFAULT_RULES} for packages, {@link ROOT_DEFAULT_RULES}\n * for the monorepo root), and a key set replaces that default wholesale (per-key,\n * no array concatenation) so a package can opt out with an explicit empty array.\n *\n * Most packages need none of these \u2014 the standard rules live in the baseline, so\n * a typical config is just `defineConfig(() => ({}))`.\n *\n * @example\n * // infra-kit.config.js\n * import { defineConfig } from 'infra-kit'\n *\n * export default defineConfig(() => ({}))\n */\nexport interface InfraKitPackageConfig {\n  /** Scripts that must be present in the package's package.json `scripts` map. */\n  requiredScripts?: string[]\n  /** Files (relative to the package root) that must exist on disk. */\n  requiredFiles?: string[]\n  /** Turborepo expectations \u2014 only meaningful where a turbo.json lives (the root). */\n  turbo?: {\n    /** Tasks that must be defined in turbo.json `tasks`. */\n    requiredTasks?: string[]\n  }\n}\n\n/**\n * Accepted shapes for a package config's default export \u2014 mirrors Vite's\n * `defineConfig` input: a plain object, a sync factory, or an async factory.\n */\nexport type InfraKitPackageConfigInput =\n  | InfraKitPackageConfig\n  | (() => InfraKitPackageConfig)\n  | (() => Promise<InfraKitPackageConfig>)\n\n/**\n * Identity helper that gives `infra-kit.config.js` authors full type inference\n * and editor autocomplete without changing the value \u2014 exactly like Vite's\n * `defineConfig`. Resolution of the factory form happens in the loader, not here.\n *\n * @example\n * export default defineConfig(() => ({}))\n *\n * @example\n * export default defineConfig(() => ({ requiredScripts: [] }))\n */\nexport const defineConfig = (config: InfraKitPackageConfigInput): InfraKitPackageConfigInput => {\n  return config\n}\n\n/** Fully-resolved rules with every defaultable field present. */\nexport interface ResolvedPackageRules {\n  requiredScripts: string[]\n  requiredFiles: string[]\n  turboTasks: string[]\n}\n\n/**\n * Baseline rules for a standard TypeScript workspace package, applied to any key\n * a package leaves unset. These are the \"under the hood\" defaults so a conforming\n * package's config can stay empty; non-standard packages override the relevant key.\n */\nexport const DEFAULT_RULES: Readonly<ResolvedPackageRules> = {\n  requiredScripts: ['build', 'ts-check', 'eslint-check', 'prettier-check', 'test'],\n  requiredFiles: ['tsconfig.json', 'eslint.config.js', 'readme.md'],\n  turboTasks: [],\n}\n\n/**\n * Baseline rules for the monorepo root (`infra-kit audit --root`). Checks the\n * root commands, the workspace/turbo files, and that the turbo pipeline defines\n * the expected tasks \u2014 so the root's own config can also stay empty.\n */\nexport const ROOT_DEFAULT_RULES: Readonly<ResolvedPackageRules> = {\n  requiredScripts: ['build', 'dev', 'test', 'qa', 'check', 'fix'],\n  requiredFiles: ['turbo.json', 'pnpm-workspace.yaml'],\n  turboTasks: ['build', 'test', 'ts-check', 'eslint-check', 'prettier-check', 'check'],\n}\n\n/**\n * Merge a parsed package config over a baseline. Each key is replaced wholesale\n * when the package provides it, otherwise the baseline value is used.\n *\n * @example\n * resolvePackageConfig({ requiredScripts: [] })\n * // => { requiredScripts: [], requiredFiles: [...DEFAULT_RULES.requiredFiles], turboTasks: [] }\n */\nexport const resolvePackageConfig = (\n  config: InfraKitPackageConfig,\n  baseline: Readonly<ResolvedPackageRules> = DEFAULT_RULES,\n): ResolvedPackageRules => {\n  return {\n    requiredScripts: config.requiredScripts ?? [...baseline.requiredScripts],\n    requiredFiles: config.requiredFiles ?? [...baseline.requiredFiles],\n    turboTasks: config.turbo?.requiredTasks ?? [...baseline.turboTasks],\n  }\n}\n"],
+  "mappings": "AAgDO,IAAMA,EAAgBC,GACpBA",
+  "names": ["defineConfig", "config"]
+}

package/dist/lib/package-config/package-config.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Validation rules for a single workspace package, declared in its
+ * `infra-kit.config.js`. Every field is optional: a key left unset falls back to
+ * the active baseline ({@link DEFAULT_RULES} for packages, {@link ROOT_DEFAULT_RULES}
+ * for the monorepo root), and a key set replaces that default wholesale (per-key,
+ * no array concatenation) so a package can opt out with an explicit empty array.
+ *
+ * Most packages need none of these — the standard rules live in the baseline, so
+ * a typical config is just `defineConfig(() => ({}))`.
+ *
+ * @example
+ * // infra-kit.config.js
+ * import { defineConfig } from 'infra-kit'
+ *
+ * export default defineConfig(() => ({}))
+ */
+export interface InfraKitPackageConfig {
+    /** Scripts that must be present in the package's package.json `scripts` map. */
+    requiredScripts?: string[];
+    /** Files (relative to the package root) that must exist on disk. */
+    requiredFiles?: string[];
+    /** Turborepo expectations — only meaningful where a turbo.json lives (the root). */
+    turbo?: {
+        /** Tasks that must be defined in turbo.json `tasks`. */
+        requiredTasks?: string[];
+    };
+}
+/**
+ * Accepted shapes for a package config's default export — mirrors Vite's
+ * `defineConfig` input: a plain object, a sync factory, or an async factory.
+ */
+export type InfraKitPackageConfigInput = InfraKitPackageConfig | (() => InfraKitPackageConfig) | (() => Promise<InfraKitPackageConfig>);
+/**
+ * Identity helper that gives `infra-kit.config.js` authors full type inference
+ * and editor autocomplete without changing the value — exactly like Vite's
+ * `defineConfig`. Resolution of the factory form happens in the loader, not here.
+ *
+ * @example
+ * export default defineConfig(() => ({}))
+ *
+ * @example
+ * export default defineConfig(() => ({ requiredScripts: [] }))
+ */
+export declare const defineConfig: (config: InfraKitPackageConfigInput) => InfraKitPackageConfigInput;
+/** Fully-resolved rules with every defaultable field present. */
+export interface ResolvedPackageRules {
+    requiredScripts: string[];
+    requiredFiles: string[];
+    turboTasks: string[];
+}
+/**
+ * Baseline rules for a standard TypeScript workspace package, applied to any key
+ * a package leaves unset. These are the "under the hood" defaults so a conforming
+ * package's config can stay empty; non-standard packages override the relevant key.
+ */
+export declare const DEFAULT_RULES: Readonly<ResolvedPackageRules>;
+/**
+ * Baseline rules for the monorepo root (`infra-kit audit --root`). Checks the
+ * root commands, the workspace/turbo files, and that the turbo pipeline defines
+ * the expected tasks — so the root's own config can also stay empty.
+ */
+export declare const ROOT_DEFAULT_RULES: Readonly<ResolvedPackageRules>;
+/**
+ * Merge a parsed package config over a baseline. Each key is replaced wholesale
+ * when the package provides it, otherwise the baseline value is used.
+ *
+ * @example
+ * resolvePackageConfig({ requiredScripts: [] })
+ * // => { requiredScripts: [], requiredFiles: [...DEFAULT_RULES.requiredFiles], turboTasks: [] }
+ */
+export declare const resolvePackageConfig: (config: InfraKitPackageConfig, baseline?: Readonly<ResolvedPackageRules>) => ResolvedPackageRules;