@wildwinter/app-shell 0.25.0 → 0.27.0

package/dist/session.cjs

@@ -24,16 +24,15 @@ function createProjectSession(opts) {
       }
       if (session !== void 0) opts.close?.(session);
       session = opened.session;
-      opts.store.touchProject(opened.root);
+      opts.store.touchProject(opened.root, opened.name);
       invalidateSatellites();
       opts.refreshMenu?.();
       return opened.reply;
     },
     isKnownPath(path$1) {
       const s = opts.store.get();
-      const known = new Set(
-        [s.lastProject, ...s.recents].filter((p) => typeof p === "string" && p !== "").map((p) => path.resolve(p))
-      );
+      const paths = [s.lastProject, ...s.recents.map((r) => r.path)];
+      const known = new Set(paths.filter((p) => !!p).map((p) => path.resolve(p)));
       return known.has(path.resolve(path$1));
     },
     addSatellite(satellite) {

package/dist/session.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/session.ts"],"names":["path","resolve"],"mappings":";;;;;AAwGO,SAAS,qBAA2B,IAAA,EAAyD;AAClG,EAAA,IAAI,OAAA;AACJ,EAAA,MAAM,aAA0B,CAAC,GAAI,IAAA,CAAK,UAAA,IAAc,EAAG,CAAA;AAE3D,EAAA,MAAM,uBAAuB,MAAY;AACvC,IAAA,KAAA,MAAW,OAAO,UAAA,EAAY;AAC5B,MAAA,GAAA,CAAI,KAAA,IAAQ;AACZ,MAAA,MAAM,GAAA,GAAM,IAAI,MAAA,EAAO;AACvB,MAAA,IAAI,GAAA,IAAO,CAAC,GAAA,CAAI,WAAA,IAAe,GAAA,CAAI,WAAA,CAAY,IAAA,CAAK,GAAA,CAAI,OAAO,CAAA;AAAA,IACjE;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,SAAS,MAAM,OAAA;AAAA,IAEf,OAAO,IAAA,EAAM;AACX,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA;AAC7B,MAAA,IAAI,WAAW,MAAA,EAAQ;AACrB,QAAA,IAAA,CAAK,KAAA,CAAM,cAAc,IAAI,CAAA;AAC7B,QAAA,IAAA,CAAK,WAAA,IAAc;AACnB,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,IAAI,OAAA,KAAY,MAAA,EAAW,IAAA,CAAK,KAAA,GAAQ,OAAO,CAAA;AAC/C,MAAA,OAAA,GAAU,MAAA,CAAO,OAAA;AACjB,MAAA,IAAA,CAAK,KAAA,CAAM,YAAA,CAAa,MAAA,CAAO,IAAI,CAAA;AACnC,MAAA,oBAAA,EAAqB;AACrB,MAAA,IAAA,CAAK,WAAA,IAAc;AACnB,MAAA,OAAO,MAAA,CAAO,KAAA;AAAA,IAChB,CAAA;AAAA,IAEA,YAAYA,MAAA,EAAM;AAChB,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,GAAA,EAAI;AACzB,MAAA,MAAM,QAAQ,IAAI,GAAA;AAAA,QAChB,CAAC,EAAE,WAAA,EAAa,GAAG,EAAE,OAAO,CAAA,CAAE,OAAO,CAAC,CAAA,KAAmB,OAAO,CAAA,KAAM,QAAA,IAAY,MAAM,EAAE,CAAA,CAAE,IAAI,CAAC,CAAA,KAAMC,YAAA,CAAQ,CAAC,CAAC;AAAA,OACnH;AACA,MAAA,OAAO,KAAA,CAAM,GAAA,CAAIA,YAAA,CAAQD,MAAI,CAAC,CAAA;AAAA,IAChC,CAAA;AAAA,IAEA,aAAa,SAAA,EAAW;AACtB,MAAA,UAAA,CAAW,KAAK,SAAS,CAAA;AACzB,MAAA,OAAO,MAAM;AACX,QAAA,MAAM,CAAA,GAAI,UAAA,CAAW,OAAA,CAAQ,SAAS,CAAA;AACtC,QAAA,IAAI,CAAA,IAAK,CAAA,EAAG,UAAA,CAAW,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,MACpC,CAAA;AAAA,IACF,CAAA;AAAA,IAEA;AAAA,GACF;AACF","file":"session.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// The project session: what happens around opening a project, as opposed to\n// the opening itself.\n//\n// Both apps have a function - `openAt` here, `openAndRecord` there - and under\n// two different names they do the same six things in the same order:\n//\n//   1. Ask the app to open it, which is the only app-specific step.\n//   2. On failure, drop it from recents (a project that has moved should stop\n//      being offered) and rebuild the menu.\n//   3. On success, finish with the outgoing session.\n//   4. Record the opened ROOT in the store, which also clears the remembered\n//      place when it is a different project.\n//   5. Invalidate everything main was caching FOR THE OLD PROJECT, and tell\n//      each satellite tool window that the ground moved.\n//   6. Rebuild the menu, so File > Open Recent is current.\n//\n// Step 5 is the one worth extracting on its own. Both apps hand-wire it per\n// window - a cached result nulled, then `if (win && !win.isDestroyed())\n// win.webContents.send(...)` - Storyletter three times, Patterpad twice, and\n// every new tool window is another chance to forget one and leave a window\n// describing a project that is no longer open. Registering a satellite once\n// makes forgetting it impossible.\n//\n// It also carries `isKnownPath`, which only Patterpad had and which is a real\n// guard rather than a tidiness: a renderer must not be able to name an\n// arbitrary directory and have main open it. Fresh paths enter through the\n// native dialogs, which run in main where the person actually chose them;\n// everything else must already be in recents.\n//\n// Electron-free: a satellite is anything with the two methods it needs, which\n// a BrowserWindow satisfies and a test can fake.\n// ---------------------------------------------------------------------------\n\nimport { resolve } from \"node:path\";\n\n/** As much of a BrowserWindow as this file has any business knowing. */\nexport interface SatelliteWindow {\n  isDestroyed(): boolean;\n  webContents: { send(channel: string, ...args: unknown[]): void };\n}\n\n/**\n * A tool window that shows something about the open project, and any state\n * main is holding on its behalf.\n */\nexport interface Satellite {\n  /** Looked up each time rather than held: these windows open and close. */\n  window: () => SatelliteWindow | undefined | null;\n  /** What to send when the project changes. The window re-fetches; it is a\n   *  nudge, not a payload, because by then the new project is already open. */\n  channel: string;\n  /** Drop what main was caching for the old project - a coverage report, a\n   *  search anchor. Called before the window is told. */\n  clear?: () => void;\n}\n\n/** The slice of the app store this needs. Structural, so the real store fits\n *  without dragging its generic parameters in here. */\nexport interface SessionStore {\n  get(): { recents: string[]; lastProject?: string };\n  touchProject(path: string): void;\n  forgetProject(path: string): void;\n}\n\nexport interface ProjectSessionOptions<S, R> {\n  store: SessionStore;\n  /**\n   * Open it. The one app-specific step.\n   *\n   * `root` is what gets recorded, and it is not always the path asked for: a\n   * file-association launch names a shard INSIDE a project, and it is the\n   * project that belongs in recents. `reply` is whatever the app sends back to\n   * its renderer - this never looks inside it.\n   */\n  open: (path: string) => { session: S; root: string; reply: R } | { error: string };\n  /**\n   * The outgoing session is finished with: sweep its temporary files, close its\n   * handles. Called only once the replacement has opened successfully, so a\n   * failed open leaves the current project entirely alone.\n   */\n  close?: (session: S) => void;\n  /** Rebuild the application menu. Called after a change either way, because a\n   *  failed open changes recents too. */\n  refreshMenu?: () => void;\n  satellites?: Satellite[];\n}\n\nexport interface ProjectSession<S, R> {\n  /** The open project, or undefined before the first one. */\n  current: () => S | undefined;\n  /** Open, with everything in the comment above. */\n  openAt: (path: string) => R | { error: string };\n  /** May the renderer ask for this path? See the note above: only paths the app\n   *  already knows, because a native dialog put them there. */\n  isKnownPath: (path: string) => boolean;\n  /** Register a tool window after construction, which is when they usually\n   *  appear. Returns a function that unregisters it. */\n  addSatellite: (satellite: Satellite) => () => void;\n  /** Fire every satellite by hand. For the cases that are not an open but do\n   *  invalidate the same things - a merge landing new content underneath. */\n  invalidateSatellites: () => void;\n}\n\nexport function createProjectSession<S, R>(opts: ProjectSessionOptions<S, R>): ProjectSession<S, R> {\n  let session: S | undefined;\n  const satellites: Satellite[] = [...(opts.satellites ?? [])];\n\n  const invalidateSatellites = (): void => {\n    for (const sat of satellites) {\n      sat.clear?.();\n      const win = sat.window();\n      if (win && !win.isDestroyed()) win.webContents.send(sat.channel);\n    }\n  };\n\n  return {\n    current: () => session,\n\n    openAt(path) {\n      const opened = opts.open(path);\n      if (\"error\" in opened) {\n        opts.store.forgetProject(path);\n        opts.refreshMenu?.();\n        return opened;\n      }\n      if (session !== undefined) opts.close?.(session);\n      session = opened.session;\n      opts.store.touchProject(opened.root);\n      invalidateSatellites();\n      opts.refreshMenu?.();\n      return opened.reply;\n    },\n\n    isKnownPath(path) {\n      const s = opts.store.get();\n      const known = new Set(\n        [s.lastProject, ...s.recents].filter((p): p is string => typeof p === \"string\" && p !== \"\").map((p) => resolve(p)),\n      );\n      return known.has(resolve(path));\n    },\n\n    addSatellite(satellite) {\n      satellites.push(satellite);\n      return () => {\n        const i = satellites.indexOf(satellite);\n        if (i >= 0) satellites.splice(i, 1);\n      };\n    },\n\n    invalidateSatellites,\n  };\n}\n"]}
+{"version":3,"sources":["../src/session.ts"],"names":["path","resolve"],"mappings":";;;;;AAgHO,SAAS,qBAA2B,IAAA,EAAyD;AAClG,EAAA,IAAI,OAAA;AACJ,EAAA,MAAM,aAA0B,CAAC,GAAI,IAAA,CAAK,UAAA,IAAc,EAAG,CAAA;AAE3D,EAAA,MAAM,uBAAuB,MAAY;AACvC,IAAA,KAAA,MAAW,OAAO,UAAA,EAAY;AAC5B,MAAA,GAAA,CAAI,KAAA,IAAQ;AACZ,MAAA,MAAM,GAAA,GAAM,IAAI,MAAA,EAAO;AACvB,MAAA,IAAI,GAAA,IAAO,CAAC,GAAA,CAAI,WAAA,IAAe,GAAA,CAAI,WAAA,CAAY,IAAA,CAAK,GAAA,CAAI,OAAO,CAAA;AAAA,IACjE;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,SAAS,MAAM,OAAA;AAAA,IAEf,OAAO,IAAA,EAAM;AACX,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA;AAC7B,MAAA,IAAI,WAAW,MAAA,EAAQ;AACrB,QAAA,IAAA,CAAK,KAAA,CAAM,cAAc,IAAI,CAAA;AAC7B,QAAA,IAAA,CAAK,WAAA,IAAc;AACnB,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,IAAI,OAAA,KAAY,MAAA,EAAW,IAAA,CAAK,KAAA,GAAQ,OAAO,CAAA;AAC/C,MAAA,OAAA,GAAU,MAAA,CAAO,OAAA;AACjB,MAAA,IAAA,CAAK,KAAA,CAAM,YAAA,CAAa,MAAA,CAAO,IAAA,EAAM,OAAO,IAAI,CAAA;AAChD,MAAA,oBAAA,EAAqB;AACrB,MAAA,IAAA,CAAK,WAAA,IAAc;AACnB,MAAA,OAAO,MAAA,CAAO,KAAA;AAAA,IAChB,CAAA;AAAA,IAEA,YAAYA,MAAA,EAAM;AAChB,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,GAAA,EAAI;AAQzB,MAAA,MAAM,KAAA,GAAQ,CAAC,CAAA,CAAE,WAAA,EAAa,GAAG,CAAA,CAAE,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,IAAI,CAAC,CAAA;AAC7D,MAAA,MAAM,QAAQ,IAAI,GAAA,CAAI,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,KAAmB,CAAC,CAAC,CAAC,EAAE,GAAA,CAAI,CAAC,MAAMC,YAAA,CAAQ,CAAC,CAAC,CAAC,CAAA;AAClF,MAAA,OAAO,KAAA,CAAM,GAAA,CAAIA,YAAA,CAAQD,MAAI,CAAC,CAAA;AAAA,IAChC,CAAA;AAAA,IAEA,aAAa,SAAA,EAAW;AACtB,MAAA,UAAA,CAAW,KAAK,SAAS,CAAA;AACzB,MAAA,OAAO,MAAM;AACX,QAAA,MAAM,CAAA,GAAI,UAAA,CAAW,OAAA,CAAQ,SAAS,CAAA;AACtC,QAAA,IAAI,CAAA,IAAK,CAAA,EAAG,UAAA,CAAW,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,MACpC,CAAA;AAAA,IACF,CAAA;AAAA,IAEA;AAAA,GACF;AACF","file":"session.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// The project session: what happens around opening a project, as opposed to\n// the opening itself.\n//\n// Both apps have a function - `openAt` here, `openAndRecord` there - and under\n// two different names they do the same six things in the same order:\n//\n//   1. Ask the app to open it, which is the only app-specific step.\n//   2. On failure, drop it from recents (a project that has moved should stop\n//      being offered) and rebuild the menu.\n//   3. On success, finish with the outgoing session.\n//   4. Record the opened ROOT in the store, which also clears the remembered\n//      place when it is a different project.\n//   5. Invalidate everything main was caching FOR THE OLD PROJECT, and tell\n//      each satellite tool window that the ground moved.\n//   6. Rebuild the menu, so File > Open Recent is current.\n//\n// Step 5 is the one worth extracting on its own. Both apps hand-wire it per\n// window - a cached result nulled, then `if (win && !win.isDestroyed())\n// win.webContents.send(...)` - Storyletter three times, Patterpad twice, and\n// every new tool window is another chance to forget one and leave a window\n// describing a project that is no longer open. Registering a satellite once\n// makes forgetting it impossible.\n//\n// It also carries `isKnownPath`, which only Patterpad had and which is a real\n// guard rather than a tidiness: a renderer must not be able to name an\n// arbitrary directory and have main open it. Fresh paths enter through the\n// native dialogs, which run in main where the person actually chose them;\n// everything else must already be in recents.\n//\n// Electron-free: a satellite is anything with the two methods it needs, which\n// a BrowserWindow satisfies and a test can fake.\n// ---------------------------------------------------------------------------\n\nimport { resolve } from \"node:path\";\nimport type { RecentProject } from \"./app-store.js\";\n\n/** As much of a BrowserWindow as this file has any business knowing. */\nexport interface SatelliteWindow {\n  isDestroyed(): boolean;\n  webContents: { send(channel: string, ...args: unknown[]): void };\n}\n\n/**\n * A tool window that shows something about the open project, and any state\n * main is holding on its behalf.\n */\nexport interface Satellite {\n  /** Looked up each time rather than held: these windows open and close. */\n  window: () => SatelliteWindow | undefined | null;\n  /** What to send when the project changes. The window re-fetches; it is a\n   *  nudge, not a payload, because by then the new project is already open. */\n  channel: string;\n  /** Drop what main was caching for the old project - a coverage report, a\n   *  search anchor. Called before the window is told. */\n  clear?: () => void;\n}\n\n/** The slice of the app store this needs. Structural, so the real store fits\n *  without dragging its generic parameters in here. */\nexport interface SessionStore {\n  get(): { recents: RecentProject[]; lastProject?: string };\n  /** The name is what the app just learned by opening the project. Omitting it\n   *  keeps whatever was known, which is `createAppStore`'s rule. */\n  touchProject(path: string, name?: string): void;\n  forgetProject(path: string): void;\n}\n\nexport interface ProjectSessionOptions<S, R> {\n  store: SessionStore;\n  /**\n   * Open it. The one app-specific step.\n   *\n   * `root` is what gets recorded, and it is not always the path asked for: a\n   * file-association launch names a shard INSIDE a project, and it is the\n   * project that belongs in recents. `reply` is whatever the app sends back to\n   * its renderer - this never looks inside it.\n   *\n   * `name` is the project's display name, if opening it revealed one. Return it\n   * and the session records it with the path; leave it out and whatever was\n   * known is kept. This is here so no app has to touch the store a second time\n   * just to name what it has already opened.\n   */\n  open: (path: string) => { session: S; root: string; name?: string; reply: R } | { error: string };\n  /**\n   * The outgoing session is finished with: sweep its temporary files, close its\n   * handles. Called only once the replacement has opened successfully, so a\n   * failed open leaves the current project entirely alone.\n   */\n  close?: (session: S) => void;\n  /** Rebuild the application menu. Called after a change either way, because a\n   *  failed open changes recents too. */\n  refreshMenu?: () => void;\n  satellites?: Satellite[];\n}\n\nexport interface ProjectSession<S, R> {\n  /** The open project, or undefined before the first one. */\n  current: () => S | undefined;\n  /** Open, with everything in the comment above. */\n  openAt: (path: string) => R | { error: string };\n  /** May the renderer ask for this path? See the note above: only paths the app\n   *  already knows, because a native dialog put them there. */\n  isKnownPath: (path: string) => boolean;\n  /** Register a tool window after construction, which is when they usually\n   *  appear. Returns a function that unregisters it. */\n  addSatellite: (satellite: Satellite) => () => void;\n  /** Fire every satellite by hand. For the cases that are not an open but do\n   *  invalidate the same things - a merge landing new content underneath. */\n  invalidateSatellites: () => void;\n}\n\nexport function createProjectSession<S, R>(opts: ProjectSessionOptions<S, R>): ProjectSession<S, R> {\n  let session: S | undefined;\n  const satellites: Satellite[] = [...(opts.satellites ?? [])];\n\n  const invalidateSatellites = (): void => {\n    for (const sat of satellites) {\n      sat.clear?.();\n      const win = sat.window();\n      if (win && !win.isDestroyed()) win.webContents.send(sat.channel);\n    }\n  };\n\n  return {\n    current: () => session,\n\n    openAt(path) {\n      const opened = opts.open(path);\n      if (\"error\" in opened) {\n        opts.store.forgetProject(path);\n        opts.refreshMenu?.();\n        return opened;\n      }\n      if (session !== undefined) opts.close?.(session);\n      session = opened.session;\n      opts.store.touchProject(opened.root, opened.name);\n      invalidateSatellites();\n      opts.refreshMenu?.();\n      return opened.reply;\n    },\n\n    isKnownPath(path) {\n      const s = opts.store.get();\n      // Read `path` off each recent EXPLICITLY rather than filtering the list to\n      // whatever looks like a string. The old form did the latter, and when\n      // recents became objects in 0.25.0 every entry quietly failed the test and\n      // was dropped: no error, no empty list to notice, just a launcher that had\n      // stopped recognising every project but the last one. A defensive filter is\n      // what turns a shape change into a silent behaviour change, so this one\n      // states the shape it wants and lets the compiler enforce it.\n      const paths = [s.lastProject, ...s.recents.map((r) => r.path)];\n      const known = new Set(paths.filter((p): p is string => !!p).map((p) => resolve(p)));\n      return known.has(resolve(path));\n    },\n\n    addSatellite(satellite) {\n      satellites.push(satellite);\n      return () => {\n        const i = satellites.indexOf(satellite);\n        if (i >= 0) satellites.splice(i, 1);\n      };\n    },\n\n    invalidateSatellites,\n  };\n}\n"]}

