Add Svelte wrapper and configure() no-op bail

Completes the workspace restructure (file moves landed in the previous
commit) with the substantive changes:

- @hyperplexed/bubbles-svelte (packages/svelte): declarative <Bubbles>/
  <Bubble> components over the core manager. <Bubbles> owns the manager
  (props -> configure(), destroy on unmount, reactive state/active via
  getBubbles()); <Bubble> maps presence to add()/remove() and prop
  changes to in-place re-adds. Snippets mount through a host with
  getAllContexts() propagated and $state-backed props, so app context
  flows in and content stays reactive. Published to npm as 0.1.0.
- Core: configure() bails when the resolved options are unchanged
  (sameOptions comparator), so props-driven consumers can call it every
  render for free. Documented as a guarantee; comparator tests added.
- Workspace plumbing: root package.json/tsconfig/vite.config aliases
  resolve @hyperplexed/bubbles and $src to live sources; packages/core
  gains its own package.json/tsconfig; publish.yml publishes both
  packages; e2e configs repointed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: githyperplexed

.github/workflows/ci.yml

@@ -18,8 +18,8 @@ jobs:
       # Guards the published artifact: SSR frameworks (Vite SSR, Next)
       # load externalized deps through Node's resolver, so the build
       # must import cleanly outside a bundler.
-      - name: Verify dist resolves under Node ESM
-        run: node --input-type=module -e "await import('./dist/index.js')"
+      - name: Verify core dist resolves under Node ESM
+        run: node --input-type=module -e "await import('./packages/core/dist/index.js')"
 
   # Browser tests for the interaction choreography (drag, dismiss, tap-away,
   # focus) that the happy-dom unit tests can't reach. Separate job so a

.github/workflows/publish.yml

@@ -35,3 +35,9 @@ jobs:
       - run: bun run test
       - run: bun run build
       - run: npm publish --provenance --access public
+        working-directory: packages/core
+      # @hyperplexed/bubbles-svelte. Requires its own npm Trusted Publishing
+      # config (set per-package on npmjs.com) plus a manual first publish to
+      # create the package — OIDC can't publish a package's initial version.
+      - run: npm publish --provenance --access public
+        working-directory: packages/svelte

.gitignore

@@ -1,5 +1,6 @@
 node_modules/
 dist/
+.svelte-kit/
 *.log
 .claude/
 dist-site/

README.md

@@ -5,12 +5,15 @@ context needed.
 
 ## Identity
 
-- **Package:** `@hyperplexed/bubbles` (scoped, public)
+- **Package:** `@hyperplexed/bubbles` (scoped, public), living at `packages/core` of a
+  bun workspace. (`packages/svelte` holds `@hyperplexed/bubbles-svelte`, not yet wired
+  into the publish workflow — see the note at the bottom.)
 - **Repo:** https://github.com/githyperplexed/bubbles
-- **Versioning:** pre-`1.0`. Additive changes are minor bumps; the `CHANGELOG.md`
-  category (`Added` / `Changed` / `Fixed`) is the source of truth for what a release contains.
+- **Versioning:** pre-`1.0`. Additive changes are minor bumps; the
+  `packages/core/CHANGELOG.md` category (`Added` / `Changed` / `Fixed`) is the source of
+  truth for what a release contains.
 - **Current state:** check `npm view @hyperplexed/bubbles version` for the published
-  `latest`, and `package.json`'s `version` for what's staged locally. These can differ —
+  `latest`, and `packages/core/package.json`'s `version` for what's staged locally. These can differ —
   a version bump committed to `main` is **not** published until a GitHub Release is cut
   (see below).
 - **Toolchain:** Bun (package manager + script runner), Vite, TypeScript, vitest.
@@ -43,14 +46,14 @@ Consequences:
    bun install
    bun run check     # svelte-check, 0 errors
    bun run test      # vitest
