isotone 1.0.7 → 1.0.8

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 1.0.8
+
+- feat: close either panel from a corner button
+
 ## 1.0.7
 
 - feat: live notes, page scope and agent progress in the panel (#12)

package/README.md

@@ -1,14 +1,41 @@
 # Isotone
 
-Point at what you want changed. Let your coding agent take it from there.
+Point at the part of your app you want changed, say what should change, and your
+coding agent gets the exact element, page and screen size with your note.
 
-Pin elements in your running app, leave feedback, and compare design variants.
-Notes stay in your project with the route, viewport, and element references your
-agent needs. No account, database, or hosted service.
+![A running app with one pinned element and the Isotone feedback panel](docs/assets/preview.jpg)
 
-![The same feedback and variants panel in light and dark mode](docs/assets/preview.jpg)
+## Why
 
-## Start
+Coding agents write UI fast, but telling one which piece of UI you mean is slow.
+You type "the label above the number in the first stats card", the agent guesses
+a component, and the next round goes to correcting the guess. Comparing two
+design directions is worse: you ask for one, review it, ask for the other, and
+try to remember what the first looked like.
+
+Some agents let you select an element, Claude Code among them, but only inside
+the browser they ship with. You lose your own browser with its sign-ins,
+extensions, devtools and window sizes, and each selection lives in a single chat
+message.
+
+Isotone is a purpose-built tool for design engineering with a coding agent. It
+runs in your dev server and adds a small panel to the page you already have open:
+
+- Pin one or more elements and write a note. The note records the route, the
+  viewport, and a selector and the visible text of every pinned element.
+- Keep a backlog. Notes go to a JSON file in your project, so you can keep
+  writing while the agent works through them.
+- Follow progress. The agent marks a note as started and closes it when the
+  change is verified, and the panel updates without a reload.
+- Compare variants. The agent can build two or three versions of a component.
+  You switch between them on the live page, comment on one, or keep the default.
+- Use any agent. Agents read notes with `npx isotone --json`, so nothing depends
+  on a particular agent, editor or browser.
+
+There is no account, database or hosted service, and nothing is added to
+production builds.
+
+## Install
 
 Run in the project you want to review:
 
@@ -17,14 +44,11 @@ npm install -D isotone
 npx isotone init --yes
 ```
 
-The second command detects your setup, prints the integration, and adds a short
-workflow to `AGENTS.md`. It does not edit your app. Your coding agent can apply
-the printed instructions.
-
-Already using the previous package? Follow the [migration guide](docs/migration.md)
-to keep your notes, variants, and project setup.
+`init` detects your setup, prints the integration to add, and adds a short
+workflow to `AGENTS.md` so your agent knows the loop. It does not edit app code.
 
-For **Vite**, add the plugin alongside your existing plugins:
+For **Vite**, add the plugin next to your existing plugins. It works with any
+Vite framework:
 
 ```ts
 import { defineConfig } from 'vite';
@@ -35,9 +59,6 @@ export default defineConfig({
 });
 ```
 
-Works with any Vite framework. The panel brings its own React runtime and is
-only injected by the development server.
-
 For **any other dev server**, run `npx isotone serve` and add this to your
 development HTML:
 
@@ -45,52 +66,33 @@ development HTML:
 <script src="http://127.0.0.1:4123/isotone.js" defer></script>
 ```
 
-[Integration guide](docs/integrations.md) covers route handlers, React embeds,
-configuration, and production guards. Node.js 20 or later is required.
+The [integration guide](docs/integrations.md) covers Next and other route
+handlers, React embeds, themes and production guards. Node.js 20 or later is
+required. Coming from the previous package? See the [migration guide](docs/migration.md).
 
 ## The loop
 
-1. Open Feedback with **⌘/Ctrl + Shift + .** Write a note, pin elements, and send.
+1. Open Feedback with **⌘/Ctrl + Shift + .**, pin elements, write a note and send.
 2. Your agent reads `npx isotone --json`, marks the note it starts with
-   `npx isotone --working <id>`, makes and verifies the change, then closes it with
-   `npx isotone --done <id>`. The panel follows along without a reload.
-3. Review the result. For alternatives, the agent creates a
-   [variant](docs/variants.md) you can switch to in the same page.
-
-The panel lists the current page's notes. When other pages have open notes too,
-a row of page chips lets you include them.
-
-Click a saved note to edit it. **Enter** sends; **Shift + Enter** adds a newline.
-While selecting elements, click to pin or Tab to a page control and press Space.
-Enter or Escape finishes selection. The selected element text stays attached to
-the note; closing the panel preserves your draft.
-
-## Themes
-
-The panel follows the rendered page by default. Set `theme` on the Vite plugin,
-`mountIteration`, or `IterationPanel`:
-
-```ts
-iteration({ theme: 'auto' }); // page background; the default
-iteration({ theme: 'system' }); // operating system preference
-iteration({ theme: 'light' }); // explicit light, or 'dark'
-```
+   `npx isotone --working <id>`, makes and checks the change, then closes it
+   with `npx isotone --done <id>`.
+3. Review the result on the page. For alternatives, ask for
+   [variants](docs/variants.md) and switch between them in place.
 
-Standalone: `npx isotone serve --theme dark`.
-Automatic detection samples background colours; use an explicit theme for
-image-led or unusual layered backgrounds. The demo has separate page and panel
-theme controls so you can try each combination.
+The panel lists the current page's notes. When other pages have open notes,
+page chips let you include them. Click a saved note to edit it. **Enter** sends
+and **Shift + Enter** adds a newline. While selecting, click to pin, hold
+**Shift** to use the page normally, and press Enter or Escape to finish.
 
 ## Updates
 
-The dev server checks public npm in the background, at most once a day while its
-cache is retained. A quiet notice offers an exact upgrade command; you or your
-agent choose when to run it. Checks fail quietly offline and never send project
-content. Use `checkForUpdates: false` to opt out. [Update details](docs/updates.md).
+The dev server checks npm for a newer version at most once a day and shows the
+upgrade command in the panel. The check sends no project content and stays quiet
+offline. Set `checkForUpdates: false` to turn it off. [Update details](docs/updates.md).
 
 ## For maintainers
 
 [Development and contributing](https://github.com/aaroi/isotone/blob/main/docs/development.md)
-covers the source, design language, checks, and releases.
+covers the source, design language, checks and releases.
 
 MIT.

package/dist/{chunk-WMNR7KVD.js → chunk-YFQXGHNT.js}

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

package/dist/{chunk-WMNR7KVD.js.map → chunk-YFQXGHNT.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.7\",\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.8\",\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-WMNR7KVD.js";
+} from "./chunk-YFQXGHNT.js";
 import {
   readNotes,
   updateNotes

package/dist/index.js

@@ -781,7 +781,17 @@ ${APPEARANCE_CSS}
 .isotone-panel[data-open='true'] { display: flex; }
 .isotone-variants-panel { flex-shrink: 1; max-height: calc(100dvh - 76px); }
 .isotone-notes-panel { flex-shrink: 0; max-height: calc(100dvh - 76px); padding: var(--iso-space); gap: var(--iso-space); }
-.isotone-root .isotone-panel { background: var(--iso-bg); border: 1px solid var(--iso-line); border-radius: 12px; box-shadow: var(--iso-panel-shadow); overflow: hidden; }
+.isotone-root .isotone-panel { background: var(--iso-bg); border: 1px solid var(--iso-line); border-radius: 12px; box-shadow: var(--iso-panel-shadow); }
+/* The close control sits on the panel's top-left corner, half outside it, with
+   the same face as a note's delete button, a touch larger. It fades in while the
+   pointer is over the panel; keyboard focus and touch screens always show it. */
+.isotone-panel-close { position: absolute; left: -9px; top: -9px; z-index: 3; width: 26px; height: 26px; display: grid; place-items: center; padding: 0; border: 0; isolation: isolate; color: var(--iso-muted); background: none; opacity: 0; }
+.isotone-panel-close::before { content: ''; position: absolute; inset: 4px; border-radius: 50%; z-index: -1; background: var(--iso-bg); box-shadow: 0 0 0 1px var(--iso-edge); transition: background-color 120ms ease; }
+.isotone-root .isotone-panel > .isotone-panel-close { transition: opacity 220ms ease, color 120ms ease; }
+.isotone-root .isotone-panel:hover > .isotone-panel-close, .isotone-panel-close:focus-visible { opacity: 1; }
+.isotone-root .isotone-panel > .isotone-panel-close:hover { color: var(--iso-fg); }
+.isotone-panel-close:hover::before { background: var(--iso-control-hover-face); }
+@media (hover: none) { .isotone-panel-close { opacity: 1; } }
 .isotone-panel-head { flex: 0 0 42px; min-height: 42px; display: flex; align-items: center; justify-content: space-between; padding: 0 8px 0 14px; gap: 8px; border-bottom: 1px solid var(--iso-line); }
 .isotone-root .isotone-notes-panel > .isotone-panel-head { display: none; }
 .isotone-root .isotone-vars > .isotone-panel-head { order: 2; flex: 0 0 auto; min-height: 48px; padding: var(--iso-space); border: 0; }
@@ -795,6 +805,8 @@ ${APPEARANCE_CSS}
 .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-vars { min-height: min(var(--iso-menu-need, 0px), calc(100dvh - 76px)); }
+/* The panel no longer clips, so its corner close can overhang; the variants body clips itself. */
+.isotone-root .isotone-panel > .isotone-vars { overflow: hidden; border-radius: 11px; }
 .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. */
@@ -914,7 +926,9 @@ ${FEEDBACK_LAYOUT_CSS}
 .isotone-pick::after, .isotone-send::after { content: ''; position: absolute; inset: -2px; border-radius: inherit; }
 .isotone-send { display: grid; place-items: center; margin-left: auto; flex: none; }
 .isotone-notice { font-size: 10px; color: var(--iso-muted); }
-.isotone-hint { position: fixed; top: 16px; left: 50%; transform: translateX(-50%); display: flex; align-items: center; gap: 12px; padding: 8px 10px 8px 14px; border-radius: 24px; background: var(--iso-bg); box-shadow: var(--iso-shadow); font-size: 11px; white-space: nowrap; }
+.isotone-hint { position: fixed; top: 16px; left: 50%; transform: translateX(-50%); display: flex; align-items: center; gap: 12px; padding: 8px 10px 8px 14px; border-radius: 24px; background: var(--iso-bg); box-shadow: var(--iso-shadow); font-size: 11px; white-space: nowrap; transition: opacity 120ms ease; }
+/* Near the pointer the hint fades and lets the page underneath be hovered and pinned. */
+.isotone-root .isotone-hint[data-away='true'] { opacity: 0; pointer-events: none; }
 .isotone-hint button { display: flex; align-items: center; gap: 8px; border-radius: 14px; padding: 5px 9px; }
 .isotone-hint kbd { font: inherit; color: var(--iso-muted); }
 .isotone-hover { position: fixed; pointer-events: none; border: 1px solid var(--iso-pick-line); background: var(--iso-pick-fill); border-radius: 5px; z-index: 2147483001; }
@@ -942,6 +956,8 @@ ${FEEDBACK_LAYOUT_CSS}
   .isotone-root button:not(:disabled):active > svg { transform: none; }
 }
 .isotone-root[data-instant='true'] *, .isotone-root[data-instant='true'] *::before, .isotone-root[data-instant='true'] *::after { transition-duration: 0s !important; transition-delay: 0s !important; animation: none !important; }
+/* Instant mode follows any key press, but the corner close only ever appears under the pointer, so it keeps its fade. */
+.isotone-root[data-instant='true'] .isotone-panel > .isotone-panel-close { transition-duration: 220ms, 120ms !important; }
 ${UPDATE_NOTICE_CSS}
 `;
 function ensurePanelStyles(target) {
@@ -1827,6 +1843,8 @@ function IterationPanel({
     null
   );
   const [hoverRect, setHoverRect] = useState3(null);
+  const [hintAway, setHintAway] = useState3(false);
+  const hintRef = useRef4(null);
   const [rects, setRects] = useState3([]);
   const [text, setText] = useState3("");
   const [notes, setNotes] = useState3([]);
@@ -2276,6 +2294,11 @@ function IterationPanel({
       cancelAnimationFrame(frame);
       const deferred = e.shiftKey;
       frame = requestAnimationFrame(() => {
+        const hint = hintRef.current?.getBoundingClientRect();
+        const reach = 48;
+        setHintAway(
+          !!hint && e.clientX > hint.left - reach && e.clientX < hint.right + reach && e.clientY > hint.top - reach && e.clientY < hint.bottom + reach
+        );
         const el = deferred ? null : elementAt(e);
         setHoverRect(el ? el.getBoundingClientRect() : null);
       });
@@ -2320,6 +2343,7 @@ function IterationPanel({
       document.body.style.cursor = cursor;
       cancelAnimationFrame(frame);
       setHoverRect(null);
+      setHintAway(false);
       window.removeEventListener("mousemove", onMove, true);
       window.removeEventListener("click", onClick, true);
       window.removeEventListener("keydown", onKey, true);
@@ -2376,7 +2400,7 @@ function IterationPanel({
       window.removeEventListener("resize", schedule);
     };
   }, [targets, picking]);
-  const variantsPanel = variants && /* @__PURE__ */ jsx5(
+  const variantsPanel = variants && /* @__PURE__ */ jsxs4(
     "section",
     {
       id: `${id}-variants`,
@@ -2388,21 +2412,27 @@ function IterationPanel({
       ref: (node) => {
         node?.toggleAttribute("inert", !variantsOpen);
       },
-      children: /* @__PURE__ */ jsx5(
-        VariantsView,
-        {
-          source: variants,
-          active: variantsOpen,
-          onClose: () => {
-            setVariantsOpen(false);
-            setExpanded(false);
-          },
-          onFeedback: notesAvailable ? feedback : void 0,
-          onSaved: loadNotes,
-          onManage: notesAvailable ? queueRemoval : void 0,
-          pendingActions
-        }
-      )
+      children: [
+        /* @__PURE__ */ jsx5(PanelClose, { label: "Close variants", onClose: () => {
+          setVariantsOpen(false);
+          setExpanded(false);
+        } }),
+        /* @__PURE__ */ jsx5(
+          VariantsView,
+          {
+            source: variants,
+            active: variantsOpen,
+            onClose: () => {
+              setVariantsOpen(false);
+              setExpanded(false);
+            },
+            onFeedback: notesAvailable ? feedback : void 0,
+            onSaved: loadNotes,
+            onManage: notesAvailable ? queueRemoval : void 0,
+            pendingActions
+          }
+        )
+      ]
     }
   );
   const notesPanel = notesAvailable && /* @__PURE__ */ jsxs4(
@@ -2418,6 +2448,17 @@ function IterationPanel({
         node?.toggleAttribute("inert", !notesOpen);
       },
       children: [
+        /* @__PURE__ */ jsx5(
+          PanelClose,
+          {
+            label: "Close feedback",
+            onClose: () => {
+              setNotesOpen(false);
+              setExpanded(false);
+              setPicking(false);
+            }
+          }
+        ),
         /* @__PURE__ */ jsxs4("div", { className: "isotone-panel-head", children: [
           /* @__PURE__ */ jsxs4("h2", { children: [
             "Feedback",
@@ -2633,7 +2674,7 @@ function IterationPanel({
       className: "isotone-root",
       children: [
         /* @__PURE__ */ jsx5("div", { className: "isotone-rail-track", "aria-hidden": "true" }),
-        picking && /* @__PURE__ */ jsxs4("div", { className: "isotone-hint", "data-isotone": true, children: [
+        picking && /* @__PURE__ */ jsxs4("div", { ref: hintRef, className: "isotone-hint", "data-isotone": true, "data-away": hintAway, children: [
           /* @__PURE__ */ jsxs4("span", { children: [
             targets.length,
             " selected \xB7 click to add or remove \xB7 hold \u21E7 to use the page"
@@ -2786,6 +2827,9 @@ function IterationPanel({
     }
   );
 }
+function PanelClose({ label, onClose }) {
+  return /* @__PURE__ */ jsx5("button", { type: "button", className: "isotone-panel-close", "aria-label": label, title: label, onClick: onClose, children: /* @__PURE__ */ jsx5(Icon2, { name: "close", size: 12 }) });
+}
 
 // src/react/IterationMount.tsx
 import { createRoot } from "react-dom/client";