sveltekit-ui 1.1.87 → 1.1.88

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 1.1.88 - 2026-10-16
+
+### Toolchain
+
+- Update the documentation and package toolchain to SvelteKit 3.1.0, Vercel adapter 7.0.1, Svelte package 3.0.1, Svelte Check 4.7.7, Vite 8.3.4, Vitest 5.0.5, and jsdom 30.1.3.
+- Require Node.js 24.15 or newer to satisfy the updated test toolchain.
+- Keep TypeScript 6.0.3 and Analytics 1.3.2 because current stable Svelte tooling excludes TypeScript 7 and Analytics 2 excludes SvelteKit 3.
+
+### SvelteKit compatibility
+
+- Target SvelteKit 3 for new installs, documentation, and packed-consumer verification. Svelte 5 remains required.
+- Verify the documentation app and packed consumer with SvelteKit 3.1.0 and Svelte 5.57.2.
+
+### Component fixes
+
+- Default stored-media URLs and audio processing endpoints to the application's own `/api` routes, while preserving configurable endpoint overrides.
+- Preserve natural popover height in Safari by giving the scrolling content container a content-based flex basis, while retaining fixed-height and scrolling layouts.
+- Focus the image comparison slider before starting a drag so focus changes cannot cancel the new drag.
+- Preserve native button activation, including popover toggles and form submission, when an `on_click` callback starts an async loading state, while still blocking repeated actions until it settles.
+- Accept Apple's domain-restricted, non-expiring MapKit JS tokens while continuing to reject malformed and expired tokens.
+
 ## 1.1.87 - 2026-10-03
 
 ### Toolchain
@@ -18,15 +39,6 @@
 - Migrate the documentation app to SvelteKit 3, Vercel adapter 7, explicit public environment variables, and Vite plugin configuration.
 - Preserve documentation analytics using the generic Analytics API, with manual SvelteKit navigation tracking that does not depend on removed stores.
 
-## Unreleased
-
-### Component fixes
-
-- Preserve natural popover height in Safari by giving the scrolling content container a content-based flex basis, while retaining fixed-height and scrolling layouts.
-- Focus the image comparison slider before starting a drag so focus changes cannot cancel the new drag.
-- Preserve native button activation, including popover toggles and form submission, when an `on_click` callback starts an async loading state, while still blocking repeated actions until it settles.
-- Accept Apple's domain-restricted, non-expiring MapKit JS tokens while continuing to reject malformed and expired tokens.
-
 ## 1.1.84 - 2026-09-20
 
 ### Icons

package/README.md

@@ -1,6 +1,6 @@
 # SvelteKit UI
 
