@drawcall/design 0.12.3 → 0.12.5

package/dist/v1/contract.d.ts

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

package/dist/v1/contract.js

@@ -1,7 +1,7 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 import { projectFrameLayoutSchema } from "../project-state.js";
-import { cameraPoseSchema, commentBodySchema, commentSchema, createFrameSchema, createCommentSchema, createProjectFromBriefSchema, designIdSchema, fileListSchema, fileMutationSchema, fileSchema, fileTextSchema, frameExportSchema, frameNameSchema, frameSchema, generateImageSchema, projectDirectoryPathSchema, projectFilePathSchema, projectNameSchema, projectSchema, screenshotSchema, userSchema, } from "./schemas.js";
+import { cameraPoseSchema, commentBodySchema, commentSchema, createFrameSchema, createCommentSchema, createProjectFromBriefSchema, designIdSchema, fileListSchema, fileMutationSchema, fileSchema, fileTextSchema, importsSchema, frameExportSchema, frameNameSchema, frameSchema, generateImageSchema, projectDirectoryPathSchema, projectFilePathSchema, projectNameSchema, projectSchema, screenshotSchema, userSchema, } from "./schemas.js";
 const projectInputSchema = z.object({ project: designIdSchema });
 const frameInputSchema = projectInputSchema.extend({ frame: designIdSchema });
 const commentInputSchema = projectInputSchema.extend({
@@ -151,13 +151,17 @@ export const contract = {
             .output(fileSchema),
         write: oc
             .route({ method: "PUT", path: "/projects/{project}/files/{path}" })
-            .input(fileInputSchema.extend({ text: fileTextSchema }))
+            .input(fileInputSchema.extend({
+            text: fileTextSchema,
+            imports: importsSchema.optional(),
+        }))
             .output(fileMutationSchema),
         edit: oc
             .route({ method: "PATCH", path: "/projects/{project}/files/{path}" })
             .input(fileInputSchema.extend({
             oldText: fileTextSchema.min(1),
             newText: fileTextSchema,
+            imports: importsSchema.optional(),
         }))
             .output(fileMutationSchema),
         delete: oc

package/dist/v1/schemas.d.ts

@@ -39,6 +39,18 @@ export declare const projectPathSchema: z.ZodString;
 export declare const projectDirectoryPathSchema: z.ZodUnion<readonly [z.ZodLiteral<"/">, z.ZodString]>;
 export declare const projectFilePathSchema: z.ZodString;
 export declare const fileTextSchema: z.ZodString;
+/** The space a not-yet-written GLTS file will occupy, as its placeholder box. */
+export declare const boundingBoxSchema: z.ZodObject<{
+    min: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    max: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+}, z.core.$strict>;
+/** A static `.glts` import specifier as written in source: relative or project-absolute. */
+export declare const importSpecifierSchema: z.ZodString;
+/** Bounding boxes for imported `.glts` files that do not exist yet, keyed by specifier. */
+export declare const importsSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    min: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    max: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+}, z.core.$strict>>;
 export declare const marketAssetNameSchema: z.ZodString;
 export declare const marketAssetVersionSchema: z.ZodString;
 export declare const marketAssetSchema: z.ZodString;
@@ -189,6 +201,7 @@ export declare const gltsFrameSchema: z.ZodObject<{
     width: z.ZodNumber;
     height: z.ZodNumber;
     viewUrl: z.ZodString;
+    previewUrl: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"glts">;
@@ -216,6 +229,7 @@ export declare const markdownFrameSchema: z.ZodObject<{
     width: z.ZodNumber;
     height: z.ZodNumber;
     viewUrl: z.ZodString;
+    previewUrl: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"markdown">;
@@ -272,6 +286,7 @@ export declare const imageFrameSchema: z.ZodObject<{
     width: z.ZodNumber;
     height: z.ZodNumber;
     viewUrl: z.ZodString;
+    previewUrl: z.ZodString;
     contentRevision: z.ZodOptional<z.ZodNumber>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -310,6 +325,7 @@ export declare const marketFrameSchema: z.ZodObject<{
     width: z.ZodNumber;
     height: z.ZodNumber;
     viewUrl: z.ZodString;
+    previewUrl: z.ZodString;
     contentRevision: z.ZodOptional<z.ZodNumber>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -325,6 +341,7 @@ export declare const frameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     width: z.ZodNumber;
     height: z.ZodNumber;
     viewUrl: z.ZodString;
+    previewUrl: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"glts">;
@@ -351,6 +368,7 @@ export declare const frameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     width: z.ZodNumber;
     height: z.ZodNumber;
     viewUrl: z.ZodString;
+    previewUrl: z.ZodString;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
     type: z.ZodLiteral<"markdown">;
@@ -364,6 +382,7 @@ export declare const frameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     width: z.ZodNumber;
     height: z.ZodNumber;
     viewUrl: z.ZodString;
+    previewUrl: z.ZodString;
     contentRevision: z.ZodOptional<z.ZodNumber>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -401,6 +420,7 @@ export declare const frameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     width: z.ZodNumber;
     height: z.ZodNumber;
     viewUrl: z.ZodString;
+    previewUrl: z.ZodString;
     contentRevision: z.ZodOptional<z.ZodNumber>;
     createdAt: z.ZodString;
     updatedAt: z.ZodString;
@@ -415,6 +435,11 @@ export declare const createGltsFrameSchema: z.ZodObject<{
     type: z.ZodLiteral<"glts">;
     width: z.ZodNumber;
     height: z.ZodNumber;
+    text: z.ZodOptional<z.ZodString>;
+    imports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        min: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        max: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 export declare const createMarkdownFrameSchema: z.ZodObject<{
     project: z.ZodString;
@@ -424,6 +449,7 @@ export declare const createMarkdownFrameSchema: z.ZodObject<{
     type: z.ZodLiteral<"markdown">;
     width: z.ZodNumber;
     height: z.ZodNumber;
+    text: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export declare const createImageFrameSchema: z.ZodObject<{
     project: z.ZodString;
@@ -449,6 +475,11 @@ export declare const createFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"glts">;
     width: z.ZodNumber;
     height: z.ZodNumber;
+    text: z.ZodOptional<z.ZodString>;
+    imports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        min: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        max: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>, z.ZodObject<{
     project: z.ZodString;
     name: z.ZodString;
@@ -457,6 +488,7 @@ export declare const createFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"markdown">;
     width: z.ZodNumber;
     height: z.ZodNumber;
+    text: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>, z.ZodObject<{
     project: z.ZodString;
     name: z.ZodString;
@@ -728,6 +760,8 @@ export type TextFile = z.infer<typeof textFileSchema>;
 export type BinaryFile = z.infer<typeof binaryFileSchema>;
 export type DesignFile = z.infer<typeof fileSchema>;
 export type FileMutation = z.infer<typeof fileMutationSchema>;
+export type BoundingBox = z.infer<typeof boundingBoxSchema>;
+export type Imports = z.infer<typeof importsSchema>;
 export type Screenshot = z.infer<typeof screenshotSchema>;
 export type GltsFrameExport = z.infer<typeof gltsFrameExportSchema>;
 export type MarkdownFrameExport = z.infer<typeof markdownFrameExportSchema>;

package/dist/v1/schemas.js

@@ -77,6 +77,29 @@ export const projectFilePathSchema = projectPathSchema
     .regex(/^\/[a-z0-9]{14}\/.+/, "Project file paths must include a frame ID and filename, for example /a4z8m2q7v9kcde/index.glts")
     .describe("Project-absolute file path including the frame ID, for example /a4z8m2q7v9kcde/index.glts");
 export const fileTextSchema = z.string().max(MAX_FILE_LENGTH);
+const coordinateSchema = z.number().finite();
+const cornerSchema = z.tuple([
+    coordinateSchema,
+    coordinateSchema,
+    coordinateSchema,
+]);
+/** The space a not-yet-written GLTS file will occupy, as its placeholder box. */
+export const boundingBoxSchema = z
+    .object({ min: cornerSchema, max: cornerSchema })
+    .strict()
+    .refine((box) => box.min[0] <= box.max[0] &&
+    box.min[1] <= box.max[1] &&
+    box.min[2] <= box.max[2], {
+    message: "min must not exceed max on any axis",
+});
+/** A static `.glts` import specifier as written in source: relative or project-absolute. */
+export const importSpecifierSchema = z
+    .string()
+    .min(1)
+    .max(1024)
+    .regex(/^(\.\.?\/|\/).*\.glts$/, "Import specifiers are relative or project-absolute .glts paths");
+/** Bounding boxes for imported `.glts` files that do not exist yet, keyed by specifier. */
+export const importsSchema = z.record(importSpecifierSchema, boundingBoxSchema);
 export const marketAssetNameSchema = z
     .string()
     .min(1)
@@ -200,6 +223,7 @@ const frameBaseSchema = z.object({
     width: frameSizeSchema,
     height: frameSizeSchema,
     viewUrl: httpUrlSchema,
+    previewUrl: httpUrlSchema,
     contentRevision: z.number().int().nonnegative().optional(),
     createdAt: z.string().datetime(),
     updatedAt: z.string().datetime(),
@@ -280,6 +304,9 @@ export const createGltsFrameSchema = createFrameBaseSchema
     type: z.literal("glts"),
     width: frameSizeSchema,
     height: frameSizeSchema,
+    /** Initial `index.glts` source, stored with the frame in one operation. */
+    text: fileTextSchema.optional(),
+    imports: importsSchema.optional(),
 })
     .strict();
 export const createMarkdownFrameSchema = createFrameBaseSchema
@@ -287,6 +314,8 @@ export const createMarkdownFrameSchema = createFrameBaseSchema
     type: z.literal("markdown"),
     width: frameSizeSchema,
     height: frameSizeSchema,
+    /** Initial `index.md` source, stored with the frame in one operation. */
+    text: fileTextSchema.optional(),
 })
     .strict();
 export const createImageFrameSchema = createFrameBaseSchema

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawcall/design",
-  "version": "0.12.3",
+  "version": "0.12.5",
   "description": "Typed API and remote CLI for Drawcall Design",
   "repository": {
     "type": "git",

package/skills/drawcall-design/SKILL.md

@@ -16,6 +16,28 @@ Select the project with `-p <project-id>`. File commands take project-absolute p
 ```sh
 npx drawcall design project list
 npx drawcall design -p r6z2n9k4x8m1qc frame list
+npx drawcall design -p r6z2n9k4x8m1qc frame create Racecar --type glts --size 1280x800 --import ./parts/wheel.glts=-0.5,0,-0.5:0.5,1,0.5 --text - <<'GLTS'
+import * as THREE from "three";
+import Wheel from "./parts/wheel.glts";
+
+export default class Racecar extends THREE.Group {
+  constructor() {
+    super();
+    this.add(new Wheel());
+  }
+}
+GLTS
+npx drawcall design -p r6z2n9k4x8m1qc write /a4z8m2q7v9kcde/parts/wheel.glts - <<'GLTS'
+import * as THREE from "three";
+
+export default class Wheel extends THREE.Mesh {
+  constructor() {
+    super(new THREE.TorusGeometry(0.4, 0.12, 16, 48), new THREE.MeshStandardMaterial({ color: 0x222222 }));
+  }
+}
+GLTS
+npx drawcall design -p r6z2n9k4x8m1qc frame preview a4z8m2q7v9kcde
+npx drawcall design -p r6z2n9k4x8m1qc frame screenshot a4z8m2q7v9kcde
 npx drawcall design -p r6z2n9k4x8m1qc ls
 npx drawcall design -p r6z2n9k4x8m1qc read /a4z8m2q7v9kcde/index.glts
 npx drawcall design -p r6z2n9k4x8m1qc edit /a4z8m2q7v9kcde/index.glts 'color: 0xffffff' 'color: 0x000000'
@@ -29,7 +51,7 @@ npx drawcall design -p r6z2n9k4x8m1qc frame generate-image 'Product photograph'
 npx drawcall design -p r6z2n9k4x8m1qc frame edit-image b4z8m2q7v9kcdf --prompt 'Use warmer light' --name 'Warm product photograph' --reference ./lighting.webp
 ```
 
-Comment create and reply text is positional to keep commands compact. Omit it or pass `-` to read the text from stdin. Use `--position-2d x,y` only for normalized image coordinates and `--position-3d x,y,z` only for authoritative GLTS world coordinates.
+`frame create --text`, `write`, comment create, and reply text accept `-` to read the text from stdin; a quoted heredoc keeps multi-line source intact. `--import <specifier>=<min>:<max>` declares the bounding box of an imported `.glts` file that does not exist yet, as `x,y,z:x,y,z`, and may repeat. Run one file write per command invocation, never several in one shell command. Use `--position-2d x,y` only for normalized image coordinates and `--position-3d x,y,z` only for authoritative GLTS world coordinates.
 
 Design is a remote, current-state canvas. Inspect the project and its frames before changing them. Use immutable IDs for every project and frame target; names are mutable labels. In user-facing replies, refer to projects, frames, and other named resources by their current names. Do not expose their IDs unless the user explicitly asks for them; IDs may remain embedded in URLs that link to those resources.
 
@@ -39,13 +61,13 @@ We recommend using Drawcall Market when a design needs 3D assets such as models,
 
 A project is a hosted filesystem at `https://<project-id>.design.drawcallcontent.com/`. Each frame owns one top-level directory, `/<frame-id>`. Files use project-absolute paths that include that directory, for example `/a4z8m2q7v9kcde/index.glts`.
 
-Create frames with an explicit type. Choose the type from the requested artifact, not from the word "frame": use GLTS for a 3D object or scene, Markdown for a formatted text document, image for an existing 2D image, and Market only for an exact public asset reference, `name@version`. GLTS and Markdown frames require a viewport size; image and Market frames derive their canvas size.
+Create frames with an explicit type. Choose the type from the requested artifact, not from the word "frame": use GLTS for a 3D object or scene, Markdown for a formatted text document, image for an existing 2D image, and Market only for an exact public asset reference, `name@version`. GLTS and Markdown frames require a viewport size; image and Market frames derive their canvas size. A GLTS or Markdown frame accepts its root file at creation.
 
 Read a file before editing it. Use a narrow edit for one known change and write a complete file when replacing it. GLTS and Markdown frame files may be created or deleted. Image and Market frame files are read-only.
 
-## Frame images
+## Frame previews
 
-Every frame has a public image at `https://<project-id>.design.drawcallcontent.com/<frame-id>.webp`. This URL represents the current rendered frame whether its type is GLTS, Markdown, image, or Market. Pass it with `--reference` when one frame's appearance should inform another image. A reference may instead be a local PNG, JPEG, or WebP file.
+Every frame has a canonical public WebP preview in `previewUrl` at `https://<project-id>.design.drawcallcontent.com/<frame-id>.webp`, whether its type is GLTS, Markdown, image, or Market. `frame preview <frame-id>` prints that URL. Use `frame screenshot` only when a fresh PNG render is required. Pass a preview URL with `--reference` when one frame's appearance should inform another image. A reference may instead be a local PNG, JPEG, or WebP file.
 
 ## Markdown documents
 
@@ -75,16 +97,27 @@ An error means the requested operation did not happen. Follow its next action wi
 
 A GLTS frame contains only `.glts` files. `index.glts` is its optional root asset; without it the frame renders empty. Every `.glts` file is a trusted TypeScript ESM module that default-exports a no-argument class derived from `THREE.Object3D`. Avoid top-level side effects because reload evaluates the module again. Implement `dispose()` when the asset exclusively owns disposable resources.
 
-Author GLTS scenes top-down: create the root entry scene first, reference the child `.glts` assets it will compose, then implement those children progressively. A missing `.glts` import renders as a glowing marker labeled with its filename until the real file is written, so the completed parts of the scene remain visible. Treat the marker and its console warning as a temporary missing-dependency diagnostic, not as authored content.
+For a 3D object, create the frame with its complete `index.glts` first, giving each imported `.glts` file that does not exist yet a rough bounding box in `imports`, then write the imported files one call at a time, the most visible first, and take a screenshot once they all exist. This order shows the whole object early and keeps every write visible. A file that imports further files declares their boxes the same way.
 
 ```ts
 import * as THREE from "three";
+import Chassis from "./parts/chassis.glts";
 import Wheel from "./parts/wheel.glts";
 
 export default class Racecar extends THREE.Group {
   constructor() {
     super();
-    this.add(new Wheel());
+    this.add(new Chassis());
+    for (const [x, z] of [
+      [-0.8, 1.3],
+      [0.8, 1.3],
+      [-0.8, -1.3],
+      [0.8, -1.3],
+    ]) {
+      const wheel = new Wheel();
+      wheel.position.set(x, 0.4, z);
+      this.add(wheel);
+    }
   }
 }
 ```