sheer-ui 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 polumeyv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# sheer-ui
+
+Svelte 5 component library built on [Tailwind CSS v4](https://tailwindcss.com). The headless primitives are a vendored copy of [bits-ui](https://bits-ui.com) (see `src/lib/VENDORED.md`), so the package has no Svelte component dependencies to fight bundlers over.
+
+## Components
+
+Accordion, Alert, Alert Dialog, Aspect Ratio, Avatar, Badge, Breadcrumb, Button, Button Group, Card, Carousel, Chart, Checkbox, Collapsible, Command, Context Menu, Copy Button, Data Table, Dialog, Drawer, Dropdown Menu, Empty, Field, Hover Card, Image Cropper, Input, Input Group, Input OTP, Item, Kbd, Label, Menubar, Native Select, Navigation Menu, Pagination, Popover, Progress, Radio Group, Resizable, Scroll Area, Select, Separator, Share Card, Sheet, Sidebar, Skeleton, Slider, Sonner, Spinner, Switch, Table, Tabs, Textarea, Theme Toggle, Toggle, Toggle Group, Tooltip
+
+## Install
+
+```bash
+bun add sheer-ui
+```
+
+## CSS Import
+
+Import the theme CSS:
+
+```svelte
+<script>
+  import 'sheer-ui/styles';
+</script>
+```
+
+This requires your app to provide the font files separately, since the CSS references `/fonts/...` paths.
+
+## Usage
+
+```svelte
+<script>
+  import { Button } from 'sheer-ui';
+</script>
+
+<Button variant="outline">Click me</Button>
+```
+
+## Development
+
+```bash
+bun install
+bun run check
+```

package/package.json

@@ -0,0 +1,369 @@
+{
+	"name": "sheer-ui",
+	"version": "0.0.0",
+	"description": "Svelte 5 UI component library with Tailwind CSS",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/polumeyv/sheer-ui.git"
+	},
+	"files": [
+		"src/lib",
+		"!src/lib/**/*.test.*"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"svelte",
+		"ui",
+		"components",
+		"tailwind"
+	],
+	"type": "module",
+	"sideEffects": [
+		"**/*.css"
+	],
+	"scripts": {
+		"dev": "bun --bun node_modules/.bin/vite dev --host 127.0.0.1 --port 4273 --strictPort",
+		"build": "bunx --bun vite build",
+		"preview": "bunx --bun vite preview",
+		"prepare": "svelte-kit sync || echo ''",
+		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+		"test": "bun test && bun run test:components",
+		"test:components": "svelte-kit sync && bunx vitest run --config vitest.config.ts",
+		"changeset": "changeset",
+		"changeset:version": "changeset version && oxfmt",
+		"changeset:release": "changeset publish"
+	},
+	"exports": {
+		"./blocks": {
+			"types": "./src/lib/blocks/index.ts",
+			"svelte": "./src/lib/blocks/index.ts",
+			"default": "./src/lib/blocks/index.ts"
+		},
+		"./blocks/*": {
+			"svelte": "./src/lib/blocks/*/index.ts",
+			"default": "./src/lib/blocks/*/index.ts"
+		},
+		"./utils": {
+			"types": "./src/lib/internal/utils.ts",
+			"svelte": "./src/lib/internal/utils.ts",
+			"default": "./src/lib/internal/utils.ts"
+		},
+		"./time": {
+			"types": "./src/lib/time.ts",
+			"svelte": "./src/lib/time.ts",
+			"default": "./src/lib/time.ts"
+		},
+		"./icons/*": {
+			"types": "./src/lib/icons/icon.d.ts",
+			"svelte": "./src/lib/icons/*",
+			"default": "./src/lib/icons/*"
+		},
+		"./styles": "./src/lib/assets/ui.css",
+		"./components/accordion": {
+			"types": "./src/lib/components/accordion/index.ts",
+			"svelte": "./src/lib/components/accordion/index.ts",
+			"default": "./src/lib/components/accordion/index.ts"
+		},
+		"./components/alert": {
+			"types": "./src/lib/components/alert/index.ts",
+			"svelte": "./src/lib/components/alert/index.ts",
+			"default": "./src/lib/components/alert/index.ts"
+		},
+		"./components/avatar": {
+			"types": "./src/lib/components/avatar/index.ts",
+			"svelte": "./src/lib/components/avatar/index.ts",
+			"default": "./src/lib/components/avatar/index.ts"
+		},
+		"./components/badge": {
+			"types": "./src/lib/components/badge/index.ts",
+			"svelte": "./src/lib/components/badge/index.ts",
+			"default": "./src/lib/components/badge/index.ts"
+		},
+		"./components/breadcrumb": {
+			"types": "./src/lib/components/breadcrumb/index.ts",
+			"svelte": "./src/lib/components/breadcrumb/index.ts",
+			"default": "./src/lib/components/breadcrumb/index.ts"
+		},
+		"./components/button": {
+			"types": "./src/lib/components/button/index.ts",
+			"svelte": "./src/lib/components/button/index.ts",
+			"default": "./src/lib/components/button/index.ts"
+		},
+		"./components/calendar": {
+			"types": "./src/lib/components/calendar/index.ts",
+			"svelte": "./src/lib/components/calendar/index.ts",
+			"default": "./src/lib/components/calendar/index.ts"
+		},
+		"./components/range-calendar": {
+			"types": "./src/lib/components/range-calendar/index.ts",
+			"svelte": "./src/lib/components/range-calendar/index.ts",
+			"default": "./src/lib/components/range-calendar/index.ts"
+		},
+		"./components/card": {
+			"types": "./src/lib/components/card/index.ts",
+			"svelte": "./src/lib/components/card/index.ts",
+			"default": "./src/lib/components/card/index.ts"
+		},
+		"./components/carousel": {
+			"types": "./src/lib/components/carousel/index.ts",
+			"svelte": "./src/lib/components/carousel/index.ts",
+			"default": "./src/lib/components/carousel/index.ts"
+		},
+		"./components/chart": {
+			"types": "./src/lib/components/chart/index.ts",
+			"svelte": "./src/lib/components/chart/index.ts",
+			"default": "./src/lib/components/chart/index.ts"
+		},
+		"./components/checkbox": {
+			"types": "./src/lib/components/checkbox/index.ts",
+			"svelte": "./src/lib/components/checkbox/index.ts",
+			"default": "./src/lib/components/checkbox/index.ts"
+		},
+		"./components/checkbox-native": {
+			"types": "./src/lib/components/checkbox-native/index.ts",
+			"svelte": "./src/lib/components/checkbox-native/index.ts",
+			"default": "./src/lib/components/checkbox-native/index.ts"
+		},
+		"./components/collapsible": {
+			"types": "./src/lib/components/collapsible/index.ts",
+			"svelte": "./src/lib/components/collapsible/index.ts",
+			"default": "./src/lib/components/collapsible/index.ts"
+		},
+		"./components/combobox": {
+			"types": "./src/lib/components/combobox/index.ts",
+			"svelte": "./src/lib/components/combobox/index.ts",
+			"default": "./src/lib/components/combobox/index.ts"
+		},
+		"./components/command": {
+			"types": "./src/lib/components/command/index.ts",
+			"svelte": "./src/lib/components/command/index.ts",
+			"default": "./src/lib/components/command/index.ts"
+		},
+		"./components/context-menu": {
+			"types": "./src/lib/components/context-menu/index.ts",
+			"svelte": "./src/lib/components/context-menu/index.ts",
+			"default": "./src/lib/components/context-menu/index.ts"
+		},
+		"./components/data-table": {
+			"types": "./src/lib/components/data-table/index.ts",
+			"svelte": "./src/lib/components/data-table/index.ts",
+			"default": "./src/lib/components/data-table/index.ts"
+		},
+		"./components/dialog": {
+			"types": "./src/lib/components/dialog/index.ts",
+			"svelte": "./src/lib/components/dialog/index.ts",
+			"default": "./src/lib/components/dialog/index.ts"
+		},
+		"./components/drawer": {
+			"types": "./src/lib/components/drawer/index.ts",
+			"svelte": "./src/lib/components/drawer/index.ts",
+			"default": "./src/lib/components/drawer/index.ts"
+		},
+		"./components/dropdown-menu": {
+			"types": "./src/lib/components/dropdown-menu/index.ts",
+			"svelte": "./src/lib/components/dropdown-menu/index.ts",
+			"default": "./src/lib/components/dropdown-menu/index.ts"
+		},
+		"./components/empty": {
+			"types": "./src/lib/components/empty/index.ts",
+			"svelte": "./src/lib/components/empty/index.ts",
+			"default": "./src/lib/components/empty/index.ts"
+		},
+		"./components/field": {
+			"types": "./src/lib/components/field/index.ts",
+			"svelte": "./src/lib/components/field/index.ts",
+			"default": "./src/lib/components/field/index.ts"
+		},
+		"./components/input": {
+			"types": "./src/lib/components/input/index.ts",
+			"svelte": "./src/lib/components/input/index.ts",
+			"default": "./src/lib/components/input/index.ts"
+		},
+		"./components/pin-input": {
+			"types": "./src/lib/components/pin-input/index.ts",
+			"svelte": "./src/lib/components/pin-input/index.ts",
+			"default": "./src/lib/components/pin-input/index.ts"
+		},
+		"./components/item": {
+			"types": "./src/lib/components/item/index.ts",
+			"svelte": "./src/lib/components/item/index.ts",
+			"default": "./src/lib/components/item/index.ts"
+		},
+		"./components/kbd": {
+			"types": "./src/lib/components/kbd/index.ts",
+			"svelte": "./src/lib/components/kbd/index.ts",
+			"default": "./src/lib/components/kbd/index.ts"
+		},
+		"./components/label": {
+			"types": "./src/lib/components/label/index.ts",
+			"svelte": "./src/lib/components/label/index.ts",
+			"default": "./src/lib/components/label/index.ts"
+		},
+		"./components/menubar": {
+			"types": "./src/lib/components/menubar/index.ts",
+			"svelte": "./src/lib/components/menubar/index.ts",
+			"default": "./src/lib/components/menubar/index.ts"
+		},
+		"./components/navigation-menu": {
+			"types": "./src/lib/components/navigation-menu/index.ts",
+			"svelte": "./src/lib/components/navigation-menu/index.ts",
+			"default": "./src/lib/components/navigation-menu/index.ts"
+		},
+		"./components/pagination": {
+			"types": "./src/lib/components/pagination/index.ts",
+			"svelte": "./src/lib/components/pagination/index.ts",
+			"default": "./src/lib/components/pagination/index.ts"
+		},
+		"./components/popover": {
+			"types": "./src/lib/components/popover/index.ts",
+			"svelte": "./src/lib/components/popover/index.ts",
+			"default": "./src/lib/components/popover/index.ts"
+		},
+		"./components/progress": {
+			"types": "./src/lib/components/progress/index.ts",
+			"svelte": "./src/lib/components/progress/index.ts",
+			"default": "./src/lib/components/progress/index.ts"
+		},
+		"./components/radio-group": {
+			"types": "./src/lib/components/radio-group/index.ts",
+			"svelte": "./src/lib/components/radio-group/index.ts",
+			"default": "./src/lib/components/radio-group/index.ts"
+		},
+		"./components/resizable": {
+			"types": "./src/lib/components/resizable/index.ts",
+			"svelte": "./src/lib/components/resizable/index.ts",
+			"default": "./src/lib/components/resizable/index.ts"
+		},
+		"./components/scroll-area": {
+			"types": "./src/lib/components/scroll-area/index.ts",
+			"svelte": "./src/lib/components/scroll-area/index.ts",
+			"default": "./src/lib/components/scroll-area/index.ts"
+		},
+		"./components/select": {
+			"types": "./src/lib/components/select/index.ts",
+			"svelte": "./src/lib/components/select/index.ts",
+			"default": "./src/lib/components/select/index.ts"
+		},
+		"./components/separator": {
+			"types": "./src/lib/components/separator/index.ts",
+			"svelte": "./src/lib/components/separator/index.ts",
+			"default": "./src/lib/components/separator/index.ts"
+		},
+		"./components/sheet": {
+			"types": "./src/lib/components/sheet/index.ts",
+			"svelte": "./src/lib/components/sheet/index.ts",
+			"default": "./src/lib/components/sheet/index.ts"
+		},
+		"./components/sidebar": {
+			"types": "./src/lib/components/sidebar/index.ts",
+			"svelte": "./src/lib/components/sidebar/index.ts",
+			"default": "./src/lib/components/sidebar/index.ts"
+		},
+		"./components/skeleton": {
+			"types": "./src/lib/components/skeleton/index.ts",
+			"svelte": "./src/lib/components/skeleton/index.ts",
+			"default": "./src/lib/components/skeleton/index.ts"
+		},
+		"./components/slider": {
+			"types": "./src/lib/components/slider/index.ts",
+			"svelte": "./src/lib/components/slider/index.ts",
+			"default": "./src/lib/components/slider/index.ts"
+		},
+		"./components/sonner": {
+			"types": "./src/lib/components/sonner/index.ts",
+			"svelte": "./src/lib/components/sonner/index.ts",
+			"default": "./src/lib/components/sonner/index.ts"
+		},
+		"./components/switch": {
+			"types": "./src/lib/components/switch/index.ts",
+			"svelte": "./src/lib/components/switch/index.ts",
+			"default": "./src/lib/components/switch/index.ts"
+		},
+		"./components/table": {
+			"types": "./src/lib/components/table/index.ts",
+			"svelte": "./src/lib/components/table/index.ts",
+			"default": "./src/lib/components/table/index.ts"
+		},
+		"./components/tabs": {
+			"types": "./src/lib/components/tabs/index.ts",
+			"svelte": "./src/lib/components/tabs/index.ts",
+			"default": "./src/lib/components/tabs/index.ts"
+		},
+		"./components/textarea": {
+			"types": "./src/lib/components/textarea/index.ts",
+			"svelte": "./src/lib/components/textarea/index.ts",
+			"default": "./src/lib/components/textarea/index.ts"
+		},
+		"./components/theme-toggle": {
+			"types": "./src/lib/components/theme-toggle/index.ts",
+			"svelte": "./src/lib/components/theme-toggle/index.ts",
+			"default": "./src/lib/components/theme-toggle/index.ts"
+		},
+		"./components/toggle": {
+			"types": "./src/lib/components/toggle/index.ts",
+			"svelte": "./src/lib/components/toggle/index.ts",
+			"default": "./src/lib/components/toggle/index.ts"
+		},
+		"./components/toggle-group": {
+			"types": "./src/lib/components/toggle-group/index.ts",
+			"svelte": "./src/lib/components/toggle-group/index.ts",
+			"default": "./src/lib/components/toggle-group/index.ts"
+		},
+		"./components/toolbar": {
+			"types": "./src/lib/components/toolbar/index.ts",
+			"svelte": "./src/lib/components/toolbar/index.ts",
+			"default": "./src/lib/components/toolbar/index.ts"
+		},
+		"./components/tooltip": {
+			"types": "./src/lib/components/tooltip/index.ts",
+			"svelte": "./src/lib/components/tooltip/index.ts",
+			"default": "./src/lib/components/tooltip/index.ts"
+		}
+	},
+	"peerDependencies": {
+		"svelte": "^5.57.0",
+		"@sveltejs/kit": "^3.0.0-next.25",
+		"@internationalized/date": "^3.12.0"
+	},
+	"dependencies": {
+		"@lucide/svelte": "^1.18.0",
+		"esm-env": "^1.2.2",
+		"handful": "^0.3.0",
+		"d3-scale": "^4.0.2",
+		"layerchart": "^2.0.1",
+		"overrule": "^0.7.3"
+	},
+	"devDependencies": {
+		"@changesets/changelog-github": "^1.0.0",
+		"@changesets/cli": "^3.0.1",
+		"@fontsource-variable/inter": "^5.2.8",
+		"@sveltejs/adapter-auto": "8.0.0-next.1",
+		"@internationalized/date": "^3.12.2",
+		"@sveltejs/kit": "^3.0.0-next.25",
+		"@sveltejs/vite-plugin-svelte": "^7.3.0",
+		"@tailwindcss/vite": "^4.3.2",
+		"tailwindcss": "^4.3.2",
+		"@types/d3-chord": "^3.0.6",
+		"@types/d3-delaunay": "^6.0.4",
+		"@types/d3-force": "^3.0.10",
+		"@types/d3-geo": "^3.1.0",
+		"@types/d3-hierarchy": "^3.1.7",
+		"@types/d3-sankey": "^0.12.5",
+		"@types/d3-shape": "^3.1.8",
+		"@types/d3-time": "^3.0.4",
+		"@types/bun": "^1.3.14",
+		"jsdom": "^30.0.1",
+		"svelte": "^5.57.0",
+		"svelte-check": "^4.7.1",
+		"typescript": "^6.0.3",
+		"vite": "^8.2.1",
+		"vitest": "^4.1.9"
+	},
+	"imports": {
+		"#lib/*": "./src/lib/*"
+	}
+}