-SvelteKit UI is a Svelte 5 component library built around paired components and reactive manager functions. It supports SvelteKit 2 and 3 applications.
+SvelteKit UI is a Svelte 5 component library built around paired components and reactive manager functions for SvelteKit 3 applications.
 
 The component documentation and interactive examples live at [sveltekit-ui.com](https://www.sveltekit-ui.com).
 
@@ -28,6 +28,20 @@ Import the shared styles once in your root layout:
 
 Most interactive components expose a `create_*_manager` function. The manager owns state and behavior; the Svelte component renders that manager. Components that depend on browser APIs should be initialized or used in the browser, while imports remain safe during SvelteKit server rendering.
 
+## Use with AI
+
+Give Codex or another coding agent the [Use with AI guide](https://www.sveltekit-ui.com/ai). It explains installation, paired feature components/managers, live inputs, Button navigation/icons, adaptive themes, root sizing, lifecycle cleanup, backend boundaries, and verification. It includes a starting prompt and a short section to add to a consumer project's existing `AGENTS.md`.
+
+Agents can fetch the [component index](https://www.sveltekit-ui.com/llms.txt) or the [complete reference](https://www.sveltekit-ui.com/llms-full.txt) directly. The complete reference is generated from the same API definitions and public-import examples as the website, including configuration, methods, returned state, required values, allowed options, and component notes. Homepage, guide, and component URLs also serve Markdown when requested with `Accept: text/markdown`.
+
+Documentation source lives in `src/lib/client/docs` and `src/routes/_docs/ai-guide.js`. Keep the shared component inventory, definitions, and examples in agreement; documentation tests check coverage against public component exports. Do not hand-maintain a separate full-reference snapshot.
+
+## Media services
+
+Stored-media examples default to the same-origin URL template `/api/storage/{storage_id}`. `AudioEditor` defaults to `/api` for its API prefix, posting metadata requests to `/api/tools/audio/read_tags` and audio processing requests to `/api/tools/audio`.
+
+These endpoints belong to your application's backend. Implement them in your app or configure the managers to use your existing service. `AudioEditor` accepts `api_prefix`, `fetch_path_audio_read_tags`, `fetch_path_audio_post`, `file_prefix`, and `storage_src` overrides; `StoragePicker` accepts `storage_src`; `Content` and `ContentInput` accept `storage_path`.
+
 ## Starter project
 
 To create a new site using the library:
@@ -45,7 +59,7 @@ npm run dev
 
 Copy `.env.example` to `.env` and provide `PUBLIC_APPLE_MAPKIT_JS_API_KEY` if you want to run the MapKit showcases locally.
 
-The package and documentation app require Node.js 24 or newer. The documentation app uses SvelteKit 3 and TypeScript 6, even when writing JavaScript. The `.ncurc.js` configuration updates development and runtime dependencies while respecting peer dependencies and the current Node engine. TypeScript 7 is held until SvelteKit and `svelte-check` support it. Analytics remains pinned until a compatible stable release supports SvelteKit 3.
+The package and documentation app require Node.js 24.15 or newer. The documentation app uses SvelteKit 3 and TypeScript 6, even when writing JavaScript. The `.ncurc.js` configuration updates development and runtime dependencies while respecting peer dependencies and the current Node engine. TypeScript 7 remains incompatible with the peer requirements of SvelteKit 3.1, `svelte-check` 4.7, and `@sveltejs/package` 3.0. Analytics remains pinned at 1.3.2 because Analytics 2.0.1's SvelteKit peer range excludes SvelteKit 3. These compatibility constraints were checked against npm on October 16, 2026.
 
 Before publishing, run the complete verification suite:
 
@@ -55,7 +69,7 @@ npm run verify
 
 This checks the Svelte source, runs tests, generates and verifies the distributable package, and builds the documentation site.
 
-To verify a packed release in clean SvelteKit 2 and 3 consumers, run `node scripts/verify-kit-consumers.js /absolute/path/to/sveltekit-ui.tgz`. The consumers install their dependencies with normal peer validation, then compile the public components for server and browser use and check server-rendered pages.
+To verify a packed release in a clean SvelteKit 3 consumer, run `node scripts/verify-kit-consumers.js /absolute/path/to/sveltekit-ui.tgz`. The consumer installs its dependencies with normal peer validation, then compiles the public components for server and browser use and checks server-rendered pages.
 
 Publish with `npm run publish:npm`. It checks npm for the newest published release, selects the next patch version when needed, keeps `package.json` and `package-lock.json` in sync, and runs verification before publishing. A prepared version that is newer than the published releases is reused, so retrying a failed publish does not skip another version.
 
@@ -68,8 +82,6 @@ npm run version:available -- --dry-run
 ## Compatibility and releases
 
 - Svelte 5 is required.
-- SvelteKit 2.22.2 or newer, or SvelteKit 3, is required because some components use SvelteKit navigation modules.
+- SvelteKit 3 is required because some components use SvelteKit navigation modules.
 - Browser flags use `esm-env`. Source `#lib` imports are rewritten to relative imports in the published package; consumers do not need to configure the library's source alias.
 - Public API changes are documented with package releases. Consumers should review release notes before adopting a new minor version.
-
-The experimental Contibase code generator is available at [contibase.com/code_generator](https://www.contibase.com/code_generator).

package/dist/Components/AudioEditor/index.svelte.js

@@ -293,10 +293,9 @@ export function create_audio_editor_manager(config) {
   let generation_abort_controller = null
   let success_timeout_id = null
 
-  // actually we'll prob do this server stuff diff like call config?.fetch_audio_read_tags() and handle in parent
-  let api_prefix = $derived(set_closurable(config?.api_prefix, "https://www.contibase.com/api/v1"))
+  let api_prefix = $derived(set_closurable(config?.api_prefix, "/api"))
   let storage_src = $derived(
-    set_closurable(config?.storage_src, "https://www.contibase.com/api/v1/storage/{storage_id}")
+    set_closurable(config?.storage_src, `${api_prefix}/storage/{storage_id}`)
   )
   let fetch_path_audio_read_tags = $derived(
     set_closurable(config?.fetch_path_audio_read_tags, `${api_prefix}/tools/audio/read_tags`)
@@ -770,6 +769,7 @@ export function create_audio_editor_manager(config) {
       storage: storage,
       default_folder_path: config?.storage_default_folder_path,
       locally_uploaded_files: () => locally_uploaded_files,
+      storage_src: () => storage_src,
       accept: ["image/png", "image/jpeg", "image/webp", "image/gif"],
       is_multiselect: false,
       mb: 1,
@@ -849,6 +849,7 @@ export function create_audio_editor_manager(config) {
       storage: storage,
       default_folder_path: config?.storage_default_folder_path,
       locally_uploaded_files: () => locally_uploaded_files,
+      storage_src: () => storage_src,
       accept: ["audio/mpeg"],
       is_multiselect: false,
       is_disabled: () => is_loading_generate_audio || is_disabled,

package/dist/Components/Content/index.svelte.js

@@ -40,7 +40,7 @@ export function create_content_manager(config) {
   const id = create_unique_id(null, 20)
   let definition_stack = $state([])
   let is_dark_theme = $derived(set_closurable(config?.is_dark_theme, false))
-  let storage_path = $derived(set_closurable(config?.storage_path, "/api/v1/storage/{storage_id}"))
+  let storage_path = $derived(set_closurable(config?.storage_path, "/api/storage/{storage_id}"))
   let mapkit_js_token = $derived(set_closurable(config?.mapkit_js_token, null))
   let val_prepped = $state(null)
 

package/dist/Components/ContentInput/AttributesInput/CustomConfig/Audio/index.svelte.js

@@ -25,7 +25,7 @@ export function create_audio_config_manager(config) {
   let image_aspect_ratio_text_input_manager = $state(null)
 
   let storage_src = $derived(
-    set_closurable(config?.storage_src, "https://www.contibase.com/api/v1/storage/{storage_id}")
+    set_closurable(config?.storage_src, set_closurable(config?.storage_path, "/api/storage/{storage_id}"))
   )
 
   let val = $derived({
@@ -80,13 +80,12 @@ export function create_audio_config_manager(config) {
     audio_storage_picker_manager = create_storage_picker_manager({
       storage: config?.storage,
       default_folder_path: config?.storage_default_folder_path,
-      storage_path: config?.storage_path,
+      storage_src: () => storage_src,
       storage_origins: ["storage"],
       is_drop_zone: false,
       accept: ["audio/mpeg"],
       is_multiselect: false,
       on_finish: async (input) => {
-        const src = storage_src.replace("{storage_id}", input?.id)
         storage_id_text_input_manager.set_val(input?.id ?? null)
         is_storage_id_public_checkbox_manager.set_val(input?.is_public ?? null)
         src_text_input_manager.set_val(null)
@@ -131,7 +130,7 @@ export function create_audio_config_manager(config) {
     image_storage_picker_manager = create_storage_picker_manager({
       storage: config?.storage,
       default_folder_path: config?.storage_default_folder_path,
-      storage_path: config?.storage_path,
+      storage_src: () => storage_src,
       storage_origins: ["storage"],
       is_drop_zone: false,
       accept: ["image/png", "image/jpeg", "image/webp", "image/gif"],

package/dist/Components/ContentInput/AttributesInput/CustomConfig/AudioAdvanced/index.svelte.js

@@ -25,7 +25,7 @@ export function create_audio_advanced_config_manager(config) {
   let image_aspect_ratio_text_input_manager = $state(null)
 
   let storage_src = $derived(
-    set_closurable(config?.storage_src, "https://www.contibase.com/api/v1/storage/{storage_id}")
+    set_closurable(config?.storage_src, set_closurable(config?.storage_path, "/api/storage/{storage_id}"))
   )
 
   let val = $derived({
@@ -80,13 +80,12 @@ export function create_audio_advanced_config_manager(config) {
     audio_storage_picker_manager = create_storage_picker_manager({
       storage: config?.storage,
       default_folder_path: config?.storage_default_folder_path,
-      storage_path: config?.storage_path,
+      storage_src: () => storage_src,
       storage_origins: ["storage"],
       is_drop_zone: false,
       accept: ["audio/mpeg"],
       is_multiselect: false,
       on_finish: async (input) => {
-        const src = storage_src.replace("{storage_id}", input?.id)
         storage_id_text_input_manager.set_val(input?.id ?? null)
         is_storage_id_public_checkbox_manager.set_val(input?.is_public ?? null)
         src_text_input_manager.set_val(null)
@@ -131,7 +130,7 @@ export function create_audio_advanced_config_manager(config) {
     image_storage_picker_manager = create_storage_picker_manager({
       storage: config?.storage,
       default_folder_path: config?.storage_default_folder_path,
-      storage_path: config?.storage_path,
+      storage_src: () => storage_src,
       storage_origins: ["storage"],
       is_drop_zone: false,
       accept: ["image/png", "image/jpeg", "image/webp", "image/gif"],

package/dist/Components/ContentInput/AttributesInput/CustomConfig/Image/index.svelte.js

@@ -22,7 +22,7 @@ export function create_image_config_manager(config) {
   let bg_img_opacity_slider_manager = $state(null)
 
   let storage_src = $derived(
-    set_closurable(config?.storage_src, "https://www.contibase.com/api/v1/storage/{storage_id}")
+    set_closurable(config?.storage_src, set_closurable(config?.storage_path, "/api/storage/{storage_id}"))
   )
 
   let val = $derived({
@@ -63,7 +63,7 @@ export function create_image_config_manager(config) {
     storage_picker_manager = create_storage_picker_manager({
       storage: config?.storage,
       default_folder_path: config?.storage_default_folder_path,
-      storage_path: config?.storage_path,
+      storage_src: () => storage_src,
       storage_origins: ["storage"],
       is_drop_zone: false,
       accept: ["image/png", "image/jpeg", "image/webp", "image/gif"],

package/dist/Components/ContentInput/index.svelte.js

@@ -990,7 +990,7 @@ export function create_content_input_manager(config) {
     versions = [config?.val]
     storage = config?.storage
     storage_default_folder_path = config?.storage_default_folder_path
-    storage_path = config?.storage_path
+    storage_path = set_closurable(config?.storage_path, "/api/storage/{storage_id}")
     preempt_add_first_element_button_manager = create_button_manager({
       type: "outlined",
       support_icon: "edit",

package/dist/Components/StoragePicker/index.svelte.js

@@ -53,7 +53,7 @@ export function create_storage_picker_manager(config) {
   let is_show_button = $derived(set_closurable(config?.is_show_button, true))
   let is_show_file_view_toggle = $derived(set_closurable(config?.is_show_file_view_toggle, true))
   let storage_src = $derived(
-    set_closurable(config?.storage_src, "https://www.contibase.com/api/v1/storage/{storage_id}")
+    set_closurable(config?.storage_src, "/api/storage/{storage_id}")
   )
   let max_selected_files = $derived.by(() => {
     const configured_max = set_closurable(config?.max_selected_files, null)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sveltekit-ui",
-  "version": "1.1.87",
+  "version": "1.1.88",
   "description": "A SvelteKit UI component library for building modern web applications",
   "license": "MIT",
   "repository": {
@@ -49,21 +49,21 @@
     "qr-code-styling": "^1.9.2"
   },
   "peerDependencies": {
-    "@sveltejs/kit": "^2.22.2 || ^3.0.0",
+    "@sveltejs/kit": "^3.0.0",
     "svelte": "^5.0.0"
   },
   "devDependencies": {
-    "@sveltejs/adapter-vercel": "^7.0.0",
-    "@sveltejs/kit": "^3.0.0",
-    "@sveltejs/package": "^3.0.0",
+    "@sveltejs/adapter-vercel": "^7.0.1",
+    "@sveltejs/kit": "^3.1.0",
+    "@sveltejs/package": "^3.0.1",
     "@sveltejs/vite-plugin-svelte": "^7.3.1",
     "@vercel/analytics": "1.3.2",
-    "jsdom": "^30.1.1",
-    "svelte": "^5.57.1",
-    "svelte-check": "^4.7.6",
+    "jsdom": "^30.1.3",
+    "svelte": "^5.57.2",
+    "svelte-check": "^4.7.7",
     "typescript": "^6.0.3",
-    "vite": "^8.3.2",
-    "vitest": "^5.0.3"
+    "vite": "^8.3.4",
+    "vitest": "^5.0.5"
   },
   "homepage": "https://www.sveltekit-ui.com",
   "keywords": [
@@ -74,7 +74,7 @@
     "library"
   ],
   "engines": {
-    "node": ">=24.0.0"
+    "node": ">=24.15.0"
   },
   "publishConfig": {
     "access": "public"