limina 0.0.5 → 0.1.1

package/README.md

@@ -1,30 +1,36 @@
 # limina
 
 <p align="center">
-  <a href="https://docs.senao.me/docs-islands/limina" target="_blank" rel="noopener noreferrer">
+  <a href="https://docs.senao.me/docs-islands/limina/" target="_blank" rel="noopener noreferrer">
     <img width="180" src="https://docs.senao.me/docs-islands/limina/logo.svg" alt="limina logo">
   </a>
 </p>
+
 <p align="center">
   <a href="https://npmjs.com/package/limina"><img src="https://img.shields.io/npm/v/limina.svg" alt="npm package"></a>
   <a href="https://nodejs.org/en/about/previous-releases"><img src="https://img.shields.io/node/v/limina.svg" alt="node compatibility"></a>
-  <a href="https://github.com/XiSenao/docs-islands/actions/workflows/ci.yml"><img src="https://github.com/XiSenao/docs-islands/actions/workflows/ci.yml/badge.svg?branch=main" alt="build status"></a>
-  <a href="https://github.com/XiSenao/docs-islands/blob/main/packages/limina/LICENSE.md"><img src="https://img.shields.io/npm/l/limina.svg" alt="license"></a>
+  <a href="https://github.com/senaoxi/docs-islands/blob/main/packages/limina/LICENSE.md"><img src="https://img.shields.io/npm/l/limina.svg" alt="license"></a>
 </p>
 
 English | [简体中文](./README.zh-CN.md)
 
-> Architecture governance CLI for TypeScript monorepos
+> Architecture governance for TypeScript monorepos.
+
+Start with incremental type builds, then progressively enable architecture governance.
+
+Limina is designed for large TypeScript monorepos where project references, source boundaries, check coverage, and release artifacts can drift over time. It builds on existing TypeScript configuration and source dependency relationships to generate reusable type-build configuration, then adds checks for dependency graphs, source boundaries, coverage, and release readiness.
+
+## What Limina does
 
-- Keep source dependency graphs aligned with type build graphs
-- Guard package, runtime, and workspace boundaries
-- Cover TypeScript and framework-specific checkers
-- Manage compatibility paths for workspace source dependencies
-- Validate package outputs before release
-- Compose checks for local development, CI, and publishing
+- Adopts incremental type builds by generating reusable build configuration and deriving a build order from source dependencies.
+- Governs the dependency graph by checking project references, access boundaries, and dependency declarations.
+- Protects source boundaries by detecting cross-package relative imports, unauthorized imports, missing dependency declarations, and source ownership issues.
+- Verifies check coverage by finding source files that are uncovered, covered more than once, or covered by a scope that does not match the source boundary.
+- Composes check pipelines for local development, CI, and release workflows, with independent tasks running concurrently when dependencies allow.
+- Adds release checks for package metadata, type entry points, build output, and packed package contents.
 
-Limina helps teams turn drifting TypeScript monorepo constraints into explicit, reviewable, runnable checks. It keeps source relationships, type coverage, build coordination, package metadata, and publishable outputs aligned across everyday development, code review, and pre-release workflows.
+## Non-goals
 
