@codefast/cli 0.8.1 → 0.10.0

package/dist/tag/target-candidates.d.ts

@@ -0,0 +1,8 @@
+import type { FilesystemPort } from "#/core/filesystem/port";
+import type { TagTargetCandidate } from "#/tag/domain/types";
+/**
+ * Resolves the candidate targets for a tag run: the explicit target, or the discovered workspace packages.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function resolveTagTargetCandidates(fs: FilesystemPort, rootDir: string, explicitTarget: string | undefined): Promise<Array<TagTargetCandidate>>;

package/dist/tag/target-candidates.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { z } from "zod";
 import { listWorkspacePackageDirectories } from "#/core/workspace/resolver";
-const packageJsonFileName = "package.json";
+import { packageJsonFileName } from "#/core/workspace/well-known-files";
 const packageJsonNameSchema = z.looseObject({
     name: z.string().min(1).optional(),
 });

package/dist/tag/target-runner.d.ts

@@ -0,0 +1,8 @@
+import type { FilesystemPort } from "#/core/filesystem/port";
+import type { TagRunOptions, TagRunResult } from "#/tag/domain/types";
+/**
+ * Stamps `@since` tags across one target's TypeScript files and returns the run result.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function runTagOnTarget(fs: FilesystemPort, targetPath: string, opts: TagRunOptions): TagRunResult;

package/dist/tag/version-resolver.d.ts

@@ -0,0 +1,7 @@
+import type { FilesystemPort } from "#/core/filesystem/port";
+/**
+ * Returns the `version` of the nearest enclosing `package.json` above a target path.
+ *
+ * @since 0.3.16-canary.0
+ */
+export declare function resolveNearestPackageVersion(fs: FilesystemPort, targetPath: string): string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codefast/cli",
-  "version": "0.8.1",
-  "description": "Developer CLI for the Codefast monorepo (arrange, audit, mirror, tag)",
+  "version": "0.10.0",
+  "description": "Developer CLI for the Codefast monorepo (arrange, audit, mirror, pack-slim, tag)",
   "keywords": [
     "cli",
     "codefast",
@@ -15,7 +15,7 @@
     "url": "https://github.com/codefastlabs/codefast/issues"
   },
   "license": "MIT",
-  "author": "Vuong Phan <mr.thevuong@gmail.com>",
+  "author": "Vuong Phan <mr.thevuong@gmail.com> (https://github.com/thevuong)",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/codefastlabs/codefast.git",
@@ -26,23 +26,27 @@
   },
   "files": [
     "dist",
-    "LICENSE",
+    "CHANGELOG.md",
     "README.md",
-    "package.json"
+    "LICENSE"
   ],
   "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "imports": {
-    "#/tests/*": [
-      "./tests/*",
-      "./tests/*.ts",
-      "./tests/*.tsx",
-      "./tests/*/index.ts",
-      "./tests/*/index.tsx"
-    ],
     "#/*": {
+      "types": "./dist/*.d.ts",
       "default": "./dist/*.js"
     }
   },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "publishConfig": {
     "access": "public"
   },
@@ -55,28 +59,7 @@
     "yaml": "^2.9.0",
     "zod": "^4.5.4"
   },
-  "devDependencies": {
-    "@types/node": "^26.4.1",
-    "@types/picomatch": "^4.0.3",
-    "@vitest/coverage-v8": "^5.0.0",
-    "typescript": "^7.0.2",
-    "vite": "^8.2.2",
-    "vitest": "^5.0.0",
-    "@codefast/typescript-config": "0.9.0"
-  },
   "engines": {
     "node": ">=24.0.0"
-  },
-  "scripts": {
-    "build": "rm -rf dist && tsc -p tsconfig.build.json",
-    "check-types": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:e2e": "vitest run tests/e2e",
-    "test:integration": "vitest run tests/integration",
-    "test:type": "vitest run tests/types",
-    "test:unit": "vitest run tests/unit",
-    "test:watch": "vitest"
   }
 }

package/dist/audit/domain/react-imports.js

@@ -1,91 +0,0 @@
-import { parseSync } from "oxc-parser";
-function isOxcNode(value) {
-    return typeof value === "object" && value !== null && typeof value.type === "string";
-}
-function isIdentifierNamed(node, name) {
-    return isOxcNode(node) && node.type === "Identifier" && node.name === name;
-}
-/**
- * Scans one TypeScript source for React import-policy violations.
- *
- * @remarks Three violation kinds: `import * as React`, a default `React` import (type-only
- * included), and — only when no import binds `React` — an implicit `React.*` UMD-global type
- * reference, which tsc accepts silently through the `export as namespace React` in `@types/react`.
- *
- * @since 0.8.0
- */
-export function auditReactImportSource(filePath, sourceText) {
-    const { program } = parseSync(filePath, sourceText);
-    const statements = program.body;
-    const violations = [];
-    let bindsReact = false;
-    for (const statement of statements) {
-        if (statement.type !== "ImportDeclaration") {
-            continue;
-        }
-        const source = statement.source;
-        if (!isOxcNode(source) || source.value !== "react") {
-            continue;
-        }
-        const specifiers = Array.isArray(statement.specifiers) ? statement.specifiers.filter(isOxcNode) : [];
-        bindsReact ||= specifiers.some((specifier) => isIdentifierNamed(specifier.local, "React"));
-        for (const specifier of specifiers) {
-            if (specifier.type === "ImportNamespaceSpecifier") {
-                violations.push({
-                    line: lineOfOffset(sourceText, statement.start),
-                    raw: firstLineOf(sourceText.slice(statement.start, statement.end)),
-                    reason: 'namespace React import — import members by name from "react"',
-                });
-            }
-            else if (specifier.type === "ImportDefaultSpecifier") {
-                violations.push({
-                    line: lineOfOffset(sourceText, statement.start),
-                    raw: firstLineOf(sourceText.slice(statement.start, statement.end)),
-                    reason: 'default React import — import members by name from "react"',
-                });
-            }
-        }
-    }
-    // A bound `React` means the import itself is flagged above; qualified names under it are
-    // symptoms, not extra findings.
-    if (!bindsReact) {
-        collectUmdGlobalReferences(program, sourceText, violations);
-    }
-    violations.sort((a, b) => a.line - b.line);
-    return violations;
-}
-function collectUmdGlobalReferences(node, sourceText, violations) {
-    if (node.type === "TSQualifiedName" && isIdentifierNamed(node.left, "React")) {
-        violations.push({
-            line: lineOfOffset(sourceText, node.start),
-            raw: sourceText.slice(node.start, node.end),
-            reason: 'implicit React.* UMD global — add import type { … } from "react"',
-        });
-        return;
-    }
-    for (const value of Object.values(node)) {
-        if (Array.isArray(value)) {
-            for (const item of value) {
-                if (isOxcNode(item)) {
-                    collectUmdGlobalReferences(item, sourceText, violations);
-                }
-            }
-        }
-        else if (isOxcNode(value)) {
-            collectUmdGlobalReferences(value, sourceText, violations);
-        }
-    }
-}
-function lineOfOffset(sourceText, offset) {
-    let line = 1;
-    for (let index = 0; index < offset; index++) {
-        if (sourceText.charCodeAt(index) === 10) {
-            line++;
-        }
-    }
-    return line;
-}
-function firstLineOf(text) {
-    const newlineIndex = text.indexOf("\n");
-    return newlineIndex === -1 ? text : text.slice(0, newlineIndex);
-}