@crustjs/core 0.3.0 → 0.3.2

package/dist/index.js

@@ -1,4 +1,5 @@
-import { C as normalizeFlag, S as normalizeArg, _ as defineExtension, a as runInvocation, b as definingOf, d as resolveArtifactDir, f as cloneCommandNode, g as registerFlag, h as createCommandNode, i as resolveTypedPath, m as validateCommandSections, n as executeInvocation, o as snapshotCommand, p as installExtensionContexts, r as prepareInvocation, v as contextSources, w as CrustError, x as validateContextAvailability, y as defineContext } from "./invocation-CIvHShiW.js";
+import { S as CrustError, _ as defineContext, a as runInvocation, b as normalizeArg, d as installExtensionContexts, f as validateCommandSections, g as contextSources, h as defineExtension, i as resolveTypedPath, m as registerFlag, n as executeInvocation, o as snapshotCommand, p as createCommandNode, r as prepareInvocation, u as cloneCommandNode, v as definingOf, x as normalizeFlag, y as validateContextAvailability } from "./invocation-B17RvTLb.js";
+import { resolveArtifactDir } from "@crustjs/utils/artifacts";
 //#region src/identity.ts
 /** Mint an Extension identity from any non-blank, trimmed string. */
 function defineExtensionId(id) {

package/dist/{invocation-CIvHShiW.js → invocation-B17RvTLb.js}

@@ -1,12 +1,12 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, join, posix, resolve, win32 } from "node:path";
-import { existsSync, realpathSync, statSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { AsyncLocalStorage } from "node:async_hooks";
-import { Writable } from "node:stream";
+import { BUILD_OUT_DIR_ENV } from "@crustjs/utils/artifacts";
+import { withAmbientTerminalIO } from "@crustjs/utils/terminal";
 import { parseArgs } from "node:util";
 import { isPromise } from "node:util/types";
+import { coerceBooleanString, tryCoerceNumber } from "@crustjs/utils/primitive";
 import { homedir } from "node:os";
+import { normalizeStandardIssues } from "@crustjs/utils/schema";
 //#region src/errors.ts
 /**
 * A typed error for runtime recipe, Extension, Context, documentation, argv, and validation failures.
@@ -614,156 +614,6 @@ function installExtensionContexts(node, extensions, reRegisteredIds) {
 	return cloned;
 }
 //#endregion
-//#region ../utils/src/source.ts
-/**
-* Find the nearest directory containing `package.json` by walking up the
-* filesystem from `startPath`.
-*
-* If `startPath` points at an existing file, its parent directory is used as
-* the starting point. The directory walk uses `path.resolve()` (lexical), not
-* `fs.realpath()`, so a symlink's parent chain is walked rather than the
-* symlink target's parent chain.
-*
-* @param startPath - Directory or file path to start walking from.
-* @returns The absolute path of the nearest enclosing directory containing
-*   `package.json`, or `null` if the filesystem root is reached first.
-*
-* @internal Shared by {@link resolveSourceDir} and `resolveArtifactDir`.
-*/
-function findNearestPackageRoot(startPath) {
-	let current = resolve(startPath);
-	if (existsSync(current) && !statSync(current).isDirectory()) current = dirname(current);
-	while (true) {
-		if (existsSync(join(current, "package.json"))) return current;
-		const parent = dirname(current);
-		if (parent === current) return null;
-		current = parent;
-	}
-}
-//#endregion
-//#region ../utils/src/artifacts.ts
-/**
-* Set by `crust build` while it prepares the Command Snapshot: the absolute
-* entry-isolated directory Extension build hooks write into. Core reads it
-* to run the hooks; `resolveArtifactDir` reads it so sections evaluated during
-* that run see the artifacts being built instead of the wiped `.crust/root`.
-*/
-const BUILD_OUT_DIR_ENV = "CRUST_INTERNAL_BUILD_OUT_DIR";
-/** True inside a `bun build --compile` or `deno compile` executable. */
-function isCompiledExecutable() {
-	const { Bun, Deno } = globalThis;
-	const bunMain = Bun?.main ?? "";
-	return bunMain.startsWith("/$bunfs/") || /^[A-Za-z]:[\\/]~BUN[\\/]/.test(bunMain) || Deno?.build?.standalone === true;
-}
-/**
-* Absolute path of a build artifact or `crust.include` directory shipped with
-* this CLI. `name` is a top-level directory name such as `"skills"`.
-*
-* The artifact path is computed from how the CLI is running — never probed:
-* - Compiled executable (Bun or Deno): `<dir of the executable>/<name>`, which
-*   is a platform package's `bin/` or wherever the binary was placed.
-* - Crust-built Node bundle: `<name>` next to the bundle's `bin/` directory,
-*   i.e. `.crust/root/<name>` in place and `<installed root>/<name>` after install.
-* - Snapshot preparation inside `crust build`: `<build output dir>/<name>`, the
-*   artifacts earlier Extension build hooks wrote in this same build.
-* - Source (`bun run`, `node`, `deno run`): `.crust/root/<name>` under the
-*   nearest package root of the real `process.argv[1]` entrypoint (following source
-*   links) — the output of the last `crust build`.
-*
-* @throws {Error} when `name` is not a single path segment, or in source mode
-*   when the entrypoint cannot be resolved or has no enclosing `package.json`.
-*/
-function resolveArtifactDir(name) {
-	if (name === "" || name === "." || name === ".." || /[\\/]/.test(name)) throw new Error(`Artifact name must be a single directory name, got ${JSON.stringify(name)}.`);
-	if (isCompiledExecutable()) return join(dirname(process.execPath), name);
-	if (process.env.CRUST_INTERNAL_BUILD === "1") return resolve(fileURLToPath(import.meta.url), "..", "..", name);
-	const buildOutDir = process.env[BUILD_OUT_DIR_ENV];
-	if (buildOutDir) return join(buildOutDir, name);
-	const entrypoint = process.argv[1];
-	let sourceEntrypoint = entrypoint;
-	if (entrypoint) try {
-		sourceEntrypoint = realpathSync(entrypoint);
-	} catch (cause) {
-		throw new Error(`Could not resolve artifact "${name}": could not resolve source entrypoint "${entrypoint}".`, { cause });
-	}
-	const packageRoot = sourceEntrypoint ? findNearestPackageRoot(sourceEntrypoint) : null;
-	if (!packageRoot) throw new Error(`Could not resolve artifact "${name}": no package.json was found above ${entrypoint ? `entrypoint "${entrypoint}"` : "process.argv[1] (unset)"}.`);
-	return join(packageRoot, ".crust", "root", name);
-}
-//#endregion
-//#region ../utils/src/terminal.ts
-const STORAGE_KEY = Symbol.for("crustjs.terminal.io");
-const AMBIENT_CALLBACKS_KEY = Symbol.for("crustjs.terminal.ambient-callbacks");
-const globalWithStorage = globalThis;
-const globalWithAmbientCallbacks = globalThis;
-/** Bundled copies in Core, Prompts, and Progress share process-wide terminal state. */
-const storage = globalWithStorage[STORAGE_KEY] ??= new AsyncLocalStorage();
-const ambientCallbacks = globalWithAmbientCallbacks[AMBIENT_CALLBACKS_KEY] ??= /* @__PURE__ */ new WeakMap();
-/** Run a function with terminal streams available in its async scope. */
-function withTerminalIO(io, fn) {
-	const current = storage.getStore();
-	return storage.run({
-		input: io.input ?? current?.input,
-		output: io.output ?? current?.output
-	}, fn);
-}
-function lineBufferedOutput(io) {
-	let pending = "";
-	const output = new Writable({
-		decodeStrings: false,
-		write(chunk, _encoding, callback) {
-			pending += chunk.toString();
-			let newline = pending.indexOf("\n");
-			while (newline !== -1) {
-				io.stderr(pending.slice(0, newline));
-				pending = pending.slice(newline + 1);
-				newline = pending.indexOf("\n");
-			}
-			callback();
-		}
-	});
-	ambientCallbacks.set(output, io);
-	return output;
-}
-/** Run a function with Core's line-oriented output bridged into the terminal stream scope. */
-function withAmbientTerminalIO(io, fn) {
-	const current = storage.getStore();
-	return withTerminalIO({
-		input: current?.input,
-		output: current?.output && !ambientCallbacks.has(current.output) ? current.output : lineBufferedOutput(io)
-	}, fn);
-}
-//#endregion
-//#region ../utils/src/primitive.ts
-/**
-* Attempts to coerce a string to a number, returning `undefined` only when the
-* result is `NaN`. Callers decide whether `undefined` means throw or fallback.
-*
-* @example
-* ```ts
-* tryCoerceNumber("42"); // 42
-* tryCoerceNumber("abc"); // undefined
-* tryCoerceNumber(""); // 0
-* ```
-*/
-function tryCoerceNumber(raw) {
-	const num = Number(raw);
-	return Number.isNaN(num) ? void 0 : num;
-}
-/**
-* Coerces Crust boolean strings using the existing strict truthy spellings.
-*
-* @example
-* ```ts
-* coerceBooleanString("true"); // true
-* coerceBooleanString("1"); // true
-* coerceBooleanString("false"); // false
-* ```
-*/
-function coerceBooleanString(raw) {
-	return raw === "true" || raw === "1";
-}
-//#endregion
 //#region src/parsing/coercers.ts
 /**
 * Coerce a raw argv string into a {@link URL} instance via the WHATWG
@@ -1203,67 +1053,6 @@ function validateParsed(command, parsed) {
 	validateRequiredFlags(flagsDef, flags);
 }
 //#endregion
-//#region ../utils/src/schema.ts
-/**
-* Format an issue path into a dot-path string.
-*
-* - Numeric keys (array indexes) are rendered with bracket notation: `items[0]`
-* - String/symbol keys are joined with dots: `flags.verbose`
-* - An empty path array produces an empty string (root-level issue)
-*
-* @example
-* ```ts
-* formatPath(["flags", "verbose"]);
-* // => "flags.verbose"
-*
-* formatPath(["args", 0]);
-* // => "args[0]"
-*
-* formatPath([]);
-* // => ""
-* ```
-*/
-function isNumericPathSegment(segment) {
-	return typeof segment === "number";
-}
-function formatPath(path) {
-	return path.map((segment, index) => isNumericPathSegment(segment) ? `[${segment}]` : index > 0 ? `.${String(segment)}` : String(segment)).join("");
-}
-/**
-* Normalize a Standard Schema issue path to an array of `PropertyKey`.
-*
-* Standard Schema paths contain either bare `PropertyKey` values or
-* `{ key: PropertyKey }` segment objects; both forms are flattened to
-* plain `PropertyKey`. Returns an empty array for a root-level issue
-* (`undefined`).
-*/
-function isStandardPathSegment(segment) {
-	return typeof segment === "object" && segment !== null && "key" in segment;
-}
-function normalizeStandardPath(path) {
-	if (!path) return [];
-	return path.map((segment) => isStandardPathSegment(segment) ? segment.key : segment);
-}
-/**
-* Normalize Standard Schema issues into canonical `ValidationIssue` objects.
-*
-* Applies an optional prefix (e.g. `["flags", "verbose"]`) to each issue
-* path, then formats each path to its canonical dot-path string.
-*
-* @param issues — Raw Standard Schema issues from a failed validation
-* @param prefix — Optional path segments prepended to each issue path
-*/
-function normalizeStandardIssues(issues, prefix = []) {
-	return issues.map((issue) => {
-		const resolvedPath = normalizeStandardPath(issue.path);
-		const fullPath = [...prefix, ...resolvedPath];
-		return {
-			message: issue.message,
-			path: formatPath(fullPath)
-		};
-	});
-}
-//#endregion
 //#region src/parsing/schema.ts
 async function runSchema(schema, raw, path, issues) {
 	const result = await schema["~standard"].validate(raw);
@@ -1976,4 +1765,4 @@ async function executeInvocation(node, options, materializeCommandDefinition) {
 	return await (hasInjectedIO(options?.io) ? withAmbientTerminalIO(io, invoke) : invoke());
 }
 //#endregion
-export { normalizeFlag as C, normalizeArg as S, defineExtension as _, runInvocation as a, definingOf as b, sectionsFor as c, resolveArtifactDir as d, cloneCommandNode as f, registerFlag as g, createCommandNode as h, resolveTypedPath as i, visibleSectionsFor as l, validateCommandSections as m, executeInvocation as n, snapshotCommand as o, installExtensionContexts as p, prepareInvocation as r, isListed as s, SNAPSHOT_PATH_ENV as t, BUILD_OUT_DIR_ENV as u, contextSources as v, CrustError as w, validateContextAvailability as x, defineContext as y };
+export { CrustError as S, defineContext as _, runInvocation as a, normalizeArg as b, sectionsFor as c, installExtensionContexts as d, validateCommandSections as f, contextSources as g, defineExtension as h, resolveTypedPath as i, visibleSectionsFor as l, registerFlag as m, executeInvocation as n, snapshotCommand as o, createCommandNode as p, prepareInvocation as r, isListed as s, SNAPSHOT_PATH_ENV as t, cloneCommandNode as u, definingOf as v, normalizeFlag as x, validateContextAvailability as y };

package/dist/tooling.d.ts

@@ -1,4 +1,5 @@
-import { A as FlagSnapshot, G as ExtensionId, c as DeclaredDefault, k as CommandSnapshot, o as CommandSection, t as BUILD_OUT_DIR_ENV } from "./artifacts-D8Jlug-a.js";
+import { Ct as FlagSnapshot, St as CommandSnapshot, g as DeclaredDefault, kt as ExtensionId, m as CommandSection } from "./context-Cud9frNp.js";
+import { BUILD_OUT_DIR_ENV } from "@crustjs/utils/artifacts";
 //#region src/command/invocation.d.ts
 /**
  * Snapshot subprocess protocol used by first-party build tooling.

package/dist/tooling.js

@@ -1,4 +1,5 @@
-import { c as sectionsFor, l as visibleSectionsFor, s as isListed, t as SNAPSHOT_PATH_ENV, u as BUILD_OUT_DIR_ENV } from "./invocation-CIvHShiW.js";
+import { c as sectionsFor, l as visibleSectionsFor, s as isListed, t as SNAPSHOT_PATH_ENV } from "./invocation-B17RvTLb.js";
+import { BUILD_OUT_DIR_ENV } from "@crustjs/utils/artifacts";
 //#region src/command/documentation.ts
 function isNonFiniteNumber(value) {
 	return typeof value === "number" && !Number.isFinite(value);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@crustjs/core",
-	"version": "0.3.0",
+	"version": "0.3.2",
 	"description": "Core library for the Crust CLI framework",
 	"type": "module",
 	"sideEffects": false,
@@ -48,9 +48,11 @@
 		"prepack": "cp ../../LICENSE LICENSE",
 		"postpack": "rm -f LICENSE"
 	},
+	"dependencies": {
+		"@crustjs/utils": "^0.1.0"
+	},
 	"devDependencies": {
 		"@crustjs/config": "0.0.0",
-		"@crustjs/utils": "0.0.0",
 		"tsdown": "^0.23.0"
 	},
 	"peerDependencies": {