-   bun run build     # tsc → dist/ ; must succeed
-   node --input-type=module -e "await import('./dist/index.js')"   # dist resolves under bare Node ESM
+   bun run build     # builds every package's dist/ ; must succeed
+   node --input-type=module -e "await import('./packages/core/dist/index.js')"   # dist resolves under bare Node ESM
    ```
 
-2. **Bump the version** in `package.json` (`version` field) to the target, e.g. `0.4.1` or
-   `0.5.0`.
+2. **Bump the version** in `packages/core/package.json` (`version` field) to the target,
+   e.g. `0.4.1` or `0.5.0`.
 
-3. **Promote the changelog** in `CHANGELOG.md`: rename `## [Unreleased]` to
+3. **Promote the changelog** in `packages/core/CHANGELOG.md`: rename `## [Unreleased]` to
    `## [X.Y.Z] - <date>` and add a fresh empty `## [Unreleased]` above it. Format is
    [Keep a Changelog](https://keepachangelog.com/).
 
@@ -60,7 +63,7 @@ Consequences:
 5. **Commit, tag, push** — the tag must point at the commit carrying the bumped version:
 
    ```sh
-   git add package.json CHANGELOG.md bun.lock
+   git add packages/core/package.json packages/core/CHANGELOG.md bun.lock
    git commit -m "Release X.Y.Z"
    git tag -a vX.Y.Z -m "vX.Y.Z"
    git push origin main
@@ -86,23 +89,30 @@ Consequences:
 - **`.github/workflows/publish.yml`** — `on: release: published`, with `id-token: write`.
   Checkout → setup Bun → setup Node 24 → `npm install -g npm@latest` (Trusted Publishing
   needs npm 11.5.1+) → `bun install --frozen-lockfile` → `bun run test` → `bun run build` →
-  `npm publish --provenance --access public`.
+  `npm publish --provenance --access public` from `packages/core`.
 - **`.github/workflows/ci.yml`** — `on: push (main)` and `pull_request`. Runs
-  `check` → `test` → `build`, then verifies `dist/index.js` imports cleanly under bare Node
-  ESM (guards SSR consumers).
-- **`package.json` `prepublishOnly`** — `bun run test && bun run build`, a backstop.
+  `check` → `test` → `build`, then verifies `packages/core/dist/index.js` imports cleanly
+  under bare Node ESM (guards SSR consumers).
+- **each package's `prepublishOnly`** — re-runs the root `check` + `test` gate and its own
+  build, a backstop for any publish path that skips the workflow.
 
 ## Gotchas
 
 - **Tag push ≠ publish.** You must create the GitHub Release.
 - **`package.json` `version` must match the tag** — the workflow publishes whatever version
   is in the checked-out tag.
 - **Lockfile must be in sync**, or `--frozen-lockfile` aborts the run.
-- **Only `dist/` is published** (`files: ["dist"]`); `src/` and the playground are not.
+- **Only a package's `files` list is published** (`dist/` plus non-test `src/`); the
+  playground and e2e tests never ship.
 - **A published version can't be overwritten.** If a release is botched, bump to the next
   patch — npm forbids re-publishing the same version.
 - **If `npm publish` fails on auth/OIDC in the workflow**, the npm Trusted Publisher config
   on npmjs.com doesn't match this repo + workflow. Fix it in the package settings on
   npmjs.com (web UI) — it isn't controlled by the workflow or local environment.
 - On Windows, Git's `LF will be replaced by CRLF` warnings on `bun.lock` / `package.json`
   are harmless.
+- **`@hyperplexed/bubbles-svelte` is not published yet.** Before its first release: create
+  the package on npmjs.com with a Trusted Publisher config matching this repo + workflow,
+  then uncomment its publish step in `publish.yml`. Its `dependencies` pin
+  `@hyperplexed/bubbles` by semver range (not `workspace:`), so `npm publish` needs no
+  rewriting.

bun.lock

@@ -1,57 +1,22 @@
 {
-	"name": "@hyperplexed/bubbles",
-	"version": "0.8.1",
-	"description": "Android-style app bubbles for the web — floating, draggable, expandable overlay bubbles",
-	"author": "Hyperplexed",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/githyperplexed/bubbles.git"
-	},
-	"homepage": "https://bubbles.hyperplexed.io",
-	"bugs": "https://github.com/githyperplexed/bubbles/issues",
+	"name": "bubbles-workspace",
+	"private": true,
+	"description": "Workspace root for @hyperplexed/bubbles — packages, playground site, and e2e tests",
 	"type": "module",
-	"main": "./dist/index.js",
-	"module": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"import": "./dist/index.js",
-			"default": "./dist/index.js"
-		}
-	},
-	"files": [
-		"dist",
-		"src",
-		"!src/**/*.test.ts"
+	"workspaces": [
+		"packages/*"
 	],
-	"sideEffects": false,
-	"publishConfig": {
-		"access": "public"
-	},
 	"scripts": {
 		"dev": "vite",
-		"build": "rimraf dist && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+		"build": "bun run --cwd packages/core build && bun run --cwd packages/svelte build",
 		"build:site": "vite build",
 		"test": "vitest run",
 		"test:watch": "vitest",
 		"test:e2e": "playwright test",
 		"test:e2e:ui": "playwright test --ui",
 		"check": "svelte-check --tsconfig ./tsconfig.json",
-		"format": "prettier --write .",
-		"prepublishOnly": "bun run check && bun run test && bun run build"
+		"format": "prettier --write ."
 	},
-	"keywords": [
-		"bubbles",
-		"chat-heads",
-		"floating",
-		"overlay",
-		"ui",
-		"draggable",
-		"widget",
-		"vanilla",
-		"typescript"
-	],
 	"license": "MIT",
 	"engines": {
 		"node": ">=18"
@@ -68,11 +33,9 @@
 		"prettier": "^3.8.4",
 		"prettier-plugin-svelte": "^4.1.0",
 		"prettier-plugin-tailwindcss": "^0.8.0",
-		"rimraf": "^6.1.3",
 		"svelte": "^5.56.3",
 		"svelte-check": "^4.6.0",
 		"tailwindcss": "^4.3.0",
-		"tsc-alias": "^1.8.17",
 		"typescript": "^6.0.3",
 		"vite": "^8.0.16",
 		"vitest": "^4.1.8"

docs/RELEASING.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hyperplexed
+
+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.