@metamesh/cli 0.0.0-stage → 0.14.0

package/dist/docs/reference/authoring/CapturedBuffer.md

@@ -0,0 +1,14 @@
+# CapturedBuffer
+
+A captured file's relative path, byte length, and SHA-256 integrity digest.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** A captured file's relative path, byte length, and SHA-256 integrity digest. */
+export interface CapturedBuffer {
+    readonly path: string;
+    readonly bytes: number;
+    readonly sha256: string;
+}
+```

package/dist/docs/reference/authoring/CapturedGeometry.md

@@ -0,0 +1,14 @@
+# CapturedGeometry
+
+Validated local-space mesh buffers loaded from a completed captured resource.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Validated local-space mesh buffers loaded from a completed captured resource. */
+export interface CapturedGeometry {
+    readonly id: string;
+    readonly positions: Float32Array;
+    readonly indices: Uint32Array;
+}
+```

package/dist/docs/reference/authoring/CapturedPart.md

@@ -0,0 +1,19 @@
+# CapturedPart
+
+Semantic part identity and appearance referencing a shared mesh with separate placement.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Semantic part identity and appearance referencing a shared mesh with separate placement. */
+export interface CapturedPart {
+    readonly id: string;
+    readonly resourceId: string;
+    /** World translation in millimetres, applied after rotation. */
+    readonly position: Vector3Tuple;
+    /** Global XYZ rotation in degrees, applied once to local geometry. */
+    readonly rotation: Vector3Tuple;
+    readonly color?: string;
+    readonly measurements: SnapshotPart["measurements"];
+}
+```

package/dist/docs/reference/authoring/CapturedResource.md

@@ -0,0 +1,15 @@
+# CapturedResource
+
+A shared local-space mesh resource and its measurements, before per-part placement.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** A shared local-space mesh resource and its measurements, before per-part placement. */
+export interface CapturedResource {
+    readonly id: string;
+    readonly positions: CapturedBuffer;
+    readonly indices: CapturedBuffer;
+    readonly measurements: SnapshotPart["measurements"];
+}
+```

package/dist/docs/reference/authoring/CapturedRun.md

@@ -0,0 +1,14 @@
+# CapturedRun
+
+A validated successful capture with its manifest and shared local geometry buffers.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** A validated successful capture with its manifest and shared local geometry buffers. */
+export interface CapturedRun {
+    readonly directory: string;
+    readonly manifest: CapturedRunManifest;
+    readonly resources: readonly CapturedGeometry[];
+}
+```

package/dist/docs/reference/authoring/CapturedRunManifest.md

@@ -0,0 +1,40 @@
+# CapturedRunManifest
+
+A completed attempt's provenance, effective inputs, diagnostics, and captured geometry.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** A completed attempt's provenance, effective inputs, diagnostics, and captured geometry. */
+export interface CapturedRunManifest {
+    readonly formatVersion: 1;
+    readonly status: "complete";
+    readonly runId: string;
+    readonly createdAt: string;
+    readonly kind: AuthoringKind;
+    /** Project-relative entry and fingerprint of bundled local source files. */
+    readonly source: {
+        readonly entry: string;
+        readonly fingerprint: string;
+    };
+    readonly packages: Readonly<Record<string, string>>;
+    readonly parameters: Readonly<Record<string, unknown>>;
+    /** Effective Generator font selections, or declared and byte-verified standalone fixture revisions. */
+    readonly assets: readonly {
+        readonly faceId: string;
+        readonly revision: string;
+        readonly weight: number;
+    }[];
+    readonly policy: {
+        readonly timeoutMs: number;
+        readonly limits: ModelingLimits;
+    };
+    readonly diagnostics: readonly GenerationDiagnostic[];
+    readonly bounds: Bounds3;
+    readonly stats: FinalizedModel["stats"];
+    readonly dependencies: ModelDependencies;
+    readonly resources: readonly CapturedResource[];
+    readonly parts: readonly CapturedPart[];
+    readonly export3mf?: CapturedBuffer;
+}
+```

package/dist/docs/reference/authoring/CheckOptions.md