package/dist/session.d.cts

@@ -1,3 +1,5 @@
+import { RecentProject } from './app-store.cjs';
+
 /** As much of a BrowserWindow as this file has any business knowing. */
 interface SatelliteWindow {
     isDestroyed(): boolean;
@@ -23,10 +25,12 @@ interface Satellite {
  *  without dragging its generic parameters in here. */
 interface SessionStore {
     get(): {
-        recents: string[];
+        recents: RecentProject[];
         lastProject?: string;
     };
-    touchProject(path: string): void;
+    /** The name is what the app just learned by opening the project. Omitting it
+     *  keeps whatever was known, which is `createAppStore`'s rule. */
+    touchProject(path: string, name?: string): void;
     forgetProject(path: string): void;
 }
 interface ProjectSessionOptions<S, R> {
@@ -38,10 +42,16 @@ interface ProjectSessionOptions<S, R> {
      * file-association launch names a shard INSIDE a project, and it is the
      * project that belongs in recents. `reply` is whatever the app sends back to
      * its renderer - this never looks inside it.
+     *
+     * `name` is the project's display name, if opening it revealed one. Return it
+     * and the session records it with the path; leave it out and whatever was
+     * known is kept. This is here so no app has to touch the store a second time
+     * just to name what it has already opened.
      */
     open: (path: string) => {
         session: S;
         root: string;
+        name?: string;
         reply: R;
     } | {
         error: string;

package/dist/session.d.ts

@@ -1,3 +1,5 @@
+import { RecentProject } from './app-store.js';
+
 /** As much of a BrowserWindow as this file has any business knowing. */
 interface SatelliteWindow {
     isDestroyed(): boolean;
@@ -23,10 +25,12 @@ interface Satellite {
  *  without dragging its generic parameters in here. */
 interface SessionStore {
     get(): {
-        recents: string[];
+        recents: RecentProject[];
         lastProject?: string;
     };
-    touchProject(path: string): void;
+    /** The name is what the app just learned by opening the project. Omitting it
+     *  keeps whatever was known, which is `createAppStore`'s rule. */
+    touchProject(path: string, name?: string): void;
     forgetProject(path: string): void;
 }
 interface ProjectSessionOptions<S, R> {
@@ -38,10 +42,16 @@ interface ProjectSessionOptions<S, R> {
      * file-association launch names a shard INSIDE a project, and it is the
      * project that belongs in recents. `reply` is whatever the app sends back to
      * its renderer - this never looks inside it.
+     *
+     * `name` is the project's display name, if opening it revealed one. Return it
+     * and the session records it with the path; leave it out and whatever was
+     * known is kept. This is here so no app has to touch the store a second time
+     * just to name what it has already opened.
      */
     open: (path: string) => {
         session: S;
         root: string;
+        name?: string;
         reply: R;
     } | {
         error: string;

package/dist/session.js

@@ -22,16 +22,15 @@ function createProjectSession(opts) {
       }
       if (session !== void 0) opts.close?.(session);
       session = opened.session;
-      opts.store.touchProject(opened.root);
+      opts.store.touchProject(opened.root, opened.name);
       invalidateSatellites();
       opts.refreshMenu?.();
       return opened.reply;
     },
     isKnownPath(path) {
       const s = opts.store.get();
-      const known = new Set(
-        [s.lastProject, ...s.recents].filter((p) => typeof p === "string" && p !== "").map((p) => resolve(p))
-      );
+      const paths = [s.lastProject, ...s.recents.map((r) => r.path)];
+      const known = new Set(paths.filter((p) => !!p).map((p) => resolve(p)));
       return known.has(resolve(path));
     },
     addSatellite(satellite) {

package/dist/session.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/session.ts"],"names":[],"mappings":";;;AAwGO,SAAS,qBAA2B,IAAA,EAAyD;AAClG,EAAA,IAAI,OAAA;AACJ,EAAA,MAAM,aAA0B,CAAC,GAAI,IAAA,CAAK,UAAA,IAAc,EAAG,CAAA;AAE3D,EAAA,MAAM,uBAAuB,MAAY;AACvC,IAAA,KAAA,MAAW,OAAO,UAAA,EAAY;AAC5B,MAAA,GAAA,CAAI,KAAA,IAAQ;AACZ,MAAA,MAAM,GAAA,GAAM,IAAI,MAAA,EAAO;AACvB,MAAA,IAAI,GAAA,IAAO,CAAC,GAAA,CAAI,WAAA,IAAe,GAAA,CAAI,WAAA,CAAY,IAAA,CAAK,GAAA,CAAI,OAAO,CAAA;AAAA,IACjE;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,SAAS,MAAM,OAAA;AAAA,IAEf,OAAO,IAAA,EAAM;AACX,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA;AAC7B,MAAA,IAAI,WAAW,MAAA,EAAQ;AACrB,QAAA,IAAA,CAAK,KAAA,CAAM,cAAc,IAAI,CAAA;AAC7B,QAAA,IAAA,CAAK,WAAA,IAAc;AACnB,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,IAAI,OAAA,KAAY,MAAA,EAAW,IAAA,CAAK,KAAA,GAAQ,OAAO,CAAA;AAC/C,MAAA,OAAA,GAAU,MAAA,CAAO,OAAA;AACjB,MAAA,IAAA,CAAK,KAAA,CAAM,YAAA,CAAa,MAAA,CAAO,IAAI,CAAA;AACnC,MAAA,oBAAA,EAAqB;AACrB,MAAA,IAAA,CAAK,WAAA,IAAc;AACnB,MAAA,OAAO,MAAA,CAAO,KAAA;AAAA,IAChB,CAAA;AAAA,IAEA,YAAY,IAAA,EAAM;AAChB,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,GAAA,EAAI;AACzB,MAAA,MAAM,QAAQ,IAAI,GAAA;AAAA,QAChB,CAAC,EAAE,WAAA,EAAa,GAAG,EAAE,OAAO,CAAA,CAAE,OAAO,CAAC,CAAA,KAAmB,OAAO,CAAA,KAAM,QAAA,IAAY,MAAM,EAAE,CAAA,CAAE,IAAI,CAAC,CAAA,KAAM,OAAA,CAAQ,CAAC,CAAC;AAAA,OACnH;AACA,MAAA,OAAO,KAAA,CAAM,GAAA,CAAI,OAAA,CAAQ,IAAI,CAAC,CAAA;AAAA,IAChC,CAAA;AAAA,IAEA,aAAa,SAAA,EAAW;AACtB,MAAA,UAAA,CAAW,KAAK,SAAS,CAAA;AACzB,MAAA,OAAO,MAAM;AACX,QAAA,MAAM,CAAA,GAAI,UAAA,CAAW,OAAA,CAAQ,SAAS,CAAA;AACtC,QAAA,IAAI,CAAA,IAAK,CAAA,EAAG,UAAA,CAAW,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,MACpC,CAAA;AAAA,IACF,CAAA;AAAA,IAEA;AAAA,GACF;AACF","file":"session.js","sourcesContent":["// ---------------------------------------------------------------------------\n// The project session: what happens around opening a project, as opposed to\n// the opening itself.\n//\n// Both apps have a function - `openAt` here, `openAndRecord` there - and under\n// two different names they do the same six things in the same order:\n//\n//   1. Ask the app to open it, which is the only app-specific step.\n//   2. On failure, drop it from recents (a project that has moved should stop\n//      being offered) and rebuild the menu.\n//   3. On success, finish with the outgoing session.\n//   4. Record the opened ROOT in the store, which also clears the remembered\n//      place when it is a different project.\n//   5. Invalidate everything main was caching FOR THE OLD PROJECT, and tell\n//      each satellite tool window that the ground moved.\n//   6. Rebuild the menu, so File > Open Recent is current.\n//\n// Step 5 is the one worth extracting on its own. Both apps hand-wire it per\n// window - a cached result nulled, then `if (win && !win.isDestroyed())\n// win.webContents.send(...)` - Storyletter three times, Patterpad twice, and\n// every new tool window is another chance to forget one and leave a window\n// describing a project that is no longer open. Registering a satellite once\n// makes forgetting it impossible.\n//\n// It also carries `isKnownPath`, which only Patterpad had and which is a real\n// guard rather than a tidiness: a renderer must not be able to name an\n// arbitrary directory and have main open it. Fresh paths enter through the\n// native dialogs, which run in main where the person actually chose them;\n// everything else must already be in recents.\n//\n// Electron-free: a satellite is anything with the two methods it needs, which\n// a BrowserWindow satisfies and a test can fake.\n// ---------------------------------------------------------------------------\n\nimport { resolve } from \"node:path\";\n\n/** As much of a BrowserWindow as this file has any business knowing. */\nexport interface SatelliteWindow {\n  isDestroyed(): boolean;\n  webContents: { send(channel: string, ...args: unknown[]): void };\n}\n\n/**\n * A tool window that shows something about the open project, and any state\n * main is holding on its behalf.\n */\nexport interface Satellite {\n  /** Looked up each time rather than held: these windows open and close. */\n  window: () => SatelliteWindow | undefined | null;\n  /** What to send when the project changes. The window re-fetches; it is a\n   *  nudge, not a payload, because by then the new project is already open. */\n  channel: string;\n  /** Drop what main was caching for the old project - a coverage report, a\n   *  search anchor. Called before the window is told. */\n  clear?: () => void;\n}\n\n/** The slice of the app store this needs. Structural, so the real store fits\n *  without dragging its generic parameters in here. */\nexport interface SessionStore {\n  get(): { recents: string[]; lastProject?: string };\n  touchProject(path: string): void;\n  forgetProject(path: string): void;\n}\n\nexport interface ProjectSessionOptions<S, R> {\n  store: SessionStore;\n  /**\n   * Open it. The one app-specific step.\n   *\n   * `root` is what gets recorded, and it is not always the path asked for: a\n   * file-association launch names a shard INSIDE a project, and it is the\n   * project that belongs in recents. `reply` is whatever the app sends back to\n   * its renderer - this never looks inside it.\n   */\n  open: (path: string) => { session: S; root: string; reply: R } | { error: string };\n  /**\n   * The outgoing session is finished with: sweep its temporary files, close its\n   * handles. Called only once the replacement has opened successfully, so a\n   * failed open leaves the current project entirely alone.\n   */\n  close?: (session: S) => void;\n  /** Rebuild the application menu. Called after a change either way, because a\n   *  failed open changes recents too. */\n  refreshMenu?: () => void;\n  satellites?: Satellite[];\n}\n\nexport interface ProjectSession<S, R> {\n  /** The open project, or undefined before the first one. */\n  current: () => S | undefined;\n  /** Open, with everything in the comment above. */\n  openAt: (path: string) => R | { error: string };\n  /** May the renderer ask for this path? See the note above: only paths the app\n   *  already knows, because a native dialog put them there. */\n  isKnownPath: (path: string) => boolean;\n  /** Register a tool window after construction, which is when they usually\n   *  appear. Returns a function that unregisters it. */\n  addSatellite: (satellite: Satellite) => () => void;\n  /** Fire every satellite by hand. For the cases that are not an open but do\n   *  invalidate the same things - a merge landing new content underneath. */\n  invalidateSatellites: () => void;\n}\n\nexport function createProjectSession<S, R>(opts: ProjectSessionOptions<S, R>): ProjectSession<S, R> {\n  let session: S | undefined;\n  const satellites: Satellite[] = [...(opts.satellites ?? [])];\n\n  const invalidateSatellites = (): void => {\n    for (const sat of satellites) {\n      sat.clear?.();\n      const win = sat.window();\n      if (win && !win.isDestroyed()) win.webContents.send(sat.channel);\n    }\n  };\n\n  return {\n    current: () => session,\n\n    openAt(path) {\n      const opened = opts.open(path);\n      if (\"error\" in opened) {\n        opts.store.forgetProject(path);\n        opts.refreshMenu?.();\n        return opened;\n      }\n      if (session !== undefined) opts.close?.(session);\n      session = opened.session;\n      opts.store.touchProject(opened.root);\n      invalidateSatellites();\n      opts.refreshMenu?.();\n      return opened.reply;\n    },\n\n    isKnownPath(path) {\n      const s = opts.store.get();\n      const known = new Set(\n        [s.lastProject, ...s.recents].filter((p): p is string => typeof p === \"string\" && p !== \"\").map((p) => resolve(p)),\n      );\n      return known.has(resolve(path));\n    },\n\n    addSatellite(satellite) {\n      satellites.push(satellite);\n      return () => {\n        const i = satellites.indexOf(satellite);\n        if (i >= 0) satellites.splice(i, 1);\n      };\n    },\n\n    invalidateSatellites,\n  };\n}\n"]}
+{"version":3,"sources":["../src/session.ts"],"names":[],"mappings":";;;AAgHO,SAAS,qBAA2B,IAAA,EAAyD;AAClG,EAAA,IAAI,OAAA;AACJ,EAAA,MAAM,aAA0B,CAAC,GAAI,IAAA,CAAK,UAAA,IAAc,EAAG,CAAA;AAE3D,EAAA,MAAM,uBAAuB,MAAY;AACvC,IAAA,KAAA,MAAW,OAAO,UAAA,EAAY;AAC5B,MAAA,GAAA,CAAI,KAAA,IAAQ;AACZ,MAAA,MAAM,GAAA,GAAM,IAAI,MAAA,EAAO;AACvB,MAAA,IAAI,GAAA,IAAO,CAAC,GAAA,CAAI,WAAA,IAAe,GAAA,CAAI,WAAA,CAAY,IAAA,CAAK,GAAA,CAAI,OAAO,CAAA;AAAA,IACjE;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,SAAS,MAAM,OAAA;AAAA,IAEf,OAAO,IAAA,EAAM;AACX,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA;AAC7B,MAAA,IAAI,WAAW,MAAA,EAAQ;AACrB,QAAA,IAAA,CAAK,KAAA,CAAM,cAAc,IAAI,CAAA;AAC7B,QAAA,IAAA,CAAK,WAAA,IAAc;AACnB,QAAA,OAAO,MAAA;AAAA,MACT;AACA,MAAA,IAAI,OAAA,KAAY,MAAA,EAAW,IAAA,CAAK,KAAA,GAAQ,OAAO,CAAA;AAC/C,MAAA,OAAA,GAAU,MAAA,CAAO,OAAA;AACjB,MAAA,IAAA,CAAK,KAAA,CAAM,YAAA,CAAa,MAAA,CAAO,IAAA,EAAM,OAAO,IAAI,CAAA;AAChD,MAAA,oBAAA,EAAqB;AACrB,MAAA,IAAA,CAAK,WAAA,IAAc;AACnB,MAAA,OAAO,MAAA,CAAO,KAAA;AAAA,IAChB,CAAA;AAAA,IAEA,YAAY,IAAA,EAAM;AAChB,MAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,GAAA,EAAI;AAQzB,MAAA,MAAM,KAAA,GAAQ,CAAC,CAAA,CAAE,WAAA,EAAa,GAAG,CAAA,CAAE,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,IAAI,CAAC,CAAA;AAC7D,MAAA,MAAM,QAAQ,IAAI,GAAA,CAAI,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,KAAmB,CAAC,CAAC,CAAC,EAAE,GAAA,CAAI,CAAC,MAAM,OAAA,CAAQ,CAAC,CAAC,CAAC,CAAA;AAClF,MAAA,OAAO,KAAA,CAAM,GAAA,CAAI,OAAA,CAAQ,IAAI,CAAC,CAAA;AAAA,IAChC,CAAA;AAAA,IAEA,aAAa,SAAA,EAAW;AACtB,MAAA,UAAA,CAAW,KAAK,SAAS,CAAA;AACzB,MAAA,OAAO,MAAM;AACX,QAAA,MAAM,CAAA,GAAI,UAAA,CAAW,OAAA,CAAQ,SAAS,CAAA;AACtC,QAAA,IAAI,CAAA,IAAK,CAAA,EAAG,UAAA,CAAW,MAAA,CAAO,GAAG,CAAC,CAAA;AAAA,MACpC,CAAA;AAAA,IACF,CAAA;AAAA,IAEA;AAAA,GACF;AACF","file":"session.js","sourcesContent":["// ---------------------------------------------------------------------------\n// The project session: what happens around opening a project, as opposed to\n// the opening itself.\n//\n// Both apps have a function - `openAt` here, `openAndRecord` there - and under\n// two different names they do the same six things in the same order:\n//\n//   1. Ask the app to open it, which is the only app-specific step.\n//   2. On failure, drop it from recents (a project that has moved should stop\n//      being offered) and rebuild the menu.\n//   3. On success, finish with the outgoing session.\n//   4. Record the opened ROOT in the store, which also clears the remembered\n//      place when it is a different project.\n//   5. Invalidate everything main was caching FOR THE OLD PROJECT, and tell\n//      each satellite tool window that the ground moved.\n//   6. Rebuild the menu, so File > Open Recent is current.\n//\n// Step 5 is the one worth extracting on its own. Both apps hand-wire it per\n// window - a cached result nulled, then `if (win && !win.isDestroyed())\n// win.webContents.send(...)` - Storyletter three times, Patterpad twice, and\n// every new tool window is another chance to forget one and leave a window\n// describing a project that is no longer open. Registering a satellite once\n// makes forgetting it impossible.\n//\n// It also carries `isKnownPath`, which only Patterpad had and which is a real\n// guard rather than a tidiness: a renderer must not be able to name an\n// arbitrary directory and have main open it. Fresh paths enter through the\n// native dialogs, which run in main where the person actually chose them;\n// everything else must already be in recents.\n//\n// Electron-free: a satellite is anything with the two methods it needs, which\n// a BrowserWindow satisfies and a test can fake.\n// ---------------------------------------------------------------------------\n\nimport { resolve } from \"node:path\";\nimport type { RecentProject } from \"./app-store.js\";\n\n/** As much of a BrowserWindow as this file has any business knowing. */\nexport interface SatelliteWindow {\n  isDestroyed(): boolean;\n  webContents: { send(channel: string, ...args: unknown[]): void };\n}\n\n/**\n * A tool window that shows something about the open project, and any state\n * main is holding on its behalf.\n */\nexport interface Satellite {\n  /** Looked up each time rather than held: these windows open and close. */\n  window: () => SatelliteWindow | undefined | null;\n  /** What to send when the project changes. The window re-fetches; it is a\n   *  nudge, not a payload, because by then the new project is already open. */\n  channel: string;\n  /** Drop what main was caching for the old project - a coverage report, a\n   *  search anchor. Called before the window is told. */\n  clear?: () => void;\n}\n\n/** The slice of the app store this needs. Structural, so the real store fits\n *  without dragging its generic parameters in here. */\nexport interface SessionStore {\n  get(): { recents: RecentProject[]; lastProject?: string };\n  /** The name is what the app just learned by opening the project. Omitting it\n   *  keeps whatever was known, which is `createAppStore`'s rule. */\n  touchProject(path: string, name?: string): void;\n  forgetProject(path: string): void;\n}\n\nexport interface ProjectSessionOptions<S, R> {\n  store: SessionStore;\n  /**\n   * Open it. The one app-specific step.\n   *\n   * `root` is what gets recorded, and it is not always the path asked for: a\n   * file-association launch names a shard INSIDE a project, and it is the\n   * project that belongs in recents. `reply` is whatever the app sends back to\n   * its renderer - this never looks inside it.\n   *\n   * `name` is the project's display name, if opening it revealed one. Return it\n   * and the session records it with the path; leave it out and whatever was\n   * known is kept. This is here so no app has to touch the store a second time\n   * just to name what it has already opened.\n   */\n  open: (path: string) => { session: S; root: string; name?: string; reply: R } | { error: string };\n  /**\n   * The outgoing session is finished with: sweep its temporary files, close its\n   * handles. Called only once the replacement has opened successfully, so a\n   * failed open leaves the current project entirely alone.\n   */\n  close?: (session: S) => void;\n  /** Rebuild the application menu. Called after a change either way, because a\n   *  failed open changes recents too. */\n  refreshMenu?: () => void;\n  satellites?: Satellite[];\n}\n\nexport interface ProjectSession<S, R> {\n  /** The open project, or undefined before the first one. */\n  current: () => S | undefined;\n  /** Open, with everything in the comment above. */\n  openAt: (path: string) => R | { error: string };\n  /** May the renderer ask for this path? See the note above: only paths the app\n   *  already knows, because a native dialog put them there. */\n  isKnownPath: (path: string) => boolean;\n  /** Register a tool window after construction, which is when they usually\n   *  appear. Returns a function that unregisters it. */\n  addSatellite: (satellite: Satellite) => () => void;\n  /** Fire every satellite by hand. For the cases that are not an open but do\n   *  invalidate the same things - a merge landing new content underneath. */\n  invalidateSatellites: () => void;\n}\n\nexport function createProjectSession<S, R>(opts: ProjectSessionOptions<S, R>): ProjectSession<S, R> {\n  let session: S | undefined;\n  const satellites: Satellite[] = [...(opts.satellites ?? [])];\n\n  const invalidateSatellites = (): void => {\n    for (const sat of satellites) {\n      sat.clear?.();\n      const win = sat.window();\n      if (win && !win.isDestroyed()) win.webContents.send(sat.channel);\n    }\n  };\n\n  return {\n    current: () => session,\n\n    openAt(path) {\n      const opened = opts.open(path);\n      if (\"error\" in opened) {\n        opts.store.forgetProject(path);\n        opts.refreshMenu?.();\n        return opened;\n      }\n      if (session !== undefined) opts.close?.(session);\n      session = opened.session;\n      opts.store.touchProject(opened.root, opened.name);\n      invalidateSatellites();\n      opts.refreshMenu?.();\n      return opened.reply;\n    },\n\n    isKnownPath(path) {\n      const s = opts.store.get();\n      // Read `path` off each recent EXPLICITLY rather than filtering the list to\n      // whatever looks like a string. The old form did the latter, and when\n      // recents became objects in 0.25.0 every entry quietly failed the test and\n      // was dropped: no error, no empty list to notice, just a launcher that had\n      // stopped recognising every project but the last one. A defensive filter is\n      // what turns a shape change into a silent behaviour change, so this one\n      // states the shape it wants and lets the compiler enforce it.\n      const paths = [s.lastProject, ...s.recents.map((r) => r.path)];\n      const known = new Set(paths.filter((p): p is string => !!p).map((p) => resolve(p)));\n      return known.has(resolve(path));\n    },\n\n    addSatellite(satellite) {\n      satellites.push(satellite);\n      return () => {\n        const i = satellites.indexOf(satellite);\n        if (i >= 0) satellites.splice(i, 1);\n      };\n    },\n\n    invalidateSatellites,\n  };\n}\n"]}

package/dist/vc-status.cjs

@@ -23,6 +23,7 @@ async function query(shards) {
   const states = /* @__PURE__ */ new Map();
   for (const s of shards) states.set(s.key, { writable: true });
   const keyOf = new Map(shards.map((s) => [s.path, s.key]));
+  const isPrimary = new Set(shards.filter((s) => s.primary).map((s) => s.path));
   const doRemote = Date.now() - lastRemoteAt >= REMOTE_STATUS_THROTTLE_MS;
   let system = "filesystem";
   try {
@@ -32,6 +33,9 @@ async function query(shards) {
       system = st.system;
       const acc = states.get(key);
       if (!st.writable) acc.writable = false;
+      if (st.openedByMe) acc.checkedOutByMe = true;
+      if (st.dirty) acc.dirty = true;
+      if (st.tracked === false && isPrimary.has(st.filePath)) acc.untracked = true;
       if (doRemote) {
         if (st.lockedBy?.length) acc.lockedBy = [.../* @__PURE__ */ new Set([...acc.lockedBy ?? [], ...st.lockedBy])];
         if (st.outOfDate) acc.outOfDate = true;

package/dist/vc-status.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/vc-status.ts"],"names":["fileStatusAsync"],"mappings":"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","file":"vc-status.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// Per-shard version-control state, over @wildwinter/simple-vc-lib.\n//\n// The family's, because it follows from the SHAPE rather than from any app's\n// subject: these are all Electron apps editing JSON shards in a working copy,\n// so they all want to say \"locked by Bo\" before a save is refused rather than\n// after. Patterpad wrote it, Storyletter hand-ported it, and this is the third\n// copy becoming the only one.\n//\n// A SHARD here is just a key and a path: what the key means is the app's\n// business (a scene, a deck, a box's three files folded into one row).\n//\n// THROTTLING, which is the reason this is a module rather than a function call:\n// the local bits (`writable` - the on-disk read-only bit a lock VCS keys off)\n// are cheap and refresh on every call, so a save re-badges at once. The remote\n// bits (`lockedBy` / `outOfDate`) cost a SERVER round-trip under SVN and\n// Plastic, so they are re-queried at most once per window and otherwise reused\n// from the cache. The query is async (never blocks the main-process event loop)\n// and coalesced (a save, a focus and the poll timer arriving together make ONE\n// query), so a lock badge can never make typing stutter.\n//\n// Best-effort throughout: if the query throws (no tooling, broken repo) every\n// shard reports clean and writable, and the editor carries on.\n// ---------------------------------------------------------------------------\n\nimport { fileStatusAsync } from \"@wildwinter/simple-vc-lib\";\nimport type { VCFileStatus, VCStatusOptions } from \"@wildwinter/simple-vc-lib\";\n\n/** One shard to ask about: the key the renderer looks state up by, and its\n *  absolute path on disk. */\nexport interface ShardRef {\n  key: string;\n  path: string;\n}\n\n/** One shard's version-control state. All-clean is `{ writable: true }`. */\nexport interface ShardState {\n  /** Writable on disk right now. `false` = the read-only bit is set (a lock\n   *  VCS has not checked it out yet, or someone else holds it). */\n  writable: boolean;\n  /** Who else holds it open / locked (e.g. \"bo@bo-ws\") - we can read it, not\n   *  write it. */\n  lockedBy?: string[];\n  /** A newer revision exists on the server (get latest before editing). */\n  outOfDate?: boolean;\n}\n\nexport interface ShardStatus {\n  /** The backend simple-vc-lib actually detected (\"git\" / \"perforce\" / ...). */\n  system: string;\n  states: Map<string, ShardState>;\n}\n\n/** How long a remote (server round-trip) answer stays good for. */\nexport const REMOTE_STATUS_THROTTLE_MS = 15_000;\n\ntype StatusReader = (paths: string[], options?: VCStatusOptions) => Promise<VCFileStatus[]>;\n\nlet read: StatusReader = fileStatusAsync;\n/** What the app calls itself in the one warning this module can emit. */\nlet logPrefix = \"app-shell\";\n/** Name the app, for that warning. */\nexport function setVcLogPrefix(name: string): void { logPrefix = name; }\nlet lastRemoteAt = 0;\nlet cachedRemoteBits = new Map<string, { lockedBy?: string[]; outOfDate?: boolean }>();\nlet inFlight: Promise<ShardStatus> | undefined;\n\n/** Test seam, mirroring simple-vc-lib's own `setCommandRunner`: swap the status\n *  reader for canned answers. Pass null to restore the real one. */\nexport function setStatusReader(reader: StatusReader | null): void {\n  read = reader ?? fileStatusAsync;\n}\n\n/** Drop the throttle window and the cached remote bits - called when a project\n *  opens, so a new project never inherits the last one's answers. */\nexport function resetShardStatus(): void {\n  lastRemoteAt = 0;\n  cachedRemoteBits = new Map();\n}\n\nasync function query(shards: ShardRef[]): Promise<ShardStatus> {\n  const states = new Map<string, ShardState>();\n  for (const s of shards) states.set(s.key, { writable: true });\n  const keyOf = new Map(shards.map((s) => [s.path, s.key]));\n  // Hit the server only when the window has elapsed; otherwise a cheap local read.\n  const doRemote = Date.now() - lastRemoteAt >= REMOTE_STATUS_THROTTLE_MS;\n  let system = \"filesystem\";\n  try {\n    for (const st of await read(shards.map((s) => s.path), { remote: doRemote })) {\n      const key = keyOf.get(st.filePath);\n      if (key === undefined) continue;\n      system = st.system;\n      const acc = states.get(key)!;\n      if (!st.writable) acc.writable = false;\n      if (doRemote) {   // remote bits are authoritative only on a fresh server query\n        if (st.lockedBy?.length) acc.lockedBy = [...new Set([...(acc.lockedBy ?? []), ...st.lockedBy])];\n        if (st.outOfDate) acc.outOfDate = true;\n      }\n    }\n    if (doRemote) {   // snapshot the fresh remote bits for the throttled calls that follow\n      lastRemoteAt = Date.now();\n      cachedRemoteBits = new Map([...states].map(([key, s]) => [key, {\n        ...(s.lockedBy !== undefined ? { lockedBy: s.lockedBy } : {}),\n        ...(s.outOfDate !== undefined ? { outOfDate: s.outOfDate } : {}),\n      }]));\n    } else {   // overlay the last known remote bits onto the fresh local snapshot\n      for (const [key, acc] of states) {\n        const cached = cachedRemoteBits.get(key);\n        if (cached?.lockedBy?.length) acc.lockedBy = cached.lockedBy;\n        if (cached?.outOfDate) acc.outOfDate = true;\n      }\n    }\n  } catch (e) {\n    // Tooling missing, repo error, timeout: everything reads clean + writable.\n    console.warn(`${logPrefix}: the version-control status query failed - treating every shard as writable:`, e);\n  }\n  return { system, states };\n}\n\n/** The current state of every shard, throttled + coalesced as above. Never\n *  throws: a failed query yields a clean, writable snapshot. */\nexport function shardStatus(shards: ShardRef[]): Promise<ShardStatus> {\n  if (!inFlight) {\n    inFlight = (async () => {\n      try { return await query(shards); } finally { inFlight = undefined; }\n    })();\n  }\n  return inFlight;\n}\n"]}
+{"version":3,"sources":["../src/vc-status.ts"],"names":["fileStatusAsync"],"mappings":"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","file":"vc-status.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// Per-shard version-control state, over @wildwinter/simple-vc-lib.\n//\n// The family's, because it follows from the SHAPE rather than from any app's\n// subject: these are all Electron apps editing JSON shards in a working copy,\n// so they all want to say \"locked by Bo\" before a save is refused rather than\n// after. Patterpad wrote it, Storyletter hand-ported it, and this is the third\n// copy becoming the only one.\n//\n// A SHARD here is just a key and a path: what the key means is the app's\n// business (a scene, a deck, a box's three files folded into one row).\n//\n// THROTTLING, which is the reason this is a module rather than a function call:\n// the local bits (`writable` - the on-disk read-only bit a lock VCS keys off)\n// are cheap and refresh on every call, so a save re-badges at once. The remote\n// bits (`lockedBy` / `outOfDate`) cost a SERVER round-trip under SVN and\n// Plastic, so they are re-queried at most once per window and otherwise reused\n// from the cache. The query is async (never blocks the main-process event loop)\n// and coalesced (a save, a focus and the poll timer arriving together make ONE\n// query), so a lock badge can never make typing stutter.\n//\n// Best-effort throughout: if the query throws (no tooling, broken repo) every\n// shard reports clean and writable, and the editor carries on.\n// ---------------------------------------------------------------------------\n\nimport { fileStatusAsync } from \"@wildwinter/simple-vc-lib\";\nimport type { VCFileStatus, VCStatusOptions } from \"@wildwinter/simple-vc-lib\";\n\n/** One shard to ask about: the key the renderer looks state up by, and its\n *  absolute path on disk. */\nexport interface ShardRef {\n  key: string;\n  path: string;\n  /**\n   * This path is the one that decides whether the KEY is untracked.\n   *\n   * A key usually spans several files, and \"new\" is the one state that does not\n   * fold by \"any of them counts\": a scene whose flow file is committed but whose\n   * sidecar has never been written is not a new scene, it is an edited one.\n   * Patterpad keys off the flow shard for exactly that reason. Mark the canonical\n   * path and the rest are ignored for `untracked`; mark none and the key never\n   * reports untracked.\n   */\n  primary?: boolean;\n}\n\n/** One shard's version-control state. All-clean is `{ writable: true }`. */\nexport interface ShardState {\n  /** Writable on disk right now. `false` = the read-only bit is set (a lock\n   *  VCS has not checked it out yet, or someone else holds it). */\n  writable: boolean;\n  /** Who else holds it open / locked (e.g. \"bo@bo-ws\") - we can read it, not\n   *  write it. */\n  lockedBy?: string[];\n  /** A newer revision exists on the server (get latest before editing). */\n  outOfDate?: boolean;\n  /** WE hold it: checked out / opened by the current user, still ours to edit.\n   *  Distinct from `writable`, which says only that the bit is off. */\n  checkedOutByMe?: boolean;\n  /** Tracked, with local changes not yet committed. */\n  dirty?: boolean;\n  /** Not in version control yet. Decided by the `primary` path alone (see\n   *  `ShardRef.primary`). */\n  untracked?: boolean;\n}\n\nexport interface ShardStatus {\n  /** The backend simple-vc-lib actually detected (\"git\" / \"perforce\" / ...). */\n  system: string;\n  states: Map<string, ShardState>;\n}\n\n/** How long a remote (server round-trip) answer stays good for. */\nexport const REMOTE_STATUS_THROTTLE_MS = 15_000;\n\ntype StatusReader = (paths: string[], options?: VCStatusOptions) => Promise<VCFileStatus[]>;\n\nlet read: StatusReader = fileStatusAsync;\n/** What the app calls itself in the one warning this module can emit. */\nlet logPrefix = \"app-shell\";\n/** Name the app, for that warning. */\nexport function setVcLogPrefix(name: string): void { logPrefix = name; }\nlet lastRemoteAt = 0;\nlet cachedRemoteBits = new Map<string, { lockedBy?: string[]; outOfDate?: boolean }>();\nlet inFlight: Promise<ShardStatus> | undefined;\n\n/** Test seam, mirroring simple-vc-lib's own `setCommandRunner`: swap the status\n *  reader for canned answers. Pass null to restore the real one. */\nexport function setStatusReader(reader: StatusReader | null): void {\n  read = reader ?? fileStatusAsync;\n}\n\n/** Drop the throttle window and the cached remote bits - called when a project\n *  opens, so a new project never inherits the last one's answers. */\nexport function resetShardStatus(): void {\n  lastRemoteAt = 0;\n  cachedRemoteBits = new Map();\n}\n\nasync function query(shards: ShardRef[]): Promise<ShardStatus> {\n  const states = new Map<string, ShardState>();\n  for (const s of shards) states.set(s.key, { writable: true });\n  const keyOf = new Map(shards.map((s) => [s.path, s.key]));\n  const isPrimary = new Set(shards.filter((s) => s.primary).map((s) => s.path));\n  // Hit the server only when the window has elapsed; otherwise a cheap local read.\n  const doRemote = Date.now() - lastRemoteAt >= REMOTE_STATUS_THROTTLE_MS;\n  let system = \"filesystem\";\n  try {\n    for (const st of await read(shards.map((s) => s.path), { remote: doRemote })) {\n      const key = keyOf.get(st.filePath);\n      if (key === undefined) continue;\n      system = st.system;\n      const acc = states.get(key)!;\n      if (!st.writable) acc.writable = false;\n      // Local bits, cheap on every provider, so never throttled.\n      if (st.openedByMe) acc.checkedOutByMe = true;\n      if (st.dirty) acc.dirty = true;\n      if (st.tracked === false && isPrimary.has(st.filePath)) acc.untracked = true;\n      if (doRemote) {   // remote bits are authoritative only on a fresh server query\n        if (st.lockedBy?.length) acc.lockedBy = [...new Set([...(acc.lockedBy ?? []), ...st.lockedBy])];\n        if (st.outOfDate) acc.outOfDate = true;\n      }\n    }\n    if (doRemote) {   // snapshot the fresh remote bits for the throttled calls that follow\n      lastRemoteAt = Date.now();\n      cachedRemoteBits = new Map([...states].map(([key, s]) => [key, {\n        ...(s.lockedBy !== undefined ? { lockedBy: s.lockedBy } : {}),\n        ...(s.outOfDate !== undefined ? { outOfDate: s.outOfDate } : {}),\n      }]));\n    } else {   // overlay the last known remote bits onto the fresh local snapshot\n      for (const [key, acc] of states) {\n        const cached = cachedRemoteBits.get(key);\n        if (cached?.lockedBy?.length) acc.lockedBy = cached.lockedBy;\n        if (cached?.outOfDate) acc.outOfDate = true;\n      }\n    }\n  } catch (e) {\n    // Tooling missing, repo error, timeout: everything reads clean + writable.\n    console.warn(`${logPrefix}: the version-control status query failed - treating every shard as writable:`, e);\n  }\n  return { system, states };\n}\n\n/** The current state of every shard, throttled + coalesced as above. Never\n *  throws: a failed query yields a clean, writable snapshot. */\nexport function shardStatus(shards: ShardRef[]): Promise<ShardStatus> {\n  if (!inFlight) {\n    inFlight = (async () => {\n      try { return await query(shards); } finally { inFlight = undefined; }\n    })();\n  }\n  return inFlight;\n}\n"]}

package/dist/vc-status.d.cts

@@ -5,6 +5,17 @@ import { VCStatusOptions, VCFileStatus } from '@wildwinter/simple-vc-lib';
 interface ShardRef {
     key: string;
     path: string;
+    /**
+     * This path is the one that decides whether the KEY is untracked.
+     *
+     * A key usually spans several files, and "new" is the one state that does not
+     * fold by "any of them counts": a scene whose flow file is committed but whose
+     * sidecar has never been written is not a new scene, it is an edited one.
+     * Patterpad keys off the flow shard for exactly that reason. Mark the canonical
+     * path and the rest are ignored for `untracked`; mark none and the key never
+     * reports untracked.
+     */
+    primary?: boolean;
 }
 /** One shard's version-control state. All-clean is `{ writable: true }`. */
 interface ShardState {
@@ -16,6 +27,14 @@ interface ShardState {
     lockedBy?: string[];
     /** A newer revision exists on the server (get latest before editing). */
     outOfDate?: boolean;
+    /** WE hold it: checked out / opened by the current user, still ours to edit.
+     *  Distinct from `writable`, which says only that the bit is off. */
+    checkedOutByMe?: boolean;
+    /** Tracked, with local changes not yet committed. */
+    dirty?: boolean;
+    /** Not in version control yet. Decided by the `primary` path alone (see
+     *  `ShardRef.primary`). */
+    untracked?: boolean;
 }
 interface ShardStatus {
     /** The backend simple-vc-lib actually detected ("git" / "perforce" / ...). */

package/dist/vc-status.d.ts

@@ -5,6 +5,17 @@ import { VCStatusOptions, VCFileStatus } from '@wildwinter/simple-vc-lib';
 interface ShardRef {
     key: string;
     path: string;
+    /**
+     * This path is the one that decides whether the KEY is untracked.
+     *
+     * A key usually spans several files, and "new" is the one state that does not
+     * fold by "any of them counts": a scene whose flow file is committed but whose
+     * sidecar has never been written is not a new scene, it is an edited one.
+     * Patterpad keys off the flow shard for exactly that reason. Mark the canonical
+     * path and the rest are ignored for `untracked`; mark none and the key never
+     * reports untracked.
+     */
+    primary?: boolean;
 }
 /** One shard's version-control state. All-clean is `{ writable: true }`. */
 interface ShardState {
@@ -16,6 +27,14 @@ interface ShardState {
     lockedBy?: string[];
     /** A newer revision exists on the server (get latest before editing). */
     outOfDate?: boolean;
+    /** WE hold it: checked out / opened by the current user, still ours to edit.
+     *  Distinct from `writable`, which says only that the bit is off. */
+    checkedOutByMe?: boolean;
+    /** Tracked, with local changes not yet committed. */
+    dirty?: boolean;
+    /** Not in version control yet. Decided by the `primary` path alone (see
+     *  `ShardRef.primary`). */
+    untracked?: boolean;
 }
 interface ShardStatus {
     /** The backend simple-vc-lib actually detected ("git" / "perforce" / ...). */

package/dist/vc-status.js

@@ -21,6 +21,7 @@ async function query(shards) {
   const states = /* @__PURE__ */ new Map();
   for (const s of shards) states.set(s.key, { writable: true });
   const keyOf = new Map(shards.map((s) => [s.path, s.key]));
+  const isPrimary = new Set(shards.filter((s) => s.primary).map((s) => s.path));
   const doRemote = Date.now() - lastRemoteAt >= REMOTE_STATUS_THROTTLE_MS;
   let system = "filesystem";
   try {
@@ -30,6 +31,9 @@ async function query(shards) {
       system = st.system;
       const acc = states.get(key);
       if (!st.writable) acc.writable = false;
+      if (st.openedByMe) acc.checkedOutByMe = true;
+      if (st.dirty) acc.dirty = true;
+      if (st.tracked === false && isPrimary.has(st.filePath)) acc.untracked = true;
       if (doRemote) {
         if (st.lockedBy?.length) acc.lockedBy = [.../* @__PURE__ */ new Set([...acc.lockedBy ?? [], ...st.lockedBy])];
         if (st.outOfDate) acc.outOfDate = true;

package/dist/vc-status.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/vc-status.ts"],"names":[],"mappings":"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","file":"vc-status.js","sourcesContent":["// ---------------------------------------------------------------------------\n// Per-shard version-control state, over @wildwinter/simple-vc-lib.\n//\n// The family's, because it follows from the SHAPE rather than from any app's\n// subject: these are all Electron apps editing JSON shards in a working copy,\n// so they all want to say \"locked by Bo\" before a save is refused rather than\n// after. Patterpad wrote it, Storyletter hand-ported it, and this is the third\n// copy becoming the only one.\n//\n// A SHARD here is just a key and a path: what the key means is the app's\n// business (a scene, a deck, a box's three files folded into one row).\n//\n// THROTTLING, which is the reason this is a module rather than a function call:\n// the local bits (`writable` - the on-disk read-only bit a lock VCS keys off)\n// are cheap and refresh on every call, so a save re-badges at once. The remote\n// bits (`lockedBy` / `outOfDate`) cost a SERVER round-trip under SVN and\n// Plastic, so they are re-queried at most once per window and otherwise reused\n// from the cache. The query is async (never blocks the main-process event loop)\n// and coalesced (a save, a focus and the poll timer arriving together make ONE\n// query), so a lock badge can never make typing stutter.\n//\n// Best-effort throughout: if the query throws (no tooling, broken repo) every\n// shard reports clean and writable, and the editor carries on.\n// ---------------------------------------------------------------------------\n\nimport { fileStatusAsync } from \"@wildwinter/simple-vc-lib\";\nimport type { VCFileStatus, VCStatusOptions } from \"@wildwinter/simple-vc-lib\";\n\n/** One shard to ask about: the key the renderer looks state up by, and its\n *  absolute path on disk. */\nexport interface ShardRef {\n  key: string;\n  path: string;\n}\n\n/** One shard's version-control state. All-clean is `{ writable: true }`. */\nexport interface ShardState {\n  /** Writable on disk right now. `false` = the read-only bit is set (a lock\n   *  VCS has not checked it out yet, or someone else holds it). */\n  writable: boolean;\n  /** Who else holds it open / locked (e.g. \"bo@bo-ws\") - we can read it, not\n   *  write it. */\n  lockedBy?: string[];\n  /** A newer revision exists on the server (get latest before editing). */\n  outOfDate?: boolean;\n}\n\nexport interface ShardStatus {\n  /** The backend simple-vc-lib actually detected (\"git\" / \"perforce\" / ...). */\n  system: string;\n  states: Map<string, ShardState>;\n}\n\n/** How long a remote (server round-trip) answer stays good for. */\nexport const REMOTE_STATUS_THROTTLE_MS = 15_000;\n\ntype StatusReader = (paths: string[], options?: VCStatusOptions) => Promise<VCFileStatus[]>;\n\nlet read: StatusReader = fileStatusAsync;\n/** What the app calls itself in the one warning this module can emit. */\nlet logPrefix = \"app-shell\";\n/** Name the app, for that warning. */\nexport function setVcLogPrefix(name: string): void { logPrefix = name; }\nlet lastRemoteAt = 0;\nlet cachedRemoteBits = new Map<string, { lockedBy?: string[]; outOfDate?: boolean }>();\nlet inFlight: Promise<ShardStatus> | undefined;\n\n/** Test seam, mirroring simple-vc-lib's own `setCommandRunner`: swap the status\n *  reader for canned answers. Pass null to restore the real one. */\nexport function setStatusReader(reader: StatusReader | null): void {\n  read = reader ?? fileStatusAsync;\n}\n\n/** Drop the throttle window and the cached remote bits - called when a project\n *  opens, so a new project never inherits the last one's answers. */\nexport function resetShardStatus(): void {\n  lastRemoteAt = 0;\n  cachedRemoteBits = new Map();\n}\n\nasync function query(shards: ShardRef[]): Promise<ShardStatus> {\n  const states = new Map<string, ShardState>();\n  for (const s of shards) states.set(s.key, { writable: true });\n  const keyOf = new Map(shards.map((s) => [s.path, s.key]));\n  // Hit the server only when the window has elapsed; otherwise a cheap local read.\n  const doRemote = Date.now() - lastRemoteAt >= REMOTE_STATUS_THROTTLE_MS;\n  let system = \"filesystem\";\n  try {\n    for (const st of await read(shards.map((s) => s.path), { remote: doRemote })) {\n      const key = keyOf.get(st.filePath);\n      if (key === undefined) continue;\n      system = st.system;\n      const acc = states.get(key)!;\n      if (!st.writable) acc.writable = false;\n      if (doRemote) {   // remote bits are authoritative only on a fresh server query\n        if (st.lockedBy?.length) acc.lockedBy = [...new Set([...(acc.lockedBy ?? []), ...st.lockedBy])];\n        if (st.outOfDate) acc.outOfDate = true;\n      }\n    }\n    if (doRemote) {   // snapshot the fresh remote bits for the throttled calls that follow\n      lastRemoteAt = Date.now();\n      cachedRemoteBits = new Map([...states].map(([key, s]) => [key, {\n        ...(s.lockedBy !== undefined ? { lockedBy: s.lockedBy } : {}),\n        ...(s.outOfDate !== undefined ? { outOfDate: s.outOfDate } : {}),\n      }]));\n    } else {   // overlay the last known remote bits onto the fresh local snapshot\n      for (const [key, acc] of states) {\n        const cached = cachedRemoteBits.get(key);\n        if (cached?.lockedBy?.length) acc.lockedBy = cached.lockedBy;\n        if (cached?.outOfDate) acc.outOfDate = true;\n      }\n    }\n  } catch (e) {\n    // Tooling missing, repo error, timeout: everything reads clean + writable.\n    console.warn(`${logPrefix}: the version-control status query failed - treating every shard as writable:`, e);\n  }\n  return { system, states };\n}\n\n/** The current state of every shard, throttled + coalesced as above. Never\n *  throws: a failed query yields a clean, writable snapshot. */\nexport function shardStatus(shards: ShardRef[]): Promise<ShardStatus> {\n  if (!inFlight) {\n    inFlight = (async () => {\n      try { return await query(shards); } finally { inFlight = undefined; }\n    })();\n  }\n  return inFlight;\n}\n"]}
+{"version":3,"sources":["../src/vc-status.ts"],"names":[],"mappings":"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","file":"vc-status.js","sourcesContent":["// ---------------------------------------------------------------------------\n// Per-shard version-control state, over @wildwinter/simple-vc-lib.\n//\n// The family's, because it follows from the SHAPE rather than from any app's\n// subject: these are all Electron apps editing JSON shards in a working copy,\n// so they all want to say \"locked by Bo\" before a save is refused rather than\n// after. Patterpad wrote it, Storyletter hand-ported it, and this is the third\n// copy becoming the only one.\n//\n// A SHARD here is just a key and a path: what the key means is the app's\n// business (a scene, a deck, a box's three files folded into one row).\n//\n// THROTTLING, which is the reason this is a module rather than a function call:\n// the local bits (`writable` - the on-disk read-only bit a lock VCS keys off)\n// are cheap and refresh on every call, so a save re-badges at once. The remote\n// bits (`lockedBy` / `outOfDate`) cost a SERVER round-trip under SVN and\n// Plastic, so they are re-queried at most once per window and otherwise reused\n// from the cache. The query is async (never blocks the main-process event loop)\n// and coalesced (a save, a focus and the poll timer arriving together make ONE\n// query), so a lock badge can never make typing stutter.\n//\n// Best-effort throughout: if the query throws (no tooling, broken repo) every\n// shard reports clean and writable, and the editor carries on.\n// ---------------------------------------------------------------------------\n\nimport { fileStatusAsync } from \"@wildwinter/simple-vc-lib\";\nimport type { VCFileStatus, VCStatusOptions } from \"@wildwinter/simple-vc-lib\";\n\n/** One shard to ask about: the key the renderer looks state up by, and its\n *  absolute path on disk. */\nexport interface ShardRef {\n  key: string;\n  path: string;\n  /**\n   * This path is the one that decides whether the KEY is untracked.\n   *\n   * A key usually spans several files, and \"new\" is the one state that does not\n   * fold by \"any of them counts\": a scene whose flow file is committed but whose\n   * sidecar has never been written is not a new scene, it is an edited one.\n   * Patterpad keys off the flow shard for exactly that reason. Mark the canonical\n   * path and the rest are ignored for `untracked`; mark none and the key never\n   * reports untracked.\n   */\n  primary?: boolean;\n}\n\n/** One shard's version-control state. All-clean is `{ writable: true }`. */\nexport interface ShardState {\n  /** Writable on disk right now. `false` = the read-only bit is set (a lock\n   *  VCS has not checked it out yet, or someone else holds it). */\n  writable: boolean;\n  /** Who else holds it open / locked (e.g. \"bo@bo-ws\") - we can read it, not\n   *  write it. */\n  lockedBy?: string[];\n  /** A newer revision exists on the server (get latest before editing). */\n  outOfDate?: boolean;\n  /** WE hold it: checked out / opened by the current user, still ours to edit.\n   *  Distinct from `writable`, which says only that the bit is off. */\n  checkedOutByMe?: boolean;\n  /** Tracked, with local changes not yet committed. */\n  dirty?: boolean;\n  /** Not in version control yet. Decided by the `primary` path alone (see\n   *  `ShardRef.primary`). */\n  untracked?: boolean;\n}\n\nexport interface ShardStatus {\n  /** The backend simple-vc-lib actually detected (\"git\" / \"perforce\" / ...). */\n  system: string;\n  states: Map<string, ShardState>;\n}\n\n/** How long a remote (server round-trip) answer stays good for. */\nexport const REMOTE_STATUS_THROTTLE_MS = 15_000;\n\ntype StatusReader = (paths: string[], options?: VCStatusOptions) => Promise<VCFileStatus[]>;\n\nlet read: StatusReader = fileStatusAsync;\n/** What the app calls itself in the one warning this module can emit. */\nlet logPrefix = \"app-shell\";\n/** Name the app, for that warning. */\nexport function setVcLogPrefix(name: string): void { logPrefix = name; }\nlet lastRemoteAt = 0;\nlet cachedRemoteBits = new Map<string, { lockedBy?: string[]; outOfDate?: boolean }>();\nlet inFlight: Promise<ShardStatus> | undefined;\n\n/** Test seam, mirroring simple-vc-lib's own `setCommandRunner`: swap the status\n *  reader for canned answers. Pass null to restore the real one. */\nexport function setStatusReader(reader: StatusReader | null): void {\n  read = reader ?? fileStatusAsync;\n}\n\n/** Drop the throttle window and the cached remote bits - called when a project\n *  opens, so a new project never inherits the last one's answers. */\nexport function resetShardStatus(): void {\n  lastRemoteAt = 0;\n  cachedRemoteBits = new Map();\n}\n\nasync function query(shards: ShardRef[]): Promise<ShardStatus> {\n  const states = new Map<string, ShardState>();\n  for (const s of shards) states.set(s.key, { writable: true });\n  const keyOf = new Map(shards.map((s) => [s.path, s.key]));\n  const isPrimary = new Set(shards.filter((s) => s.primary).map((s) => s.path));\n  // Hit the server only when the window has elapsed; otherwise a cheap local read.\n  const doRemote = Date.now() - lastRemoteAt >= REMOTE_STATUS_THROTTLE_MS;\n  let system = \"filesystem\";\n  try {\n    for (const st of await read(shards.map((s) => s.path), { remote: doRemote })) {\n      const key = keyOf.get(st.filePath);\n      if (key === undefined) continue;\n      system = st.system;\n      const acc = states.get(key)!;\n      if (!st.writable) acc.writable = false;\n      // Local bits, cheap on every provider, so never throttled.\n      if (st.openedByMe) acc.checkedOutByMe = true;\n      if (st.dirty) acc.dirty = true;\n      if (st.tracked === false && isPrimary.has(st.filePath)) acc.untracked = true;\n      if (doRemote) {   // remote bits are authoritative only on a fresh server query\n        if (st.lockedBy?.length) acc.lockedBy = [...new Set([...(acc.lockedBy ?? []), ...st.lockedBy])];\n        if (st.outOfDate) acc.outOfDate = true;\n      }\n    }\n    if (doRemote) {   // snapshot the fresh remote bits for the throttled calls that follow\n      lastRemoteAt = Date.now();\n      cachedRemoteBits = new Map([...states].map(([key, s]) => [key, {\n        ...(s.lockedBy !== undefined ? { lockedBy: s.lockedBy } : {}),\n        ...(s.outOfDate !== undefined ? { outOfDate: s.outOfDate } : {}),\n      }]));\n    } else {   // overlay the last known remote bits onto the fresh local snapshot\n      for (const [key, acc] of states) {\n        const cached = cachedRemoteBits.get(key);\n        if (cached?.lockedBy?.length) acc.lockedBy = cached.lockedBy;\n        if (cached?.outOfDate) acc.outOfDate = true;\n      }\n    }\n  } catch (e) {\n    // Tooling missing, repo error, timeout: everything reads clean + writable.\n    console.warn(`${logPrefix}: the version-control status query failed - treating every shard as writable:`, e);\n  }\n  return { system, states };\n}\n\n/** The current state of every shard, throttled + coalesced as above. Never\n *  throws: a failed query yields a clean, writable snapshot. */\nexport function shardStatus(shards: ShardRef[]): Promise<ShardStatus> {\n  if (!inFlight) {\n    inFlight = (async () => {\n      try { return await query(shards); } finally { inFlight = undefined; }\n    })();\n  }\n  return inFlight;\n}\n"]}

package/dist/vc.css

@@ -11,6 +11,16 @@
 .vc-badge.vc-stale {
   color: var(--warn);
 }
+.vc-badge.vc-mine {
+  color: var(--accent);
+}
+.vc-badge.vc-dirty {
+  color: var(--accent);
+  font-size: 0.6rem;
+}
+.vc-badge.vc-new {
+  color: var(--muted);
+}
 .vc-badge.vc-frozen {
   color: var(--muted);
   opacity: 0.6;

package/dist/vc.css.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/vc.css"],"sourcesContent":["/* Version-control surfacing (vc-view.ts): the badge a row flies, and what a\n   locked document looks like. Monochrome and themed - never colour emoji - so\n   each glyph inherits its palette and reads the same in every theme. */\n.vc-badge { margin-left: 6px; font-size: 0.78rem; line-height: 1; opacity: 0.85; }\n.vc-badge.vc-locked { color: var(--danger); }\n.vc-badge.vc-stale { color: var(--warn); }\n.vc-badge.vc-frozen { color: var(--muted); opacity: 0.6; }\n\n/* A document somebody else holds: everything reads, nothing types. */\n.vc-readonly { position: relative; }\n.vc-off { opacity: 0.6; cursor: not-allowed; }\n.vc-lock {\n  display: flex; align-items: center; gap: 8px;\n  margin-bottom: 10px; padding: 7px 10px;\n  border: 1px solid var(--line); border-left: 3px solid var(--danger);\n  border-radius: var(--radius-sm);\n  background: var(--card);\n  font: 0.8rem/1.4 var(--font-ui); color: var(--ink);\n}\n.vc-lock-glyph { color: var(--danger); }\n"],"mappings":";AAGA,CAAC;AAAW,eAAa;AAAK,aAAW;AAAS,eAAa;AAAG,WAAS;AAAM;AACjF,CADC,QACQ,CAAC;AAAY,SAAO,IAAI;AAAW;AAC5C,CAFC,QAEQ,CAAC;AAAW,SAAO,IAAI;AAAS;AACzC,CAHC,QAGQ,CAAC;AAAY,SAAO,IAAI;AAAU,WAAS;AAAK;AAGzD,CAAC;AAAc,YAAU;AAAU;AACnC,CAAC;AAAS,WAAS;AAAK,UAAQ;AAAa;AAC7C,CAAC;AACC,WAAS;AAAM,eAAa;AAAQ,OAAK;AACzC,iBAAe;AAAM,WAAS,IAAI;AAClC,UAAQ,IAAI,MAAM,IAAI;AAAS,eAAa,IAAI,MAAM,IAAI;AAC1D,iBAAe,IAAI;AACnB,cAAY,IAAI;AAChB,QAAM,MAAM,CAAC,IAAI,IAAI;AAAY,SAAO,IAAI;AAC9C;AACA,CAAC;AAAgB,SAAO,IAAI;AAAW;","names":[]}
+{"version":3,"sources":["../src/vc.css"],"sourcesContent":["/* Version-control surfacing (vc-view.ts): the badge a row flies, and what a\n   locked document looks like. Monochrome and themed - never colour emoji - so\n   each glyph inherits its palette and reads the same in every theme. */\n.vc-badge { margin-left: 6px; font-size: 0.78rem; line-height: 1; opacity: 0.85; }\n.vc-badge.vc-locked { color: var(--danger); }\n.vc-badge.vc-stale { color: var(--warn); }\n/* The three \"this one is yours\" states. Accent rather than danger or warn:\n   nothing is wrong with a file you are holding, so it must not read as a\n   problem sitting in a list beside ones that are. */\n.vc-badge.vc-mine { color: var(--accent); }\n.vc-badge.vc-dirty { color: var(--accent); font-size: 0.6rem; }\n.vc-badge.vc-new { color: var(--muted); }\n.vc-badge.vc-frozen { color: var(--muted); opacity: 0.6; }\n\n/* A document somebody else holds: everything reads, nothing types. */\n.vc-readonly { position: relative; }\n.vc-off { opacity: 0.6; cursor: not-allowed; }\n.vc-lock {\n  display: flex; align-items: center; gap: 8px;\n  margin-bottom: 10px; padding: 7px 10px;\n  border: 1px solid var(--line); border-left: 3px solid var(--danger);\n  border-radius: var(--radius-sm);\n  background: var(--card);\n  font: 0.8rem/1.4 var(--font-ui); color: var(--ink);\n}\n.vc-lock-glyph { color: var(--danger); }\n"],"mappings":";AAGA,CAAC;AAAW,eAAa;AAAK,aAAW;AAAS,eAAa;AAAG,WAAS;AAAM;AACjF,CADC,QACQ,CAAC;AAAY,SAAO,IAAI;AAAW;AAC5C,CAFC,QAEQ,CAAC;AAAW,SAAO,IAAI;AAAS;AAIzC,CANC,QAMQ,CAAC;AAAU,SAAO,IAAI;AAAW;AAC1C,CAPC,QAOQ,CAAC;AAAW,SAAO,IAAI;AAAW,aAAW;AAAQ;AAC9D,CARC,QAQQ,CAAC;AAAS,SAAO,IAAI;AAAU;AACxC,CATC,QASQ,CAAC;AAAY,SAAO,IAAI;AAAU,WAAS;AAAK;AAGzD,CAAC;AAAc,YAAU;AAAU;AACnC,CAAC;AAAS,WAAS;AAAK,UAAQ;AAAa;AAC7C,CAAC;AACC,WAAS;AAAM,eAAa;AAAQ,OAAK;AACzC,iBAAe;AAAM,WAAS,IAAI;AAClC,UAAQ,IAAI,MAAM,IAAI;AAAS,eAAa,IAAI,MAAM,IAAI;AAC1D,iBAAe,IAAI;AACnB,cAAY,IAAI;AAChB,QAAM,MAAM,CAAC,IAAI,IAAI;AAAY,SAAO,IAAI;AAC9C;AACA,CAAC;AAAgB,SAAO,IAAI;AAAW;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wildwinter/app-shell",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "The shared shell for the editor family (Patterpad, Storylet Studio): the app-agnostic design-token grammar, the per-entity colour hash, and the vanilla-TS DOM primitive. Two palettes, one grammar - each app supplies its own palette/fonts over these tokens.",
   "type": "module",
   "license": "MIT",