@volter/project 0.5.212 → 0.5.213

package/package.json

@@ -2,7 +2,7 @@
   "name": "@volter/project",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.212",
+  "version": "0.5.213",
   "publishConfig": {
     "access": "public"
   },

package/src/adapter/adapter-module.ts

@@ -497,6 +497,9 @@ export interface DocumentEntry {
   readonly source?: SceneSource;
   /** Which finder produced it; absent = the adapter stated it outright. */
   readonly finder?: string;
+  /** `true` = its editor opens it before its file is written, and its first save writes the file: what `editor.open`
+   *  of its id opens when the file is not there yet. */
+  readonly opensUnwritten?: boolean;
 }
 
 const DocumentEntrySchema = z
@@ -509,6 +512,7 @@ const DocumentEntrySchema = z
     reach: SceneReachSchema,
     source: SceneSourceSchema.optional(),
     finder: z.string().min(1).optional(),
+    opensUnwritten: z.boolean().optional(),
   })
   .strict();
 

package/src/adapter/editor-looks.ts

@@ -159,12 +159,14 @@ export interface WorkspaceLayoutContribution {
    *  `'mounts'` (at least one root that plays) or a document kind the
    *  project's table lists. Omitted: every project. */
   readonly requires?: 'mounts' | { readonly documentKind: string };
-  /** Chrome region overrides; omitted regions use their defaults, including hidden workspace tabs. */
+  /** Chrome region overrides; omitted regions take the person's own choice, then their defaults. */
   readonly regions?: WorkspaceLayoutRegions;
   /** The workspace's EDITOR AREAS beside the centre document — a second
    *  editor group holding a `workspace.document` contribution
    *  (`WorkspaceAreaContribution`). Absent: the centre document alone. */
   readonly areas?: WorkspaceArrangement['areas'];
+  /** The document the workspace is for (`WorkspaceArrangement.document`). */
+  readonly document?: WorkspaceArrangement['document'];
 }
 
 /**

package/src/adapter/workspace-arrangement.ts

@@ -69,4 +69,8 @@ export interface WorkspaceArrangement {
   /** The workspace's EDITOR AREAS beside the centre document — see
    *  {@link WorkspaceAreaContribution}. Absent: the centre document alone. */
   readonly areas?: readonly WorkspaceAreaContribution[];
+  /** The document the workspace is FOR, shown in the centre as it becomes active: the id of a workspace document a
+   *  package registers (`workspace:ui-components`, the UI board). Its package activates on `onDocument:<id>`, so the
+   *  document opens once it is registered. Absent: the centre keeps the document the person has open. */
+  readonly document?: string;
 }

package/src/manifest/locate.ts

@@ -1,10 +1,9 @@
 // Finding the project manifest ON DISK. There is ONE filename (`./filename.ts`).
 //
 // Deliberately dependency-light — `node:fs` + `node:path` + `./filename` and
-// NOTHING else (no Zod, no `./load`). Several callers are explicitly
-// schema-free by design (`packages/editor-core/server/project-root-surface.ts`,
-// `packages/editor-react/serving/ui-oid-plugin.ts`) and must be able to locate a
-// manifest without dragging the validator in.
+// NOTHING else (no Zod, no `./load`). Its callers (the editor's server, the
+// live session and a product's CLI) locate a manifest without dragging the
+// validator in.
 
 import { existsSync } from 'node:fs';
 import { join } from 'node:path';