@deltabox/toolchain 2.4.0 → 2.6.0

package/dist/packages/shared/src/config-schema/json.d.ts

@@ -4,7 +4,7 @@ import { z } from "zod";
 //#region packages/shared/src/config-schema/json.d.ts
 /** A JSON value, recursively. */
 type JsonValue = string | number | boolean | null | JsonValue[] | {
-  [key: string]: JsonValue;
+  [key: string & {}]: JsonValue;
 };
 /**
  * Any JSON value (string, number, boolean, null, array or object), recursively.

package/dist/packages/shared/src/config-schema/tsconfig.d.ts

@@ -11,6 +11,27 @@ export declare const tsconfigConfigSchema: z.ZodObject<{
   refs: z.ZodOptional<z.ZodBoolean>;
   composite: z.ZodOptional<z.ZodBoolean>;
   aliases: z.ZodOptional<z.ZodBoolean>;
+  auto: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    rewriteAlias: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodArray<z.ZodObject<{
+      pattern: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+      replacement: z.ZodString;
+    }, z.core.$strip>>]>>;
+  }, z.core.$strip>]>>;
+  aliasAuto: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    rewriteAlias: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodString>, z.ZodArray<z.ZodObject<{
+      pattern: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+      replacement: z.ZodString;
+    }, z.core.$strip>>]>>;
+  }, z.core.$strip>]>>;
+  refsAuto: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>]>>;
+  autoSrcDir: z.ZodOptional<z.ZodString>;
   indent: z.ZodOptional<z.ZodNumber>;
   rootFile: z.ZodOptional<z.ZodString>;
   defaultFile: z.ZodOptional<z.ZodString>;

package/dist/packages/shared/src/config-schema/tsconfig.js

@@ -1 +1 @@
-import"node:path";import"node:url";import.meta.url;import{externalConfigSchema as e}from"./external.js";import{withEnabled as t}from"./meta.js";import{z as n}from"zod";const r=t=>e(t,`TsConfigJson`),i=t(n.object({glob:n.union([n.string(),n.array(n.string())]).describe("Glob(s) for the workspace default tsconfig files. Defaults to matching every `defaultFile` recursively.").optional(),exclude:n.union([n.string(),n.array(n.string())]).describe("Glob(s) to exclude from `glob`. Defaults to the common ignored paths (`node_modules`, `.dbx`, `dist`, `build`, ...).").optional(),gitignore:n.boolean().describe("Also respect `.gitignore` files (root + nested) when matching `glob` (default true).").optional(),refs:n.boolean().describe(`Wire project references (default false).`).optional(),composite:n.boolean().describe("Emit `composite: true` (default false).").optional(),aliases:n.boolean().describe(`Inject path aliases (default true).`).optional(),indent:n.number().describe(`JSON indentation (default 4).`).optional(),rootFile:n.string().describe("The workspaces tsconfig file name that holds `paths` + `references` (default `tsconfig.workspaces.json`).").optional(),defaultFile:n.string().describe("The workspace default tsconfig file name that the generator expands (default `tsconfig.default.json`).").optional(),buildFile:n.string().describe("The workspace build tsconfig file name (default `tsconfig.build.json`).").optional(),baseFile:n.string().describe("The root base tsconfig file name (default `tsconfig.base.json`).").optional(),extends:n.object({base:n.union([n.string(),n.array(n.string()),n.literal(!1)]).describe("`extends` written into scaffolded `tsconfig.base.json` files (or `false` to remove the field).").optional(),default:n.union([n.string(),n.array(n.string()),n.literal(!1)]).describe("`extends` written into scaffolded `tsconfig.default.json` files (or `false` to remove the field).").optional(),build:n.union([n.string(),n.array(n.string()),n.literal(!1)]).describe("`extends` written into scaffolded `tsconfig.build.json` files. Default `./tsconfig.default.json`; use `./tsconfig.json` to let builds reuse the path aliases (at the cost of pulling workspace source into the build).").optional()}).describe("Per-file `extends` overrides for generated/scaffolded tsconfig templates.").optional(),overrides:n.object({base:r("Deep-merged into the root base tsconfig (`baseFile`) during sync.").optional(),default:r("Deep-merged into every workspace default tsconfig (`defaultFile`) during sync.").optional(),build:r("Deep-merged into every workspace build tsconfig (`buildFile`) during sync.").optional(),root:r("Deep-merged into the root workspaces tsconfig (`rootFile`) during sync.").optional()}).describe(`Managed overrides deep-merged into the base/root/default/build tsconfig files during sync. The originals are snapshotted in the manifest, so removing a key reverts it (restoring the original value when the file defined one).`).meta({id:`ToolchainTsconfigOverrides`}).optional()})).describe(`Workspace tsconfig generation (path aliases + project references).`).meta({id:`ToolchainTsconfigConfig`});export{i as tsconfigConfigSchema};
+import"node:path";import"node:url";import.meta.url;import{externalConfigSchema as e}from"./external.js";import{withEnabled as t}from"./meta.js";import{z as n}from"zod";const r=t=>e(t,`TsConfigJson`),i=n.object({include:n.array(n.string()).describe("Only auto-wire entries matching these globs (`auto`: workspace dirs; `aliasAuto`: rewritten alias keys; `refsAuto`: reference paths).").optional(),exclude:n.array(n.string()).describe("Skip entries matching these globs (same targets as `include`).").optional()}).meta({id:`ToolchainTsconfigAutoSetting`}),a=n.union([n.record(n.string(),n.string()),n.array(n.object({pattern:n.union([n.string(),n.array(n.string())]),replacement:n.string()}))]).describe('Rewrite the alias keys auto-wiring generates (custom keys are preserved). Patterns are URL-rewrite style: a string is a regular-expression source and replacements support `$1`, `$2`, ... capture groups. Examples: `{ "^@acme/(.+)$": "@acme/pkg/$1" }` (string patterns), `[{ pattern: /^@acme\\/(.+)$/, replacement: "@acme/pkg/$1" }]` (RegExp patterns), `[{ pattern: ["^@acme/a$", "^@acme/b$"], replacement: "@acme/x" }]` (an array of keys), and an array of such rules (applied in order; the first matching rule wins). `RegExp` patterns are only available from TS/JS configs; JSON configs use string patterns.').meta({tsType:`ToolchainTsconfigAliasRewrite`}),o=i.extend({rewriteAlias:a.optional()}).meta({id:`ToolchainTsconfigAliasAutoSetting`}),s=e=>n.union([n.boolean(),i]).describe(e),c=e=>n.union([n.boolean(),o]).describe(e),l=t(n.object({glob:n.union([n.string(),n.array(n.string())]).describe("Glob(s) for the workspace default tsconfig files. Defaults to matching every `defaultFile` recursively.").optional(),exclude:n.union([n.string(),n.array(n.string())]).describe("Glob(s) to exclude from `glob`. Defaults to the common ignored paths (`node_modules`, `.dbx`, `dist`, `build`, ...).").optional(),gitignore:n.boolean().describe("Also respect `.gitignore` files (root + nested) when matching `glob` (default true).").optional(),refs:n.boolean().describe(`Wire project references (default false).`).optional(),composite:n.boolean().describe("Emit `composite: true` (default false).").optional(),aliases:n.boolean().describe(`Inject path aliases (default true).`).optional(),auto:c(`Auto-generate the root workspaces tsconfig paths/references from the project graph (default false). Set true to derive them from the project graph; set false to only use the entries you define yourself.`).optional(),aliasAuto:c("Auto-generate path aliases (defaults to `auto`; `aliases` must also be enabled). Accepts the same `include`/`exclude`/`rewriteAlias` object as `auto`.").optional(),refsAuto:s("Auto-generate project references (defaults to `auto`; `refs` must also be enabled).").optional(),autoSrcDir:n.string().describe("Source directory used to resolve workspace entry points when `package.json` does not declare `exports`/`main`/`types` (default: the workspace's final tsconfig `rootDir`/`baseUrl`, falling back to `src`).").meta({tsType:`'src' | '.' | (string & {})`}).optional(),indent:n.number().describe(`JSON indentation (default 4).`).optional(),rootFile:n.string().describe("The workspaces tsconfig file name that holds `paths` + `references` (default `tsconfig.workspaces.json`).").optional(),defaultFile:n.string().describe("The workspace default tsconfig file name that the generator expands (default `tsconfig.default.json`).").optional(),buildFile:n.string().describe("The workspace build tsconfig file name (default `tsconfig.build.json`).").optional(),baseFile:n.string().describe("The root base tsconfig file name (default `tsconfig.base.json`).").optional(),extends:n.object({base:n.union([n.string(),n.array(n.string()),n.literal(!1)]).describe("`extends` written into scaffolded `tsconfig.base.json` files (or `false` to remove the field).").optional(),default:n.union([n.string(),n.array(n.string()),n.literal(!1)]).describe("`extends` written into scaffolded `tsconfig.default.json` files (or `false` to remove the field).").optional(),build:n.union([n.string(),n.array(n.string()),n.literal(!1)]).describe("`extends` written into scaffolded `tsconfig.build.json` files. Default `./tsconfig.default.json`; use `./tsconfig.json` to let builds reuse the path aliases (at the cost of pulling workspace source into the build).").optional()}).describe("Per-file `extends` overrides for generated/scaffolded tsconfig templates.").optional(),overrides:n.object({base:r("Deep-merged into the root base tsconfig (`baseFile`) during sync.").optional(),default:r("Deep-merged into every workspace default tsconfig (`defaultFile`) during sync.").optional(),build:r("Deep-merged into every workspace build tsconfig (`buildFile`) during sync.").optional(),root:r("Deep-merged into the root workspaces tsconfig (`rootFile`) during sync.").optional()}).describe(`Managed overrides deep-merged into the base/root/default/build tsconfig files during sync. The originals are snapshotted in the manifest, so removing a key reverts it (restoring the original value when the file defined one).`).meta({id:`ToolchainTsconfigOverrides`}).optional()})).describe(`Workspace tsconfig generation (path aliases + project references).`).meta({id:`ToolchainTsconfigConfig`});export{l as tsconfigConfigSchema};

package/dist/packages/shared/src/config-schema/vendor-types.d.ts

@@ -0,0 +1,156 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+//#region packages/shared/src/config-schema/vendor-types.d.ts
+/**
+ * Self-contained mirrors of the external tool config types.
+ *
+ * `prettier`, `eslint` and `@dprint/types` are optional peers of the published
+ * package. Importing their types directly from `dist/*.d.ts` makes a clean
+ * install fail to typecheck unless they happen to be installed, so the
+ * published declarations carry these local mirrors instead. Each one exposes
+ * the keys users reach for most and keeps an open index signature for the rest,
+ * so unknown/newer options still typecheck (and known keys still autocomplete).
+ */
+/** Prettier's `Options` (the `.prettierrc` shape). */
+export interface PrettierConfig {
+  /** Wrap prose to this width. */
+  proseWrap?: 'always' | 'never' | 'preserve';
+  /** Print semicolons at the ends of statements. */
+  semi?: boolean;
+  /** Use single quotes instead of double quotes. */
+  singleQuote?: boolean;
+  /** Use single quotes in JSX. */
+  jsxSingleQuote?: boolean;
+  /** Print trailing commas wherever possible. */
+  trailingComma?: 'none' | 'es5' | 'all';
+  /** Print spaces between brackets in object literals. */
+  bracketSpacing?: boolean;
+  /** How to wrap object literals. */
+  objectWrap?: 'preserve' | 'collapse';
+  /** Put the `>` of a multi-line element on the last line. */
+  bracketSameLine?: boolean;
+  /** Deprecated alias for {@link bracketSameLine}. */
+  jsxBracketSameLine?: boolean;
+  /** Format only a segment of a file (start offset). */
+  rangeStart?: number;
+  /** Format only a segment of a file (end offset). */
+  rangeEnd?: number;
+  /** The parser to use (a built-in name or a plugin parser). */
+  parser?: string | Record<string & {}, unknown>;
+  /** The input filepath, used for parser inference. */
+  filepath?: string;
+  /** Only format files containing the `@format` pragma. */
+  requirePragma?: boolean;
+  /** Insert the `@format` pragma when formatting. */
+  insertPragma?: boolean;
+  /** Allow files to opt out with an ignore pragma. */
+  checkIgnorePragma?: boolean;
+  /** Include parentheses around a sole arrow function parameter. */
+  arrowParens?: 'avoid' | 'always';
+  /** Prettier plugins to load (module specifiers, URLs or plugin objects). */
+  plugins?: Array<unknown>;
+  /** How to handle whitespace in HTML. */
+  htmlWhitespaceSensitivity?: 'css' | 'strict' | 'ignore';
+  /** Which end-of-line characters to apply. */
+  endOfLine?: 'auto' | 'lf' | 'crlf' | 'cr';
+  /** Change when properties in objects are quoted. */
+  quoteProps?: 'as-needed' | 'consistent' | 'preserve';
+  /** Indent `<script>`/`<style>` content in Vue files. */
+  vueIndentScriptAndStyle?: boolean;
+  /** Control formatting of quoted code embedded in the file. */
+  embeddedLanguageFormatting?: 'auto' | 'off';
+  /** Enforce a single attribute per line in HTML/Vue/JSX. */
+  singleAttributePerLine?: boolean;
+  /** Where to print operators when binary expressions wrap. */
+  experimentalOperatorPosition?: 'start' | 'end';
+  /** Use curious ternaries. */
+  experimentalTernaries?: boolean;
+  /** The line length the printer wraps on. */
+  printWidth?: number;
+  /** The number of spaces per indentation level. */
+  tabWidth?: number;
+  /** Indent with tabs instead of spaces. */
+  useTabs?: boolean;
+  /** The parent parser, when formatting an embedded language. */
+  parentParser?: string;
+  /** @internal Whether the value is embedded in HTML. */
+  __embeddedInHtml?: boolean;
+  [key: string & {}]: unknown;
+}
+/** ESLint flat-config language options. */
+export interface EslintLanguageOptions {
+  /** The ECMAScript version to support (`latest` for the newest). */
+  ecmaVersion?: number | 'latest';
+  /** The source type. */
+  sourceType?: 'script' | 'module' | 'commonjs';
+  /** Globals added to the linting scope. */
+  globals?: Record<string & {}, unknown>;
+  /** The parser (an object or a module specifier). */
+  parser?: unknown;
+  /** Parser-specific options. */
+  parserOptions?: Record<string & {}, unknown>;
+}
+/** ESLint flat-config linter options. */
+export interface EslintLinterOptions {
+  /** Disallow inline configuration comments. */
+  noInlineConfig?: boolean;
+  /** Report unused `eslint-disable` directives. */
+  reportUnusedDisableDirectives?: boolean | 'off' | 'warn' | 'error' | 0 | 1 | 2;
+}
+/** ESLint's flat config object (`Linter.Config`). */
+export interface EslintConfig {
+  /** A name for this config object (useful in errors and tooling). */
+  name?: string;
+  /** The base path for relative file patterns. */
+  basePath?: string;
+  /** The glob patterns (or groups of patterns) this config applies to. */
+  files?: Array<string | Array<string>>;
+  /** The glob patterns this config ignores. */
+  ignores?: Array<string>;
+  /** The language used for linting (set by language plugins). */
+  language?: string;
+  /** Other configs to extend. */
+  extends?: Array<string | EslintConfig>;
+  /** Language options (parser, globals, ECMAScript version). */
+  languageOptions?: EslintLanguageOptions;
+  /** Linter behaviour options. */
+  linterOptions?: EslintLinterOptions;
+  /** Plugin implementations keyed by namespace. */
+  plugins?: Record<string & {}, unknown>;
+  /** A processor (a module specifier or a processor object). */
+  processor?: unknown;
+  /** Rule severities and options keyed by rule name. */
+  rules?: Record<string & {}, unknown>;
+  /** Shared settings passed to every rule. */
+  settings?: Record<string & {}, unknown>;
+  [key: string & {}]: unknown;
+}
+/**
+ * Dprint's `dprint.json` configuration: global layout options plus arbitrary
+ * per-language/plugin sections.
+ */
+export interface DprintConfig {
+  /** The project type (used by dprint's sponsor check). */
+  projectType?: 'openSource' | 'commercialSponsored' | 'commercialDidNotSponsor';
+  /** Only format changed files on subsequent runs. */
+  incremental?: boolean;
+  /** The width the printer tries to stay under. */
+  lineWidth?: number;
+  /** The number of spaces per indent level. */
+  indentWidth?: number;
+  /** Indent with tabs instead of spaces. */
+  useTabs?: boolean;
+  /** The kind of newline to use. */
+  newLineKind?: 'auto' | 'crlf' | 'lf' | 'system';
+  /** The files to include (globs). */
+  includes?: Array<string>;
+  /** The files to exclude (globs). */
+  excludes?: Array<string>;
+  /** The plugins to load (module specifiers or plugin objects). */
+  plugins?: Array<unknown>;
+  /** TypeScript plugin options. */
+  typescript?: Record<string & {}, unknown>;
+  /** Any other language/plugin section. */
+  [section: string & {}]: unknown;
+}
+//#endregion