@decohere/forge 0.0.1-dev.13 → 0.0.1-dev.130

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/forge",
-  "version": "0.0.1-dev.13",
+  "version": "0.0.1-dev.130",
   "description": "TypeScript monorepo build system — zero config, fast compilation, streamlined developer workflow",
   "keywords": [
     "typescript",
@@ -10,6 +10,15 @@
     "swc",
     "decohere"
   ],
+  "homepage": "https://github.com/typesmiths/decohere/tree/main/projects/forge#readme",
+  "bugs": {
+    "url": "https://github.com/typesmiths/decohere/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/typesmiths/decohere.git",
+    "directory": "projects/forge"
+  },
   "license": "ISC",
   "author": "Typesmiths",
   "type": "module",
@@ -29,10 +38,11 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/crucible": "0.0.1-dev.13",
-    "@decohere/mesh": "0.0.1-dev.13",
-    "@decohere/nexus": "0.0.1-dev.13",
-    "@decohere/scribe": "0.0.1-dev.13",
+    "@decohere/core": "0.0.1-dev.130",
+    "@decohere/crucible": "0.0.1-dev.130",
+    "@decohere/devkit": "0.0.1-dev.130",
+    "@decohere/scribe": "0.0.1-dev.130",
+    "@decohere/workspace": "0.0.1-dev.130",
     "@swc/core": "^1.11.11",
     "async": "^3.2.6",
     "parse-imports": "^2.2.1",

package/types/src/actions/build.action.d.ts

@@ -1,11 +1,12 @@
-import type { Project } from "@decohere/mesh";
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import type { Project } from "@decohere/workspace";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 import { FileWriterService } from "../services/file-writer.service.js";
 import type { TransformResponse } from "../types/transform-response.model.js";
 import { type Transformer } from "../types/transformer.type.js";
 export type BuildOptions = {
+    build?: boolean;
     configuration: string;
     file: string;
 };