@@ -0,0 +1,18 @@
+# CheckOptions
+
+Source entry contract and project-local resolution settings for semantic checking.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Source entry contract and project-local resolution settings for semantic checking. */
+export interface CheckOptions {
+    /** Entry path, resolved from project. */
+    readonly entry: string;
+    readonly kind: AuthoringKind;
+    /** Package and path resolution root; defaults to the current working directory. */
+    readonly project?: string;
+    /** Explicit configuration path relative to project; otherwise the entry's nearest tsconfig is used. */
+    readonly tsconfig?: string;
+}
+```

package/dist/docs/reference/authoring/CheckSuccess.md

@@ -0,0 +1,16 @@
+# CheckSuccess
+
+A successful semantic check; source has not been evaluated and no geometry is captured.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** A successful semantic check; source has not been evaluated and no geometry is captured. */
+export interface CheckSuccess {
+    readonly success: true;
+    readonly entry: string;
+    readonly kind: AuthoringKind;
+    readonly tsconfig?: string;
+    readonly diagnostics: readonly AuthoringDiagnostic[];
+}
+```

package/dist/docs/reference/authoring/DocumentationEntry.md

@@ -0,0 +1,20 @@
+# DocumentationEntry
+
+Metadata for one installed Markdown guide or public API symbol.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Metadata for one installed Markdown guide or public API symbol. */
+export interface DocumentationEntry {
+    readonly id: string;
+    readonly title: string;
+    readonly summary: string;
+    /** Forward-slash relative path beside the owning documentation manifest. */
+    readonly path: string;
+    readonly importPath: string;
+    readonly availability: string;
+    readonly canonical: string;
+    readonly keywords: readonly string[];
+}
+```

package/dist/docs/reference/authoring/DocumentationManifest.md

@@ -0,0 +1,15 @@
+# DocumentationManifest
+
+Exact-package-version index exposed through the package's docs/manifest.json export.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Exact-package-version index exposed through the package's docs/manifest.json export. */
+export interface DocumentationManifest {
+    readonly formatVersion: 1;
+    readonly packageName: string;
+    readonly packageVersion: string;
+    readonly documents: readonly DocumentationEntry[];
+}
+```

package/dist/docs/reference/authoring/DocumentationSearchResult.md

@@ -0,0 +1,13 @@
+# DocumentationSearchResult
+
+An installed documentation match carrying the exact package identity that owns it.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** An installed documentation match carrying the exact package identity that owns it. */
+export interface DocumentationSearchResult extends DocumentationEntry {
+    readonly packageName: string;
+    readonly packageVersion: string;
+}
+```

package/dist/docs/reference/authoring/InstalledAuthoringPackage.md

@@ -0,0 +1,15 @@
+# InstalledAuthoringPackage
+
+A project-local MetaMesh package and its verified documentation index.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** A project-local MetaMesh package and its verified documentation index. */
+export interface InstalledAuthoringPackage {
+    readonly name: string;
+    readonly version: string;
+    readonly manifestPath: string;
+    readonly documentCount: number;
+}
+```

package/dist/docs/reference/authoring/RenderCamera.md

@@ -0,0 +1,22 @@
+# RenderCamera
+
+Recorded orthographic camera, expressed in millimetres and world coordinates.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Recorded orthographic camera, expressed in millimetres and world coordinates. */
+export interface RenderCamera {
+    readonly position: readonly [number, number, number];
+    readonly target: readonly [number, number, number];
+    readonly up: readonly [number, number, number];
+    readonly frustum: {
+        readonly left: number;
+        readonly right: number;
+        readonly top: number;
+        readonly bottom: number;
+        readonly near: number;
+        readonly far: number;
+    };
+}
+```

package/dist/docs/reference/authoring/RenderFormat.md

@@ -0,0 +1,10 @@
+# RenderFormat
+
+Image encodings; WebP is always lossless.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Image encodings; WebP is always lossless. */
+export type RenderFormat = "png" | "webp";
+```

package/dist/docs/reference/authoring/RenderOptions.md

@@ -0,0 +1,20 @@
+# RenderOptions
+
+Options for rendering a previously captured model, without executing author code.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Options for rendering a previously captured model, without executing author code. */
+export interface RenderOptions {
+    readonly views?: readonly RenderView[];
+    readonly width?: number;
+    readonly height?: number;
+    readonly format?: RenderFormat;
+    readonly background?: "transparent" | `#${string}`;
+    /** Parent for a new unique capture directory; defaults to the run's renders directory. */
+    readonly outputDirectory?: string;
+    /** Browser startup, page readiness, and capture deadline; defaults to 30 seconds. */
+    readonly timeoutMs?: number;
+}
+```

package/dist/docs/reference/authoring/RenderResult.md

@@ -0,0 +1,15 @@
+# RenderResult
+
+Images always belong to one captured run and one unique output directory.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Images always belong to one captured run and one unique output directory. */
+export interface RenderResult {
+    readonly runId: string;
+    readonly sourceFingerprint: string;
+    readonly directory: string;
+    readonly images: readonly RenderedImage[];
+}
+```

