@tileflow/vite 0.1.0-alpha.14 → 0.1.0-alpha.17

package/README.md

@@ -3,13 +3,23 @@
 Vite plugin for local Tileflow style development and static build artifacts.
 
 ```ts
-import react from "@vitejs/plugin-react";
-import { tileflow } from "@tileflow/vite";
-import { defineConfig } from "vite";
+import react from '@vitejs/plugin-react';
+import {defineConfig} from 'vite';
+import {tileflow} from '@tileflow/vite';
 
 export default defineConfig({
   plugins: [react(), tileflow()],
 });
 ```
 
+The Vite process is the only application server needed. It watches config, transitive imports, and
+local icons, serves the Tileflow manifest/styles/sprites, and reloads from the latest valid
+generation. To capture an application scene, keep `vite` running and point the short-lived headless
+command at that same loopback origin; do not start `tileflow dev`:
+
+```sh
+npm run dev
+TILEFLOW_APP_ORIGIN=http://127.0.0.1:5173 npm exec --no -- tileflow capture app-desktop
+```
+
 Docs: https://tileflow.dev/docs

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import { Plugin } from 'vite';
 
 type TileflowVitePluginOptions = {
+    apiBaseUrl?: string;
     base?: string;
     config?: string;
     emitBuildArtifacts?: boolean;
-    tileBaseUrl?: string;
 };
 declare function tileflow(options?: TileflowVitePluginOptions): Plugin;
 

package/dist/index.js

@@ -1,13 +1,13 @@
 // src/index.ts
 import { resolve } from "path";
 import {
+  createTileflowArtifactSession,
   createTileflowBuildArtifacts,
   createTileflowDevRequestHandler,
   createTileflowNodeRequest,
   defaultTileflowConfigPath,
   getTileflowAssetBasePath,
   getTileflowAssetFileName,
-  getTileflowWatchPaths,
   isTileflowRequestUrl,
   joinTileflowPublicUrl,
   normalizeTileflowBasePath,
@@ -26,22 +26,36 @@ function tileflow(options = {}) {
       const root = server.config.root;
       const configFile = resolve(root, configPath);
       const watchedIconPaths = /* @__PURE__ */ new Set();
-      const handler = createTileflowDevRequestHandler({
-        basePath,
+      const sessionPromise = createTileflowArtifactSession({
+        assetBaseUrl: basePath,
         config: configPath,
         cwd: root,
-        onError(error) {
-          const message = error instanceof Error ? error.message : "Unknown Tileflow error";
-          server.config.logger.error(`[tileflow] ${message}`);
-        },
-        tileBaseUrl: options.tileBaseUrl
+        styleBaseUrl: basePath,
+        apiBaseUrl: options.apiBaseUrl,
+        watch: false
+      });
+      const handlerPromise = sessionPromise.then((session) => {
+        session.subscribe((state) => {
+          if (state.status === "ready" && state.generation > 1) {
+            server.ws.send({ type: "full-reload" });
+          }
+        });
+        return createTileflowDevRequestHandler({
+          basePath,
+          config: configPath,
+          cwd: root,
+          onError(error) {
+            const message = error instanceof Error ? error.message : "Unknown Tileflow error";
+            server.config.logger.error(`[tileflow] ${message}`);
+          },
+          session,
+          apiBaseUrl: options.apiBaseUrl
+        });
       });
       const refreshWatchedIconPaths = async () => {
         try {
-          const watchPaths = await getTileflowWatchPaths({
-            config: configPath,
-            cwd: root
-          });
+          const session = await sessionPromise;
+          const watchPaths = session.getLastGoodArtifacts()?.watchPaths ?? [];
           for (const watchPath of watchPaths) {
             if (!watchedIconPaths.has(watchPath)) {
               server.watcher.add(watchPath);
@@ -54,20 +68,20 @@ function tileflow(options = {}) {
         }
       };
       const reloadIfTileflowInput = (file) => {
-        if (file === configFile) {
-          void refreshWatchedIconPaths();
-          server.ws.send({ type: "full-reload" });
-          return;
-        }
-        if (isWatchedIconPath(file, watchedIconPaths)) {
-          server.ws.send({ type: "full-reload" });
-        }
+        if (!isTileflowInputPath(file, root, configFile, watchedIconPaths)) return;
+        void sessionPromise.then(async (session) => {
+          await session.refresh("vite watcher");
+          await refreshWatchedIconPaths();
+        });
       };
       server.watcher.add(configFile);
       void refreshWatchedIconPaths();
       server.watcher.on("add", reloadIfTileflowInput);
       server.watcher.on("change", reloadIfTileflowInput);
       server.watcher.on("unlink", reloadIfTileflowInput);
+      server.httpServer?.once("close", () => {
+        void sessionPromise.then((session) => session.close());
+      });
       server.middlewares.use(async (request, response, next) => {
         if (!isTileflowRequestUrl(request.url, basePath)) {
           next();
@@ -75,7 +89,7 @@ function tileflow(options = {}) {
         }
         try {
           const tileflowRequest = createTileflowNodeRequest(request);
-          const tileflowResponse = await handler(tileflowRequest);
+          const tileflowResponse = await (await handlerPromise)(tileflowRequest);
           await writeTileflowNodeResponse(response, tileflowResponse);
         } catch (error) {
           next(error);
@@ -95,7 +109,7 @@ function tileflow(options = {}) {
         config: configPath,
         cwd: config.root,
         styleBaseUrl: joinTileflowPublicUrl(config.base, basePath),
-        tileBaseUrl: options.tileBaseUrl
+        apiBaseUrl: options.apiBaseUrl
       });
       const assetBase = getTileflowAssetBasePath(basePath);
       this.emitFile({
@@ -133,6 +147,18 @@ function isWatchedIconPath(file, watchedIconPaths) {
   }
   return false;
 }
+function isTileflowInputPath(file, root, configFile, watchedIconPaths) {
+  if (file === configFile || isWatchedIconPath(file, watchedIconPaths)) return true;
+  const normalizedFile = normalizePath(file);
+  const normalizedRoot = normalizePath(root).replace(/\/+$/, "");
+  if (!normalizedFile.startsWith(`${normalizedRoot}/`)) return false;
+  if (/\/(?:node_modules|\.git|\.tileflow|dist|build|coverage|\.next|\.cache|\.turbo)\//.test(
+    normalizedFile
+  )) {
+    return false;
+  }
+  return /\.(?:cjs|cts|js|json|mjs|mts|ts|tsx)$/.test(normalizedFile);
+}
 function normalizePath(value) {
   return value.replace(/\\/g, "/");
 }

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@tileflow/vite",
-  "version": "0.1.0-alpha.14",
+  "version": "0.1.0-alpha.17",
   "description": "Vite plugin for Tileflow map style development and static artifacts.",
   "type": "module",
   "sideEffects": false,
   "homepage": "https://tileflow.dev",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tileflow/tileflow.git",
+    "url": "git+https://github.com/tileflow/tileflow-sdk.git",
     "directory": "packages/vite"
   },
   "bugs": {
-    "url": "https://github.com/tileflow/tileflow/issues"
+    "url": "https://github.com/tileflow/tileflow-sdk/issues"
   },
   "keywords": [
     "tileflow",
@@ -36,7 +36,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@tileflow/dev": "0.1.0-alpha.14"
+    "@tileflow/dev": ">=0.1.0-alpha.18 <0.1.0-beta.0"
   },
   "peerDependencies": {
     "vite": ">=5"