package/src/lib/VENDORED.md

@@ -0,0 +1,109 @@
+# Vendored code
+
+The headless engine under `internal/` is vendored source, not a dependency (ADR 0006). Inlined
+2026-06-12 to stop bundler issues from Svelte-flavored deps.
+
+## Layout
+
+`internal/` is the whole engine layer. `components/*` hold only styled, exported components whose
+state engines (`*.svelte.ts`) are bits-ui-derived; `blocks/` are styled composites above them.
+Nothing under `internal/` appears in the package.json exports map.
+
+## What lives where
+
+| Path | Upstream | Version |
+| --- | --- | --- |
+| `internal/` engine core (`tools/utils`, `date-time/`, flat helpers) + the behavior primitives (`portal/`, `floating-layer/` (positioning rewritten on CSS anchor positioning 2026-09-01), `popper-layer/`, `dismissible-layer/`, `escape-layer/`, `focus-scope/`, `scroll-lock/`, `prop-resolvers.ts`) + component state engines in `components/*/**.svelte.ts` | [huntabyte/bits-ui](https://github.com/huntabyte/bits-ui) tag `bits-ui@2.18.1`, `packages/bits-ui/src/lib` (the behavior primitives are upstream's `bits/utilities`, moved here 2026-07-04) | 2.18.1 |
+| `internal/tools/` (`box`, `use-debounce`) | [svecosystem/runed](https://github.com/svecosystem/runed) `runed@0.35.1` subset + svelte-toolbelt `v0.10.6` derivations (`box`) | 0.35.1 / 0.10.6 |
+| `internal/tabbable.ts` | [focus-trap/tabbable](https://github.com/focus-trap/tabbable) `v6.5.0` `src/index.js`, adapted (see file header); the `full` display check is the platform's `checkVisibility()` (upstream's opt-in `full-native`), 2026-08-31 | 6.5.0 |
+| `internal/vaul/` | vaul-svelte (drawer engine; sole consumer `components/drawer`) | untracked — pin on next sync |
+| `internal/paneforge/` | [svecosystem/paneforge](https://github.com/svecosystem/paneforge) (resizable engine; sole consumer `components/resizable`) | untracked — pin on next sync |
+| `internal/table/` (rune-native engine; `sorting-fns.ts`, `filter-fns.ts` and the toggle/paging semantics are ported, the `$derived` pipeline in `table.svelte.ts` is locally authored) | [TanStack/table](https://github.com/TanStack/table) `@tanstack/table-core@8.21.3` subset — replaced the npm dependency 2026-07-26; deliberate deviation: sort inference samples the FIRST ten rows (upstream's `slice(10)` drops them) | 8.21.3 |
+
+The embla-carousel engine and the embla-backed `components/carousel` were deleted 2026-07-26 with
+Nic's per-component confirmation: the scroll-snap implementation (formerly `carousel-native`,
+locally authored) is now `components/carousel`. Capability loss accepted:
+embla `opts`/`plugins`/`setApi` and desktop mouse-drag momentum.
+
+All upstreams are MIT. clsx and style-to-object (in the original inline) are gone — `cn()` is a
+plain join via `overrule`. `@floating-ui/dom` left 2026-09-01: `internal/floating-layer` positions
+with CSS anchor positioning (`position-area`, `position-try-fallbacks`, `anchor-size()`), so the
+`floating-svelte/` port of its Svelte binding went with it. Kept on purpose: the
+`@internationalized/date` peer.
+
+## No workspace edges (2026-07-08)
+
+This package installs and typechecks standalone. That is a hard constraint, not an accident: it is
+mirrored to [polumeyv/sheer-ui](https://github.com/polumeyv/sheer-ui), and a specifier that only resolves
+inside the mono makes that clone uninstallable. **Nothing here may use `workspace:*` or a bun
+`catalog:`.** Verify with a cold install outside the monorepo before changing dependencies.
+
+There are no `@polumeyv/*` dependencies left. The last one, `@polumeyv/utilities`, was cut 2026-08-17:
+its wall-clock module moved here as `src/lib/time.ts` (exported as `sheer-ui/time`, and now the
+only copy — the apps import it from here), and the two date-picker blocks format their `DateValue`
+with `@internationalized/date` directly instead of round-tripping it through a string formatter.
+
+Two edges only a cold install reveals, both previously borrowed from the mono root:
+
+- `typescript` and `@types/bun` are declared here now; they used to hoist from the root manifest.
+- `vite.config.ts` extends the monorepo base tsconfig **only when that file exists**. The two options
+  it supplied that the check truly needs — `allowJs` (for `theme-toggle.svelte`, the one non-TS
+  component) and `noFallthroughCasesInSwitch` — live in `./tsconfig.json`.
+
+## Locally-authored (not vendored)
+
+Modules written here, marked by their `.test.ts` siblings: `internal/layer-stack.ts`,
+`internal/hover-intent-geometry.ts`, `internal/arrays.ts`, `internal/animations-settled.svelte.ts`
+(absorbed `internal/use-open-change-complete.svelte.ts`), `internal/tools/utils/attach-ref.ts`. The
+shared `internal/native-dialog-controller.svelte.ts`, `internal/typeahead.svelte.ts` and
+`internal/date-time/field/range-field.svelte.ts` are also local consolidation Modules, covered through
+their dialog, typeahead and range-field integration suites. A future upstream diff touching these is
+drift on our side, not upstream's.
+
+## Local deviations from upstream (carried forward from the original)
+
+- Bare imports rewritten to local relative paths (`bits-ui`, `svelte-toolbelt`, `runed`,
+  `tabbable` → in-tree; `esm-env` stays as-is); other specifiers are relative with explicit
+  extensions — new shadcn pulls need the same rewrite.
+- `override` modifiers added in state files (`noImplicitOverride` is on here, plus
+  `noUncheckedIndexedAccess` fixes from the 07-03 source-consumption migration).
+- runed's `Context` class replaced with Svelte's native `createContext` (5.40+).
+- Upstream test files dropped.
+- Package-entry `exports.ts` barrels are folded into their sibling `index.ts` when that `index.ts`
+  was their sole consumer. Namespace-producing barrels (`export * as`) remain because they preserve
+  type members as well as runtime values; non-entry source inventory is retained independently of
+  current in-repository usage.
+- One `internal/typeahead.svelte.ts` where upstream keeps `DataTypeahead` and `DOMTypeahead`
+  separate; the candidate → search-text projection is a constructor parameter.
+- `internal/roving-focus-group.ts` takes a candidate-node source as well as an attribute or a
+  selector, so upstream's `use-arrow-navigation` (its only caller navigated a tabbable walk) is gone.
+- Menu and Select input modality is a boolean field on each root state. Menu roots own capture-phase
+  document listeners through `<svelte:document>` instead of routing browser-only lifecycle through
+  `SharedState`.
+- `dismissible-layer/` drifts twice: its timers run through an injected `Timers` seam
+  (`scheduler.ts`, defaulting to the real globals) so the 1ms/10ms/20ms windows are testable, and
+  `isValidEvent` collapses upstream's three context-menu branches into `return e.button === 0`
+  (same truth table, verified over every trigger/content/button combination). Its handler and
+  predicate opts (`onInteractOutside`, `onFocusOutside`, `isValidEvent`) are optional here rather
+  than upstream's `Required<>` boxes, so callers omit them instead of passing no-ops.
+- The menu family has one Content implementation. Upstream ships ten files (Content and
+  ContentStatic for menu, dropdown, context and menubar, plus the sub-content pair); here
+  `menu/components/menu-content.svelte` and `menu-sub-content.svelte` take an `isStatic` prop, the
+  per-family `-static` files are type adapters over them, and dropdown-menu/context-menu/menubar
+  Content are styled adapters. The base menu has no `-static` Content of its own.
+- `state_referenced_locally` warnings from vendored files are upstream's; svelte-check prints them.
+
+## Syncing upstream fixes
+
+Diff the tags and port what matters:
+
+```sh
+git clone --depth 1 --branch "bits-ui@2.18.1" https://github.com/huntabyte/bits-ui /tmp/bits-old
+git clone --depth 1 --branch "bits-ui@2.x.y" https://github.com/huntabyte/bits-ui /tmp/bits-new
+diff -ru /tmp/bits-old/packages/bits-ui/src/lib /tmp/bits-new/packages/bits-ui/src/lib
+```
+
+Upstream paths map here as: `bits/<x>/<x>.svelte.ts` → `components/<x>/<x>.svelte.ts`,
+`bits/utilities/*` → `internal/*`, `internal/*` → `internal/*`. New shadcn-svelte pulls were
+generated against current bits-ui — check their primitive usage against this snapshot before
+adopting.