@drawcall/design 0.12.3 → 0.12.5

package/README.md

@@ -10,7 +10,7 @@ const projects = await design.project.list();
 ```
 
 Projects and frames have immutable 14-character lowercase IDs. A project is a hosted filesystem at `https://<project-id>.design.drawcallcontent.com/`; every frame owns `/<frame-id>/` within it.
-The current rendered image for any GLTS, Markdown, image, or Market frame is available at
+Every GLTS, Markdown, image, or Market frame includes a canonical `previewUrl` at
 `https://<project-id>.design.drawcallcontent.com/<frame-id>.webp`.
 
 ```sh
@@ -19,13 +19,17 @@ npx drawcall design project create showroom
 # `project list` prints: <project-id> <name>
 
 npx drawcall design -p r6z2n9k4x8m1qc frame create racecar \
-  --type glts --size 800x800
-# `frame create` prints its frame ID and /<frame-id>/ path.
-
-npx drawcall design -p r6z2n9k4x8m1qc write /a4z8m2q7v9kcde/index.glts \
-  'export default class Racecar extends THREE.Group {}'
+  --type glts --size 800x800 \
+  --import ./parts/wheel.glts=-0.5,0,-0.5:0.5,1,0.5 \
+  --text 'import * as THREE from "three"; import Wheel from "./parts/wheel.glts"; export default class Racecar extends THREE.Group { constructor() { super(); this.add(new Wheel()); } }'
+# `frame create` prints its frame ID and /<frame-id>/ path. `--text -` reads stdin.
+# Each `--import` box becomes a placeholder file until the real part is written.
+
+npx drawcall design -p r6z2n9k4x8m1qc write /a4z8m2q7v9kcde/parts/wheel.glts \
+  'import * as THREE from "three"; export default class Wheel extends THREE.Group {}'
 npx drawcall design -p r6z2n9k4x8m1qc ls /
 npx drawcall design -p r6z2n9k4x8m1qc read /a4z8m2q7v9kcde/index.glts
+npx drawcall design -p r6z2n9k4x8m1qc frame preview a4z8m2q7v9kcde
 npx drawcall design -p r6z2n9k4x8m1qc frame screenshot a4z8m2q7v9kcde
 
 npx drawcall design -p r6z2n9k4x8m1qc frame create release-notes \

package/dist/browser.d.ts

@@ -1,5 +1,6 @@
 export * as v1 from "./v1/index.js";
 export { frameImageUrl } from "./frame-image.js";
+export { framePreviewUrl } from "./frame-preview.js";
 export { registerDesignTools, type DesignMcpOptions, type DesignMcpServer, type DesignMcpToolResult, } from "./mcp/index.js";
 export { cliDesignSkill, mcpDesignSkill } from "./skill.generated.js";
 export { frameCreationCapabilities, type FrameCreationCapability, type FrameCreationCapabilityId, type FrameCreationInput, } from "./v1/capabilities.js";
@@ -7,4 +8,4 @@ export { cameraPoseSchema, commentBodySchema, commentPositionInputSchema, commen
 export { parseFrameSize } from "./target.js";
 export { projectFrameLayoutSchema, projectCommentsChangedServerMessageSchema, projectFrameRecordSchema, projectGltsFrameRecordSchema, projectImageFrameRecordSchema, projectMarkdownFrameRecordSchema, projectMarketFileSchema, projectMarketFrameRecordSchema, projectPresenceClientMessageSchema, projectPresenceServerMessageSchema, projectStateSchema, type ProjectFrameLayout, type ProjectCommentsChangedServerMessage, type ProjectFrameRecord, type ProjectGltsFrameRecord, type ProjectImageFrameRecord, type ProjectMarkdownFrameRecord, type ProjectMarketFile, type ProjectMarketFrameRecord, type ProjectPresenceClientMessage, type ProjectPresenceServerMessage, type ProjectState, } from "./project-state.js";
 export { cameraCaptureCommandSchema, cameraCaptureResultSchema, cameraMessageTypes, cameraSetCommandSchema, commentActionMessageSchema, commentActionResultSchema, commentPickCommandSchema, commentPickResultSchema, commentRuntimeMessageTypes, commentSelectionMessageSchema, commentStateCommandSchema, frameNavigationMessageSchema, frameNavigationMessageTypes, frameNavigationV2MessageSchema, frameNavigationV2MessageTypes, frameInteractionMessageSchema, frameInteractionMessageTypes, framePointerMessageSchema, framePointerMessageTypes, frameZoomMessageSchema, frameZoomMessageTypes, frameRenderResultSchema, gltsExportCancelCommandSchema, gltsExportCancelledResultSchema, gltsExportCommandSchema, gltsExportFrameMessageSchema, gltsExportMessageTypes, gltsExportParentMessageSchema, gltsExportResultSchema, gltsRuntimeExportFormatSchema, immersiveCommandSchema, immersiveFrameMessageSchema, immersiveMessageTypes, immersiveModeSchema, inspectionCommandSchema, inspectionFrameMessageSchema, inspectionMessageTypes, posterMessageTypes, posterPagePath, posterPageUrl, posterRenderCommandSchema, posterRenderResultSchema, previewConfigureCommandSchema, previewLoadCommandSchema, previewLoadResultSchema, previewMessageTypes, previewPagePath, previewPageUrl, previewPixelRatioMax, previewSessionEventSchema, projectSyncUrl, sourceFileChangeSchema, sourceFileMessageTypes, sourceFileReloadResultSchema, sourceFilesChangedMessageSchema, type GltsExportCancelCommand, type GltsExportCancelledResult, type GltsExportCommand, type GltsExportFrameMessage, type GltsExportParentMessage, type GltsExportResult, type GltsRuntimeExportFormat, type CameraCaptureCommand, type CameraSetCommand, type CameraCaptureFailure, type CameraCaptureResult, type CommentActionMessage, type CommentActionResult, type CommentPickCommand, type CommentPickResult, type CommentSelectionMessage, type CommentStateCommand, type FrameRenderResult, type FramePointerMessage, type FrameZoomMessage, type InspectionAppliedMessage, type InspectionCommand, type InspectionFrameMessage, type PosterRenderCommand, type PosterRenderResult, type PreviewLoadCommand, type PreviewLoadResult, type ImmersiveCommand, type ImmersiveFrameMessage, type ImmersiveMode, type SourceFileChange, type SourceFileReloadResult, type SourceFilesChangedMessage, } from "./protocol.js";
-export type { BinaryFile, CameraPose, Comment, CommentAuthor, CommentPosition, CommentPositionInput, CommentReply, CommentResolution, CreateComment, CreateFrame, CreateProjectFromBrief, CreateGltsFrame, CreateImageFrame, CreateMarkdownFrame, CreateMarketFrame, GenerateImage, GenerateImageUrl, DesignFile, FileList, FileMutation, FrameExport, Frame, GltsFrame, GltsFrameExport, ImageFrame, ImageFrameExport, ImageGenerationOperation, ImageGenerationProvenance, ImageGenerationResult, ImageInput, ImageInputProvenance, MarketFrame, MarketFrameExport, MarkdownFrame, MarkdownFrameExport, Project, ProjectDerivationStatus, Screenshot, TextFile, User, } from "./v1/schemas.js";
+export type { BinaryFile, BoundingBox, CameraPose, Imports, Comment, CommentAuthor, CommentPosition, CommentPositionInput, CommentReply, CommentResolution, CreateComment, CreateFrame, CreateProjectFromBrief, CreateGltsFrame, CreateImageFrame, CreateMarkdownFrame, CreateMarketFrame, GenerateImage, GenerateImageUrl, DesignFile, FileList, FileMutation, FrameExport, Frame, GltsFrame, GltsFrameExport, ImageFrame, ImageFrameExport, ImageGenerationOperation, ImageGenerationProvenance, ImageGenerationResult, ImageInput, ImageInputProvenance, MarketFrame, MarketFrameExport, MarkdownFrame, MarkdownFrameExport, Project, ProjectDerivationStatus, Screenshot, TextFile, User, } from "./v1/schemas.js";

package/dist/browser.js

@@ -1,5 +1,6 @@
 export * as v1 from "./v1/index.js";
 export { frameImageUrl } from "./frame-image.js";
+export { framePreviewUrl } from "./frame-preview.js";
 export { registerDesignTools, } from "./mcp/index.js";
 export { cliDesignSkill, mcpDesignSkill } from "./skill.generated.js";
 export { frameCreationCapabilities, } from "./v1/capabilities.js";

package/dist/command/context.d.ts

@@ -112,6 +112,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"glts">;
@@ -138,6 +139,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"markdown">;
@@ -151,6 +153,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -188,6 +191,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -202,6 +206,11 @@ export declare function clientFor(command: Command): Promise<{
             type: import("zod").ZodLiteral<"glts">;
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
+            text: import("zod").ZodOptional<import("zod").ZodString>;
+            imports: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+                min: import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber], null>;
+                max: import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber], null>;
+            }, import("zod/v4/core").$strict>>>;
         }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
             project: import("zod").ZodString;
             name: import("zod").ZodString;
@@ -210,6 +219,7 @@ export declare function clientFor(command: Command): Promise<{
             type: import("zod").ZodLiteral<"markdown">;
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
+            text: import("zod").ZodOptional<import("zod").ZodString>;
         }, import("zod/v4/core").$strict>, import("zod").ZodObject<{
             project: import("zod").ZodString;
             name: import("zod").ZodString;
@@ -233,6 +243,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"glts">;
@@ -259,6 +270,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"markdown">;
@@ -272,6 +284,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -309,6 +322,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -353,6 +367,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"glts">;
@@ -379,6 +394,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"markdown">;
@@ -392,6 +408,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -429,6 +446,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -448,6 +466,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"glts">;
@@ -474,6 +493,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"markdown">;
@@ -487,6 +507,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -524,6 +545,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -557,6 +579,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"glts">;
@@ -583,6 +606,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"markdown">;
@@ -596,6 +620,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -633,6 +658,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -655,6 +681,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"glts">;
@@ -681,6 +708,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
             type: import("zod").ZodLiteral<"markdown">;
@@ -694,6 +722,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -731,6 +760,7 @@ export declare function clientFor(command: Command): Promise<{
             width: import("zod").ZodNumber;
             height: import("zod").ZodNumber;
             viewUrl: import("zod").ZodString;
+            previewUrl: import("zod").ZodString;
             contentRevision: import("zod").ZodOptional<import("zod").ZodNumber>;
             createdAt: import("zod").ZodString;
             updatedAt: import("zod").ZodString;
@@ -1109,6 +1139,10 @@ export declare function clientFor(command: Command): Promise<{
             project: import("zod").ZodString;
             path: import("zod").ZodString;
             text: import("zod").ZodString;
+            imports: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+                min: import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber], null>;
+                max: import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber], null>;
+            }, import("zod/v4/core").$strict>>>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             paths: import("zod").ZodArray<import("zod").ZodString>;
         }, import("zod/v4/core").$strip>, Record<never, never>>;
@@ -1117,6 +1151,10 @@ export declare function clientFor(command: Command): Promise<{
             path: import("zod").ZodString;
             oldText: import("zod").ZodString;
             newText: import("zod").ZodString;
+            imports: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodObject<{
+                min: import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber], null>;
+                max: import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber], null>;
+            }, import("zod/v4/core").$strict>>>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             paths: import("zod").ZodArray<import("zod").ZodString>;
         }, import("zod/v4/core").$strip>, Record<never, never>>;

package/dist/command/filesystem.js

@@ -1,4 +1,5 @@
 import { clientFor, projectId, requireConfirmation } from "./context.js";
+import { importOption, parseImports } from "./imports.js";
 import { textArgument } from "./input.js";
 export function registerFilesystemCommands(program) {
     program
@@ -35,12 +36,15 @@ export function registerFilesystemCommands(program) {
         .description("Create or overwrite a text project file")
         .argument("<path>", "Absolute project path")
         .argument("[text]", "Inline text; omit or use - to read stdin")
-        .action(async (path, text, _options, command) => {
+        .addOption(importOption)
+        .action(async (path, text, options, command) => {
         const client = await clientFor(command);
+        const imports = parseImports(options.import);
         await client.filesystem.write({
             project: projectId(command),
             path,
             text: await textArgument(text),
+            ...(imports === undefined ? {} : { imports }),
         });
         console.log(`Wrote ${path}.`);
     });
@@ -50,13 +54,16 @@ export function registerFilesystemCommands(program) {
         .argument("<path>", "Absolute project path")
         .argument("<old-text>", "Text that must occur exactly once")
         .argument("<new-text>", "Replacement text")
-        .action(async (path, oldText, newText, _options, command) => {
+        .addOption(importOption)
+        .action(async (path, oldText, newText, options, command) => {
         const client = await clientFor(command);
+        const imports = parseImports(options.import);
         await client.filesystem.edit({
             project: projectId(command),
             path,
             oldText,
             newText,
+            ...(imports === undefined ? {} : { imports }),
         });
         console.log(`Edited ${path}.`);
     });

package/dist/command/frame.js

@@ -1,5 +1,7 @@
 import { readImageInput } from "../image.js";
 import { parseFrameSize } from "../target.js";
+import { importOption, parseImports } from "./imports.js";
+import { textArgument } from "./input.js";
 import { designIdSchema, marketAssetSchema, } from "../v1/schemas.js";
 import { clientFor, projectId, requireConfirmation } from "./context.js";
 import { registerImageCommands } from "./image.js";
@@ -27,6 +29,8 @@ export function registerFrameCommands(program) {
         .option("-s, --size <width>x<height>", "GLTS or Markdown viewport size")
         .option("--image <url-or-path>", "Image URL or local PNG, JPEG, or WebP")
         .option("--asset <name@version>", "Exact public Market asset version")
+        .option("--text <text>", "Initial index.glts or index.md content; use - to read stdin")
+        .addOption(importOption)
         .action(async (name, options, command) => {
         const project = projectId(command);
         const input = await createFrameInput(project, name, options);
@@ -65,6 +69,22 @@ export function registerFrameCommands(program) {
             console.log(`Deleted ${id}.`);
         }
     });
+    frame
+        .command("preview")
+        .description("Print frames' current WebP preview URLs")
+        .argument("<frame-id...>", "Frame IDs")
+        .action(async (frameIds, _options, command) => {
+        const project = projectId(command);
+        const client = await clientFor(command);
+        const frames = await client.frame.list({ project });
+        for (const frameId of frameIds) {
+            const id = designIdSchema.parse(frameId);
+            const target = frames.find((item) => item.id === id);
+            if (!target)
+                throw new Error(`Frame ${id} does not exist.`);
+            console.log(`${id}\t${target.previewUrl}`);
+        }
+    });
     frame
         .command("screenshot")
         .description("Render frames and print their screenshot URLs")
@@ -81,6 +101,9 @@ export function registerFrameCommands(program) {
     registerImageCommands(frame);
 }
 async function createFrameInput(project, name, options) {
+    if (options.import !== undefined && options.type !== "glts") {
+        throw new Error("Only GLTS frames accept --import");
+    }
     if (options.type === "glts") {
         if (options.image !== undefined || options.asset !== undefined) {
             throw new Error("GLTS frames do not accept --image or --asset");
@@ -88,17 +111,26 @@ async function createFrameInput(project, name, options) {
         if (options.size === undefined) {
             throw new Error("GLTS frames require --size <width>x<height>");
         }
+        const imports = parseImports(options.import);
+        const text = options.text === undefined
+            ? {}
+            : { text: await textArgument(options.text) };
         return {
             project,
             name,
             type: "glts",
             ...parseFrameSize(options.size),
+            ...text,
+            ...(imports === undefined ? {} : { imports }),
         };
     }
     if (options.type === "image") {
         if (options.size !== undefined || options.asset !== undefined) {
             throw new Error("Image frames do not accept --size or --asset");
         }
+        if (options.text !== undefined) {
+            throw new Error("Image frames do not accept --text");
+        }
         if (options.image === undefined) {
             throw new Error("Image frames require --image");
         }
@@ -116,17 +148,24 @@ async function createFrameInput(project, name, options) {
         if (options.size === undefined) {
             throw new Error("Markdown frames require --size <width>x<height>");
         }
+        const text = options.text === undefined
+            ? {}
+            : { text: await textArgument(options.text) };
         return {
             project,
             name,
             type: "markdown",
             ...parseFrameSize(options.size),
+            ...text,
         };
     }
     if (options.type === "market") {
         if (options.size !== undefined || options.image !== undefined) {
             throw new Error("Market frames do not accept --size or --image");
         }
+        if (options.text !== undefined) {
+            throw new Error("Market frames do not accept --text");
+        }
         if (options.asset === undefined) {
             throw new Error("Market frames require --asset");
         }

package/dist/command/image.js

@@ -66,4 +66,5 @@ function collect(value, previous) {
 function printGeneratedFrame(frame) {
     console.log(`Generated ${frame.id}\t${frame.name}\timage`);
     console.log(`Path /${frame.id}/`);
+    console.log(`Preview ${frame.previewUrl}`);
 }

package/dist/command/imports.d.ts

@@ -0,0 +1,5 @@
+import { Option } from "commander";
+import { type Imports } from "../v1/schemas.js";
+/** `--import <specifier>=<minx,miny,minz>:<maxx,maxy,maxz>`, repeatable. */
+export declare const importOption: Option;
+export declare function parseImports(values: string[] | undefined): Imports | undefined;

package/dist/command/imports.js

@@ -0,0 +1,34 @@
+import { Option } from "commander";
+import { boundingBoxSchema } from "../v1/schemas.js";
+/** `--import <specifier>=<minx,miny,minz>:<maxx,maxy,maxz>`, repeatable. */
+export const importOption = new Option("--import <specifier=min:max>", "Bounding box for an imported .glts file that does not exist yet, as x,y,z:x,y,z").argParser((value, previous = []) => [...previous, value]);
+export function parseImports(values) {
+    if (values === undefined)
+        return undefined;
+    const imports = {};
+    for (const value of values) {
+        const separator = value.indexOf("=");
+        if (separator === -1)
+            throw new Error(`--import needs <specifier>=<min>:<max>, got ${value}`);
+        const specifier = value.slice(0, separator);
+        const [min, max, ...rest] = value.slice(separator + 1).split(":");
+        if (min === undefined || max === undefined || rest.length > 0) {
+            throw new Error(`--import ${specifier} needs <minx,miny,minz>:<maxx,maxy,maxz>`);
+        }
+        imports[specifier] = boundingBoxSchema.parse({
+            min: corner(min),
+            max: corner(max),
+        });
+    }
+    return imports;
+}
+function corner(value) {
+    const coordinates = value.split(",");
+    const numbers = coordinates.map(Number);
+    if (coordinates.length !== 3 ||
+        coordinates.some((coordinate) => coordinate.trim() === "") ||
+        numbers.some((number) => !Number.isFinite(number))) {
+        throw new Error(`Bounding box corners are three comma-separated numbers, got ${value}`);
+    }
+    return numbers;
+}

package/dist/frame-image.d.ts

@@ -1 +1,2 @@
-export declare function frameImageUrl(viewUrl: string, frameId: string): string;
+/** @deprecated Use framePreviewUrl. */
+export { framePreviewUrl as frameImageUrl } from "./frame-preview.js";

package/dist/frame-image.js

@@ -1,6 +1,2 @@
-import { designIdSchema, httpUrlSchema } from "./v1/schemas.js";
-export function frameImageUrl(viewUrl, frameId) {
-    const view = new URL(httpUrlSchema.parse(viewUrl));
-    const id = designIdSchema.parse(frameId);
-    return new URL(`/${id}.webp`, view.origin).href;
-}
+/** @deprecated Use framePreviewUrl. */
+export { framePreviewUrl as frameImageUrl } from "./frame-preview.js";

package/dist/frame-preview.d.ts

@@ -0,0 +1 @@
+export declare function framePreviewUrl(viewUrl: string, frameId: string): string;

package/dist/frame-preview.js

@@ -0,0 +1,6 @@
+import { designIdSchema, httpUrlSchema } from "./v1/schemas.js";
+export function framePreviewUrl(viewUrl, frameId) {
+    const view = new URL(httpUrlSchema.parse(viewUrl));
+    const id = designIdSchema.parse(frameId);
+    return new URL(`/${id}.webp`, view.origin).href;
+}

package/dist/mcp/file.js

@@ -1,6 +1,6 @@
 import { fileTextSchema } from "../v1/schemas.js";
 import { fileResult, result } from "./result.js";
-import { directoryPathSchema, fileInput, projectInput } from "./schema.js";
+import { directoryPathSchema, fileInput, importsInput, projectInput, } from "./schema.js";
 export function registerFileTools(server, client) {
     server.registerTool("list_design_files", {
         title: "List Design files",
@@ -34,27 +34,42 @@ export function registerFileTools(server, client) {
     });
     server.registerTool("write_design_file", {
         title: "Write Design file",
-        description: "Create or replace one .glts file at a canonical project-absolute path. The path includes the frame ID; this tool does not accept a frame argument.",
-        inputSchema: fileInput.extend({ text: fileTextSchema }),
+        description: "Create or replace one .glts or .md file at a canonical project-absolute path. Every .glts file it imports must exist or be given a bounding box in imports, which creates a placeholder file to replace later. The path includes the frame ID; this tool does not accept a frame argument.",
+        inputSchema: fileInput.extend({
+            text: fileTextSchema,
+            imports: importsInput.optional(),
+        }),
         annotations: {
             readOnlyHint: false,
             destructiveHint: true,
             openWorldHint: true,
         },
-    }, async ({ project, path, text }) => result(await client.filesystem.write({ project, path, text })));
+    }, async ({ project, path, text, imports }) => result(await client.filesystem.write({
+        project,
+        path,
+        text,
+        ...(imports === undefined ? {} : { imports }),
+    })));
     server.registerTool("edit_design_file", {
         title: "Edit Design file",
-        description: "Replace oldText when it occurs exactly once at a canonical project-absolute .glts path. The path includes the frame ID; this tool does not accept a frame argument.",
+        description: "Replace oldText when it occurs exactly once at a canonical project-absolute .glts or .md path. A newly imported .glts file that does not exist needs a bounding box in imports. The path includes the frame ID; this tool does not accept a frame argument.",
         inputSchema: fileInput.extend({
             oldText: fileTextSchema.min(1),
             newText: fileTextSchema,
+            imports: importsInput.optional(),
         }),
         annotations: {
             readOnlyHint: false,
             destructiveHint: true,
             openWorldHint: true,
         },
-    }, async ({ project, path, oldText, newText }) => result(await client.filesystem.edit({ project, path, oldText, newText })));
+    }, async ({ project, path, oldText, newText, imports }) => result(await client.filesystem.edit({
+        project,
+        path,
+        oldText,
+        newText,
+        ...(imports === undefined ? {} : { imports }),
+    })));
     server.registerTool("delete_design_file", {
         title: "Delete Design file",
         description: "Permanently delete one .glts file at a canonical project-absolute path. The path includes the frame ID; this tool does not accept a frame argument.",