package/dist/docs/reference/authoring/RenderView.md

@@ -0,0 +1,10 @@
+# RenderView
+
+Standard orthographic views in MetaMesh's Z-up coordinate system.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Standard orthographic views in MetaMesh's Z-up coordinate system. */
+export type RenderView = "isometric" | "front" | "top" | "right";
+```

package/dist/docs/reference/authoring/RenderedImage.md

@@ -0,0 +1,23 @@
+# RenderedImage
+
+A view and its provenance, also written beside the image as JSON.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** A view and its provenance, also written beside the image as JSON. */
+export interface RenderedImage {
+    readonly path: string;
+    readonly metadataPath: string;
+    readonly runId: string;
+    readonly sourceFingerprint: string;
+    readonly view: RenderView;
+    readonly width: number;
+    readonly height: number;
+    readonly format: RenderFormat;
+    readonly background: string;
+    readonly camera: RenderCamera;
+    readonly rendererRevision: string;
+    readonly browserVersion: string;
+}
+```

package/dist/docs/reference/authoring/RunOptions.md

@@ -0,0 +1,25 @@
+# RunOptions
+
+Inputs and bounded execution policy for one checked, trusted local source attempt.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Inputs and bounded execution policy for one checked, trusted local source attempt. */
+export interface RunOptions extends CheckOptions {
+    /** Generator overrides merged with definition defaults, or the standalone model's raw parameter map. */
+    readonly params?: Readonly<Record<string, unknown>>;
+    /** Local font descriptor JSON path relative to project; no assets are downloaded. */
+    readonly fontFixtures?: string;
+    /** Parent for a unique attempt directory; defaults to .metamesh/runs beneath project. */
+    readonly output?: string;
+    /** Child execution deadline in milliseconds, from 1 to 3600000; defaults to 30000. */
+    readonly timeoutMs?: number;
+    /** Engine resource ceilings may be lowered from their defaults, never raised. */
+    readonly limits?: Partial<ModelingLimits>;
+    /** Export the completed snapshot as 3MF in this run; defaults to false. */
+    readonly export3mf?: boolean;
+    /** Receives combined child stdout/stderr, truncated after 64 KiB. */
+    readonly onLog?: (text: string) => void;
+}
+```

package/dist/docs/reference/authoring/RunSuccess.md

@@ -0,0 +1,14 @@
+# RunSuccess
+
+A successful checked execution; use this exact directory for subsequent inspection and rendering.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** A successful checked execution; use this exact directory for subsequent inspection and rendering. */
+export interface RunSuccess {
+    readonly success: true;
+    readonly runDirectory: string;
+    readonly manifest: CapturedRunManifest;
+}
+```

package/dist/docs/reference/authoring/authoringFailure-value.md

@@ -0,0 +1,10 @@
+# authoringFailure
+
+Converts a thrown value to a failure envelope, preserving classified authoring diagnostics.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Converts a thrown value to a failure envelope, preserving classified authoring diagnostics. */
+export declare function authoringFailure(error: unknown, fallbackPhase?: AuthoringPhase): AuthoringFailure;
+```

package/dist/docs/reference/authoring/checkAuthoringSource.md

@@ -0,0 +1,10 @@
+# checkAuthoringSource
+
+Checks strict TypeScript and the selected entry-module contract without evaluating author source.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Checks strict TypeScript and the selected entry-module contract without evaluating author source. */
+export declare function checkAuthoringSource(options: CheckOptions): Promise<CheckSuccess | AuthoringFailure>;
+```

package/dist/docs/reference/authoring/discoverAuthoringEnvironment.md