-Limina is not a bundler, test runner, or release tool, and it does not replace TypeScript or framework checkers. It runs those existing tools and verifies that the monorepo structure they rely on is still trustworthy.
+Limina is not a bundler, a test framework, or a publishing tool. It does not replace TypeScript or framework-specific checkers. Instead, it runs alongside existing tools and verifies that the monorepo structure they depend on remains consistent and reviewable.
 
 [Read the Docs to Learn More](https://docs.senao.me/docs-islands/limina/)

package/README.zh-CN.md

@@ -5,26 +5,32 @@
     <img width="180" src="https://docs.senao.me/docs-islands/limina/logo.svg" alt="limina logo">
   </a>
 </p>
+
 <p align="center">
   <a href="https://npmjs.com/package/limina"><img src="https://img.shields.io/npm/v/limina.svg" alt="npm package"></a>
   <a href="https://nodejs.org/en/about/previous-releases"><img src="https://img.shields.io/node/v/limina.svg" alt="node compatibility"></a>
-  <a href="https://github.com/XiSenao/docs-islands/actions/workflows/ci.yml"><img src="https://github.com/XiSenao/docs-islands/actions/workflows/ci.yml/badge.svg?branch=main" alt="build status"></a>
-  <a href="https://github.com/XiSenao/docs-islands/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/limina.svg" alt="license"></a>
+  <a href="https://github.com/senaoxi/docs-islands/blob/main/packages/limina/LICENSE.md"><img src="https://img.shields.io/npm/l/limina.svg" alt="license"></a>
 </p>
 
 [English](./README.md) | 简体中文
 
-> TypeScript monorepo 的架构治理 CLI
+> TypeScript 单体仓库架构治理工具。
+
+先接入增量构建，再逐步打开架构治理。
+
+Limina 面向大型 TypeScript monorepo，帮助团队把容易漂移的工程约束变成显式、可审查、可运行的检查。它基于现有 TypeScript 配置和源码依赖关系生成可复用的类型构建配置，并逐步覆盖依赖图、源码边界、检查覆盖和发布前校验。
+
+## 能力概览
 
-- 保持源码依赖图与类型构建图一致
-- 守住 package、运行时与工程边界
-- 覆盖 TypeScript 与框架专属 checker
-- 管理 workspace 源码依赖的兼容路径
-- 验证发布前 package 产物
-- 组合适合本地、CI 与发布流程的检查
+- 接入增量类型构建，生成可复用的构建配置并安排合理的构建顺序。
+- 治理项目依赖图，检查项目引用、访问边界和依赖声明是否一致。
+- 保护源码边界，发现跨包相对导入、未授权导入、漏写依赖和源码归属问题。
+- 确认检查覆盖，找出未覆盖、重复覆盖或检查范围不一致的源码文件。
+- 编排检查流程，将构建、依赖图、源码边界和检查覆盖组合进本地开发、CI 或发布流程。
+- 补充发布前检查，验证 package metadata、类型入口、发布产物和打包内容。
 
-Limina 帮助团队把 TypeScript monorepo 中容易漂移的工程约束变成显式、可审查、可运行的检查。它让源码关系、类型覆盖、构建协作、package metadata 和发布产物保持一致，适合放进日常开发、代码审查和发布前流程。
+## Limina 不是什么
 
-Limina 不是 bundler、测试框架或发布工具，也不会替代 TypeScript / framework checker。它调用这些已有工具，并验证它们依赖的 monorepo 结构是否仍然可靠。
+Limina 不是 bundler、测试框架或发布工具，也不会替代 TypeScript 或框架专属 checker。它调用已有工具，并验证这些工具依赖的 monorepo 结构是否仍然可靠。
 
 [阅读文档了解更多](https://docs.senao.me/docs-islands/limina/zh/)

package/bin/limina.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { spawnSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
+import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import path from 'pathe';
 
 const packageDir = path.resolve(fileURLToPath(new URL('..', import.meta.url)));
 const distCliPath = path.join(packageDir, 'cli.js');
@@ -30,7 +30,8 @@ if (existsSync(sourceCliPath)) {
 
   process.exit(result.status ?? 1);
 } else if (existsSync(distCliPath)) {
-  await import(pathToFileURL(distCliPath).href);
+  const { runCli } = await import(pathToFileURL(distCliPath).href);
+  await runCli(process.argv);
 } else {
   throw new Error(`Unable to find limina CLI entry. Expected ${distCliPath}.`);
 }

package/chunks/dep-BPK-6PAr.js

@@ -0,0 +1,114 @@
+import { createRequire } from "node:module";
+
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) {
+		__defProp(target, name, {
+			get: all[name],
+			enumerable: true
+		});
+	}
+	if (!no_symbols) {
+		__defProp(target, Symbol.toStringTag, { value: "Module" });
+	}
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+//#region ../../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.js
+var require_picocolors = /* @__PURE__ */ __commonJSMin(((exports, module) => {
+	let p = process || {}, argv = p.argv || [], env = p.env || {};
+	let isColorSupported = !(!!env.NO_COLOR || argv.includes("--no-color")) && (!!env.FORCE_COLOR || argv.includes("--color") || p.platform === "win32" || (p.stdout || {}).isTTY && env.TERM !== "dumb" || !!env.CI);
+	let formatter = (open, close, replace = open) => (input) => {
+		let string = "" + input, index = string.indexOf(close, open.length);
+		return ~index ? open + replaceClose(string, close, replace, index) + close : open + string + close;
+	};
+	let replaceClose = (string, close, replace, index) => {
+		let result = "", cursor = 0;
+		do {
+			result += string.substring(cursor, index) + replace;
+			cursor = index + close.length;
+			index = string.indexOf(close, cursor);
+		} while (~index);
+		return result + string.substring(cursor);
+	};
+	let createColors = (enabled = isColorSupported) => {
+		let f = enabled ? formatter : () => String;
+		return {
+			isColorSupported: enabled,
+			reset: f("\x1B[0m", "\x1B[0m"),
+			bold: f("\x1B[1m", "\x1B[22m", "\x1B[22m\x1B[1m"),
+			dim: f("\x1B[2m", "\x1B[22m", "\x1B[22m\x1B[2m"),
+			italic: f("\x1B[3m", "\x1B[23m"),
+			underline: f("\x1B[4m", "\x1B[24m"),
+			inverse: f("\x1B[7m", "\x1B[27m"),
+			hidden: f("\x1B[8m", "\x1B[28m"),
+			strikethrough: f("\x1B[9m", "\x1B[29m"),
+			black: f("\x1B[30m", "\x1B[39m"),
+			red: f("\x1B[31m", "\x1B[39m"),
+			green: f("\x1B[32m", "\x1B[39m"),
+			yellow: f("\x1B[33m", "\x1B[39m"),
+			blue: f("\x1B[34m", "\x1B[39m"),
+			magenta: f("\x1B[35m", "\x1B[39m"),
+			cyan: f("\x1B[36m", "\x1B[39m"),
+			white: f("\x1B[37m", "\x1B[39m"),
+			gray: f("\x1B[90m", "\x1B[39m"),
+			bgBlack: f("\x1B[40m", "\x1B[49m"),
+			bgRed: f("\x1B[41m", "\x1B[49m"),
+			bgGreen: f("\x1B[42m", "\x1B[49m"),
+			bgYellow: f("\x1B[43m", "\x1B[49m"),
+			bgBlue: f("\x1B[44m", "\x1B[49m"),
+			bgMagenta: f("\x1B[45m", "\x1B[49m"),
+			bgCyan: f("\x1B[46m", "\x1B[49m"),
+			bgWhite: f("\x1B[47m", "\x1B[49m"),
+			blackBright: f("\x1B[90m", "\x1B[39m"),
+			redBright: f("\x1B[91m", "\x1B[39m"),
+			greenBright: f("\x1B[92m", "\x1B[39m"),
+			yellowBright: f("\x1B[93m", "\x1B[39m"),
+			blueBright: f("\x1B[94m", "\x1B[39m"),
+			magentaBright: f("\x1B[95m", "\x1B[39m"),
+			cyanBright: f("\x1B[96m", "\x1B[39m"),
+			whiteBright: f("\x1B[97m", "\x1B[39m"),
+			bgBlackBright: f("\x1B[100m", "\x1B[49m"),
+			bgRedBright: f("\x1B[101m", "\x1B[49m"),
+			bgGreenBright: f("\x1B[102m", "\x1B[49m"),
+			bgYellowBright: f("\x1B[103m", "\x1B[49m"),
+			bgBlueBright: f("\x1B[104m", "\x1B[49m"),
+			bgMagentaBright: f("\x1B[105m", "\x1B[49m"),
+			bgCyanBright: f("\x1B[106m", "\x1B[49m"),
+			bgWhiteBright: f("\x1B[107m", "\x1B[49m")
+		};
+	};
+	module.exports = createColors();
+	module.exports.createColors = createColors;
+}));
+
+//#endregion
+export { __toESM as a, __require as i, __commonJSMin as n, __exportAll as r, require_picocolors as t };