isotone 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 1.0.2
+
+- feat: polish the variants dialog, select mode and feedback field (#7)
+
+## 1.0.1
+
+- ci: tag successful npm publishes before registry propagation (#6)
+
 ## 1.0.0
 
 - Put host-project setup and feedback handling first in the agent guide, and

package/dist/{chunk-BJ4UI73I.js → chunk-O6WJ5CTR.js}

@@ -7,7 +7,7 @@ import { randomUUID } from "crypto";
 
 // package.json
 var name = "isotone";
-var version = "1.0.0";
+var version = "1.0.2";
 
 // src/update.ts
 var UPDATE_ENDPOINT = "/api/iteration/update";
@@ -228,4 +228,4 @@ export {
   checkUpdate,
   startUpdateCheck
 };
-//# sourceMappingURL=chunk-BJ4UI73I.js.map
+//# sourceMappingURL=chunk-O6WJ5CTR.js.map

package/dist/{chunk-BJ4UI73I.js.map → chunk-O6WJ5CTR.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/update.ts","../package.json"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { mkdir, open, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';\nimport { dirname, join, resolve } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport { randomUUID } from 'node:crypto';\nimport type { UpdateInfo } from './core/update';\nimport { name as packageName, version as currentVersion } from '../package.json';\n\nexport const UPDATE_ENDPOINT = '/api/iteration/update';\nconst REGISTRY_URL = `https://registry.npmjs.org/${packageName}/latest`;\nconst CHECK_TIMEOUT = 5_000;\nconst CACHE_TTL = 24 * 60 * 60 * 1000;\nconst CACHE_FILE = join(tmpdir(), `isotone-update-${process.getuid?.() ?? 'user'}-v1.json`);\n\ntype Manager = 'npm' | 'pnpm' | 'yarn';\nexport type { UpdateInfo } from './core/update';\n\ninterface Version { parts: bigint[]; prerelease: string[] }\nfunction parseVersion(value: string): Version {\n  if (value.length > 256) throw new Error('Invalid version.');\n  const match = /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-([\\da-zA-Z-]+(?:\\.[\\da-zA-Z-]+)*))?(?:\\+([\\da-zA-Z-]+(?:\\.[\\da-zA-Z-]+)*))?$/.exec(value);\n  if (!match) throw new Error('Invalid version.');\n  const prerelease = match[4]?.split('.') ?? [];\n  if (prerelease.some((part) => /^0\\d+$/.test(part))) throw new Error('Invalid version.');\n  return { parts: match.slice(1, 4).map(BigInt), prerelease };\n}\n\n/** SemVer precedence, including numeric prereleases and ignored build metadata. */\nexport function compareVersions(a: string, b: string): number {\n  const left = parseVersion(a), right = parseVersion(b);\n  for (let i = 0; i < 3; i++) {\n    if (left.parts[i] !== right.parts[i]) return left.parts[i] > right.parts[i] ? 1 : -1;\n  }\n  if (!left.prerelease.length || !right.prerelease.length) {\n    return left.prerelease.length === right.prerelease.length ? 0 : left.prerelease.length ? -1 : 1;\n  }\n  for (let i = 0; i < Math.max(left.prerelease.length, right.prerelease.length); i++) {\n    const x = left.prerelease[i], y = right.prerelease[i];\n    if (x === y) continue;\n    if (x === undefined || y === undefined) return x === undefined ? -1 : 1;\n    const nx = /^\\d+$/.test(x), ny = /^\\d+$/.test(y);\n    if (nx && ny) return BigInt(x) > BigInt(y) ? 1 : -1;\n    if (nx !== ny) return nx ? -1 : 1;\n    return x > y ? 1 : -1;\n  }\n  return 0;\n}\n\nfunction manifest(directory: string): Record<string, unknown> | null {\n  try {\n    const value = JSON.parse(readFileSync(join(directory, 'package.json'), 'utf8'));\n    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;\n  } catch { return null; }\n}\n\nfunction findProject(cwd: string): { directory: string; json: Record<string, unknown> | null } {\n  let directory = resolve(cwd);\n  while (true) {\n    const json = manifest(directory);\n    if (json) return { directory, json };\n    if (dirname(directory) === directory || existsSync(join(directory, '.git'))) return { directory: resolve(cwd), json: null };\n    directory = dirname(directory);\n  }\n}\n\nfunction dependencyOwner(project: ReturnType<typeof findProject>): ReturnType<typeof findProject> {\n  let directory = project.directory;\n  while (true) {\n    const json = manifest(directory);\n    if (['dependencies', 'devDependencies', 'optionalDependencies', 'peerDependencies'].some((key) => {\n      const dependencies = json?.[key];\n      return dependencies && typeof dependencies === 'object' && Object.hasOwn(dependencies, packageName);\n    })) return { directory, json };\n    if (dirname(directory) === directory || existsSync(join(directory, '.git'))) return project;\n    directory = dirname(directory);\n  }\n}\n\nexport function upgradePlan(cwd: string, latest: string, override?: Manager): Pick<UpdateInfo, 'upgrade' | 'message'> {\n  parseVersion(latest); // Only a validated version can enter a copied command.\n  const project = dependencyOwner(findProject(cwd));\n  if (project.json?.name === packageName) return { upgrade: null, message: 'This is the source checkout; update its source instead of adding itself as a dependency.' };\n  let manager = override;\n  let directory = project.directory;\n  const locks = new Set<Manager>();\n  while (!manager) {\n    const declared = manifest(directory)?.packageManager;\n    if (typeof declared === 'string') {\n      const match = /^(npm|pnpm|yarn)@/.exec(declared);\n      if (!match) return { upgrade: null, message: 'The declared package manager is not supported by this command. Upgrade with your project’s package manager.' };\n      manager = match[1] as Manager;\n      break;\n    }\n    if (['bun.lock', 'bun.lockb'].some((file) => existsSync(join(directory, file)))) return { upgrade: null, message: 'This project uses Bun. Upgrade with the project’s package manager.' };\n    if (existsSync(join(directory, 'pnpm-lock.yaml'))) locks.add('pnpm');\n    if (existsSync(join(directory, 'yarn.lock'))) locks.add('yarn');\n    if (['package-lock.json', 'npm-shrinkwrap.json'].some((file) => existsSync(join(directory, file)))) locks.add('npm');\n    if (locks.size || dirname(directory) === directory || existsSync(join(directory, '.git'))) break;\n    directory = dirname(directory);\n  }\n  if (!manager && locks.size > 1) return { upgrade: null, message: 'Multiple package-manager lockfiles found. Pass --manager npm, pnpm or yarn.' };\n  manager ??= [...locks][0] ?? 'npm';\n  const production = project.json?.dependencies as Record<string, unknown> | undefined;\n  const optional = project.json?.optionalDependencies as Record<string, unknown> | undefined;\n  const peers = project.json?.peerDependencies as Record<string, unknown> | undefined;\n  if (optional?.[packageName] || peers?.[packageName]) return { upgrade: null, message: 'Review this optional/peer dependency manually with your package manager.' };\n  const dev = production?.[packageName] ? '' : ' -D';\n  let workspace = manager === 'pnpm' && existsSync(join(project.directory, 'pnpm-workspace.yaml')) ? ' -w' : '';\n  if (manager === 'yarn' && project.json?.workspaces) {\n    const declared = project.json.packageManager;\n    if (typeof declared !== 'string' || !/^yarn@\\d+\\./.test(declared)) return { upgrade: null, message: 'Declare the Yarn version in packageManager before updating a workspace-root dependency; Yarn Classic and modern Yarn use different root flags.' };\n    if (declared.startsWith('yarn@1.')) workspace = ' -W';\n  }\n  const command = manager === 'npm'\n    ? `npm install${dev} --save-exact ${packageName}@${latest}`\n    : `${manager} add${dev}${workspace} --exact ${packageName}@${latest}`;\n  return { upgrade: { manager, command, cwd: project.directory } };\n}\n\nexport async function fetchLatest(fetcher: typeof fetch = fetch, signal?: AbortSignal): Promise<string> {\n  const controller = new AbortController();\n  const abort = () => controller.abort();\n  if (signal?.aborted) abort();\n  else signal?.addEventListener('abort', abort, { once: true });\n  const timer = setTimeout(abort, CHECK_TIMEOUT);\n  try {\n    if (controller.signal.aborted) throw new Error('Update check cancelled.');\n    const response = await fetcher(REGISTRY_URL, { signal: controller.signal, redirect: 'error', headers: { accept: 'application/json' } });\n    if (!response.ok) throw new Error(`Registry returned HTTP ${response.status}.`);\n    if (!response.body) throw new Error('Registry returned an empty response.');\n    const reader = response.body.getReader();\n    const chunks: Uint8Array[] = [];\n    let bytes = 0;\n    try {\n      while (true) {\n        const { value, done } = await reader.read();\n        if (done) break;\n        bytes += value.byteLength;\n        if (bytes > 64 * 1024) {\n          await reader.cancel();\n          throw new Error('Registry response was too large.');\n        }\n        chunks.push(value);\n      }\n    } finally { reader.releaseLock(); }\n    const data = JSON.parse(Buffer.concat(chunks).toString('utf8'));\n    if (typeof data.version !== 'string') throw new Error('Registry returned no version.');\n    parseVersion(data.version);\n    return data.version;\n  } finally { clearTimeout(timer); signal?.removeEventListener('abort', abort); }\n}\n\nexport function updateInfo(latest: string, cwd: string, manager?: Manager): UpdateInfo {\n  const order = compareVersions(latest, currentVersion);\n  return {\n    currentVersion, latestVersion: latest,\n    status: order > 0 ? 'available' : order < 0 ? 'ahead' : 'current',\n    ...(order > 0 ? upgradePlan(cwd, latest, manager) : { upgrade: null }),\n  };\n}\n\nexport async function checkUpdate(cwd: string, manager?: Manager, fetcher?: typeof fetch, signal?: AbortSignal): Promise<UpdateInfo> {\n  try { return updateInfo(await fetchLatest(fetcher, signal), cwd, manager); }\n  catch { return { currentVersion, latestVersion: null, status: 'unavailable', upgrade: null, message: 'Could not check npm for updates. The installed version remains usable; try again when online.' }; }\n}\n\ninterface CachedCheck { checkedAt: number; latestVersion: string | null }\nasync function readCache(file: string): Promise<CachedCheck | null> {\n  try {\n    if ((await stat(file)).size > 4096) return null;\n    const data = JSON.parse(await readFile(file, 'utf8'));\n    if (!Number.isFinite(data.checkedAt) || data.checkedAt > Date.now() || Date.now() - data.checkedAt >= CACHE_TTL) return null;\n    if (data.latestVersion !== null) parseVersion(data.latestVersion);\n    return data;\n  } catch { return null; }\n}\n\nasync function saveCache(file: string, latestVersion: string | null): Promise<void> {\n  const temporary = `${file}.${randomUUID()}.tmp`;\n  try {\n    await writeFile(temporary, JSON.stringify({ checkedAt: Date.now(), latestVersion }), { mode: 0o600, flag: 'wx' });\n    await rename(temporary, file);\n  } finally { await rm(temporary, { force: true }); }\n}\n\n/** One bounded request a day, including failed attempts, shared across dev servers. */\nexport function startUpdateCheck(cwd: string, enabled = true, options: { cacheFile?: string; fetcher?: typeof fetch; env?: NodeJS.ProcessEnv } = {}): { getSnapshot(): UpdateInfo; ready: Promise<void>; dispose(): void } {\n  const controller = new AbortController();\n  const env = options.env ?? process.env;\n  const off = !enabled || env.ISOTONE_UPDATE_CHECK === '0' || (!!env.CI && env.CI !== 'false' && env.CI !== '0') || env.NODE_ENV === 'test' || !!env.VITEST;\n  let info: UpdateInfo = { currentVersion, latestVersion: null, status: off ? 'disabled' : 'checking', upgrade: null };\n  const ready = off ? Promise.resolve() : (async () => {\n    const file = options.cacheFile ?? CACHE_FILE;\n    let locked = false;\n    try {\n      const cache = await readCache(file);\n      if (cache) { info = cache.latestVersion ? updateInfo(cache.latestVersion, cwd) : { ...info, status: 'unavailable' }; return; }\n      await mkdir(dirname(file), { recursive: true });\n      try { await (await open(`${file}.lock`, 'wx', 0o600)).close(); locked = true; }\n      catch {\n        // A concurrent server owns the request. Recover an abandoned lease next time.\n        if (Date.now() - (await stat(`${file}.lock`)).mtimeMs > CHECK_TIMEOUT * 3) await rm(`${file}.lock`, { force: true });\n        info = { ...info, status: 'unavailable' };\n        return;\n      }\n      const refreshed = await readCache(file);\n      if (refreshed) { info = refreshed.latestVersion ? updateInfo(refreshed.latestVersion, cwd) : { ...info, status: 'unavailable' }; return; }\n      await saveCache(file, null);\n      info = await checkUpdate(cwd, undefined, options.fetcher, controller.signal);\n      if (info.latestVersion) await saveCache(file, info.latestVersion);\n    } catch { info = { currentVersion, latestVersion: null, status: 'unavailable', upgrade: null }; }\n    finally { if (locked) await rm(`${file}.lock`, { force: true }).catch(() => {}); }\n  })();\n  return { getSnapshot: () => info, ready, dispose: () => controller.abort() };\n}\n","{\n  \"name\": \"isotone\",\n  \"version\": \"1.0.0\",\n  \"type\": \"module\",\n  \"license\": \"MIT\",\n  \"description\": \"Local feedback and design variants for your running web app. Pin elements, leave notes, and give your coding agent the context to make the change.\",\n  \"engines\": {\n    \"node\": \">=20\"\n  },\n  \"exports\": {\n    \"./react\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\"\n    },\n    \"./core\": {\n      \"types\": \"./dist/core.d.ts\",\n      \"import\": \"./dist/core.js\"\n    },\n    \"./server\": {\n      \"types\": \"./dist/server.d.ts\",\n      \"import\": \"./dist/server.js\"\n    },\n    \"./serve\": {\n      \"types\": \"./dist/serve.d.ts\",\n      \"import\": \"./dist/serve.js\"\n    },\n    \"./vite\": {\n      \"types\": \"./dist/vite-plugin.d.ts\",\n      \"import\": \"./dist/vite-plugin.js\"\n    },\n    \"./cli\": {\n      \"types\": \"./dist/cli.d.ts\",\n      \"import\": \"./dist/cli.js\"\n    }\n  },\n  \"files\": [\n    \"dist\",\n    \"docs/assets/preview.jpg\",\n    \"docs/integrations.md\",\n    \"docs/migration.md\",\n    \"docs/updates.md\",\n    \"docs/variants.md\",\n    \"docs/third-party-notices.md\",\n    \"AGENTS.md\",\n    \"CHANGELOG.md\"\n  ],\n  \"bin\": {\n    \"isotone\": \"./dist/cli.js\"\n  },\n  \"scripts\": {\n    \"typecheck\": \"tsc --noEmit\",\n    \"lint\": \"biome lint .\",\n    \"lint:fix\": \"biome lint --write .\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"build\": \"tsup\",\n    \"check\": \"pnpm typecheck && pnpm lint && pnpm build && pnpm test\",\n    \"prepublishOnly\": \"pnpm check\",\n    \"dev\": \"vite --config examples/vite.config.ts\",\n    \"check:package\": \"node scripts/check-package.mjs\"\n  },\n  \"peerDependencies\": {\n    \"react\": \"^18 || ^19\",\n    \"react-dom\": \"^18 || ^19\",\n    \"vite\": \"^5 || ^6 || ^7 || ^8\"\n  },\n  \"devDependencies\": {\n    \"@biomejs/biome\": \"2.5.7\",\n    \"@types/node\": \"24.13.3\",\n    \"@types/react\": \"^19\",\n    \"@types/react-dom\": \"^19\",\n    \"jsdom\": \"^30.0.1\",\n    \"react\": \"^19\",\n    \"react-dom\": \"^19\",\n    \"tsup\": \"^8\",\n    \"typescript\": \"^5\",\n    \"vite\": \"^7\",\n    \"vitest\": \"^4.1.10\",\n    \"lucide-react\": \"^1.55.0\"\n  },\n  \"keywords\": [\n    \"feedback\",\n    \"review\",\n    \"dev-tool\",\n    \"vite-plugin\",\n    \"coding-agent\",\n    \"annotations\",\n    \"design-review\",\n    \"variants\",\n    \"iteration\"\n  ],\n  \"sideEffects\": false,\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/aaroi/isotone.git\"\n  },\n  \"homepage\": \"https://github.com/aaroi/isotone#readme\",\n  \"bugs\": \"https://github.com/aaroi/isotone/issues\",\n  \"peerDependenciesMeta\": {\n    \"react\": {\n      \"optional\": true\n    },\n    \"react-dom\": {\n      \"optional\": true\n    },\n    \"vite\": {\n      \"optional\": true\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/update.ts","../package.json"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { mkdir, open, readFile, rename, rm, stat, writeFile } from 'node:fs/promises';\nimport { dirname, join, resolve } from 'node:path';\nimport { tmpdir } from 'node:os';\nimport { randomUUID } from 'node:crypto';\nimport type { UpdateInfo } from './core/update';\nimport { name as packageName, version as currentVersion } from '../package.json';\n\nexport const UPDATE_ENDPOINT = '/api/iteration/update';\nconst REGISTRY_URL = `https://registry.npmjs.org/${packageName}/latest`;\nconst CHECK_TIMEOUT = 5_000;\nconst CACHE_TTL = 24 * 60 * 60 * 1000;\nconst CACHE_FILE = join(tmpdir(), `isotone-update-${process.getuid?.() ?? 'user'}-v1.json`);\n\ntype Manager = 'npm' | 'pnpm' | 'yarn';\nexport type { UpdateInfo } from './core/update';\n\ninterface Version { parts: bigint[]; prerelease: string[] }\nfunction parseVersion(value: string): Version {\n  if (value.length > 256) throw new Error('Invalid version.');\n  const match = /^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-([\\da-zA-Z-]+(?:\\.[\\da-zA-Z-]+)*))?(?:\\+([\\da-zA-Z-]+(?:\\.[\\da-zA-Z-]+)*))?$/.exec(value);\n  if (!match) throw new Error('Invalid version.');\n  const prerelease = match[4]?.split('.') ?? [];\n  if (prerelease.some((part) => /^0\\d+$/.test(part))) throw new Error('Invalid version.');\n  return { parts: match.slice(1, 4).map(BigInt), prerelease };\n}\n\n/** SemVer precedence, including numeric prereleases and ignored build metadata. */\nexport function compareVersions(a: string, b: string): number {\n  const left = parseVersion(a), right = parseVersion(b);\n  for (let i = 0; i < 3; i++) {\n    if (left.parts[i] !== right.parts[i]) return left.parts[i] > right.parts[i] ? 1 : -1;\n  }\n  if (!left.prerelease.length || !right.prerelease.length) {\n    return left.prerelease.length === right.prerelease.length ? 0 : left.prerelease.length ? -1 : 1;\n  }\n  for (let i = 0; i < Math.max(left.prerelease.length, right.prerelease.length); i++) {\n    const x = left.prerelease[i], y = right.prerelease[i];\n    if (x === y) continue;\n    if (x === undefined || y === undefined) return x === undefined ? -1 : 1;\n    const nx = /^\\d+$/.test(x), ny = /^\\d+$/.test(y);\n    if (nx && ny) return BigInt(x) > BigInt(y) ? 1 : -1;\n    if (nx !== ny) return nx ? -1 : 1;\n    return x > y ? 1 : -1;\n  }\n  return 0;\n}\n\nfunction manifest(directory: string): Record<string, unknown> | null {\n  try {\n    const value = JSON.parse(readFileSync(join(directory, 'package.json'), 'utf8'));\n    return value && typeof value === 'object' && !Array.isArray(value) ? value : null;\n  } catch { return null; }\n}\n\nfunction findProject(cwd: string): { directory: string; json: Record<string, unknown> | null } {\n  let directory = resolve(cwd);\n  while (true) {\n    const json = manifest(directory);\n    if (json) return { directory, json };\n    if (dirname(directory) === directory || existsSync(join(directory, '.git'))) return { directory: resolve(cwd), json: null };\n    directory = dirname(directory);\n  }\n}\n\nfunction dependencyOwner(project: ReturnType<typeof findProject>): ReturnType<typeof findProject> {\n  let directory = project.directory;\n  while (true) {\n    const json = manifest(directory);\n    if (['dependencies', 'devDependencies', 'optionalDependencies', 'peerDependencies'].some((key) => {\n      const dependencies = json?.[key];\n      return dependencies && typeof dependencies === 'object' && Object.hasOwn(dependencies, packageName);\n    })) return { directory, json };\n    if (dirname(directory) === directory || existsSync(join(directory, '.git'))) return project;\n    directory = dirname(directory);\n  }\n}\n\nexport function upgradePlan(cwd: string, latest: string, override?: Manager): Pick<UpdateInfo, 'upgrade' | 'message'> {\n  parseVersion(latest); // Only a validated version can enter a copied command.\n  const project = dependencyOwner(findProject(cwd));\n  if (project.json?.name === packageName) return { upgrade: null, message: 'This is the source checkout; update its source instead of adding itself as a dependency.' };\n  let manager = override;\n  let directory = project.directory;\n  const locks = new Set<Manager>();\n  while (!manager) {\n    const declared = manifest(directory)?.packageManager;\n    if (typeof declared === 'string') {\n      const match = /^(npm|pnpm|yarn)@/.exec(declared);\n      if (!match) return { upgrade: null, message: 'The declared package manager is not supported by this command. Upgrade with your project’s package manager.' };\n      manager = match[1] as Manager;\n      break;\n    }\n    if (['bun.lock', 'bun.lockb'].some((file) => existsSync(join(directory, file)))) return { upgrade: null, message: 'This project uses Bun. Upgrade with the project’s package manager.' };\n    if (existsSync(join(directory, 'pnpm-lock.yaml'))) locks.add('pnpm');\n    if (existsSync(join(directory, 'yarn.lock'))) locks.add('yarn');\n    if (['package-lock.json', 'npm-shrinkwrap.json'].some((file) => existsSync(join(directory, file)))) locks.add('npm');\n    if (locks.size || dirname(directory) === directory || existsSync(join(directory, '.git'))) break;\n    directory = dirname(directory);\n  }\n  if (!manager && locks.size > 1) return { upgrade: null, message: 'Multiple package-manager lockfiles found. Pass --manager npm, pnpm or yarn.' };\n  manager ??= [...locks][0] ?? 'npm';\n  const production = project.json?.dependencies as Record<string, unknown> | undefined;\n  const optional = project.json?.optionalDependencies as Record<string, unknown> | undefined;\n  const peers = project.json?.peerDependencies as Record<string, unknown> | undefined;\n  if (optional?.[packageName] || peers?.[packageName]) return { upgrade: null, message: 'Review this optional/peer dependency manually with your package manager.' };\n  const dev = production?.[packageName] ? '' : ' -D';\n  let workspace = manager === 'pnpm' && existsSync(join(project.directory, 'pnpm-workspace.yaml')) ? ' -w' : '';\n  if (manager === 'yarn' && project.json?.workspaces) {\n    const declared = project.json.packageManager;\n    if (typeof declared !== 'string' || !/^yarn@\\d+\\./.test(declared)) return { upgrade: null, message: 'Declare the Yarn version in packageManager before updating a workspace-root dependency; Yarn Classic and modern Yarn use different root flags.' };\n    if (declared.startsWith('yarn@1.')) workspace = ' -W';\n  }\n  const command = manager === 'npm'\n    ? `npm install${dev} --save-exact ${packageName}@${latest}`\n    : `${manager} add${dev}${workspace} --exact ${packageName}@${latest}`;\n  return { upgrade: { manager, command, cwd: project.directory } };\n}\n\nexport async function fetchLatest(fetcher: typeof fetch = fetch, signal?: AbortSignal): Promise<string> {\n  const controller = new AbortController();\n  const abort = () => controller.abort();\n  if (signal?.aborted) abort();\n  else signal?.addEventListener('abort', abort, { once: true });\n  const timer = setTimeout(abort, CHECK_TIMEOUT);\n  try {\n    if (controller.signal.aborted) throw new Error('Update check cancelled.');\n    const response = await fetcher(REGISTRY_URL, { signal: controller.signal, redirect: 'error', headers: { accept: 'application/json' } });\n    if (!response.ok) throw new Error(`Registry returned HTTP ${response.status}.`);\n    if (!response.body) throw new Error('Registry returned an empty response.');\n    const reader = response.body.getReader();\n    const chunks: Uint8Array[] = [];\n    let bytes = 0;\n    try {\n      while (true) {\n        const { value, done } = await reader.read();\n        if (done) break;\n        bytes += value.byteLength;\n        if (bytes > 64 * 1024) {\n          await reader.cancel();\n          throw new Error('Registry response was too large.');\n        }\n        chunks.push(value);\n      }\n    } finally { reader.releaseLock(); }\n    const data = JSON.parse(Buffer.concat(chunks).toString('utf8'));\n    if (typeof data.version !== 'string') throw new Error('Registry returned no version.');\n    parseVersion(data.version);\n    return data.version;\n  } finally { clearTimeout(timer); signal?.removeEventListener('abort', abort); }\n}\n\nexport function updateInfo(latest: string, cwd: string, manager?: Manager): UpdateInfo {\n  const order = compareVersions(latest, currentVersion);\n  return {\n    currentVersion, latestVersion: latest,\n    status: order > 0 ? 'available' : order < 0 ? 'ahead' : 'current',\n    ...(order > 0 ? upgradePlan(cwd, latest, manager) : { upgrade: null }),\n  };\n}\n\nexport async function checkUpdate(cwd: string, manager?: Manager, fetcher?: typeof fetch, signal?: AbortSignal): Promise<UpdateInfo> {\n  try { return updateInfo(await fetchLatest(fetcher, signal), cwd, manager); }\n  catch { return { currentVersion, latestVersion: null, status: 'unavailable', upgrade: null, message: 'Could not check npm for updates. The installed version remains usable; try again when online.' }; }\n}\n\ninterface CachedCheck { checkedAt: number; latestVersion: string | null }\nasync function readCache(file: string): Promise<CachedCheck | null> {\n  try {\n    if ((await stat(file)).size > 4096) return null;\n    const data = JSON.parse(await readFile(file, 'utf8'));\n    if (!Number.isFinite(data.checkedAt) || data.checkedAt > Date.now() || Date.now() - data.checkedAt >= CACHE_TTL) return null;\n    if (data.latestVersion !== null) parseVersion(data.latestVersion);\n    return data;\n  } catch { return null; }\n}\n\nasync function saveCache(file: string, latestVersion: string | null): Promise<void> {\n  const temporary = `${file}.${randomUUID()}.tmp`;\n  try {\n    await writeFile(temporary, JSON.stringify({ checkedAt: Date.now(), latestVersion }), { mode: 0o600, flag: 'wx' });\n    await rename(temporary, file);\n  } finally { await rm(temporary, { force: true }); }\n}\n\n/** One bounded request a day, including failed attempts, shared across dev servers. */\nexport function startUpdateCheck(cwd: string, enabled = true, options: { cacheFile?: string; fetcher?: typeof fetch; env?: NodeJS.ProcessEnv } = {}): { getSnapshot(): UpdateInfo; ready: Promise<void>; dispose(): void } {\n  const controller = new AbortController();\n  const env = options.env ?? process.env;\n  const off = !enabled || env.ISOTONE_UPDATE_CHECK === '0' || (!!env.CI && env.CI !== 'false' && env.CI !== '0') || env.NODE_ENV === 'test' || !!env.VITEST;\n  let info: UpdateInfo = { currentVersion, latestVersion: null, status: off ? 'disabled' : 'checking', upgrade: null };\n  const ready = off ? Promise.resolve() : (async () => {\n    const file = options.cacheFile ?? CACHE_FILE;\n    let locked = false;\n    try {\n      const cache = await readCache(file);\n      if (cache) { info = cache.latestVersion ? updateInfo(cache.latestVersion, cwd) : { ...info, status: 'unavailable' }; return; }\n      await mkdir(dirname(file), { recursive: true });\n      try { await (await open(`${file}.lock`, 'wx', 0o600)).close(); locked = true; }\n      catch {\n        // A concurrent server owns the request. Recover an abandoned lease next time.\n        if (Date.now() - (await stat(`${file}.lock`)).mtimeMs > CHECK_TIMEOUT * 3) await rm(`${file}.lock`, { force: true });\n        info = { ...info, status: 'unavailable' };\n        return;\n      }\n      const refreshed = await readCache(file);\n      if (refreshed) { info = refreshed.latestVersion ? updateInfo(refreshed.latestVersion, cwd) : { ...info, status: 'unavailable' }; return; }\n      await saveCache(file, null);\n      info = await checkUpdate(cwd, undefined, options.fetcher, controller.signal);\n      if (info.latestVersion) await saveCache(file, info.latestVersion);\n    } catch { info = { currentVersion, latestVersion: null, status: 'unavailable', upgrade: null }; }\n    finally { if (locked) await rm(`${file}.lock`, { force: true }).catch(() => {}); }\n  })();\n  return { getSnapshot: () => info, ready, dispose: () => controller.abort() };\n}\n","{\n  \"name\": \"isotone\",\n  \"version\": \"1.0.2\",\n  \"type\": \"module\",\n  \"license\": \"MIT\",\n  \"description\": \"Local feedback and design variants for your running web app. Pin elements, leave notes, and give your coding agent the context to make the change.\",\n  \"engines\": {\n    \"node\": \">=20\"\n  },\n  \"exports\": {\n    \"./react\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\"\n    },\n    \"./core\": {\n      \"types\": \"./dist/core.d.ts\",\n      \"import\": \"./dist/core.js\"\n    },\n    \"./server\": {\n      \"types\": \"./dist/server.d.ts\",\n      \"import\": \"./dist/server.js\"\n    },\n    \"./serve\": {\n      \"types\": \"./dist/serve.d.ts\",\n      \"import\": \"./dist/serve.js\"\n    },\n    \"./vite\": {\n      \"types\": \"./dist/vite-plugin.d.ts\",\n      \"import\": \"./dist/vite-plugin.js\"\n    },\n    \"./cli\": {\n      \"types\": \"./dist/cli.d.ts\",\n      \"import\": \"./dist/cli.js\"\n    }\n  },\n  \"files\": [\n    \"dist\",\n    \"docs/assets/preview.jpg\",\n    \"docs/integrations.md\",\n    \"docs/migration.md\",\n    \"docs/updates.md\",\n    \"docs/variants.md\",\n    \"docs/third-party-notices.md\",\n    \"AGENTS.md\",\n    \"CHANGELOG.md\"\n  ],\n  \"bin\": {\n    \"isotone\": \"./dist/cli.js\"\n  },\n  \"scripts\": {\n    \"typecheck\": \"tsc --noEmit\",\n    \"lint\": \"biome lint .\",\n    \"lint:fix\": \"biome lint --write .\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"build\": \"tsup\",\n    \"check\": \"pnpm typecheck && pnpm lint && pnpm build && pnpm test\",\n    \"prepublishOnly\": \"pnpm check\",\n    \"dev\": \"vite --config examples/vite.config.ts\",\n    \"check:package\": \"node scripts/check-package.mjs\"\n  },\n  \"peerDependencies\": {\n    \"react\": \"^18 || ^19\",\n    \"react-dom\": \"^18 || ^19\",\n    \"vite\": \"^5 || ^6 || ^7 || ^8\"\n  },\n  \"devDependencies\": {\n    \"@biomejs/biome\": \"2.5.7\",\n    \"@types/node\": \"24.13.3\",\n    \"@types/react\": \"^19\",\n    \"@types/react-dom\": \"^19\",\n    \"jsdom\": \"^30.0.1\",\n    \"react\": \"^19\",\n    \"react-dom\": \"^19\",\n    \"tsup\": \"^8\",\n    \"typescript\": \"^5\",\n    \"vite\": \"^7\",\n    \"vitest\": \"^4.1.10\",\n    \"lucide-react\": \"^1.55.0\"\n  },\n  \"keywords\": [\n    \"feedback\",\n    \"review\",\n    \"dev-tool\",\n    \"vite-plugin\",\n    \"coding-agent\",\n    \"annotations\",\n    \"design-review\",\n    \"variants\",\n    \"iteration\"\n  ],\n  \"sideEffects\": false,\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/aaroi/isotone.git\"\n  },\n  \"homepage\": \"https://github.com/aaroi/isotone#readme\",\n  \"bugs\": \"https://github.com/aaroi/isotone/issues\",\n  \"peerDependenciesMeta\": {\n    \"react\": {\n      \"optional\": true\n    },\n    \"react-dom\": {\n      \"optional\": true\n    },\n    \"vite\": {\n      \"optional\": true\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli.js

@@ -20,7 +20,7 @@ import {
 } from "./chunk-OSETWKGE.js";
 import {
   checkUpdate
-} from "./chunk-BJ4UI73I.js";
+} from "./chunk-O6WJ5CTR.js";
 import {
   readNotes,
   updateNotes

package/dist/index.js

@@ -45,7 +45,7 @@ function showOverflowTitle(event) {
 }
 
 // src/react/IterationPanel.tsx
-import { useCallback, useEffect as useEffect3, useId as useId2, useLayoutEffect as useLayoutEffect3, useMemo as useMemo3, useRef as useRef4, useState as useState3 } from "react";
+import { useCallback, useEffect as useEffect3, useId as useId2, useLayoutEffect as useLayoutEffect4, useMemo as useMemo3, useRef as useRef4, useState as useState3 } from "react";
 
 // src/react/appearance.ts
 var darkPalette = {
@@ -788,14 +788,14 @@ ${APPEARANCE_CSS}
 .isotone-root .isotone-vars > .isotone-panel-head:has(.isotone-save) { position: relative; z-index: 1; margin-top: calc(0px - var(--iso-space)); background: linear-gradient(to bottom, transparent, var(--iso-bg) var(--iso-space)); }
 .isotone-root .isotone-vars > .isotone-panel-head:not(:has(.isotone-save)) { display: none; }
 .isotone-root .isotone-vars > .isotone-panel-head :is(h2, .isotone-icon) { display: none; }
-.isotone-root .isotone-axis-menu { top: 6px; min-height: min(260px, calc(100% - 12px)); max-height: calc(100% - 12px); }
+.isotone-root .isotone-axis-menu { top: var(--iso-menu-top, 6px); max-height: calc(100% - var(--iso-menu-top, 6px) - 6px); }
 .isotone-root .isotone-save-state { top: auto; bottom: 27px; }
 .isotone-panel-head h2 { font-size: 12px; font-weight: 600; letter-spacing: -.01em; }
 .isotone-head-actions { display: flex; align-items: center; gap: 6px; margin-right: auto; }
 .isotone-icon { width: 28px; height: 28px; display: inline-grid; place-items: center; flex: none; color: var(--iso-muted); border-radius: 6px; }
 .isotone-count { margin-left: 5px; color: var(--iso-muted); font-size: 10px; font-variant-numeric: tabular-nums; }
 .isotone-vars { flex: 1; display: flex; flex-direction: column; min-height: 0; position: relative; }
-.isotone-variants-panel:has(.isotone-axis-menu[data-open='true']) { flex-basis: min(360px, calc(100dvh - 76px)); }
+.isotone-vars { min-height: min(var(--iso-menu-need, 0px), calc(100dvh - 76px)); }
 .isotone-vars-body { flex: 1; overflow-y: auto; min-height: 0; overscroll-behavior: contain; padding: var(--iso-space); display: flex; flex-direction: column; gap: var(--iso-space); }
 /* The footer overlaps only the scroller's bottom padding: content fades beneath
    it while scrolling, but the last control remains fully visible at the end. */
@@ -863,7 +863,7 @@ ${PILL_ACTIVE_CSS}
    Cancelling margin/padding keeps the first row in place at scroll start; the
    expanded height preserves the content allowance and composer position.
    The side gutters contain the corner action and keyboard focus outlines. */
-.isotone-list { display: flex; flex-direction: column; gap: 0; flex: 0 1 auto; max-height: calc(var(--iso-list-height) + 2 * var(--iso-space) - 8px); min-height: 0; overflow-y: auto; overscroll-behavior: contain; margin: calc(0px - var(--iso-space)) calc(-8px - var(--iso-note-outset)); padding: var(--iso-space) 8px; scroll-padding-block: var(--iso-space); mask-image: linear-gradient(to bottom, transparent, #000 var(--iso-space), #000 calc(100% - var(--iso-space)), transparent); }
+.isotone-list { display: flex; flex-direction: column; gap: 0; flex: 0 1 auto; max-height: calc(var(--iso-list-height) + 2 * var(--iso-space) - 8px); min-height: 0; overflow-y: auto; overscroll-behavior: contain; margin: calc(0px - var(--iso-space)) calc(-8px - var(--iso-note-outset)) calc(-2px - var(--iso-space)); padding: var(--iso-space) 8px; scroll-padding-block: var(--iso-space); mask-image: linear-gradient(to bottom, transparent, #000 var(--iso-space), #000 calc(100% - var(--iso-space)), transparent); }
 .isotone-empty { color: var(--iso-muted); font-size: 11px; line-height: 1.7; padding: 8px; }
 .isotone-note { position: relative; flex: none; }
 .isotone-request-heading { display: flex; align-items: center; gap: 8px; line-height: 14px; }
@@ -895,14 +895,13 @@ ${FEEDBACK_LAYOUT_CSS}
 .isotone-context > .isotone-chip:not(:only-child) { max-width: calc(100% - 32px); }
 .isotone-chip > span { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .isotone-chip button { display: grid; place-items: center; flex: none; width: 16px; height: 16px; border-radius: 3px; background: transparent; box-shadow: none; }
-.isotone-root .isotone-textarea { --iso-textarea-inset: 8px; display: block; width: 100%; flex: none; height: 24px; min-height: calc(24px + var(--iso-textarea-inset)); max-height: calc(120px + var(--iso-textarea-inset)); overflow-y: auto; resize: none; margin-top: calc(0px - var(--iso-textarea-inset)); padding: calc(var(--iso-textarea-inset) + 2px) 2px 2px; color: var(--iso-fg); background: transparent; border: 0; border-radius: 0; font-size: 12px; line-height: 20px; box-shadow: none; cursor: text; }
+.isotone-root .isotone-textarea { --iso-textarea-inset: 8px; display: block; width: 100%; flex: none; height: 22px; min-height: calc(22px + var(--iso-textarea-inset)); max-height: calc(120px + var(--iso-textarea-inset)); overflow-y: auto; resize: none; margin-top: calc(0px - var(--iso-textarea-inset)); padding: calc(var(--iso-textarea-inset) + 1px) 1px 1px; scrollbar-width: thin; scrollbar-color: color-mix(in srgb, var(--iso-fg) 14%, transparent) transparent; color: var(--iso-fg); background: transparent; border: 0; border-radius: 0; font-size: 12px; line-height: 20px; box-shadow: none; cursor: text; }
 /* Text scrolls through the gap below tags, or the field inset without tags. */
 .isotone-root .isotone-context:empty + .isotone-textarea { --iso-textarea-inset: var(--iso-input-padding); }
 .isotone-textarea::placeholder { color: var(--iso-faint); }
 .isotone-root .isotone-textarea:focus-visible { outline: none; }
 .isotone-textarea[data-scrolled='true'] { mask-image: linear-gradient(to bottom, transparent, #000 8px); }
 .isotone-toolbar { display: flex; flex: none; align-items: center; gap: 7px; height: 28px; }
-.isotone-key-hint { color: var(--iso-faint); font-size: 9px; }
 .isotone-pick[aria-pressed='true'] { color: var(--iso-fg); }
 .isotone-pick, .isotone-send { position: relative; width: 24px; height: 24px; }
 /* Keep a 28px hit area around the quieter composer faces. */
@@ -949,7 +948,7 @@ function ensurePanelStyles(target) {
 }
 
 // src/react/VariantsView.tsx
-import { useEffect as useEffect2, useMemo as useMemo2, useRef as useRef3, useState as useState2 } from "react";
+import { useEffect as useEffect2, useLayoutEffect as useLayoutEffect2, useMemo as useMemo2, useRef as useRef3, useState as useState2 } from "react";
 
 // src/react/useLayoutMotion.ts
 import { useLayoutEffect, useRef as useRef2 } from "react";
@@ -1084,6 +1083,45 @@ function VariantsView({
   useEffect2(() => {
     if (!menu) setMenuOpen(false);
   }, [menu]);
+  useLayoutEffect2(() => {
+    const root = bodyRef.current?.parentElement;
+    const dialog = menuRef.current;
+    const scroll = dialog?.querySelector(".isotone-menu-scroll");
+    if (!root) return;
+    const clear = () => {
+      root.style.removeProperty("--iso-menu-need");
+      root.style.removeProperty("--iso-menu-top");
+    };
+    if (!menuOpen || !dialog || !scroll) {
+      clear();
+      return;
+    }
+    const place = () => {
+      const natural = dialog.offsetHeight + scroll.scrollHeight - scroll.clientHeight;
+      root.style.setProperty("--iso-menu-need", `${natural + 12}px`);
+      const heading = trigger.current?.isConnected ? trigger.current.getBoundingClientRect().top : 0;
+      const top = heading - root.getBoundingClientRect().top - natural - 6;
+      root.style.setProperty("--iso-menu-top", `${Number.isFinite(top) && top >= 6 ? top : 6}px`);
+    };
+    place();
+    window.addEventListener("resize", place);
+    const observer = typeof ResizeObserver === "undefined" ? null : new ResizeObserver(place);
+    observer?.observe(scroll);
+    return () => {
+      window.removeEventListener("resize", place);
+      observer?.disconnect();
+      clear();
+    };
+  }, [menuOpen, menu, menuOptions.length, error]);
+  useEffect2(() => {
+    if (!menuOpen) return;
+    const onPointerDown = (e) => {
+      const dialog = menuRef.current;
+      if (dialog && !e.composedPath().includes(dialog)) closeMenu();
+    };
+    window.addEventListener("pointerdown", onPointerDown, true);
+    return () => window.removeEventListener("pointerdown", onPointerDown, true);
+  }, [menuOpen]);
   useEffect2(() => {
     if (menuOpen)
       menuRef.current?.querySelector("button")?.focus();
@@ -1145,7 +1183,7 @@ function VariantsView({
       node?.toggleAttribute("inert", menuOpen);
     }, children: [
       sourceError && /* @__PURE__ */ jsx3("p", { className: "isotone-danger", role: "alert", children: sourceError }),
-      shown.length === 0 && /* @__PURE__ */ jsx3("p", { className: "isotone-empty", children: "No variant selectors on this page." }),
+      shown.length === 0 && /* @__PURE__ */ jsx3("p", { className: "isotone-empty", children: "No variants on this page yet. Ask your agent to create variants of any design and they will appear here." }),
       shown.map((axis) => {
         const thumbnails = axis.kind !== "range" && axis.kind !== "color" && axis.options.length > 0 && axis.options.every((option) => option.image);
         return /* @__PURE__ */ jsxs2(
@@ -1598,9 +1636,9 @@ function NoteSummary({ note }) {
 }
 
 // src/react/useDockMotion.ts
-import { useLayoutEffect as useLayoutEffect2 } from "react";
+import { useLayoutEffect as useLayoutEffect3 } from "react";
 function useDockMotion(ref, visible) {
-  useLayoutEffect2(() => {
+  useLayoutEffect3(() => {
     const root = ref.current;
     if (!root || !visible) return;
     const previous = /* @__PURE__ */ new Map();
@@ -1734,7 +1772,6 @@ function IterationPanel({
   const pendingWrites = useRef4(0);
   const noteRequest = useRef4(0);
   const [editing, setEditing] = useState3(null);
-  const [unsynced, setUnsynced] = useState3(false);
   const [notice, setNotice] = useState3("");
   const [theme, setTheme] = useState3(() => detectTheme(themePreference));
   const [instant, setInstant] = useState3(false);
@@ -1755,13 +1792,13 @@ function IterationPanel({
     variants && visibleAxes(variants.getAxes(), variants.getSelections()).length
   );
   const visible = isRouteVisible(route, rule) && (notesAvailable || variantsAvailable || variantsOpen);
-  const hasContext = Boolean(editing || variantTarget || targets.length || notice || unsynced);
-  useLayoutEffect3(() => {
+  const hasContext = Boolean(editing || variantTarget || targets.length || notice);
+  useLayoutEffect4(() => {
     const field = textareaRef.current;
     if (!field || !notesOpen || !visible) return;
     const resize = () => {
       field.style.height = "0px";
-      field.style.height = `${text ? Math.max(24, field.scrollHeight) : 24}px`;
+      field.style.height = `${text ? Math.max(22, field.scrollHeight) : 22}px`;
       field.dataset.scrolled = String(field.scrollTop > 0);
     };
     resize();
@@ -1827,7 +1864,6 @@ function IterationPanel({
     void store.listNotes().then((fresh) => {
       if (request !== noteRequest.current || revision !== noteRevision.current || pendingWrites.current) return;
       setNotes(fresh);
-      setUnsynced(store.hasUnsyncedNotes);
     }).catch(() => {
     });
   }
@@ -1839,6 +1875,15 @@ function IterationPanel({
       pendingWrites.current--;
     };
   }
+  const keepPicking = useRef4(false);
+  const focusWhilePicking = useCallback(() => {
+    cancelAnimationFrame(focusFrame.current);
+    focusFrame.current = requestAnimationFrame(() => {
+      keepPicking.current = true;
+      textareaRef.current?.focus();
+      keepPicking.current = false;
+    });
+  }, []);
   const focusComposer = useCallback(() => {
     cancelAnimationFrame(focusFrame.current);
     focusFrame.current = requestAnimationFrame(
@@ -1894,7 +1939,6 @@ function IterationPanel({
         createdAt: (/* @__PURE__ */ new Date()).toISOString(),
         ...context
       }]);
-      setUnsynced(store.hasUnsyncedNotes);
       setNotesOpen(true);
     } finally {
       finish();
@@ -1949,7 +1993,6 @@ function IterationPanel({
       setNotes(
         (prev) => prev.map((n) => n.id === tempId ? { ...n, id: savedId } : n)
       );
-      setUnsynced(store.hasUnsyncedNotes);
     } catch {
       setNotes(
         (prev) => previous ? prev.map((n) => n.id === tempId ? previous : n) : prev.filter((n) => n.id !== tempId)
@@ -2038,7 +2081,7 @@ function IterationPanel({
     const el = listRef.current;
     if (el) el.scrollTop = el.scrollHeight;
   }, [notes, notesOpen]);
-  useLayoutEffect3(() => {
+  useLayoutEffect4(() => {
     if (!visible) return;
     const root = rootRef.current?.getRootNode();
     if (root instanceof ShadowRoot || root instanceof Document)
@@ -2098,8 +2141,9 @@ function IterationPanel({
     };
     const onMove = (e) => {
       cancelAnimationFrame(frame);
+      const deferred = e.shiftKey;
       frame = requestAnimationFrame(() => {
-        const el = elementAt(e);
+        const el = deferred ? null : elementAt(e);
         setHoverRect(el ? el.getBoundingClientRect() : null);
       });
     };
@@ -2110,11 +2154,13 @@ function IterationPanel({
       );
     };
     const onClick = (e) => {
+      if (e.shiftKey) return;
       const el = elementAt(e);
       if (!el) return;
       e.preventDefault();
       e.stopImmediatePropagation();
       toggleTarget(el);
+      focusWhilePicking();
     };
     const onKey = (e) => {
       if (e.key === " ") {
@@ -2145,7 +2191,17 @@ function IterationPanel({
       window.removeEventListener("click", onClick, true);
       window.removeEventListener("keydown", onKey, true);
     };
-  }, [picking, focusComposer]);
+  }, [picking, focusComposer, focusWhilePicking]);
+  useEffect3(() => {
+    const shadow = rootRef.current?.getRootNode();
+    if (!(shadow instanceof ShadowRoot)) return;
+    const stop = (e) => e.stopPropagation();
+    const types = ["pointerdown", "pointerup", "mousedown", "mouseup", "touchstart", "touchend", "click"];
+    for (const type of types) shadow.addEventListener(type, stop);
+    return () => {
+      for (const type of types) shadow.removeEventListener(type, stop);
+    };
+  }, []);
   useEffect3(() => {
     if (!picking) {
       setRects([]);
@@ -2347,7 +2403,7 @@ function IterationPanel({
                   },
                   target.selector
                 )),
-                (notice || unsynced) && /* @__PURE__ */ jsx5("p", { role: "status", className: "isotone-notice", children: notice || "Saved in this browser. It will sync when the dev server returns." })
+                notice && /* @__PURE__ */ jsx5("p", { role: "status", className: "isotone-notice", children: notice })
               ] }),
               /* @__PURE__ */ jsx5(
                 "textarea",
@@ -2356,7 +2412,10 @@ function IterationPanel({
                   value: text,
                   "aria-label": "Feedback for the agent",
                   onChange: (e) => setText(e.target.value),
-                  onFocus: () => setPicking(false),
+                  onFocus: () => {
+                    if (!keepPicking.current) setPicking(false);
+                  },
+                  onPointerDown: () => setPicking(false),
                   onScroll: (event) => {
                     event.currentTarget.dataset.scrolled = String(event.currentTarget.scrollTop > 0);
                   },
@@ -2380,6 +2439,7 @@ function IterationPanel({
                     "aria-label": "Select elements",
                     "aria-pressed": picking,
                     className: "isotone-pick isotone-icon",
+                    onMouseDown: (e) => e.preventDefault(),
                     onClick: () => {
                       cancelAnimationFrame(focusFrame.current);
                       setPicking((v) => !v);
@@ -2387,7 +2447,6 @@ function IterationPanel({
                     children: /* @__PURE__ */ jsx5(Icon2, { name: "pin", size: 14 })
                   }
                 ),
-                picking && /* @__PURE__ */ jsx5("span", { className: "isotone-key-hint", children: "Click or Space to pin \xB7 Enter to finish" }),
                 /* @__PURE__ */ jsx5(
                   "button",
                   {
@@ -2425,7 +2484,7 @@ function IterationPanel({
         picking && /* @__PURE__ */ jsxs4("div", { className: "isotone-hint", "data-isotone": true, children: [
           /* @__PURE__ */ jsxs4("span", { children: [
             targets.length,
-            " selected \xB7 click to add or remove"
+            " selected \xB7 click to add or remove \xB7 hold \u21E7 to use the page"
           ] }),
           /* @__PURE__ */ jsxs4(
             "button",