@@ -0,0 +1,13 @@
+# discoverAuthoringEnvironment
+
+Discovers project-local Modeling, CLI, and optional SDK/Testkit documentation. Rejects missing required packages, stale manifests, and mixed exact package versions.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/**
+ * Discovers project-local Modeling, CLI, and optional SDK/Testkit documentation.
+ * Rejects missing required packages, stale manifests, and mixed exact package versions.
+ */
+export declare function discoverAuthoringEnvironment(project?: string): Promise<AuthoringEnvironment>;
+```

package/dist/docs/reference/authoring/inspectCapturedRun.md

@@ -0,0 +1,15 @@
+# inspectCapturedRun
+
+Validates a completed capture and returns its manifest with an optional semantic part selection. Original source is never evaluated; incomplete captures and unknown part IDs reject.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/**
+ * Validates a completed capture and returns its manifest with an optional semantic part selection.
+ * Original source is never evaluated; incomplete captures and unknown part IDs reject.
+ */
+export declare function inspectCapturedRun(directory: string, partId?: string): Promise<Omit<CapturedRun, "resources"> & {
+    readonly selectedPart?: CapturedPart;
+}>;
+```

package/dist/docs/reference/authoring/installAuthoringBrowser.md

@@ -0,0 +1,13 @@
+# installAuthoringBrowser
+
+Explicit installation of this package's pinned Chromium. Never called by render.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Explicit installation of this package's pinned Chromium. Never called by render. */
+export declare function installAuthoringBrowser(): Promise<{
+    browser: "chromium";
+    executablePath: string;
+}>;
+```

package/dist/docs/reference/authoring/readCapturedRun.md

@@ -0,0 +1,10 @@
+# readCapturedRun
+
+Reads only immutable captured files. It never imports or executes original author source.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Reads only immutable captured files. It never imports or executes original author source. */
+export declare function readCapturedRun(directory: string): Promise<CapturedRun>;
+```

package/dist/docs/reference/authoring/renderCapturedRun.md

@@ -0,0 +1,13 @@
+# renderCapturedRun
+
+Render validated persisted local geometry and placements. Source code is never imported, and a fresh capture directory prevents overlapping calls from overwriting evidence.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/**
+ * Render validated persisted local geometry and placements. Source code is never imported,
+ * and a fresh capture directory prevents overlapping calls from overwriting evidence.
+ */
+export declare function renderCapturedRun(directory: string, options?: RenderOptions): Promise<RenderResult>;
+```

package/dist/docs/reference/authoring/runAuthoringSource.md

@@ -0,0 +1,13 @@
+# runAuthoringSource
+
+Checks and executes trusted local source in a disposable child, then captures its finalized geometry. Returns a success or failure envelope for this fresh attempt; failed attempts cannot be rendered.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/**
+ * Checks and executes trusted local source in a disposable child, then captures its finalized geometry.
+ * Returns a success or failure envelope for this fresh attempt; failed attempts cannot be rendered.
+ */
+export declare function runAuthoringSource(options: RunOptions): Promise<RunSuccess | AuthoringFailure>;
+```

package/dist/docs/reference/authoring/searchAuthoringDocumentation.md

@@ -0,0 +1,16 @@
+# searchAuthoringDocumentation
+
+Ranks installed topic and symbol metadata without loading every document's body. Returns up to limit matches, defaulting to 10; supported limits are 1 through 50.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/**
+ * Ranks installed topic and symbol metadata without loading every document's body.
+ * Returns up to limit matches, defaulting to 10; supported limits are 1 through 50.
+ */
+export declare function searchAuthoringDocumentation(query: string, options?: {
+    readonly project?: string;
+    readonly limit?: number;
+}): Promise<readonly DocumentationSearchResult[]>;
+```

package/dist/docs/reference/authoring/showAuthoringDocumentation.md

@@ -0,0 +1,12 @@
+# showAuthoringDocumentation
+
+Reads one exact-version installed Markdown topic by its discovered ID, without executing source.
+
+Import from `@metamesh/cli/authoring` (@metamesh/cli@0.14.0).
+
+```ts
+/** Reads one exact-version installed Markdown topic by its discovered ID, without executing source. */
+export declare function showAuthoringDocumentation(id: string, project?: string): Promise<DocumentationSearchResult & {
+    readonly markdown: string;
+}>;
+```

package/dist/metamesh.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=metamesh.d.ts.map

package/dist/metamesh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metamesh.d.ts","sourceRoot":"","sources":["../src/metamesh.ts"],"names":[],"mappings":""}