@uapkg/cli 1.4.0 → 1.5.0

package/dist/{postinstall → types/uapkg/postinstall}/loader/EsbuildTranspiler.d.ts

@@ -1,4 +1,4 @@
-import { Result } from "@uapkg/diagnostics";
+import { Result } from "../../../uapkg-diagnostics/index.js";
 //#region src/postinstall/loader/EsbuildTranspiler.d.ts
 /**
  * Transpiles a single `.ts` postinstall entry into an in-memory ESM bundle.
@@ -18,4 +18,3 @@ declare class EsbuildTranspiler {
 }
 //#endregion
 export { EsbuildTranspiler };
-//# sourceMappingURL=EsbuildTranspiler.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/loader/ExportValidator.d.ts

@@ -1,5 +1,5 @@
 import { PostinstallDefinition } from "../api/PostinstallDsl.js";
-import { Result } from "@uapkg/diagnostics";
+import { Result } from "../../../uapkg-diagnostics/index.js";
 //#region src/postinstall/loader/ExportValidator.d.ts
 /**
  * Normalizes an imported module to its default export (or the module object
@@ -15,4 +15,3 @@ declare class ExportValidator {
 }
 //#endregion
 export { ExportValidator };
-//# sourceMappingURL=ExportValidator.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/loader/ModuleImporter.d.ts

@@ -1,4 +1,4 @@
-import { Result } from "@uapkg/diagnostics";
+import { Result } from "../../../uapkg-diagnostics/index.js";
 //#region src/postinstall/loader/ModuleImporter.d.ts
 type ModuleSource = {
   readonly kind: 'file';
@@ -29,4 +29,3 @@ declare class ModuleImporter {
 }
 //#endregion
 export { ModuleImporter, ModuleSource };
-//# sourceMappingURL=ModuleImporter.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/loader/PostinstallLoader.d.ts

@@ -3,7 +3,7 @@ import { EntryResolver } from "./EntryResolver.js";
 import { EsbuildTranspiler } from "./EsbuildTranspiler.js";
 import { ExportValidator } from "./ExportValidator.js";
 import { ModuleImporter } from "./ModuleImporter.js";
-import { Result } from "@uapkg/diagnostics";
+import { Result } from "../../../uapkg-diagnostics/index.js";
 //#region src/postinstall/loader/PostinstallLoader.d.ts
 interface LoadedPostinstall {
   readonly packageName: string;
@@ -32,4 +32,3 @@ declare class PostinstallLoader {
 }
 //#endregion
 export { LoadedPostinstall, PostinstallLoader };
-//# sourceMappingURL=PostinstallLoader.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/markers/MarkerBlockEditor.d.ts

@@ -1,6 +1,6 @@
 import { MarkerBlockService } from "./MarkerBlockService.js";
 import { MarkerIntegrityValidator } from "./MarkerIntegrityValidator.js";
-import { Result } from "@uapkg/diagnostics";
+import { Result } from "../../../uapkg-diagnostics/index.js";
 //#region src/postinstall/markers/MarkerBlockEditor.d.ts
 /**
  * Higher-level idempotent wrapper around {@link MarkerBlockService}.
@@ -30,4 +30,3 @@ declare class MarkerBlockEditor {
 }
 //#endregion
 export { MarkerBlockEditor };
-//# sourceMappingURL=MarkerBlockEditor.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/markers/MarkerBlockService.d.ts

@@ -24,4 +24,3 @@ declare class MarkerBlockService {
 }
 //#endregion
 export { MarkerBlockService };
-//# sourceMappingURL=MarkerBlockService.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/markers/MarkerIntegrityValidator.d.ts

@@ -29,4 +29,3 @@ declare class MarkerIntegrityValidator {
 }
 //#endregion
 export { MarkerIntegrityFail, MarkerIntegrityOk, MarkerIntegrityResult, MarkerIntegrityValidator };
-//# sourceMappingURL=MarkerIntegrityValidator.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/policy/PostinstallPolicyGate.d.ts

@@ -1,5 +1,5 @@
-import { ConfigInstance, PostInstallPolicyResolver, PostInstallPolicyValue, ResolvedConfig } from "@uapkg/config";
-import { PostinstallPolicyDeniedDiagnostic } from "@uapkg/diagnostics";
+import { ConfigInstance, PostInstallPolicyResolver, PostInstallPolicyValue, ResolvedConfig } from "../../../uapkg-config/index.js";
+import { PostinstallPolicyDeniedDiagnostic } from "../../../uapkg-diagnostics/index.js";
 //#region src/postinstall/policy/PostinstallPolicyGate.d.ts
 /** Minimal config reader surface; defaults to the singleton `@uapkg/config`. */
 interface PolicyConfigReader {
@@ -35,4 +35,3 @@ declare class PostinstallPolicyGate {
 }
 //#endregion
 export { type ConfigInstance, PolicyConfigReader, PolicyDecision, PostinstallPolicyGate };
-//# sourceMappingURL=PostinstallPolicyGate.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/runner/PostinstallOrchestrator.d.ts

@@ -6,7 +6,7 @@ import { TargetCsInjector } from "../unreal/TargetCsInjector.js";
 import { UnrealSourceCatalogBuilder } from "../unreal/UnrealSourceCatalog.js";
 import { UProjectInjector } from "../unreal/UProjectInjector.js";
 import { UProjectMetadataReader } from "../unreal/UProjectMetadataReader.js";
-import { Result } from "@uapkg/diagnostics";
+import { Result } from "../../../uapkg-diagnostics/index.js";
 //#region src/postinstall/runner/PostinstallOrchestrator.d.ts
 /**
  * Projection of an installer action that the orchestrator needs. The CLI
@@ -71,4 +71,3 @@ declare class PostinstallOrchestrator {
 }
 //#endregion
 export { PostinstallCandidate, PostinstallOrchestrator, PostinstallOrchestratorInput, PostinstallReport };
-//# sourceMappingURL=PostinstallOrchestrator.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/BuildCsInjector.d.ts

@@ -3,7 +3,7 @@ import { MarkerBlockEditor } from "../markers/MarkerBlockEditor.js";
 import { CSharpInjectionEngine } from "./CSharpInjectionEngine.js";
 import { CSharpStructureAnalyzer } from "./CSharpStructureAnalyzer.js";
 import { CSharpWrapperFactory } from "./CSharpWrapperFactory.js";
-import { Result } from "@uapkg/diagnostics";
+import { Result } from "../../../uapkg-diagnostics/index.js";
 //#region src/postinstall/unreal/BuildCsInjector.d.ts
 /**
  * Injects a plugin's `setupModules` content into a single `*.Build.cs` file.
@@ -23,4 +23,3 @@ declare class BuildCsInjector {
 }
 //#endregion
 export { BuildCsInjector };
-//# sourceMappingURL=BuildCsInjector.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/CSharpInjectionEngine.d.ts

@@ -22,4 +22,3 @@ declare class CSharpInjectionEngine {
 }
 //#endregion
 export { CSharpInjectionEngine };
-//# sourceMappingURL=CSharpInjectionEngine.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/CSharpStructureAnalyzer.d.ts

@@ -22,4 +22,3 @@ declare class CSharpStructureAnalyzer {
 }
 //#endregion
 export { CSharpStructureAnalyzer };
-//# sourceMappingURL=CSharpStructureAnalyzer.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/CSharpStructures.d.ts

@@ -19,4 +19,3 @@ interface ParsedCSharpFile {
 }
 //#endregion
 export { CSharpFileKind, ParsedCSharpFile, ParsedClass, ParsedConstructor };
-//# sourceMappingURL=CSharpStructures.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/CSharpWrapperFactory.d.ts

@@ -26,4 +26,3 @@ declare class CSharpWrapperFactory {
 }
 //#endregion
 export { CSharpWrapperFactory, WrapperContextType };
-//# sourceMappingURL=CSharpWrapperFactory.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/PluginHash.d.ts

@@ -8,4 +8,3 @@ declare function getPluginHash(pluginName: string): string;
 declare function getWrapperClassName(pluginName: string): string;
 //#endregion
 export { getPluginHash, getWrapperClassName };
-//# sourceMappingURL=PluginHash.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/PrettyParseError.d.ts

@@ -15,4 +15,3 @@ declare class PrettyParseError extends Error {
 }
 //#endregion
 export { PrettyParseError };
-//# sourceMappingURL=PrettyParseError.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/ProjectFileLocator.d.ts

@@ -20,4 +20,3 @@ declare class ProjectFileLocator {
 }
 //#endregion
 export { ProjectFileLocator };
-//# sourceMappingURL=ProjectFileLocator.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/TargetCsInjector.d.ts

@@ -3,7 +3,7 @@ import { MarkerBlockEditor } from "../markers/MarkerBlockEditor.js";
 import { CSharpInjectionEngine } from "./CSharpInjectionEngine.js";
 import { CSharpStructureAnalyzer } from "./CSharpStructureAnalyzer.js";
 import { CSharpWrapperFactory } from "./CSharpWrapperFactory.js";
-import { Result } from "@uapkg/diagnostics";
+import { Result } from "../../../uapkg-diagnostics/index.js";
 //#region src/postinstall/unreal/TargetCsInjector.d.ts
 /**
  * Injects a plugin's `setupTargets` content into a single `*.Target.cs` file.
@@ -23,4 +23,3 @@ declare class TargetCsInjector {
 }
 //#endregion
 export { TargetCsInjector };
-//# sourceMappingURL=TargetCsInjector.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/UProjectInjector.d.ts

@@ -1,4 +1,4 @@
-import { Result } from "@uapkg/diagnostics";
+import { Result } from "../../../uapkg-diagnostics/index.js";
 //#region src/postinstall/unreal/UProjectInjector.d.ts
 /**
  * Enables the given plugin names in the host project's `.uproject` file,
@@ -12,4 +12,3 @@ declare class UProjectInjector {
 }
 //#endregion
 export { UProjectInjector };
-//# sourceMappingURL=UProjectInjector.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/UProjectMetadataReader.d.ts

@@ -9,4 +9,3 @@ declare class UProjectMetadataReader {
 }
 //#endregion
 export { UProjectMetadataReader };
-//# sourceMappingURL=UProjectMetadataReader.d.ts.map

package/dist/{postinstall → types/uapkg/postinstall}/unreal/UnrealSourceCatalog.d.ts

@@ -23,4 +23,3 @@ declare class UnrealSourceCatalogBuilder {
 }
 //#endregion
 export { SourceCatalog, UnrealSourceCatalogBuilder };
-//# sourceMappingURL=UnrealSourceCatalog.d.ts.map

package/dist/{prompts → types/uapkg/prompts}/InkPromptService.d.ts

@@ -9,4 +9,3 @@ declare class InkPromptService implements PromptService {
 }
 //#endregion
 export { InkPromptService };
-//# sourceMappingURL=InkPromptService.d.ts.map

package/dist/{prompts → types/uapkg/prompts}/ProjectContextDetector.d.ts

@@ -1,4 +1,4 @@
-import { ManifestKind } from "@uapkg/package-manifest-schema";
+import { ManifestKind } from "../../uapkg-package-manifest-schema/index.js";
 //#region src/prompts/ProjectContextDetector.d.ts
 interface ProjectContextDetection {
   suggestedKind: ManifestKind;
@@ -10,4 +10,3 @@ declare class ProjectContextDetector {
 }
 //#endregion
 export { ProjectContextDetection, ProjectContextDetector };
-//# sourceMappingURL=ProjectContextDetector.d.ts.map

package/dist/{prompts → types/uapkg/prompts}/PromptService.d.ts

@@ -11,4 +11,3 @@ interface PromptService {
 }
 //#endregion
 export { PromptService, SelectOption };
-//# sourceMappingURL=PromptService.d.ts.map

package/dist/{reporting → types/uapkg/reporting}/DiagnosticDeduplicator.d.ts

@@ -1,4 +1,4 @@
-import { Diagnostic } from "@uapkg/diagnostics";
+import { Diagnostic } from "../../uapkg-diagnostics/index.js";
 //#region src/reporting/DiagnosticDeduplicator.d.ts
 /**
  * Suppresses diagnostics marked as `emitPolicy: "once"` across the current
@@ -11,4 +11,3 @@ declare class DiagnosticDeduplicator {
 }
 //#endregion
 export { DiagnosticDeduplicator };
-//# sourceMappingURL=DiagnosticDeduplicator.d.ts.map

package/dist/{reporting → types/uapkg/reporting}/DiagnosticRenderer.d.ts

@@ -1,4 +1,4 @@
-import { Diagnostic } from "@uapkg/diagnostics";
+import { Diagnostic } from "../../uapkg-diagnostics/index.js";
 //#region src/reporting/DiagnosticRenderer.d.ts
 /**
  * Strategy for turning a batch of diagnostics at a single severity stream
@@ -18,4 +18,3 @@ interface DiagnosticRenderer {
 }
 //#endregion
 export { DiagnosticRenderer };
-//# sourceMappingURL=DiagnosticRenderer.d.ts.map

package/dist/{reporting → types/uapkg/reporting}/DiagnosticReporter.d.ts

@@ -1,6 +1,6 @@
 import { DiagnosticDeduplicator } from "./DiagnosticDeduplicator.js";
 import { DiagnosticRenderer } from "./DiagnosticRenderer.js";
-import { Diagnostic } from "@uapkg/diagnostics";
+import { Diagnostic } from "../../uapkg-diagnostics/index.js";
 //#region src/reporting/DiagnosticReporter.d.ts
 /**
  * Human-readable diagnostic reporter.
@@ -23,4 +23,3 @@ declare class DiagnosticReporter {
 }
 //#endregion
 export { DiagnosticReporter };
-//# sourceMappingURL=DiagnosticReporter.d.ts.map

package/dist/{reporting → types/uapkg/reporting}/InkDiagnosticRenderer.d.ts

@@ -1,7 +1,7 @@
 import { DiagnosticRenderer } from "./DiagnosticRenderer.js";
 import { TextSink } from "./TextSink.js";
-import { Diagnostic } from "@uapkg/diagnostics";
-import { DiagnosticInkRegistry } from "@uapkg/diagnostics-format/ink";
+import { Diagnostic } from "../../uapkg-diagnostics/index.js";
+import { DiagnosticInkRegistry } from "../../uapkg-diagnostics-format/ink/index.js";
 //#region src/reporting/InkDiagnosticRenderer.d.ts
 /**
  * Ink-backed diagnostic renderer.
@@ -21,4 +21,3 @@ declare class InkDiagnosticRenderer implements DiagnosticRenderer {
 }
 //#endregion
 export { InkDiagnosticRenderer };
-//# sourceMappingURL=InkDiagnosticRenderer.d.ts.map

package/dist/{reporting → types/uapkg/reporting}/InstallProgressReporter.d.ts

@@ -1,5 +1,5 @@
 import { TextSink } from "./TextSink.js";
-import { DownloadStatusSnapshot } from "@uapkg/installer";
+import { DownloadStatusSnapshot } from "../../uapkg-installer/index.js";
 //#region src/reporting/InstallProgressReporter.d.ts
 /**
  * Text-mode progress reporter for `uapkg install / add / update`.
@@ -34,4 +34,3 @@ declare class InstallProgressReporter {
 }
 //#endregion
 export { InstallProgressReporter };
-//# sourceMappingURL=InstallProgressReporter.d.ts.map

package/dist/{reporting → types/uapkg/reporting}/JsonReporter.d.ts

@@ -1,5 +1,5 @@
 import { TextSink } from "./TextSink.js";
-import { Diagnostic } from "@uapkg/diagnostics";
+import { Diagnostic } from "../../uapkg-diagnostics/index.js";
 //#region src/reporting/JsonReporter.d.ts
 /**
  * Stable JSON envelope used when any command is invoked with `--json`.
@@ -28,4 +28,3 @@ declare class JsonReporter {
 }
 //#endregion
 export { JsonEnvelope, JsonReporter };
-//# sourceMappingURL=JsonReporter.d.ts.map

package/dist/{reporting → types/uapkg/reporting}/RegistryRequestTerminalFormatter.d.ts

@@ -33,4 +33,3 @@ declare function isRegistryRequestTerminalStatus(status: RegistryRequestStatus):
 declare function isRegistryRequestSuccessStatus(status: RegistryRequestStatus): boolean;
 //#endregion
 export { RegistryRequestPresentation, RegistryRequestTerminalFormatOptions, RegistryRequestTerminalOutput, formatRegistryRequestTerminal, isRegistryRequestSuccessStatus, isRegistryRequestTerminalStatus };
-//# sourceMappingURL=RegistryRequestTerminalFormatter.d.ts.map

package/dist/{reporting → types/uapkg/reporting}/TextDiagnosticRenderer.d.ts

@@ -1,6 +1,6 @@
 import { DiagnosticRenderer } from "./DiagnosticRenderer.js";
 import { TextSink } from "./TextSink.js";
-import { Diagnostic } from "@uapkg/diagnostics";
+import { Diagnostic } from "../../uapkg-diagnostics/index.js";
 //#region src/reporting/TextDiagnosticRenderer.d.ts
 /**
  * Plain-text diagnostic renderer — used by tests and by any non-TTY path
@@ -20,4 +20,3 @@ declare class TextDiagnosticRenderer implements DiagnosticRenderer {
 }
 //#endregion
 export { TextDiagnosticRenderer };
-//# sourceMappingURL=TextDiagnosticRenderer.d.ts.map

package/dist/{reporting → types/uapkg/reporting}/TextSink.d.ts

@@ -1,4 +1,4 @@
-import { Diagnostic } from "@uapkg/diagnostics";
+import { Diagnostic } from "../../uapkg-diagnostics/index.js";
 //#region src/reporting/TextSink.d.ts
 /**
  * Minimal stdout writer abstraction so reporters can be driven by tests.
@@ -21,4 +21,3 @@ declare const DIAGNOSTIC_LEVEL_ORDER: Readonly<Record<Diagnostic['level'], numbe
 declare function sortDiagnostics(diagnostics: readonly Diagnostic[]): Diagnostic[];
 //#endregion
 export { DIAGNOSTIC_LEVEL_ORDER, ProcessTextSink, TextSink, sortDiagnostics };
-//# sourceMappingURL=TextSink.d.ts.map

package/dist/types/uapkg-common/format/prettyBytes.d.ts

@@ -0,0 +1,19 @@
+//#region src/format/prettyBytes.d.ts
+/**
+ * Human-friendly byte formatting matching the uapkg CLI convention.
+ *
+ * - Less than 100 MB → render as MB with 1 decimal place (e.g. `85.3 MB`).
+ * - 100 MB or greater → render as GB with 1 decimal place (e.g. `2.0 GB`).
+ * - Negative or non-finite values are clamped to 0.
+ *
+ * Uses SI units (1 MB = 1_000_000 bytes). This is deliberate: user-facing
+ * package sizes are reported by registries in decimal units.
+ */
+declare function prettyBytes(bytes: number): string;
+/**
+ * Render a progress pair like `"12.3 MB/85.0 MB"`. Both numbers use the same
+ * unit chosen by the larger of the two, so the ratio stays readable.
+ */
+declare function prettyBytesProgress(done: number, total: number): string;
+//#endregion
+export { prettyBytes, prettyBytesProgress };

package/dist/types/uapkg-common/hash/registryIdentifier.d.ts

@@ -0,0 +1,28 @@
+//#region src/hash/registryIdentifier.d.ts
+/**
+ * Descriptor shape for a registry identity (mirrors `registries.<name>` from config).
+ */
+interface RegistryIdentityDescriptor {
+  url: string;
+  ref: {
+    type: string;
+    value: string;
+  };
+}
+/**
+ * Compute the full `RegistryIdentifier` (64-char hex SHA-256) from a
+ * `registries.<name>` config object.
+ *
+ * Steps:
+ *   1. Normalize the Git repository identity.
+ *   2. Trim the ref value while preserving its case.
+ *   3. Deep-sort keys via stable JSON serialization.
+ *   4. SHA-256 the resulting string.
+ */
+declare function computeRegistryIdentifier(descriptor: RegistryIdentityDescriptor): string;
+/**
+ * Compute the short identifier (first 16 hex chars / 64 bits).
+ */
+declare function computeRegistryIdentifierShort(descriptor: RegistryIdentityDescriptor): string;
+//#endregion
+export { RegistryIdentityDescriptor, computeRegistryIdentifier, computeRegistryIdentifierShort };

package/dist/types/uapkg-common/hash/sha256.d.ts

@@ -0,0 +1,12 @@
+//#region src/hash/sha256.d.ts
+/**
+ * Compute a SHA-256 hex digest of the given input.
+ */
+declare function sha256(input: string | Buffer): string;
+/**
+ * Compute a SHA-256 hex digest prefixed with the algorithm identifier.
+ * Format: `sha256:<hex>`
+ */
+declare function sha256Prefixed(input: string | Buffer): string;
+//#endregion
+export { sha256, sha256Prefixed };

package/dist/types/uapkg-common/index.d.ts

@@ -0,0 +1,10 @@
+import { prettyBytes, prettyBytesProgress } from "./format/prettyBytes.js";
+import { RegistryIdentityDescriptor, computeRegistryIdentifier, computeRegistryIdentifierShort } from "./hash/registryIdentifier.js";
+import { sha256, sha256Prefixed } from "./hash/sha256.js";
+import { safeJsonParse } from "./json/safeJsonParse.js";
+import { stableStringify } from "./json/stableStringify.js";
+import { normalizeUrl } from "./normalize/normalizeUrl.js";
+import { normalizePath, toForwardSlash } from "./paths/forwardSlash.js";
+import { INTERNAL_BUILD_MODE_ENV, INTERNAL_PROFILE_HOME_ENV, UAPKGBuildMode, resolveActiveUapkgProfileRoot, resolveUapkgBuildMode, resolveUapkgProfileRoot } from "./runtime/UapkgRuntimeProfile.js";
+import { formatPackageSpec, parsePackageSpec } from "./spec/parsePackageSpec.js";
+export { INTERNAL_BUILD_MODE_ENV, INTERNAL_PROFILE_HOME_ENV, type RegistryIdentityDescriptor, type UAPKGBuildMode, computeRegistryIdentifier, computeRegistryIdentifierShort, formatPackageSpec, normalizePath, normalizeUrl, parsePackageSpec, prettyBytes, prettyBytesProgress, resolveActiveUapkgProfileRoot, resolveUapkgBuildMode, resolveUapkgProfileRoot, safeJsonParse, sha256, sha256Prefixed, stableStringify, toForwardSlash };

package/dist/types/uapkg-common/json/safeJsonParse.d.ts

@@ -0,0 +1,9 @@
+import { Result } from "../../uapkg-diagnostics/index.js";
+//#region src/json/safeJsonParse.d.ts
+/**
+ * Parse a JSON string without throwing.
+ * Returns a `Result<T>` with a `PARSE_ERROR` diagnostic on failure.
+ */
+declare function safeJsonParse<T = unknown>(raw: string, filePath?: string): Result<T>;
+//#endregion
+export { safeJsonParse };

package/dist/types/uapkg-common/json/stableStringify.d.ts

@@ -0,0 +1,9 @@
+//#region src/json/stableStringify.d.ts
+/**
+ * Deterministic JSON serialization with sorted keys (deep).
+ *
+ * Equivalent to `json-stable-stringify` but zero-dependency.
+ */
+declare function stableStringify(value: unknown): string;
+//#endregion
+export { stableStringify };

package/dist/types/uapkg-common/normalize/normalizeUrl.d.ts

@@ -0,0 +1,11 @@
+//#region src/normalize/normalizeUrl.d.ts
+/**
+ * Normalize a registry URL for identity hashing.
+ *
+ * GitHub repository coordinates are normalized across HTTPS, SSH URL, and
+ * SCP-like syntax. Generic URL paths retain their case because not every Git
+ * host treats paths as case-insensitive.
+ */
+declare function normalizeUrl(url: string): string;
+//#endregion
+export { normalizeUrl };

package/dist/types/uapkg-common/paths/forwardSlash.d.ts

@@ -0,0 +1,12 @@
+//#region src/paths/forwardSlash.d.ts
+/**
+ * Normalize a file path to use forward slashes on all platforms.
+ */
+declare function toForwardSlash(filePath: string): string;
+/**
+ * Remove `.` and `..` segments and normalize separators.
+ * This is a pure string operation — it does **not** access the file system.
+ */
+declare function normalizePath(filePath: string): string;
+//#endregion
+export { normalizePath, toForwardSlash };

package/dist/types/uapkg-common/runtime/UapkgRuntimeProfile.d.ts

@@ -0,0 +1,19 @@
+//#region src/runtime/UapkgRuntimeProfile.d.ts
+type UAPKGBuildMode = 'development' | 'production';
+/** Build mode selected by the generated CLI launcher. */
+declare const INTERNAL_BUILD_MODE_ENV = "UAPKG_INTERNAL_BUILD_MODE";
+/**
+ * Global profile root selected by the generated CLI launcher.
+ *
+ * The environment variable name is retained for compatibility with existing
+ * launchers even though the directory now contains all global CLI state.
+ */
+declare const INTERNAL_PROFILE_HOME_ENV = "UAPKG_INTERNAL_CONFIG_CACHE_HOME";
+/** Resolve or normalize build mode, failing closed to production. */
+declare function resolveUapkgBuildMode(raw?: string | undefined): UAPKGBuildMode;
+/** Resolve the global profile root for an explicit build mode. */
+declare function resolveUapkgProfileRoot(mode: UAPKGBuildMode, homeDirectory?: string): string;
+/** Resolve the active global profile without creating it. */
+declare function resolveActiveUapkgProfileRoot(): string;
+//#endregion
+export { INTERNAL_BUILD_MODE_ENV, INTERNAL_PROFILE_HOME_ENV, UAPKGBuildMode, resolveActiveUapkgProfileRoot, resolveUapkgBuildMode, resolveUapkgProfileRoot };

package/dist/types/uapkg-common/spec/parsePackageSpec.d.ts

@@ -0,0 +1,21 @@
+import { Result } from "../../uapkg-diagnostics/index.js";
+import { PackageSpec } from "../../uapkg-common-schema/index.js";
+//#region src/spec/parsePackageSpec.d.ts
+/**
+ * Parse a CLI package specifier of the form:
+ *
+ *   (@<org>/)?<name>(@<range>)?
+ *
+ * Examples:
+ *   - "awesome-pkg"                     → { name }
+ *   - "awesome-pkg@^1.0.0"              → { name, range }
+ *   - "@myorg/awesome-pkg"              → { org, name }
+ *   - "@myorg/awesome-pkg@^1.0.0"       → { org, name, range }
+ *
+ * Never throws; returns a `Result<PackageSpec>` with typed diagnostics.
+ */
+declare function parsePackageSpec(input: string): Result<PackageSpec>;
+/** Inverse of `parsePackageSpec` — renders a `PackageSpec` back to its string form. */
+declare function formatPackageSpec(spec: PackageSpec): string;
+//#endregion
+export { formatPackageSpec, parsePackageSpec };

package/dist/types/uapkg-common-schema/brand/Brand.d.ts

@@ -0,0 +1,15 @@
+import { $brand } from "zod";
+//#region src/brand/Brand.d.ts
+/**
+ * Nominal (branded) type utility.
+ *
+ * Uses Zod's type-only brand so runtime schemas remain their native JSON
+ * Schema-compatible primitive type while structurally identical values stay
+ * incompatible at compile time.
+ *
+ * @example
+ * type PackageName = Brand<string, 'PackageName'>;
+ */
+type Brand<T, B extends string> = T & $brand<B>;
+//#endregion
+export { Brand };

package/dist/types/uapkg-common-schema/index.d.ts

@@ -0,0 +1,17 @@
+import { Brand } from "./brand/Brand.js";
+import { AssetHash, AssetHashSchema } from "./primitives/AssetHash.js";
+import { ConcurrencyCount, ConcurrencyCountSchema } from "./primitives/ConcurrencyCount.js";
+import { DurationSeconds, DurationSecondsSchema } from "./primitives/DurationSeconds.js";
+import { GitTree, GitTreeSchema } from "./primitives/GitTree.js";
+import { InstallPath, InstallPathSchema } from "./primitives/InstallPath.js";
+import { OrgName, OrgNameSchema } from "./primitives/OrgName.js";
+import { PackageName, PackageNameSchema, isScopedPackageName } from "./primitives/PackageName.js";
+import { PackageSpec, PackageSpecSchema } from "./primitives/PackageSpec.js";
+import { PackageVersion, PackageVersionSchema } from "./primitives/PackageVersion.js";
+import { POSTINSTALL_POLICY_DEFAULT, PostInstallPolicy, PostInstallPolicySchema } from "./primitives/PostInstallPolicy.js";
+import { RegistryIdentifier, RegistryIdentifierSchema, RegistryIdentifierShort, RegistryIdentifierShortSchema } from "./primitives/RegistryIdentifier.js";
+import { DEFAULT_REGISTRY_ALIAS, RegistryName, RegistryNameSchema } from "./primitives/RegistryName.js";
+import { RegistryURL, RegistryURLSchema } from "./primitives/RegistryURL.js";
+import { UnixTimestamp, UnixTimestampSchema } from "./primitives/UnixTimestamp.js";
+import { VersionRange, VersionRangeSchema } from "./primitives/VersionRange.js";
+export { type AssetHash, AssetHashSchema, type Brand, type ConcurrencyCount, ConcurrencyCountSchema, DEFAULT_REGISTRY_ALIAS, type DurationSeconds, DurationSecondsSchema, type GitTree, GitTreeSchema, type InstallPath, InstallPathSchema, type OrgName, OrgNameSchema, POSTINSTALL_POLICY_DEFAULT, type PackageName, PackageNameSchema, type PackageSpec, PackageSpecSchema, type PackageVersion, PackageVersionSchema, type PostInstallPolicy, PostInstallPolicySchema, type RegistryIdentifier, RegistryIdentifierSchema, type RegistryIdentifierShort, RegistryIdentifierShortSchema, type RegistryName, RegistryNameSchema, type RegistryURL, RegistryURLSchema, type UnixTimestamp, UnixTimestampSchema, type VersionRange, VersionRangeSchema, isScopedPackageName };

package/dist/types/uapkg-common-schema/primitives/AssetHash.d.ts

@@ -0,0 +1,11 @@
+import { Brand } from "../brand/Brand.js";
+import { z } from "zod";
+//#region src/primitives/AssetHash.d.ts
+/**
+ * Branded type for an asset integrity hash.
+ * Exactly `sha256:` followed by 64 lowercase hexadecimal characters.
+ */
+type AssetHash = Brand<string, 'AssetHash'>;
+declare const AssetHashSchema: z.core.$ZodBranded<z.ZodString, "AssetHash", "out">;
+//#endregion
+export { AssetHash, AssetHashSchema };

package/dist/types/uapkg-common-schema/primitives/ConcurrencyCount.d.ts

@@ -0,0 +1,11 @@
+import { Brand } from "../brand/Brand.js";
+import { z } from "zod";
+//#region src/primitives/ConcurrencyCount.d.ts
+/**
+ * Branded integer representing a concurrency count (e.g. parallel downloads).
+ * Must be a positive integer >= 1.
+ */
+type ConcurrencyCount = Brand<number, 'ConcurrencyCount'>;
+declare const ConcurrencyCountSchema: z.core.$ZodBranded<z.ZodNumber, "ConcurrencyCount", "out">;
+//#endregion
+export { ConcurrencyCount, ConcurrencyCountSchema };

package/dist/types/uapkg-common-schema/primitives/DurationSeconds.d.ts

@@ -0,0 +1,11 @@
+import { Brand } from "../brand/Brand.js";
+import { z } from "zod";
+//#region src/primitives/DurationSeconds.d.ts
+/**
+ * Branded integer representing a duration in seconds (non-negative).
+ * Used for network timeouts, retry delays, cache TTLs.
+ */
+type DurationSeconds = Brand<number, 'DurationSeconds'>;
+declare const DurationSecondsSchema: z.core.$ZodBranded<z.ZodNumber, "DurationSeconds", "out">;
+//#endregion
+export { DurationSeconds, DurationSecondsSchema };

package/dist/types/uapkg-common-schema/primitives/GitTree.d.ts

@@ -0,0 +1,10 @@
+import { Brand } from "../brand/Brand.js";
+import { z } from "zod";
+//#region src/primitives/GitTree.d.ts
+/**
+ * Branded type for a git tree SHA (40-char hex string).
+ */
+type GitTree = Brand<string, 'GitTree'>;
+declare const GitTreeSchema: z.core.$ZodBranded<z.ZodString, "GitTree", "out">;
+//#endregion
+export { GitTree, GitTreeSchema };

package/dist/types/uapkg-common-schema/primitives/InstallPath.d.ts

@@ -0,0 +1,18 @@
+import { Brand } from "../brand/Brand.js";
+import { z } from "zod";
+//#region src/primitives/InstallPath.d.ts
+/**
+ * Branded type for a package install path, relative to the uapkg manifest root.
+ *
+ * Rules:
+ *  - forward slashes only
+ *  - no leading slash (must be relative)
+ *  - no `..` segments (no escaping the manifest root)
+ *  - non-empty
+ *
+ * Example: `Plugins/AwesomeInventorySystem`
+ */
+type InstallPath = Brand<string, 'InstallPath'>;
+declare const InstallPathSchema: z.core.$ZodBranded<z.ZodString, "InstallPath", "out">;
+//#endregion
+export { InstallPath, InstallPathSchema };

package/dist/types/uapkg-common-schema/primitives/OrgName.d.ts

@@ -0,0 +1,12 @@
+import { Brand } from "../brand/Brand.js";
+import { z } from "zod";
+//#region src/primitives/OrgName.d.ts
+/**
+ * Branded type for a scoped-organization name (the `@org` in `@org/pkg`).
+ * Follows npm-style scope rules: lowercase alphanumerics, hyphens, underscores;
+ * must start with an alphanumeric.
+ */
+type OrgName = Brand<string, 'OrgName'>;
+declare const OrgNameSchema: z.core.$ZodBranded<z.ZodString, "OrgName", "out">;
+//#endregion
+export { OrgName, OrgNameSchema };