limina 0.0.5 → 0.1.1

package/chunks/dep-lkQg1P9Q.js

@@ -1,3 +0,0 @@
-import { createRequire } from "node:module";
-
-export {  };

package/config.d.ts

@@ -1,631 +0,0 @@
-//#region src/config.d.ts
-/**
-* Runtime label used by package boundary checks.
-*
-* Use `browser` for code that must stay free of Node.js runtime imports,
-* `node` for server-only output, or a custom string when a package has its own
-* environment naming.
-*/
-type RuntimeEnvironment = "browser" | "node" | string;
-/**
-* One step in a named Limina pipeline.
-*
-* A string can be either a built-in task such as `graph:check`, or a command
-* split on whitespace. Use the object form when you need args, cwd, or env to
-* be unambiguous.
-*/
-type PipelineStep = string | {
-  /**
-  * Arguments passed to the command.
-  *
-  * Prefer this over a single command string when an argument contains
-  * spaces or when you want the config to be easy to review.
-  */
-  args?: string[];
-  /**
-  * Executable name, for example `pnpm`, `tsc`, `tsgo`, `vue-tsc`, or `vue-tsgo`.
-  *
-  * The command runs from the inferred workspace root unless `cwd` is set.
-  */
-  command: string;
-  /**
-  * Working directory for this step, relative to the inferred workspace root.
-  */
-  cwd?: string;
-  /**
-  * Extra environment variables for this step.
-  *
-  * Values are merged on top of `process.env`.
-  */
-  env?: Record<string, string>;
-  /**
-  * Marks this pipeline step as an external command.
-  */
-  type: "command";
-} | {
-  /**
-  * Built-in Limina task to run.
-  */
-  name: BuiltinTaskName;
-  /**
-  * Marks this pipeline step as a built-in task.
-  */
-  type: "task";
-};
-/**
-* Built-in task names understood by Limina pipelines.
-*/
-type BuiltinTaskName = "checker:build" | "checker:typecheck" | "graph:check" | "nx:check" | "package:check" | "proof:check" | "release:check" | "source:check";
-type BuiltinCheckerPreset = "svelte-check" | "tsc" | "tsgo" | "vue-tsc" | "vue-tsgo";
-type CheckerPreset = BuiltinCheckerPreset;
-type CheckerExecutionKind = "build" | "typecheck";
-/**
-* Checker capability for one source module family.
-*/
-interface CheckerConfig {
-  /**
-  * Built-in checker preset, such as `tsc`, `tsgo`, `vue-tsc`, `vue-tsgo`, or `svelte-check`.
-  */
-  preset: CheckerPreset;
-  /**
-  * Checker entry project used by both build and typecheck execution modes.
-  */
-  entry: string;
-}
-interface ResolvedCheckerConfig {
-  entry: string;
-  extensions: string[];
-  name: string;
-  preset: CheckerPreset;
-}
-/**
-* Explicit exception for a declared workspace package dependency that is used
-* through generated code, runtime strings, or another path that Knip
-* dependency analysis cannot see.
-*/
-interface SourceUnusedDependencyIgnoreEntry {
-  /**
-  * Importing package name from package.json.
-  */
-  importer: string;
-  /**
-  * Declared workspace dependency package name.
-  */
-  dependency: string;
-  /**
-  * Why the dependency is safe to keep even when Knip cannot prove it is
-  * reachable from package entries, binaries, or scripts.
-  */
-  reason: string;
-}
-/**
-* Source dependency usage settings.
-*/
-interface SourceUnusedDependenciesConfig {
-  /**
-  * Declared workspace dependencies intentionally not visible through Knip's
-  * entry-reachable dependency graph.
-  */
-  ignore?: SourceUnusedDependencyIgnoreEntry[];
-}
-/**
-* Explicit exception for a source module that is owned by a package but is
-* intentionally not reachable from Knip's package entry graph.
-*/
-interface SourceUnusedModuleIgnoreEntry {
-  /**
-  * Named package owner from package.json.
-  */
-  owner: string;
-  /**
-  * Workspace-root-relative source module path.
-  */
-  file: string;
-  /**
-  * Why the source module is safe to keep even when Knip cannot prove it is
-  * reachable from package entries, binaries, or scripts.
-  */
-  reason: string;
-}
-/**
-* Additional source module entries for Knip's strict-mode reachability graph.
-*/
-interface SourceUnusedModuleEntryConfig {
-  /**
-  * Named package owner from package.json.
-  */
-  owner: string;
-  /**
-  * Workspace-root-relative file or glob patterns that Knip should treat as
-  * additional entries for this owner.
-  */
-  files: string[];
-  /**
-  * Why these modules are legitimate entries even though they are not package
-  * exports, binaries, scripts, or plugin-discovered entries.
-  */
-  reason: string;
-}
-/**
-* Source module usage settings.
-*/
-interface SourceUnusedModulesConfig {
-  /**
-  * Additional entry globs for source modules loaded by test runners or local
-  * tooling rather than package exports.
-  */
-  entries?: SourceUnusedModuleEntryConfig[];
-  /**
-  * Package-owned source modules intentionally not visible through Knip's
-  * entry-reachable file graph.
-  */
-  ignore?: SourceUnusedModuleIgnoreEntry[];
-}
-/**
-* Source-owned dependency usage check settings.
-*/
-interface SourceCheckConfig {
-  /**
-  * Checks that workspace package dependencies declared in package.json are
-  * reachable from package entries, binaries, or scripts owned by that package.
-  */
-  unusedDependencies?: SourceUnusedDependenciesConfig;
-  /**
-  * Strict-mode exceptions for package-owned source modules that are not
-  * reachable from package entries, binaries, or scripts owned by that package.
-  *
-  * There is no enabled switch: strict: true enables unused module checks.
-  */
-  unusedModules?: SourceUnusedModulesConfig;
-}
-/**
-* Global source boundary used by proof checks.
-*/
-interface SourceBoundaryConfig {
-  /**
-  * Glob patterns for source files that Limina should govern.
-  *
-  * When omitted, Limina derives the source boundary from configured checker
-  * extensions and then applies `exclude`.
-  */
-  include?: string[];
-  /**
-  * Glob patterns or directory shorthands to omit from source governance.
-  *
-  * @default: [
-  *   "node_modules",
-  *   "dist",
-  *   ".git",
-  *   ".tsbuild",
-  *   "coverage",
-  *   "**\/tsconfig*.json",
-  *   "**\/package.json",
-  *   "**\/project.json",
-  *   ".prettierrc.json",
-  *   ".markdownlint.json",
-  *   "vercel.json",
-  * ]
-  */
-  exclude?: string[];
-}
-/**
-* Shared project facts used by graph, paths, proof, and related checks.
-*/
-interface SharedLiminaConfig {
-  /**
-  * Checker capabilities shared by graph, proof, paths, and tsc tasks.
-  */
-  checkers?: Record<string, CheckerConfig>;
-  /**
-  * Global source file boundary used by proof checks.
-  */
-  source?: SourceBoundaryConfig;
-}
-/**
-* Options for generated TypeScript `paths` compatibility files.
-*/
-interface PathsConfig {
-  /**
-  * Directory names treated as build artifacts when mapping package exports
-  * back to source files.
-  */
-  artifactDirectories?: string[];
-  /**
-  * Export condition priority when resolving package exports.
-  *
-  * Put more specific conditions earlier when your package exports use several
-  * entries such as `types`, `import`, `node`, or `default`.
-  */
-  conditionPriority?: string[];
-  /**
-  * File name used for generated path mapping configs.
-  *
-  * @default "tsconfig.dts.paths.generated.json"
-  */
-  generatedFileName?: string;
-  /**
-  * Header marker written into generated files.
-  *
-  * Limina uses this to know which files it is allowed to refresh.
-  */
-  generatedFileMarker?: string;
-  /**
-  * Source extensions tried when replacing artifact exports with source files.
-  */
-  sourceExtensions?: string[];
-}
-/**
-* Declaration leaf boundary denied to projects with a matching Limina label.
-*/
-interface GraphRuleRefDenyEntry {
-  /**
-  * Target `tsconfig*.dts.json` path, relative to the inferred workspace root.
-  */
-  path: string;
-  /**
-  * Human-readable explanation shown when the rule fails.
-  */
-  reason: string;
-}
-/**
-* Declaration leaf boundary explicitly allowed for projects with a matching
-* Limina graph rule when static import analysis cannot prove the edge.
-*/
-interface GraphRuleRefAllowEntry {
-  /**
-  * Target `tsconfig*.dts.json` path, relative to the inferred workspace root.
-  */
-  path: string;
-  /**
-  * Human-readable explanation documenting why this extra reference is safe.
-  */
-  reason: string;
-}
-/**
-* Dependency denied to projects with a matching Limina label.
-*/
-interface GraphRuleDepDenyEntry {
-  /**
-  * Target package root, package.json imports specifier, or Node builtin name.
-  *
-  * Examples: `@acme/internal`, `zod`, `#internal/*`, `fs`, `node:fs`,
-  * or `node:*`.
-  */
-  name: string;
-  /**
-  * Human-readable explanation shown when the rule fails.
-  */
-  reason: string;
-}
-/**
-* Deny lists for a Limina graph label.
-*/
-interface GraphRuleDenyConfig {
-  /**
-  * Declaration leaf boundaries that matching projects must not reference or import.
-  */
-  refs?: GraphRuleRefDenyEntry[];
-  /**
-  * Packages, package imports, and Node builtins that matching projects must
-  * not reference or import.
-  */
-  deps?: GraphRuleDepDenyEntry[];
-}
-/**
-* Allow lists for a Limina graph label.
-*/
-interface GraphRuleAllowConfig {
-  /**
-  * Extra declaration leaf boundaries that matching projects may keep even
-  * when static import analysis cannot prove them.
-  */
-  refs?: GraphRuleRefAllowEntry[];
-}
-/**
-* Package-level graph governance rule keyed by a label declared in
-* `tsconfig*.dts.json`.
-*/
-interface GraphRule {
-  /**
-  * Allowed graph boundaries that static analysis cannot prove.
-  */
-  allow?: GraphRuleAllowConfig;
-  /**
-  * Denied graph boundaries and workspace package dependencies.
-  */
-  deny?: GraphRuleDenyConfig;
-}
-/**
-* TypeScript project graph policy.
-*/
-interface GraphConfig {
-  /**
-  * Label-based package and build-boundary access rules.
-  *
-  * A `tsconfig*.dts.json` can opt into one or more rules by declaring
-  * `liminaOptions.graphRules`.
-  */
-  rules?: Record<string, GraphRule>;
-}
-/**
-* Explicit exception for a source file that is intentionally not covered by the
-* normal proof rules.
-*/
-interface ProofAllowlistEntry {
-  /**
-  * File path to allow, relative to the inferred workspace root.
-  */
-  file: string;
-  /**
-  * Why this file is safe to exclude from normal proof coverage.
-  */
-  reason: string;
-}
-/**
-* Typecheck coverage proof settings.
-*/
-interface ProofConfig {
-  /**
-  * Intentional file-level exceptions.
-  */
-  allowlist?: ProofAllowlistEntry[];
-}
-/**
-* Package check tools that can run against a built package output.
-*/
-type PackageCheckTool = "attw" | "boundary" | "publint";
-/**
-* CLI package check tool selection.
-*/
-type PackageCheckToolSelection = PackageCheckTool | "all";
-/**
-* Are The Types Wrong profile used for package type resolution checks.
-*/
-type PackageAttwProfile = "esm-only" | "node16" | "strict";
-/**
-* publint package check settings.
-*/
-interface PackagePublintCheckConfig {
-  /**
-  * Whether publint should run in strict mode.
-  *
-  * @default true
-  */
-  strict?: boolean;
-}
-/**
-* Are The Types Wrong package check settings.
-*/
-interface PackageAttwCheckConfig {
-  /**
-  * Problem profile to enforce.
-  *
-  * `esm-only` ignores CJS resolution failures for pure ESM packages.
-  *
-  * @default "esm-only"
-  */
-  profile?: PackageAttwProfile;
-}
-/**
-* Built package import boundary settings.
-*/
-interface PackageBoundaryCheckConfig {
-  /**
-  * Runtime environment for each emitted file.
-  *
-  * Use a string when the whole package has one environment, or a function when
-  * different files have different environments.
-  */
-  environment?: RuntimeEnvironment | ((relativeFilePath: string) => RuntimeEnvironment);
-  /**
-  * External package imports that are intentionally allowed even when they are
-  * not listed in the built package manifest.
-  */
-  ignoredExternalPackages?: string[];
-}
-/**
-* One published package output entry.
-*/
-interface PackageEntry {
-  /**
-  * Package name used by CLI filters, reports, and cwd release matching.
-  */
-  name: string;
-  /**
-  * Built package directory to scan, relative to the inferred workspace root.
-  */
-  outDir: string;
-  /**
-  * Package check tools enabled for this entry.
-  *
-  * @default ["publint", "attw", "boundary"]
-  */
-  checks?: PackageCheckTool[];
-  /**
-  * publint settings for this package output.
-  */
-  publint?: PackagePublintCheckConfig;
-  /**
-  * Are The Types Wrong settings for this package output.
-  */
-  attw?: PackageAttwCheckConfig;
-  /**
-  * Built package import boundary settings.
-  */
-  boundary?: PackageBoundaryCheckConfig;
-}
-/**
-* Published package settings.
-*/
-interface PackageConfig {
-  /**
-  * Built package outputs to check.
-  */
-  entries?: PackageEntry[];
-}
-interface ReleaseContentHashConfigArgs {
-  /**
-  * Package currently being release-checked.
-  */
-  importerName: string;
-  /**
-  * Workspace dependency package being compared against npm.
-  */
-  dependencyName: string;
-}
-/**
-* Release dependency artifact content hash settings.
-*/
-interface ReleaseContentHashConfig {
-  /**
-  * npm dist-tag used as the online baseline for dependency package output.
-  *
-  * @default "latest"
-  */
-  baselineTag?: string | ((args: ReleaseContentHashConfigArgs) => string);
-  /**
-  * Use Limina's built-in dependency artifact ignore set as a fallback when
-  * `ignore` is omitted or returns `undefined`.
-  *
-  * @default false
-  */
-  builtinIgnore?: boolean;
-  /**
-  * Additional package-relative glob patterns ignored by dependency artifact
-  * content hashes.
-  */
-  ignore?: string[] | ((args: ReleaseContentHashConfigArgs) => string[] | undefined);
-}
-/**
-* Release check settings.
-*/
-interface ReleaseConfig {
-  /**
-  * Dependency artifact content hash comparison settings.
-  */
-  contentHash?: ReleaseContentHashConfig;
-}
-/**
-* Limina user config.
-*/
-interface LiminaConfig {
-  /**
-  * Enable strict workspace modeling rules.
-  *
-  * Strict mode keeps the existing command surface but makes graph, proof,
-  * source, package, and release checks enforce the complete Limina workspace
-  * model.
-  *
-  * @default false
-  */
-  strict?: boolean;
-  /**
-  * Shared project facts, such as checker entries and source boundary.
-  */
-  config?: SharedLiminaConfig;
-  /**
-  * TypeScript project graph and architecture rules.
-  */
-  graph?: GraphConfig;
-  /**
-  * Rules for checking built package outputs before publishing.
-  */
-  package?: PackageConfig;
-  /**
-  * Options for generating TypeScript source `paths` compatibility files.
-  */
-  paths?: PathsConfig;
-  /**
-  * Named command pipelines runnable through `limina check <name>`.
-  */
-  pipelines?: Record<string, PipelineStep[]>;
-  /**
-  * Rules that prove source files are covered by graph or checker entries.
-  */
-  proof?: ProofConfig;
-  /**
-  * Rules for release dependency artifact comparisons.
-  */
-  release?: ReleaseConfig;
-  /**
-  * Rules for source-owned dependency usage checks.
-  */
-  source?: SourceCheckConfig;
-}
-/**
-* CLI command currently loading the config.
-*/
-type LiminaCommand = "check" | "graph" | "nx" | "package" | "paths" | "proof" | "release" | "source" | (string & {});
-/**
-* Environment passed to function-style configs.
-*/
-interface LiminaConfigEnv {
-  /**
-  * CLI command family, such as `check`, `graph`, or `paths`.
-  */
-  command: LiminaCommand;
-  /**
-  * Mode passed through `--mode`.
-  *
-  * Defaults to `process.env.NODE_ENV`, then `default`.
-  */
-  mode: string;
-}
-type LiminaConfigFnObject = (env: LiminaConfigEnv) => LiminaConfig;
-type LiminaConfigFnPromise = (env: LiminaConfigEnv) => Promise<LiminaConfig>;
-type LiminaConfigFn = (env: LiminaConfigEnv) => LiminaConfig | Promise<LiminaConfig>;
-type LiminaConfigExport = LiminaConfig | Promise<LiminaConfig> | LiminaConfigFnObject | LiminaConfigFnPromise | LiminaConfigFn;
-interface ResolvedLiminaConfig extends LiminaConfig {
-  /**
-  * Absolute path to the loaded config file.
-  */
-  configPath: string;
-  /**
-  * Absolute workspace root inferred from `cwd` and its parent directories.
-  */
-  rootDir: string;
-}
-/**
-* Type helper for limina.config.mjs.
-*
-* Accepts a direct config object, a Promise, or a function that receives the
-* current {@link LiminaConfigEnv}.
-*/
-declare function defineConfig(config: LiminaConfig): LiminaConfig;
-declare function defineConfig(config: Promise<LiminaConfig>): Promise<LiminaConfig>;
-declare function defineConfig(config: LiminaConfigFnObject): LiminaConfigFnObject;
-declare function defineConfig(config: LiminaConfigFnPromise): LiminaConfigFnPromise;
-declare function defineConfig(config: LiminaConfigFn): LiminaConfigFn;
-declare function validateLiminaConfig(config: LiminaConfig): void;
-declare function isStrictConfig(config: Pick<LiminaConfig, "strict">): boolean;
-declare function getActiveCheckers(config: LiminaConfig): ResolvedCheckerConfig[];
-declare function getActiveCheckerExtensions(config: LiminaConfig): string[];
-interface LoadConfigOptions {
-  /**
-  * Command family to expose to function-style configs.
-  */
-  command?: LiminaCommand;
-  /**
-  * Config file path, resolved from `cwd`. When omitted, Limina searches for
-  * the nearest `limina.config.mjs` from `cwd` upward to the inferred pnpm
-  * workspace root.
-  *
-  * @default nearest "limina.config.mjs" in `cwd` or workspace parents
-  */
-  configPath?: string;
-  /**
-  * Directory used to resolve `configPath`.
-  *
-  * @default process.cwd()
-  */
-  cwd?: string;
-  /**
-  * Mode exposed to function-style configs.
-  *
-  * @default process.env.NODE_ENV ?? "default"
-  */
-  mode?: string;
-}
-declare function loadConfig(options?: LoadConfigOptions): Promise<ResolvedLiminaConfig>;
-//#endregion
-export { BuiltinCheckerPreset, BuiltinTaskName, CheckerConfig, CheckerExecutionKind, CheckerPreset, GraphConfig, GraphRule, GraphRuleAllowConfig, GraphRuleDenyConfig, GraphRuleDepDenyEntry, GraphRuleRefAllowEntry, GraphRuleRefDenyEntry, LiminaCommand, LiminaConfig, LiminaConfigEnv, LiminaConfigExport, LiminaConfigFn, LiminaConfigFnObject, LiminaConfigFnPromise, LoadConfigOptions, PackageAttwCheckConfig, PackageAttwProfile, PackageBoundaryCheckConfig, PackageCheckTool, PackageCheckToolSelection, PackageConfig, PackageEntry, PackagePublintCheckConfig, PathsConfig, PipelineStep, ProofAllowlistEntry, ProofConfig, ReleaseConfig, ReleaseContentHashConfig, ReleaseContentHashConfigArgs, ResolvedCheckerConfig, ResolvedLiminaConfig, RuntimeEnvironment, SharedLiminaConfig, SourceBoundaryConfig, SourceCheckConfig, SourceUnusedDependenciesConfig, SourceUnusedDependencyIgnoreEntry, SourceUnusedModuleEntryConfig, SourceUnusedModuleIgnoreEntry, SourceUnusedModulesConfig, defineConfig, getActiveCheckerExtensions, getActiveCheckers, isStrictConfig, loadConfig, validateLiminaConfig };

package/config.js

@@ -1,4 +0,0 @@
-import "./chunks/dep-lkQg1P9Q.js";
-import { a as loadConfig, i as isStrictConfig, n as getActiveCheckerExtensions, o as validateLiminaConfig, r as getActiveCheckers, t as defineConfig } from "./chunks/dep-CBKvJc4Y.js";
-
-export { defineConfig, getActiveCheckerExtensions, getActiveCheckers, isStrictConfig, loadConfig, validateLiminaConfig };