tileflow 0.1.0-alpha.16 → 0.1.0-alpha.18

package/README.md

@@ -23,7 +23,7 @@ executable. With another package manager, use its local-execution command and th
 do not add a second lockfile or rely on a globally installed CLI.
 
 `init` creates a singular `tileflow.config.ts` extending the official Streets map. `preview` opens
-Map DevTools with that map, live reload, rendered-feature inspection, compiler attribution, zoom
+Inspector with that map, live reload, rendered-feature inspection, compiler attribution, zoom
 curves, a sprite atlas, scene selection, saved captures, and before/after review.
 
 Local validation, compilation, and asset preparation require no account or API key. Preview and
@@ -56,7 +56,7 @@ workspaces are advanced repository orchestration, not a second application autho
 Use `describe` for bounded language discovery (`describe themes --json` lists palette requirements
 and optional time-of-day composition), `inspect` for configuration and data, `capture`
 for reproducible evidence, and `compare` for saved captures, semantic edits, styles, references or
-baselines. `preview` opens Map DevTools. These tools work in independent projects with
+baselines. `preview` opens Inspector. These tools work in independent projects with
 custom maps and data; official maps are optional.
 
 See the [map authoring workflow](https://github.com/tileflow/tileflow-sdk/blob/main/packages/cli/docs/map-authoring.md)
@@ -69,31 +69,31 @@ it does not implicitly expose a public listener. `--theme <name>` selects a conc
 `--scene <name>` selects a committed standalone scene.
 
 Run `npx tileflow preview` from your project directory to load `tileflow.config.ts`, start the
-watched server, and automatically open Map DevTools in your default browser once the server is
+watched server, and automatically open Inspector in your default browser once the server is
 listening. Use `--config <path>` for another config or `--no-open` to start without opening a tab.
 `--json` and `--renderer native` also keep the browser closed. The CLI always prints the local URL
 in ordinary web preview output, so you can open it manually if browser launch is unavailable.
 
-Opening Map DevTools through another loopback name, such as `localhost` instead of `127.0.0.1`,
+Opening Inspector through another loopback name, such as `localhost` instead of `127.0.0.1`,
 redirects to the **Local** origin printed by the CLI, preserving camera and theme query parameters.
 This keeps the map, palette controls, and workbench API on the same origin.
 
 Run from the project directory and keep selected configs inside it, so capture commands copied from
-Map DevTools resolve the same files. The project itself can live anywhere, independently of this SDK.
+Inspector resolve the same files. The project itself can live anywhere, independently of this SDK.
 
-The default is one Map DevTools pane, one watched artifact session, and one map renderer. Choose a
+The default is one Inspector pane, one watched artifact session, and one map renderer. Choose a
 map, theme or configured scene in **Controls**. Map and theme pickers appear when there are multiple choices. **Compare → Compare live maps** adds a reference from the current
 project; `--against-*` also supports a reference from another config. The native renderer retains its assets-only
 preview endpoint.
 
-Compare two configs live in Map DevTools:
+Compare two configs live in Inspector:
 
 ```sh
 npx tileflow preview --config candidate/tileflow.config.ts --against-config reference/tileflow.config.ts
 ```
 
-Map DevTools shares a camera across side-by-side, split, overlay, or blink views. Its inspector
-shows bounded feature and compiler information; invalid edits keep the last valid generation.
+Inspector shares a camera across side-by-side, split, overlay, or blink views. Its inspection panels
+show bounded feature and compiler information; invalid edits keep the last valid generation.
 **Capture as reference** saves a starting point. After editing, **Capture & compare** reuses its
 camera and frame to review the change. The selected reference lasts for this browser session.
 
@@ -112,7 +112,7 @@ npx tileflow inspect session --url http://127.0.0.1:3333 --json
 
 Use the origin printed by your running preview. This reads browser observations, including their
 age and stale flag; exact source lines and token ownership are not inferred. See the
-[Map DevTools workflow](https://github.com/tileflow/tileflow-sdk/blob/main/packages/cli/docs/map-authoring.md#work-with-a-person-and-an-agent)
+[Inspector workflow](https://github.com/tileflow/tileflow-sdk/blob/main/packages/cli/docs/map-authoring.md#work-with-a-person-and-an-agent)
 for storage and context bounds.
 
 `--api-base-url` or `TILEFLOW_API_URL` changes the API origin used by the official preview sources.

package/dist/index.js

@@ -7329,7 +7329,7 @@ function registerModelCommands(program2, dependencies) {
       return emitFailure(
         options.json,
         "no_building_models",
-        "No building models were found. A building model is a .glb whose materials name its parts: surface, secondary, glass, accent and roof."
+        "No building models were found. A building model is a .glb whose materials name its parts, such as surface, glass, roof or water; one whose materials name only bark, leaves, fronds or stem is a tree."
       );
     }
     const authority = await resolveTeamAuthority(options, ["models:write"], dependencies);
@@ -7592,7 +7592,7 @@ async function prepareFromPaths(paths) {
       for (const name of selected)
         if (!prepared.buildings[name])
           throw new Error(
-            `${display}/${name}.glb is not a building model: its materials must name its parts (surface, secondary, glass, accent, roof).`
+            `${display}/${name}.glb is not a building model: its materials must name its parts, such as surface, glass, roof or water, and not only a tree's.`
           );
     }
   }
@@ -9748,9 +9748,9 @@ function createWorkbenchService(options) {
     if (path === "/capture") {
       const { side: id, generation, name, definition } = captureInput.parse(input);
       if (definition.target?.kind === "application")
-        throw new Error("Map DevTools captures require a map scene.");
+        throw new Error("Inspector captures require a map scene.");
       const side = options.sides[id];
-      if (!side) throw new Error("Unknown Map DevTools side.");
+      if (!side) throw new Error("Unknown Inspector side.");
       const state = side.session.getState();
       if (state.status !== "ready" || state.generation !== generation)
         return json(
@@ -9807,10 +9807,10 @@ function createWorkbenchService(options) {
       const url = new URL(request.url);
       if (url.origin !== options.origin || request.headers.has("origin") && request.headers.get("origin") !== options.origin || request.headers.get("sec-fetch-site") === "cross-site")
         return json(
-          { code: "ORIGIN_MISMATCH", message: "Use Map DevTools from its local origin." },
+          { code: "ORIGIN_MISMATCH", message: "Use Inspector from its local origin." },
           403
         );
-      if (closed) return json({ code: "SESSION_CLOSED", message: "Map DevTools has stopped." }, 503);
+      if (closed) return json({ code: "SESSION_CLOSED", message: "Inspector has stopped." }, 503);
       const path = url.pathname.slice(prefix.length);
       try {
         if (request.method === "GET") {
@@ -9863,7 +9863,7 @@ function createWorkbenchService(options) {
               }
             });
           }
-          return json({ code: "NOT_FOUND", message: "Unknown Map DevTools endpoint." }, 404);
+          return json({ code: "NOT_FOUND", message: "Unknown Inspector endpoint." }, 404);
         }
         if (request.method !== "POST")
           return json({ code: "METHOD_NOT_ALLOWED", message: "Use GET or POST." }, 405);
@@ -9875,14 +9875,14 @@ function createWorkbenchService(options) {
         const body = await readBody(request);
         if (path === "/context") {
           const { client, ...value } = contextInput.parse(body);
-          if (!options.sides[value.side]) throw new Error("Unknown Map DevTools side.");
+          if (!options.sides[value.side]) throw new Error("Unknown Inspector side.");
           contexts.delete(client);
           contexts.set(client, { ...value, updatedAt: (/* @__PURE__ */ new Date()).toISOString() });
           if (contexts.size > 8) contexts.delete(contexts.keys().next().value);
           return json({ saved: true });
         }
         if (path !== "/capture" && path !== "/compare" && path !== "/captures/delete")
-          return json({ code: "NOT_FOUND", message: "Unknown Map DevTools action." }, 404);
+          return json({ code: "NOT_FOUND", message: "Unknown Inspector action." }, 404);
         if (pending)
           return json(
             {
@@ -9898,7 +9898,7 @@ function createWorkbenchService(options) {
           pending = void 0;
         }
       } catch (error) {
-        const message = error instanceof Error ? error.message : "Map DevTools operation failed.";
+        const message = error instanceof Error ? error.message : "Inspector operation failed.";
         return json({ code: "WORKBENCH_OPERATION_FAILED", message: message.slice(0, 1500) }, 400);
       }
     },
@@ -9922,7 +9922,7 @@ async function readBody(request) {
       bytes += value.byteLength;
       if (bytes > 64 * 1024) {
         await reader.cancel();
-        throw new Error("Map DevTools request exceeds 64 KiB.");
+        throw new Error("Inspector request exceeds 64 KiB.");
       }
       chunks.push(value);
     }
@@ -9942,15 +9942,15 @@ function json(value, status = 200) {
   });
 }
 function registerWorkbenchInspection(inspect) {
-  inspect.command("session").description("Read the active local Map DevTools context and capabilities").option("--url <origin>", "local Map DevTools origin", "http://127.0.0.1:3333").option("--json", "print the versioned context document").action(async (options) => {
+  inspect.command("session").description("Read the active local Inspector context and capabilities").option("--url <origin>", "local Inspector origin", "http://127.0.0.1:3333").option("--json", "print the versioned context document").action(async (options) => {
     try {
       const url = new URL(options.url);
       if (!["127.0.0.1", "localhost", "[::1]"].includes(url.hostname) || url.protocol !== "http:" || url.username || url.password)
-        throw new Error("--url must identify a local Map DevTools HTTP server.");
+        throw new Error("--url must identify a local Inspector HTTP server.");
       const response = await fetch(new URL(`${prefix}/context`, url.origin), {
         signal: AbortSignal.timeout(5e3)
       });
-      if (!response.ok) throw new Error(`Map DevTools returned HTTP ${response.status}.`);
+      if (!response.ok) throw new Error(`Inspector returned HTTP ${response.status}.`);
       const document = await response.json();
       console.log(
         JSON.stringify(
@@ -10291,7 +10291,7 @@ program.command("build").description("Generate static Tileflow styles").option("
     printKeyValue("Output", pathLabel(resolve12(process.cwd(), options.out)));
   }
 );
-program.command("preview").description("Open Map DevTools with inspection and optional comparison").option("-c, --config <path>", "config path", defaultConfigPath).option("--against-config <path>", "second config for live comparison in Map DevTools").option("--against-map <name>", "map on the right; defaults to --map").option("--against-scene <name>", "committed standalone scene on the right").option("--against-theme <name>", "concrete theme on the right; defaults to --theme").option("--host <host>", "bind host: an explicit IP address or localhost", defaultTileflowDevHost).option("--map <name>", "preview one configured map").option("--theme <name>", "preview one concrete theme; defaults to the map default").option("--renderer <renderer>", "artifact renderer: web or native", "web").option("-p, --port <port>", "preview port", "3333").option("--no-open", "start Map DevTools without opening the browser").option("--scene <name>", "preview one committed standalone map scene").option(
+program.command("preview").description("Open Inspector with inspection and optional comparison").option("-c, --config <path>", "config path", defaultConfigPath).option("--against-config <path>", "second config for live comparison in Inspector").option("--against-map <name>", "map on the right; defaults to --map").option("--against-scene <name>", "committed standalone scene on the right").option("--against-theme <name>", "concrete theme on the right; defaults to --theme").option("--host <host>", "bind host: an explicit IP address or localhost", defaultTileflowDevHost).option("--map <name>", "preview one configured map").option("--theme <name>", "preview one concrete theme; defaults to the map default").option("--renderer <renderer>", "artifact renderer: web or native", "web").option("-p, --port <port>", "preview port", "3333").option("--no-open", "start Inspector without opening the browser").option("--scene <name>", "preview one committed standalone map scene").option(
   "--api-base-url <url>",
   "Tileflow API base URL used to resolve official map assets",
   process.env.TILEFLOW_API_URL ?? defaultApiUrl
@@ -10473,7 +10473,7 @@ program.command("preview").description("Open Map DevTools with inspection and op
           previewUrl: workbenchPreviewUrl(previewBasePath, options),
           sidecarUrl: `${previewBasePath}/__inspection/${selectedPreview?.mapName ?? "pending"}/${selectedPreview?.themeName ?? "pending"}.json`
         },
-        title: "Tileflow Map DevTools",
+        title: "Tileflow Inspector",
         workbench
       });
       let invalidSinceLastReady = false;
@@ -10543,7 +10543,7 @@ program.command("preview").description("Open Map DevTools with inspection and op
             }
             logMuted("Metro remains the JavaScript development server. Press Ctrl+C to stop.");
           } else {
-            logSuccess("Tileflow Map DevTools is running and watching for changes.");
+            logSuccess("Tileflow Inspector is running and watching for changes.");
             printKeyValue("Local", link(origin));
             printKeyValue("Config", pathLabel(options.config));
             if (options.map) printKeyValue("Map", options.map);
@@ -11301,7 +11301,7 @@ async function runTileflowComparisonPreview(options, address) {
           }),
           sidecarUrl: `${rightBasePath}/__inspection/${rightPreview.mapName}/${rightPreview.themeName}.json`
         },
-        title: "Tileflow Map DevTools"
+        title: "Tileflow Inspector"
       });
       await new Promise((resolveListening, rejectListening) => {
         const createdServer = serve(
@@ -11317,7 +11317,7 @@ async function runTileflowComparisonPreview(options, address) {
       });
       serverStarted = true;
       if (!options.json) {
-        logSuccess("Tileflow Map DevTools is running and watching both configs.");
+        logSuccess("Tileflow Inspector is running and watching both configs.");
         printKeyValue("Local", link(origin));
         printKeyValue("Left", `${leftPreview.label} \xB7 ${pathLabel(options.config)}`);
         printKeyValue("Right", `${rightPreview.label} \xB7 ${pathLabel(rightConfig)}`);

package/docs/local-visual-feedback.md

@@ -54,7 +54,7 @@ export default defineMap({
 cartographic compiler; tooling supplies the exported map ID when it normalizes a scene internally.
 Every scene stores a concrete theme; omission and browser-only `system` are invalid.
 
-### Live comparison in Map DevTools
+### Live comparison in Inspector
 
 Use the ordinary preview server with a right-hand selection to compare two maps or themes while
 authoring:
@@ -71,7 +71,7 @@ npx tileflow preview \
   --against-config ./reference.config.ts --against-map reference
 ```
 
-Any `--against-*` option opens Map DevTools in comparison mode. Both previews remain same-origin and share
+Any `--against-*` option opens Inspector in comparison mode. Both previews remain same-origin and share
 one synchronized camera. The toolbar switches between side-by-side, split, opacity overlay, and
 blink modes; the selected mode, camera, split, opacity, and active interaction side survive in the
 URL. Each config has its own watched, last-known-good session, so an invalid edit shows bounded
@@ -81,7 +81,7 @@ Enable **Inspect** and click a rendered feature to see its bounded feature data,
 zoom-curve samples, and compiler contribution sidecar. The sprite gallery shows the compiled atlas,
 not source directories. **Copy scene** produces a concrete-theme scene for the current camera and
 viewport; **Copy command** produces the corresponding capture command. The inspector sidecar exists
-only in memory in the local Map DevTools session and is not emitted by `tileflow build`.
+only in memory in the local Inspector session and is not emitted by `tileflow build`.
 
 ### Reproducible two-style review
 

package/docs/map-authoring.md

@@ -9,14 +9,14 @@ Discovery and saved-capture comparison also work without a config.
 
 Use four primary command groups for map development:
 
-| Command    | Purpose                                                                                                                                |
-| ---------- | -------------------------------------------------------------------------------------------------------------------------------------- |
-| `describe` | Discover the generated language and query one domain or schema fragment.                                                               |
-| `inspect`  | Read resolved configuration; `compiled`, `features`, `icons`, and `tileset` inspect output/data; `session` reads Map DevTools context. |
-| `capture`  | Render reproducible evidence and return a reusable capture ID.                                                                         |
-| `compare`  | Compare saved capture IDs; `configs`, `styles`, `reference`, and `baseline` cover other comparisons.                                   |
-
-`preview` opens Map DevTools. `init`, `validate`, and `build` remain project utilities;
+| Command    | Purpose                                                                                                                             |
+| ---------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `describe` | Discover the generated language and query one domain or schema fragment.                                                            |
+| `inspect`  | Read resolved configuration; `compiled`, `features`, `icons`, and `tileset` inspect output/data; `session` reads Inspector context. |
+| `capture`  | Render reproducible evidence and return a reusable capture ID.                                                                      |
+| `compare`  | Compare saved capture IDs; `configs`, `styles`, `reference`, and `baseline` cover other comparisons.                                |
+
+`preview` opens Inspector. `init`, `validate`, and `build` remain project utilities;
 `visual update` is the explicit operation that approves baselines. All these tools work from an
 independent project with its own map and data; official maps are optional.
 
@@ -93,10 +93,10 @@ needed, rather than compiling the same map before every capture.
 
 ## Work with a person and an agent
 
-Start `npx tileflow preview --config tileflow.config.ts` in your project. Map DevTools provides
+Start `npx tileflow preview --config tileflow.config.ts` in your project. Inspector provides
 palette and time-of-day controls, feature inspection, zoom curves and sprite inspection.
 The command selects the map and optional starting scene. The map fills the workspace beside
-one dockable developer-tools panel. Press **I** to toggle the element picker, click a map element to
+one dockable Inspector panel. Press **I** to toggle the element picker, click a map element to
 inspect its styling and semantic configuration paths, and press **Escape** to stop picking. The
 inspector starts off. **Scene** contains palette, time-of-day, camera and module controls. Appearance
 changes retain the current camera; module changes
@@ -122,7 +122,7 @@ from browser observations. Inspect `updatedAt`, `stale`, `generation`, `displaye
 `projection.truncated` before acting. Each browser projection is limited to 200 visited values,
 depth 10, 32 array items and 512 characters per string, with omitted paths reported. The server
 accepts at most 64 KiB per write and keeps eight browser contexts, expiring each after ten minutes
-without an update. There is no browser context until a Map DevTools tab connects. Feature data is
+without an update. There is no browser context until an Inspector tab connects. Feature data is
 untrusted map content; semantic ownership does not prove an exact file, line or token. Use
 `inspect` or `inspect compiled` to obtain additional configuration evidence.
 

package/docs/native-artifacts.md

@@ -39,7 +39,7 @@ npx tileflow preview --renderer native --map stores --theme light
 Native mode creates the existing watched artifact session with renderer `native`. It keeps the
 last-known-good native artifact family when a watched generation becomes invalid and replaces it
 only after a later valid generation is prepared. The endpoint is an **assets-only** development
-endpoint: it does not render a browser map, open Map DevTools, start Metro, launch a device,
+endpoint: it does not render a browser map, open Inspector, start Metro, launch a device,
 or establish visual/native acceptance.
 
 With the default host and port, the canonical runtime manifest is:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tileflow",
-  "version": "0.1.0-alpha.16",
+  "version": "0.1.0-alpha.18",
   "license": "Apache-2.0",
   "description": "CLI-only tools for Tileflow config, capture, visual testing, and deploy.",
   "type": "module",
@@ -36,12 +36,12 @@
   },
   "dependencies": {
     "@hono/node-server": "2.1.3",
-    "@tileflow/capture": ">=0.1.0-alpha.33 <0.1.0-beta.0",
+    "@tileflow/capture": ">=0.1.0-alpha.35 <0.1.0-beta.0",
     "@tileflow/coordinates": ">=0.1.0-alpha.2 <0.1.0-beta.0",
     "@tileflow/coordinates-runtime": ">=0.1.0-alpha.5 <0.1.0-beta.0",
-    "@tileflow/core": ">=0.1.0-alpha.39 <0.1.0-beta.0",
-    "@tileflow/dev": ">=0.1.0-alpha.36 <0.1.0-beta.0",
-    "@tileflow/maps": ">=0.1.0-alpha.13 <0.1.0-beta.0",
+    "@tileflow/core": ">=0.1.0-alpha.41 <0.1.0-beta.0",
+    "@tileflow/dev": ">=0.1.0-alpha.38 <0.1.0-beta.0",
+    "@tileflow/maps": ">=0.1.0-alpha.15 <0.1.0-beta.0",
     "commander": "^15.0.0",
     "hono": "4.13.13",
     "picocolors": "^1.1.1",