@fellowhumans/pathmx 0.0.3 → 0.1.1

package/dist/pathmx.js

@@ -100758,7 +100758,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         this._exitCallback = (err) => {
           if (err.code !== "commander.executeSubCommandAsync") {
             throw err;
-          } else {}
+          }
         };
       }
       return this;
@@ -139319,23 +139319,17 @@ class BuildGraph {
   removeNode(nodeId) {
     this.nodes.delete(nodeId);
     this.replaceEdgesFrom(nodeId, []);
-    const incoming = this.edgesByTarget.get(nodeId) ?? [];
+    const incoming = [...this.edgesByTarget.get(nodeId) ?? []];
     for (const edge of incoming) {
       this.removeEdge(edge);
     }
   }
   addEdge(edge) {
-    this.edgesBySource.set(edge.from, [
-      ...this.edgesBySource.get(edge.from) ?? [],
-      edge
-    ]);
-    this.edgesByTarget.set(edge.to, [
-      ...this.edgesByTarget.get(edge.to) ?? [],
-      edge
-    ]);
+    this.getOrCreateEdgeBucket(this.edgesBySource, edge.from).push(edge);
+    this.getOrCreateEdgeBucket(this.edgesByTarget, edge.to).push(edge);
   }
   replaceEdgesFrom(nodeId, edges) {
-    const current = this.edgesBySource.get(nodeId) ?? [];
+    const current = [...this.edgesBySource.get(nodeId) ?? []];
     for (const edge of current) {
       this.removeEdge(edge);
     }
@@ -139360,9 +139354,27 @@ class BuildGraph {
     this.edgesBySource.clear();
     this.edgesByTarget.clear();
   }
+  diagnostics() {
+    return {
+      nodes: this.nodes.size,
+      edges: countEdges(this.edgesBySource),
+      edgesBySourceBuckets: this.edgesBySource.size,
+      edgesByTargetBuckets: this.edgesByTarget.size,
+      emptyEdgesBySourceBuckets: countEmptyBuckets(this.edgesBySource),
+      emptyEdgesByTargetBuckets: countEmptyBuckets(this.edgesByTarget)
+    };
+  }
+  getOrCreateEdgeBucket(index2, nodeId) {
+    let edges = index2.get(nodeId);
+    if (!edges) {
+      edges = [];
+      index2.set(nodeId, edges);
+    }
+    return edges;
+  }
   removeEdge(edge) {
-    this.edgesBySource.set(edge.from, (this.edgesBySource.get(edge.from) ?? []).filter((current) => current !== edge));
-    this.edgesByTarget.set(edge.to, (this.edgesByTarget.get(edge.to) ?? []).filter((current) => current !== edge));
+    removeEdgeFromIndex(this.edgesBySource, edge.from, edge);
+    removeEdgeFromIndex(this.edgesByTarget, edge.to, edge);
   }
   walk(start, next) {
     const queue = Array.isArray(start) ? [...start] : [start];
@@ -139384,6 +139396,30 @@ class BuildGraph {
     return [...visited];
   }
 }
+function removeEdgeFromIndex(index2, nodeId, edge) {
+  const edges = index2.get(nodeId);
+  if (!edges)
+    return;
+  const edgeIndex = edges.indexOf(edge);
+  if (edgeIndex >= 0)
+    edges.splice(edgeIndex, 1);
+  if (edges.length === 0)
+    index2.delete(nodeId);
+}
+function countEdges(index2) {
+  let count = 0;
+  for (const edges of index2.values())
+    count += edges.length;
+  return count;
+}
+function countEmptyBuckets(index2) {
+  let count = 0;
+  for (const edges of index2.values()) {
+    if (edges.length === 0)
+      count += 1;
+  }
+  return count;
+}
 // packages/build/src/repository/node-ids.ts
 var sourceNodeId = (id) => `source:${id}`;
 var sourceDataNodeId = (id) => `source-data:${id}`;
@@ -143175,6 +143211,19 @@ function createMetadataRecordDelta(previous, current) {
   }
   return Object.keys(delta).length > 0 ? delta : undefined;
 }
+function createMetadataRecordDeltaForKeys(previous, current, keys2) {
+  const delta = {};
+  for (const key2 of keys2) {
+    if (key2 in current) {
+      if (!stableJsonEqual(previous[key2], current[key2])) {
+        delta[key2] = current[key2];
+      }
+    } else if (key2 in previous) {
+      delta[key2] = null;
+    }
+  }
+  return Object.keys(delta).length > 0 ? delta : undefined;
+}
 function buildOutputStateToDelta(state) {
   return {
     sources: state.sources,
@@ -143185,11 +143234,11 @@ function buildOutputStateToDelta(state) {
     runtime: state.runtime
   };
 }
-function createBuildOutputMetadataDelta(previous, current) {
+function createBuildOutputMetadataDelta(previous, current, hints) {
   if (!previous)
     return buildOutputStateToDelta(current);
   const delta = {};
-  const sources = createMetadataRecordDelta(previous.sources, current.sources);
+  const sources = hints?.sourceIds ? createMetadataRecordDeltaForKeys(previous.sources, current.sources, hints.sourceIds) : createMetadataRecordDelta(previous.sources, current.sources);
   if (sources)
     delta.sources = sources;
   const sourceFiles = createMetadataRecordDelta(previous.sourceFiles, current.sourceFiles);
@@ -143198,17 +143247,20 @@ function createBuildOutputMetadataDelta(previous, current) {
   if (!stableJsonEqual(previous.missingSourceFilePaths, current.missingSourceFilePaths)) {
     delta.missingSourceFilePaths = current.missingSourceFilePaths;
   }
-  const renderedBlocks = createMetadataRecordDelta(previous.renderedBlocks, current.renderedBlocks);
+  const renderedBlocks = hints?.blockIds ? createMetadataRecordDeltaForKeys(previous.renderedBlocks, current.renderedBlocks, hints.blockIds) : createMetadataRecordDelta(previous.renderedBlocks, current.renderedBlocks);
   if (renderedBlocks)
     delta.renderedBlocks = renderedBlocks;
-  const artifacts = createMetadataRecordDelta(previous.artifacts, current.artifacts);
+  const artifacts = hints?.artifactPaths ? createMetadataRecordDeltaForKeys(previous.artifacts, current.artifacts, hints.artifactPaths) : createMetadataRecordDelta(previous.artifacts, current.artifacts);
   if (artifacts)
     delta.artifacts = artifacts;
-  if (!stableJsonEqual(previous.runtime, current.runtime)) {
+  if (hints?.runtimeChanged === true || hints?.runtimeChanged === undefined && !stableJsonEqual(previous.runtime, current.runtime)) {
     delta.runtime = current.runtime;
   }
   return delta;
 }
+function isBuildOutputMetadataDeltaEmpty(delta) {
+  return delta.sources === undefined && delta.sourceFiles === undefined && delta.missingSourceFilePaths === undefined && delta.renderedBlocks === undefined && delta.artifacts === undefined && delta.runtime === undefined;
+}
 function applyMetadataRecordDelta(target, delta) {
   if (!delta)
     return;
@@ -143750,6 +143802,46 @@ function getChangedRenderedBlockIds(changes) {
   }
   return blockIds;
 }
+function getChangedSourceIds2(changes) {
+  const sourceIds = new Set;
+  if (!changes)
+    return sourceIds;
+  for (const change of changes) {
+    for (const nodeId of [
+      ...change.dirtyNodes,
+      ...change.affectedNodes,
+      ...change.addedNodes,
+      ...change.removedNodes
+    ]) {
+      const sourceId = sourceIdFromNodeId(nodeId);
+      if (sourceId)
+        sourceIds.add(sourceId);
+    }
+  }
+  return sourceIds;
+}
+function getChangedArtifactPaths(artifactChanges) {
+  if (!artifactChanges)
+    return new Set;
+  return new Set([
+    ...artifactChanges.written.map((artifact) => artifact.path),
+    ...artifactChanges.deleted.map((deletion) => deletion.path)
+  ]);
+}
+function createBuildOutputMetadataDeltaHints(options) {
+  const hasRepositoryChanges = (options.changes?.length ?? 0) > 0;
+  const hasArtifactChanges = (options.artifactChanges?.written.length ?? 0) > 0 || (options.artifactChanges?.deleted.length ?? 0) > 0;
+  if (!hasRepositoryChanges && !hasArtifactChanges)
+    return;
+  return {
+    ...hasRepositoryChanges ? {
+      sourceIds: getChangedSourceIds2(options.changes),
+      blockIds: getChangedRenderedBlockIds(options.changes)
+    } : {},
+    ...hasArtifactChanges ? { artifactPaths: getChangedArtifactPaths(options.artifactChanges) } : {},
+    ...options.runtimeChanged === undefined ? {} : { runtimeChanged: options.runtimeChanged }
+  };
+}
 function createSourceEntries(ctx) {
   return Object.fromEntries(ctx.repository.getSources().map((source3) => [
     source3.id,
@@ -144292,7 +144384,12 @@ async function writeBuildOutputCache(options) {
     artifacts,
     runtime: runtime3
   };
-  if (previousState && stableJson(previousState) === stableJson(state)) {
+  const delta = createBuildOutputMetadataDelta(previousState, state, createBuildOutputMetadataDeltaHints({
+    changes,
+    artifactChanges,
+    runtimeChanged
+  }));
+  if (previousState && isBuildOutputMetadataDeltaEmpty(delta)) {
     setCachedBuildOutputState(ctx, root, state);
     trustedBuildCacheBlobPaths.set(ctx, collectCacheBlobPaths(state));
     for (const [rendered, ref] of renderedBlockRefs) {
@@ -144308,7 +144405,7 @@ async function writeBuildOutputCache(options) {
     await Promise.all([...blobs.values()].map((write) => writeCacheBlob(cacheStorage, write, trustedBlobPaths)));
   });
   await metadataStore.writeDelta(root, {
-    buildOutput: createBuildOutputMetadataDelta(previousState, state)
+    buildOutput: delta
   });
   await ctx.performance.measure({
     kind: "cache",
@@ -145979,6 +146076,61 @@ async function createBuildSession(options) {
     }
     return finish(roots);
   }
+  async function readMetadataJournalEntries(state) {
+    if (!state.ctx.env.cache || !state.entrySourceId || !state.outputPath) {
+      return;
+    }
+    const root = {
+      entry: state.entry,
+      sourceId: state.entrySourceId,
+      outputPath: state.outputPath
+    };
+    const manifest5 = await readStorageJson(state.ctx.env.cache, getBuildMetadataManifestPath(root));
+    if (!manifest5)
+      return;
+    const signature = createBuildMetadataStoreSignature(createBuildCacheSignature(state.ctx.plugins));
+    if (manifest5.signature !== signature || manifest5.root.entry !== root.entry || manifest5.root.sourceId !== root.sourceId || manifest5.root.outputPath !== root.outputPath) {
+      return;
+    }
+    return manifest5.journal.length;
+  }
+  async function rootDiagnostics(state) {
+    const pendingCache = state.pendingCache;
+    const metadataJournalEntries = await readMetadataJournalEntries(state);
+    const diagnostics = {
+      entry: state.entry,
+      ...state.pathId ? { pathId: state.pathId } : {},
+      ...state.entrySourceId ? { entrySourceId: state.entrySourceId } : {},
+      ...state.outputPath ? { outputPath: state.outputPath } : {},
+      sources: state.ctx.repository.getSources().length,
+      reachableSources: state.reachableSourcePaths.size,
+      missingSources: state.missingSourcePaths.size,
+      graph: state.ctx.repository.graph.diagnostics(),
+      renderCache: {
+        entries: state.ctx.renderCache.size
+      },
+      artifacts: {
+        entries: state.ctx.artifacts.list().length
+      },
+      deferredTasks: state.ctx.deferredTasks?.summary() ?? createUnavailableDeferredTaskSummary(),
+      pending: {
+        settle: settledPending.has(state.entry),
+        cache: !!pendingCache,
+        cacheChanges: pendingCache?.changes.length ?? 0,
+        cacheArtifacts: pendingCache?.artifacts.size ?? 0
+      },
+      ...metadataJournalEntries === undefined ? {} : { metadataJournal: { entries: metadataJournalEntries } }
+    };
+    return diagnostics;
+  }
+  async function collectDiagnostics() {
+    const roots = await Promise.all(states.map(rootDiagnostics));
+    return {
+      roots,
+      pendingSettleRoots: settledPending.size,
+      pendingCacheRoots: roots.filter((root) => root.pending.cache).length
+    };
+  }
   async function drainDeferredTasksSession(options2 = {}) {
     let latest = await runDeferredTasksSession(options2);
     while (findStatesWithRunnableDeferredTasks(options2).length > 0) {
@@ -146048,6 +146200,9 @@ async function createBuildSession(options) {
     hasPendingSettle() {
       return settledPending.size > 0;
     },
+    diagnostics() {
+      return runExclusive(collectDiagnostics);
+    },
     flushCache() {
       return runExclusive(flushPendingCache);
     }
@@ -157565,7 +157720,7 @@ function finalize(ctx, schema2) {
     result.$schema = "http://json-schema.org/draft-07/schema#";
   } else if (ctx.target === "draft-04") {
     result.$schema = "http://json-schema.org/draft-04/schema#";
-  } else if (ctx.target === "openapi-3.0") {} else {}
+  } else if (ctx.target === "openapi-3.0") {}
   if (ctx.external?.uri) {
     const id = ctx.external.registry.get(schema2)?.id;
     if (!id)
@@ -157809,7 +157964,7 @@ var literalProcessor = (schema2, ctx, json2, _params) => {
     if (val === undefined) {
       if (ctx.unrepresentable === "throw") {
         throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-      } else {}
+      }
     } else if (typeof val === "bigint") {
       if (ctx.unrepresentable === "throw") {
         throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -188717,7 +188872,7 @@ var RuleFactory = class _RuleFactory {
               let localIncludedRule = repository2[reference.ruleName];
               if (localIncludedRule) {
                 ruleId = _RuleFactory.getCompiledRuleId(localIncludedRule, helper, repository2);
-              } else {}
+              }
               break;
             case 3:
             case 4:
@@ -188729,11 +188884,11 @@ var RuleFactory = class _RuleFactory {
                   let externalIncludedRule = externalGrammar.repository[externalGrammarInclude];
                   if (externalIncludedRule) {
                     ruleId = _RuleFactory.getCompiledRuleId(externalIncludedRule, helper, externalGrammar.repository);
-                  } else {}
+                  }
                 } else {
                   ruleId = _RuleFactory.getCompiledRuleId(externalGrammar.repository.$self, helper, externalGrammar.repository);
                 }
-              } else {}
+              }
               break;
           }
         } else {
@@ -206266,7 +206421,7 @@ var EXCLUDED_DIRS = new Set([
   ".git",
   ".obsidian",
   ".pathmx",
-  ".pathmx2",
+  ".pathmx",
   ".trash",
   "build",
   "dist",
@@ -206374,7 +206529,12 @@ async function createObsidianIndexSource(options) {
     }
     const managed = parseManagedIndexContent(existingContent);
     if (!managed || managed.hash !== hashString(managed.body)) {
-      return { status: "conflict", reason: "user-edited", indexPath, sourcePaths };
+      return {
+        status: "conflict",
+        reason: "user-edited",
+        indexPath,
+        sourcePaths
+      };
     }
   }
   await options.env.sourceStorage.write(indexPath, {
@@ -206436,7 +206596,10 @@ function resultFromMatches(matches3) {
 }
 function obsidianWikilinkResolver() {
   return ({ source: source3, sources, targetPath }) => {
-    const sourceByPath = new Map(sources.map((candidate) => [normalizeSourcePath(candidate.path), candidate]));
+    const sourceByPath = new Map(sources.map((candidate) => [
+      normalizeSourcePath(candidate.path),
+      candidate
+    ]));
     const exactPaths = [
       resolveSourcePath(targetPath, source3),
       targetPath.startsWith("/") ? normalizeSourcePath(targetPath.slice(1)) : undefined,
@@ -206484,6 +206647,26 @@ var defaultMarkdownOptions = {
   autolinks: true,
   hardSoftBreaks: true
 };
+var ensuredBunWriteDirs = new Set;
+async function ensureBunWriteDir(dir) {
+  if (ensuredBunWriteDirs.has(dir))
+    return;
+  await mkdir(dir, { recursive: true });
+  ensuredBunWriteDirs.add(dir);
+}
+async function writeBunFile(filePath, body3) {
+  const dir = dirname2(filePath);
+  await ensureBunWriteDir(dir);
+  try {
+    await Bun.write(filePath, body3);
+  } catch (error52) {
+    if (!isMissingFileError(error52))
+      throw error52;
+    ensuredBunWriteDirs.delete(dir);
+    await ensureBunWriteDir(dir);
+    await Bun.write(filePath, body3);
+  }
+}
 var textExtensions = new Set([
   ".css",
   ".html",
@@ -206558,8 +206741,7 @@ function createBunFileStorage(rootDir) {
     },
     async write(storagePath, entry) {
       const filePath = join2(rootDir, storagePath);
-      await mkdir(dirname2(filePath), { recursive: true });
-      await Bun.write(filePath, storageContentToBody(entry.content));
+      await writeBunFile(filePath, storageContentToBody(entry.content));
     },
     async delete(storagePath) {
       await rm(join2(rootDir, storagePath), { force: true });
@@ -206609,13 +206791,12 @@ function createBunArtifactWriter(rootDir, options = {}) {
   return {
     async write(artifact) {
       const filePath = join2(rootDir, artifact.path);
-      await mkdir(dirname2(filePath), { recursive: true });
       const body3 = artifact.content === undefined ? await readSourceAsset(artifact, options.env) : artifactContentToBody(artifact);
       if (body3 === undefined) {
         await rm(filePath, { force: true });
         return;
       }
-      await Bun.write(filePath, body3);
+      await writeBunFile(filePath, body3);
     },
     async delete(deletion) {
       await rm(join2(rootDir, deletion.path), { force: true });
@@ -207391,6 +207572,60 @@ var {
   Option,
   Help
 } = import__.default;
+// packages/pathmx/package.json
+var package_default = {
+  name: "pathmx",
+  version: "0.1.1",
+  private: true,
+  type: "module",
+  types: "./src/index.ts",
+  bin: {
+    pathmx: "./src/bin.ts"
+  },
+  exports: {
+    ".": {
+      types: "./src/index.ts",
+      default: "./src/index.ts"
+    },
+    "./runtime": {
+      types: "./src/runtime.ts",
+      default: "./src/runtime.ts"
+    },
+    "./runtime/react": {
+      types: "./src/runtime-react.ts",
+      default: "./src/runtime-react.ts"
+    },
+    "./runtime/bridge": {
+      types: "./src/runtime-bridge.ts",
+      default: "./src/runtime-bridge.ts"
+    },
+    "./protocol": {
+      types: "./src/protocol.ts",
+      default: "./src/protocol.ts"
+    },
+    "./plugin": {
+      types: "./src/plugin.ts",
+      default: "./src/plugin.ts"
+    },
+    "./mcp": {
+      types: "./src/mcp.ts",
+      default: "./src/mcp.ts"
+    }
+  },
+  scripts: {
+    test: "bun test",
+    typecheck: "tsc --noEmit"
+  },
+  dependencies: {
+    "@pathmx/build": "workspace:*",
+    "@pathmx/cli": "workspace:*",
+    "@pathmx/host": "workspace:*",
+    "@pathmx/mcp": "workspace:*",
+    "@pathmx/protocol": "workspace:*",
+    "@pathmx/runtime": "workspace:*",
+    "@pathmx/server": "workspace:*"
+  }
+};
 // packages/mcp/src/index.ts
 import { randomUUID } from "crypto";
 import { mkdir as mkdir3, rm as rm4 } from "fs/promises";
@@ -217949,7 +218184,7 @@ function createPathMXHost(options) {
 }
 
 // packages/mcp/src/index.ts
-var DEFAULT_MCP_OUT_DIR = ".pathmx2-mcp";
+var DEFAULT_MCP_OUT_DIR = ".pathmx-mcp";
 var DEFAULT_LIVE_MCP_HOST = "127.0.0.1";
 var DEFAULT_LIVE_MCP_PORT = 3002;
 var DEFAULT_LIVE_MCP_PATH = "/mcp";
@@ -218050,10 +218285,12 @@ async function spaceSnapshot(ctx) {
 }
 function contentResult(structuredContent) {
   return {
-    content: [{
-      type: "text",
-      text: JSON.stringify(structuredContent, null, 2)
-    }],
+    content: [
+      {
+        type: "text",
+        text: JSON.stringify(structuredContent, null, 2)
+      }
+    ],
     structuredContent
   };
 }
@@ -218357,11 +218594,13 @@ function createPathMXMcpServer(ctx) {
     description: "Current PathMX workspace, host, and refresh status.",
     mimeType: "application/json"
   }, async (uri) => ({
-    contents: [{
-      uri: uri.href,
-      mimeType: "application/json",
-      text: JSON.stringify(await spaceSnapshot(ctx), null, 2)
-    }]
+    contents: [
+      {
+        uri: uri.href,
+        mimeType: "application/json",
+        text: JSON.stringify(await spaceSnapshot(ctx), null, 2)
+      }
+    ]
   }));
   server.registerResource("pathmx-source", new ResourceTemplate("pathmx://source/{path}", { list: undefined }), {
     title: "PathMX Source",
@@ -218372,11 +218611,13 @@ function createPathMXMcpServer(ctx) {
     const sourcePath = normalizeToolSourcePath(decodeURIComponent(String(rawPath ?? "")));
     const source3 = await readSource(ctx, sourcePath);
     return {
-      contents: [{
-        uri: uri.href,
-        mimeType: source3.contentType ?? "text/plain",
-        text: source3.content
-      }]
+      contents: [
+        {
+          uri: uri.href,
+          mimeType: source3.contentType ?? "text/plain",
+          text: source3.content
+        }
+      ]
     };
   });
   server.registerTool("pathmx_status", {
@@ -218645,7 +218886,7 @@ async function runPathMXMcpServer(options = {}) {
 }
 
 // packages/cli/src/constants.ts
-var CLI_VERSION = "0.0.3";
+var CLI_VERSION = package_default.version;
 var PATHMX_PUBLIC_CLI_PACKAGE_NAME = "@fellowhumans/pathmx";
 var DEFAULT_SERVE_HOST = "127.0.0.1";
 var DEFAULT_SERVE_PORT = 3000;
@@ -219596,7 +219837,7 @@ var IGNORED_SOURCE_PARTS = new Set([
   ".git",
   "node_modules",
   ".pathmx",
-  ".pathmx2"
+  ".pathmx"
 ]);
 function isIgnoredSourceFileName(fileName) {
   return fileName === ".DS_Store" || fileName.endsWith(".swp") || fileName.endsWith(".swo") || fileName.endsWith(".tmp") || fileName.endsWith("~");
@@ -247440,7 +247681,7 @@ async function loadLocal(value$, syncOptions, syncState$, localState) {
       } catch (err) {
         if (true) {
           console.error("[legend-state] Error loading local cache. This would be a crashing error in production.", err);
-        } else {}
+        }
       }
     }
     const prevValue = getNodeValue2(node);
@@ -251383,7 +251624,9 @@ class PlayerRouterStore {
     this.$.ready.set(false);
   }
   navigate(route, options = {}) {
-    this.setPrimaryRoute(this.resolvePrimaryRoute(route), {
+    this.setPrimaryRoute(this.resolvePrimaryRoute(route, {
+      unknownRouteFallback: options.unknownRouteFallback ?? "preserve"
+    }), {
       history: options.history ?? "push"
     });
   }
@@ -251391,7 +251634,9 @@ class PlayerRouterStore {
     this.navigate(route, { history: "replace" });
   }
   syncFromLocation(options = {}) {
-    const route = this.resolvePrimaryRoute(this.routeFromLocation());
+    const route = this.resolvePrimaryRoute(this.routeFromLocation(), {
+      unknownRouteFallback: "entry"
+    });
     this.setPrimaryRoute(route, {
       history: options.canonicalize ? "replace" : false
     });
@@ -251447,10 +251692,17 @@ class PlayerRouterStore {
     }
     return \`\${url.pathname}\${url.hash}\`;
   }
-  resolvePrimaryRoute(route) {
+  resolvePrimaryRoute(route, options = {}) {
     const parsed = this.parseRoute(route);
-    const source = this.findSource(parsed.pathname) ?? this.entrySource();
+    const source = this.findSource(parsed.pathname);
     if (!source) {
+      const entrySource = this.entrySource();
+      if (entrySource && (parsed.pathname === "/" || options.unknownRouteFallback !== "preserve")) {
+        return {
+          route: \`\${entrySource.route}\${parsed.hash}\`,
+          sourceId: entrySource.id
+        };
+      }
       return {
         route: \`\${parsed.pathname}\${parsed.hash}\`,
         sourceId: undefined
@@ -252171,6 +252423,21 @@ function RuntimeSurface({
   const preferences2 = import_react17.useMemo(() => ({ colorScheme }), [colorScheme]);
   const live = import_react17.useMemo(() => liveOptions(config), [config.liveSocketPath, config.primaryDocument]);
   const fetchDocument = import_react17.useCallback((route, options) => fetchPathMXDocumentHtml(route, graph.graph, options.signal), [graph]);
+  const navigateDocumentRoute = import_react17.useCallback((path, history) => {
+    const navigate = () => {
+      router.navigate(path, { history });
+    };
+    if (findSourceForRoute(graph.graph, path)) {
+      navigate();
+      return;
+    }
+    graph.revalidate({ force: true }).catch((error) => {
+      app.reportRuntimeError(error);
+      return;
+    }).then(() => {
+      navigate();
+    });
+  }, [app, graph, router]);
   return /* @__PURE__ */ jsx_dev_runtime4.jsxDEV(PathMXRuntimeProvider, {
     live,
     fetchDocument,
@@ -252193,9 +252460,7 @@ function RuntimeSurface({
       if (!event.defaultNavigation)
         return;
       event.preventDefault();
-      router.navigate(event.path, {
-        history: event.defaultNavigation.history === "replace" ? "replace" : "push"
-      });
+      navigateDocumentRoute(event.path, event.defaultNavigation.history === "replace" ? "replace" : "push");
     },
     onError: (event) => {
       app.reportRuntimeError(event.error);
@@ -263841,14 +264106,14 @@ function PlayComposer({
             }, undefined, false, undefined, this),
             /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(IconButton, {
               icon: "send",
-              label: "Add",
+              label: "Add annotation",
               onClick: onSubmit,
               variant: "default",
               className: "absolute bottom-2 right-2 bg-primary-background text-accent-foreground"
             }, undefined, false, undefined, this),
             /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(IconButton, {
               icon: "close",
-              label: "Close",
+              label: "Close composer",
               onClick: onClose,
               className: "absolute top-1 right-2 text-muted-foreground"
             }, undefined, false, undefined, this)
@@ -263887,6 +264152,14 @@ function PlayComposerButton({
     if (!activeBeatView && composerOpen)
       play.composer.close();
   }, [activeBeatView, composerOpen, play]);
+  function handleShowComposer() {
+    if (!activeBeatView)
+      return;
+    play.composer.open({
+      beatId: activeBeatView.beatId,
+      rect: activeBeatView.rect
+    });
+  }
   if (composerOpen && composerRect) {
     return /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(PlayComposer, {
       draft,
@@ -263903,7 +264176,7 @@ function PlayComposerButton({
     label: "Compose",
     className,
     iconClassName,
-    onClick: () => play.composer.open()
+    onClick: handleShowComposer
   }, undefined, false, undefined, this);
 }
 
@@ -273058,12 +273331,22 @@ var ROOT_SCROLLBAR_STYLE_PROPERTIES = [
   "scrollbar-width",
   "-ms-overflow-style"
 ];
+function isElement5(value) {
+  return typeof value === "object" && value !== null && value.nodeType === 1;
+}
+function getEventElementTarget2(target) {
+  if (isElement5(target))
+    return target;
+  const parentElement = target?.parentElement;
+  return isElement5(parentElement) ? parentElement : undefined;
+}
 function rootScrollbarTargets(root2) {
   return [root2.documentElement, root2.body].filter((element) => Boolean(element));
 }
 function createBrowserPlayRootEffects(root2 = document, view2 = window) {
   let snapRestoreFrame;
   let restoreScrollbarStyles;
+  let removeExternalLinkHandler;
   const cancelSnapRestore = () => {
     if (snapRestoreFrame === undefined)
       return;
@@ -273097,14 +273380,69 @@ function createBrowserPlayRootEffects(root2 = document, view2 = window) {
     restoreScrollbarStyles?.();
     restoreScrollbarStyles = undefined;
   };
+  const externalHttpUrlForClick = (event) => {
+    if (event.defaultPrevented || event.button !== 0 || event.altKey || event.ctrlKey || event.metaKey || event.shiftKey) {
+      return;
+    }
+    const eventTarget = getEventElementTarget2(event.target);
+    const anchor = eventTarget?.closest("a[href]");
+    if (!anchor || anchor.hasAttribute("download"))
+      return;
+    if (anchor.hasAttribute("target"))
+      return;
+    const href = anchor.getAttribute("href")?.trim();
+    if (!href || href.startsWith("#"))
+      return;
+    let url;
+    try {
+      url = new URL(href, view2.location.href);
+    } catch {
+      return;
+    }
+    if (url.origin === view2.location.origin)
+      return;
+    if (url.protocol !== "http:" && url.protocol !== "https:")
+      return;
+    return url;
+  };
+  const openExternalLinksInNewContext = () => {
+    if (removeExternalLinkHandler)
+      return;
+    const handleClick = (event) => {
+      const url = externalHttpUrlForClick(event);
+      if (!url)
+        return;
+      let opened;
+      try {
+        opened = view2.open(url.href, "_blank", "noopener,noreferrer");
+      } catch {
+        return;
+      }
+      event.preventDefault();
+      try {
+        if (opened)
+          opened.opener = null;
+      } catch {}
+    };
+    root2.addEventListener("click", handleClick);
+    removeExternalLinkHandler = () => {
+      root2.removeEventListener("click", handleClick);
+      removeExternalLinkHandler = undefined;
+    };
+  };
+  const restoreExternalLinkBehavior = () => {
+    removeExternalLinkHandler?.();
+  };
   return {
     setPlaying(on) {
       if (on) {
         root2.documentElement.setAttribute("data-pathmx-play", "playing");
         hideRootScrollbars();
+        openExternalLinksInNewContext();
       } else {
         root2.documentElement.removeAttribute("data-pathmx-play");
         restoreRootScrollbars();
+        restoreExternalLinkBehavior();
       }
     },
     setViewportHeight(px2) {
@@ -273805,15 +274143,14 @@ function PlayerAugmentations() {
       className: "pmx-player-control-surface pointer-events-none fixed inset-0 z-50",
       children: [
         /* @__PURE__ */ jsx_dev_runtime17.jsxDEV(PlayAugmentations, {}, undefined, false, undefined, this),
-        !playActive && /* @__PURE__ */ jsx_dev_runtime17.jsxDEV(jsx_dev_runtime17.Fragment, {
+        !playActive && !exploreActive && /* @__PURE__ */ jsx_dev_runtime17.jsxDEV(jsx_dev_runtime17.Fragment, {
           children: [
             /* @__PURE__ */ jsx_dev_runtime17.jsxDEV(PlayerBreadcrumbBar, {}, undefined, false, undefined, this),
             /* @__PURE__ */ jsx_dev_runtime17.jsxDEV("div", {
               className: "absolute bottom-[max(0.75rem,env(safe-area-inset-bottom))] left-3",
               children: /* @__PURE__ */ jsx_dev_runtime17.jsxDEV(ActionButton, {
-                "aria-pressed": exploreActive,
                 icon: "map",
-                label: exploreActive ? "Close explore" : "Explore",
+                label: "Explore",
                 onClick: () => view2.toggleExplore()
               }, undefined, false, undefined, this)
             }, undefined, false, undefined, this),

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@fellowhumans/pathmx",
-  "version": "0.0.3",
+  "version": "0.1.1",
   "type": "module",
   "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pathmx/pathmx.git"
+  },
   "bin": {
     "pathmx": "dist/pathmx.js",
     "pmx": "dist/pathmx.js"
@@ -15,6 +19,7 @@
     "bun": ">=1.3.0"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
   }
 }