package/types/src/actions/clean.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type CleanOptions = {
     clean: boolean;
     configuration: string;

package/types/src/actions/commit.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type CommitFilesOptions = {
     configuration?: string;
     commit?: boolean;

package/types/src/actions/copy.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type CopyOptions = {
     copy: boolean;
     configuration: string;
@@ -10,5 +10,20 @@ export declare class Copy implements Action<CopyOptions> {
     private readonly workspace;
     constructor(workspace: Workspace);
     run: (options: CopyOptions) => Promise<ActionResponse>;
+    /**
+     * A package without a LICENSE of its own ships the workspace's, so a monorepo
+     * licensed once at the root still puts the license text in every tarball.
+     */
+    private copyWorkspaceLicense;
+    /**
+     * Packed builds emit JS under `<out>/<target>/` (e.g. `es6/`). Assets listed on
+     * the *configuration* `copyFiles` (not the workspace defaults) are also copied
+     * into each target so `import.meta.url` resolves them beside that JS.
+     *
+     * Workspace `copyFiles` (e.g. `package.json`) stay root-only — nesting a
+     * package manifest under `es6/` makes `npm install --install-links` drop the
+     * parent's `es6/` tree when packing `file:` deps.
+     */
+    private copyColocatedPackAssets;
     private copyFileToOut;
 }

package/types/src/actions/dependency-report.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 import { DependencyResolver } from "../services/dependency-resolver.service.js";
 import type { DependencyWarning, DriftEntry } from "../types/dependency.types.js";
 type ReportOptions = {

package/types/src/actions/dependency-sync.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 import { DependencyResolver } from "../services/dependency-resolver.service.js";
 import type { SyncprojectResult } from "../types/dependency.types.js";
 export type DependenciesOptions = {

package/types/src/actions/docker.action.d.ts

@@ -0,0 +1,38 @@
+import { Workspace } from "@decohere/workspace";
+import type { Action, ResultStatus } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+export type DockerOptions = {
+    configuration: string;
+    dryRun?: boolean;
+    push?: boolean;
+};
+export type DockerResponse = ResultStatus & {
+    projectName: string;
+    image: string;
+    tags: string[];
+    message: string;
+};
+export declare class Docker implements Action<DockerOptions> {
+    #private;
+    private readonly workspace;
+    private readonly docker;
+    constructor(workspace: Workspace);
+    run(options: DockerOptions): Promise<ActionResponse<DockerResponse>>;
+    private getDockerProjects;
+    /**
+     * A Dockerfile that copies `.package/` needs `forge package` to have run. Fail before the
+     * build with that instruction rather than with Docker's "not found" from deep in a layer.
+     */
+    private assertPackaged;
+    private buildProject;
+    private interpolateBuildArgs;
+    /**
+     * Keep FORGE_DOCKER_EXTRA_TAGS_JSON scoped to this image so multi-image
+     * publishes do not stamp create:latest onto the app Dev Container (and vice versa).
+     */
+    private extraTagsForImage;
+    private defaultImageName;
+    private normalizeDockerRepository;
+    private normalizeProjectSlug;
+    private parseJsonEnv;
+}

package/types/src/actions/index.d.ts

@@ -4,8 +4,14 @@ export * from "./commit.action.js";
 export * from "./copy.action.js";
 export * from "./dependency-report.action.js";
 export * from "./dependency-sync.action.js";
+export * from "./docker.action.js";
+export * from "./link.action.js";
+export * from "./package.action.js";
+export * from "./paths.action.js";
 export * from "./publish.action.js";
 export * from "./sync-lock-file.action.js";
 export * from "./tag.action.js";
+export * from "./typecheck.action.js";
+export * from "./unlink.action.js";
 export * from "./version.action.js";
 export * from "./watch.action.js";

package/types/src/actions/link.action.d.ts

@@ -0,0 +1,25 @@
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+import "../extensions/project.extensions.js";
+export declare const LINK_MANIFEST = ".forge-link.json";
+export type LinkOptions = {
+    configuration: string;
+    targetDir: string;
+};
+export declare const DEFAULT_LINK_CONFIGURATION = "link";
+export type LinkManifest = {
+    workspaceRoot: string;
+    peerNodeModulesDir?: string;
+    links: Array<{
+        packageName: string;
+        symlinkPath: string;
+        originalPath: string | null;
+    }>;
+};
+export declare class Link implements Action<LinkOptions> {
+    #private;
+    private readonly workspace;
+    constructor(workspace: Workspace);
+    run: (options: LinkOptions) => Promise<ActionResponse>;
+}

package/types/src/actions/package.action.d.ts

@@ -0,0 +1,38 @@
+import { Workspace } from "@decohere/workspace";
+import type { Action, ResultStatus } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+import { DependencyPinner } from "../packaging/dependency-pinner.service.js";
+import { ImportGraph } from "../packaging/import-graph.service.js";
+export type PackageOptions = {
+    /** Package name of one deployable. Omit to package every project that has a Dockerfile. */
+    project?: string;
+};
+export type PackageResponse = ResultStatus & {
+    projectName: string;
+    outDir: string;
+    workspacePackages: string[];
+    dependencies: Record<string, string>;
+    message: string;
+};
+/**
+ * Turns a deployable's release build into one self-contained folder that plain `node` runs:
+ * no symlinks, no workspace tooling. See ADR 0006.
+ */
+export declare class PackageDeployable implements Action<PackageOptions> {
+    #private;
+    private readonly workspace;
+    private readonly importGraph;
+    private readonly pinner;
+    private readonly npm;
+    constructor(workspace: Workspace, importGraph: ImportGraph, pinner: DependencyPinner);
+    run(options: PackageOptions): Promise<ActionResponse<PackageResponse>>;
+    /** The deployables to package, or the reason a named project cannot be one. */
+    private select;
+    private releaseProjects;
+    private packageProject;
+    private write;
+    /** Copies file contents, never links: a symlink in the output would break outside the image. */
+    private copyTree;
+    private writeJson;
+    private assertNoSymlinks;
+}

package/types/src/actions/paths.action.d.ts

@@ -0,0 +1,28 @@
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+export declare const PATHS_FILE = "tsconfig.paths.json";
+export type PathsOptions = {
+    /** Fail if the file is missing or out of date, instead of writing it. */
+    check?: boolean;
+};
+export type PathsResponse = {
+    file: string;
+    changed: boolean;
+    succeeded: boolean;
+    error?: string;
+};
+/**
+ * Writes `tsconfig.paths.json`: tsconfig `paths` for every workspace package and the subpaths it
+ * exports, from the workspace aliases. Without `node_modules` links, `tsc` finds workspace
+ * packages only through `paths`; generating them keeps them in step with what Flux, the Vitest
+ * plugin and builds resolve. The root tsconfig extends the file.
+ */
+export declare class Paths implements Action<PathsOptions> {
+    #private;
+    private readonly workspace;
+    constructor(workspace: Workspace);
+    run(options: PathsOptions): Promise<ActionResponse<PathsResponse>>;
+    /** The file's content: convention and exported subpaths only, never the tsconfig's own paths. */
+    static render(workspace: Workspace): string;
+}

package/types/src/actions/publish.action.d.ts

@@ -1,7 +1,7 @@
-import type { Project } from "@decohere/mesh";
-import { Workspace } from "@decohere/mesh";
-import type { Action, ResultStatus } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import type { Project } from "@decohere/workspace";
+import { Workspace } from "@decohere/workspace";
+import type { Action, ResultStatus } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type PublishOptions = {
     configuration: string;
     channel?: string;

package/types/src/actions/sync-lock-file.action.d.ts

@@ -1,5 +1,5 @@
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type SyncLockFileOptions = {
     sync?: boolean;
     dryRun?: boolean;

package/types/src/actions/tag.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type TagOptions = {
     prefix?: string;
     dryRun?: boolean;

package/types/src/actions/typecheck.action.d.ts

@@ -0,0 +1,14 @@
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+import { TypeEmitter } from "../services/type-emitter.js";
+export type TypeCheckOptions = {
+    configuration: string;
+};
+export declare class TypeCheck implements Action<TypeCheckOptions> {
+    #private;
+    private readonly workspace;
+    private readonly typeEmitter;
+    constructor(workspace: Workspace, typeEmitter: TypeEmitter);
+    run: (options: TypeCheckOptions) => Promise<ActionResponse>;
+}

package/types/src/actions/unlink.action.d.ts

@@ -0,0 +1,9 @@
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+export type UnlinkOptions = {
+    targetDir: string;
+};
+export declare class Unlink implements Action<UnlinkOptions> {
+    #private;
+    run: (options: UnlinkOptions) => Promise<ActionResponse>;
+}

package/types/src/actions/version.action.d.ts

@@ -1,7 +1,7 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action, ResultStatus } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
-import { type VersionType } from "@decohere/nexus/semver";
+import { Workspace } from "@decohere/workspace";
+import type { Action, ResultStatus } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
+import { type VersionType } from "../semver/index.js";
 export type VersionResponse = ResultStatus & {
     name: string;
 };

package/types/src/actions/watch.action.d.ts

@@ -1,6 +1,6 @@
-import { Workspace } from "@decohere/mesh";
-import type { Action } from "@decohere/nexus/cli";
-import { ActionResponse } from "@decohere/nexus/cli";
+import { Workspace } from "@decohere/workspace";
+import type { Action } from "@decohere/devkit/cli";
+import { ActionResponse } from "@decohere/devkit/cli";
 export type WatchOptions = {
     watch: boolean;
     configuration: string;

package/types/src/commands/build.command.d.ts

@@ -1,5 +1,5 @@
-import type { MergeOptions } from "@decohere/nexus/cli";
-import { CommandResponse, DecohereCommand } from "@decohere/nexus/cli";
+import type { MergeOptions } from "@decohere/devkit/cli";
+import { CommandResponse, DecohereCommand } from "@decohere/devkit/cli";
 import type { Build } from "../actions/build.action.js";
 import type { Clean } from "../actions/clean.action.js";
 import type { Copy } from "../actions/copy.action.js";
@@ -12,5 +12,6 @@ export type BuildActions = {
 };
 export declare class BuildCommand extends DecohereCommand<BuildActions> {
     constructor(name?: string);
+    runsUntilStopped(options: Record<string, unknown>): boolean;
     run: (actions: BuildActions, options: MergeOptions<BuildActions>) => Promise<CommandResponse<BuildActions>>;
 }

package/types/src/commands/dependency.command.d.ts

@@ -1,5 +1,5 @@
-import type { CommandHandler } from "@decohere/nexus/cli";
-import { DecohereCommand } from "@decohere/nexus/cli";
+import type { CommandHandler } from "@decohere/devkit/cli";
+import { DecohereCommand } from "@decohere/devkit/cli";
 export declare class DependencyCommand extends DecohereCommand {
     constructor(name?: string, handler?: CommandHandler);
 }

package/types/src/commands/docker.command.d.ts

@@ -0,0 +1,6 @@
+import { DecohereCommand } from "@decohere/devkit/cli";
+import { Docker } from "../actions/docker.action.js";
+export declare class DockerCommand extends DecohereCommand {
+    get actions(): (typeof Docker)[];
+    constructor(name: string);
+}

package/types/src/commands/forge.command.d.ts

@@ -1,5 +1,5 @@
-import type { Actions } from "@decohere/nexus/cli";
-import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/nexus/cli";
+import type { Actions } from "@decohere/devkit/cli";
+import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/devkit/cli";
 export declare class ForgeCommand extends DecohereCommand {
     constructor(commands: Record<string, CommandType>, handler: CommandHandler);
     run(_actions: Actions, _options: never): Promise<CommandResponse>;

package/types/src/commands/index.d.ts

@@ -1,6 +1,11 @@
 export * from "./build.command.js";
 export * from "./dependency.command.js";
+export * from "./docker.command.js";
 export * from "./forge.command.js";
+export * from "./link.command.js";
+export * from "./package.command.js";
+export * from "./paths.command.js";
 export * from "./publish.command.js";
 export * from "./tag.command.js";
+export * from "./typecheck.command.js";
 export * from "./version.command.js";

package/types/src/commands/link.command.d.ts

@@ -0,0 +1,29 @@
+import type { CommandHandler, MergeOptions } from "@decohere/devkit/cli";
+import { CommandResponse, DecohereCommand } from "@decohere/devkit/cli";
+import { Build } from "../actions/build.action.js";
+import { Clean } from "../actions/clean.action.js";
+import { Copy } from "../actions/copy.action.js";
+import { Link } from "../actions/link.action.js";
+import { Unlink } from "../actions/unlink.action.js";
+import { Watch } from "../actions/watch.action.js";
+export type LinkActions = {
+    clean: Clean;
+    build: Build;
+    copy: Copy;
+    link: Link;
+    watch: Watch;
+};
+type UnlinkActions = {
+    unlink: Unlink;
+};
+export declare class LinkCommand extends DecohereCommand<LinkActions> {
+    get actions(): (typeof Build | typeof Clean | typeof Copy | typeof Link | typeof Watch)[];
+    constructor(name?: string);
+    runsUntilStopped(options: Record<string, unknown>): boolean;
+    run: (actions: LinkActions, options: MergeOptions<LinkActions>) => Promise<CommandResponse<LinkActions>>;
+}
+export declare class UnlinkCommand extends DecohereCommand<UnlinkActions> {
+    get actions(): (typeof Unlink)[];
+    constructor(name?: string, handler?: CommandHandler);
+}
+export {};

package/types/src/commands/package.command.d.ts

@@ -0,0 +1,11 @@
+import { DecohereCommand } from "@decohere/devkit/cli";
+import { PackageDeployable } from "../actions/package.action.js";
+export declare class PackageCommand extends DecohereCommand {
+    get actions(): (typeof PackageDeployable)[];
+    constructor(name: string);
+    /**
+     * Commander passes the positional before the options; the CLI host reads only options,
+     * so the project name is stashed on them.
+     */
+    action(fn: (...args: any[]) => void | Promise<void>): this;
+}

package/types/src/commands/paths.command.d.ts

@@ -0,0 +1,6 @@
+import { DecohereCommand } from "@decohere/devkit/cli";
+import { Paths } from "../actions/paths.action.js";
+export declare class PathsCommand extends DecohereCommand {
+    get actions(): (typeof Paths)[];
+    constructor(name: string);
+}

package/types/src/commands/publish.command.d.ts

@@ -1,4 +1,4 @@
-import { DecohereCommand } from "@decohere/nexus/cli";
+import { DecohereCommand } from "@decohere/devkit/cli";
 import { Publish } from "../actions/publish.action.js";
 export declare class PublishCommand extends DecohereCommand {
     get actions(): (typeof Publish)[];

package/types/src/commands/tag.command.d.ts

@@ -1,4 +1,4 @@
-import { DecohereCommand } from "@decohere/nexus/cli";
+import { DecohereCommand } from "@decohere/devkit/cli";
 import { Tag } from "../actions/tag.action.js";
 export declare class TagCommand extends DecohereCommand {
     get actions(): (typeof Tag)[];

package/types/src/commands/typecheck.command.d.ts

@@ -0,0 +1,6 @@
+import { DecohereCommand } from "@decohere/devkit/cli";
+import { TypeCheck } from "../actions/typecheck.action.js";
+export declare class TypeCheckCommand extends DecohereCommand {
+    get actions(): (typeof TypeCheck)[];
+    constructor(name: string);
+}

package/types/src/commands/version.command.d.ts

@@ -1,4 +1,4 @@
-import { DecohereCommand } from "@decohere/nexus/cli";
+import { DecohereCommand } from "@decohere/devkit/cli";
 import { SyncLockFile } from "../actions/sync-lock-file.action.js";
 import { Version } from "../actions/version.action.js";
 type VersionActions = {

package/types/src/create-workspace.d.ts

@@ -0,0 +1,7 @@
+import { type Workspace } from "@decohere/workspace";
+import type { WorkspaceFactoryOptions } from "@decohere/devkit/cli";
+/**
+ * The workspace every Decohere tool sees (forge, the flux CLI and `flux.run`): forge's
+ * defaults, the user's `.decohere.js`, and the root: `--root-dir`, else the current folder.
+ */
+export declare function createWorkspace(options?: WorkspaceFactoryOptions): Promise<Workspace>;

package/types/src/errors.d.ts

@@ -1,4 +1,4 @@
-export { WorkspaceConfigurationError } from "@decohere/mesh";
+export { WorkspaceConfigurationError } from "@decohere/workspace";
 export declare class ForgeError extends Error {
 }
 export declare function formatUnknownError(reason: unknown): string;

package/types/src/extensions/project.extensions.d.ts

@@ -1,7 +1,7 @@
-import { Project } from "@decohere/mesh";
+import { Project } from "@decohere/workspace";
 import type { ForgeConfiguration } from "../types/configuration.type.js";
 import { SwcConfig } from "../types/swc-config.type.js";
-declare module "@decohere/mesh" {
+declare module "@decohere/workspace" {
     interface Project {
         getForgeConfiguration(): ForgeConfiguration;
         getSwcConfig(): Promise<SwcConfig>;

package/types/src/factories/swc-config.factory.d.ts

@@ -1,4 +1,4 @@
-import type { FileEx } from "@decohere/nexus/io";
+import type { FileEx } from "@decohere/core/io";
 import type { Options } from "@swc/core";
 import type { TranspileTarget } from "../types/build-target.type.js";
 import type { SwcConfigOptions } from "../types/swc-config.type.js";
@@ -8,8 +8,9 @@ export declare class SwcConfigFactory {
      * Call once per (project, target) and then use createFileConfig() per file.
      */
     createBaseConfig(buildTarget: TranspileTarget, configOptions: SwcConfigOptions): Options;
-    /** Stamps a per-file filename onto a pre-built base config. */
+    /** Stamps a per-file filename onto a pre-built base config; `.tsx` also turns on JSX. */
     createFileConfig(file: FileEx, baseConfig: Options): Options;
+    private static nonemptyPaths;
     /**
      * Validates SWC options against known causes of Rust/NAPI process crashes.
      * Throws a ForgeError with a descriptive message instead of letting the

package/types/src/forge.module.d.ts

@@ -1,6 +1,6 @@
-import type { WorkspaceFactoryOptions } from "@decohere/nexus/cli";
-import { ModuleManifest } from "@decohere/nexus/cli";
-import type { ContainerBuilder } from "@decohere/nexus/composition";
+import type { WorkspaceFactoryOptions } from "@decohere/devkit/cli";
+import { ModuleManifest } from "@decohere/devkit/cli";
+import type { ContainerBuilder } from "@decohere/core/composition";
 import * as Actions from "./actions/index.js";
 import * as Commands from "./commands/index.js";
 export declare class ForgeModule extends ModuleManifest {
@@ -9,6 +9,8 @@ export declare class ForgeModule extends ModuleManifest {
     readonly actions: {
         clean: typeof Actions.Clean;
         copy: typeof Actions.Copy;
+        docker: typeof Actions.Docker;
+        package: typeof Actions.PackageDeployable;
         build: typeof Actions.Build;
         watch: typeof Actions.Watch;
         publish: typeof Actions.Publish;
@@ -17,15 +19,25 @@ export declare class ForgeModule extends ModuleManifest {
         reportDependencies: typeof Actions.ReportDependencies;
         version: typeof Actions.Version;
         tag: typeof Actions.Tag;
+        paths: typeof Actions.Paths;
+        typecheck: typeof Actions.TypeCheck;
         commitFiles: typeof Actions.CommitFiles;
+        link: typeof Actions.Link;
+        unlink: typeof Actions.Unlink;
     };
     readonly commands: {
         build: typeof Commands.BuildCommand;
         publish: typeof Commands.PublishCommand;
         dependencies: typeof Commands.DependencyCommand;
+        docker: typeof Commands.DockerCommand;
+        package: typeof Commands.PackageCommand;
         version: typeof Commands.VersionCommand;
         tag: typeof Commands.TagCommand;
+        paths: typeof Commands.PathsCommand;
+        typecheck: typeof Commands.TypeCheckCommand;
+        link: typeof Commands.LinkCommand;
+        unlink: typeof Commands.UnlinkCommand;
     };
     registerServices(builder: ContainerBuilder): void;
-    createWorkspace(options: WorkspaceFactoryOptions): Promise<import("@decohere/mesh").Workspace>;
+    createWorkspace(options: WorkspaceFactoryOptions): Promise<import("@decohere/workspace").Workspace>;
 }

package/types/src/index.d.ts

@@ -1,9 +1,11 @@
+export { createWorkspace } from "./create-workspace.js";
 export { ForgeError } from "./errors.js";
 export { ForgeModule } from "./forge.module.js";
 export type { TranspileOptions } from "./services/swc-transpiler.js";
 export { SwcTranspiler } from "./services/swc-transpiler.js";
+export { transpileCache } from "./services/transpile-cache.js";
 export type { BuildTarget, TranspileTarget } from "./types/build-target.type.js";
 export { BuildTargets } from "./types/build-target.type.js";
 export type { ForgeConfiguration } from "./types/configuration.type.js";
 export type { WorkspaceOptions } from "./types/workspace-config.type.js";
-export { Debug as DebugConfiguration, DefaultConfigurations, Release as ReleaseConfiguration, WorkspaceDefaults, } from "./workspace.config.js";
+export { Debug as DebugConfiguration, DefaultConfigurations, Link as LinkConfiguration, Release as ReleaseConfiguration, WorkspaceDefaults, } from "./workspace.config.js";

package/types/src/packaging/dependency-pinner.service.d.ts

@@ -0,0 +1,20 @@
+import type { PackageJson } from "@decohere/workspace";
+import type { ReachedPackages, ReleaseProject } from "./import-graph.service.js";
+/**
+ * Chooses the third-party `dependencies` for the packaged `package.json`: the union of
+ * `dependencies` (never devDependencies) of the deployable, every library copied in, and the
+ * workspace root. Declared is shipped, whether or not code imports it (a runtime-loaded pino
+ * transport, say), so removing an unused dependency is the author's job. Each is pinned to the
+ * exact version installed in the workspace, so the image runs what the tests ran.
+ *
+ * Code that imports a third-party package nothing ships is a crash waiting to happen, so that
+ * is an error: the package is only a devDependency, or declared nowhere.
+ */
+export declare class DependencyPinner {
+    pin(imported: ReachedPackages["thirdParty"], shipped: readonly ReleaseProject[], projects: ReadonlyMap<string, ReleaseProject>, workspaceRoot: {
+        dir: string;
+        pkg: PackageJson;
+    }): Promise<Record<string, string>>;
+    private assertImportsAreShipped;
+    private installedVersion;
+}