@winkintel/bootstrap-svelte 1.0.0 → 1.0.2

package/README.md

@@ -1,17 +1,41 @@
 # Bootstrap Svelte
 
-> Bootstrap components for Svelte 5 with TypeScript support.
+> Bootstrap 5 components for Svelte 5 with TypeScript support.
 
-Bootstrap Svelte provides ready-to-use, type-safe Bootstrap components built specifically for Svelte 5 applications. The package follows Bootstrap's design language while exposing Svelte-native component APIs.
+Bootstrap Svelte provides ready-to-use, type-safe Bootstrap components for Svelte 5 applications. It follows Bootstrap's design language and class conventions while exposing Svelte-native component APIs.
+
+Use it when you want Bootstrap's familiar grid, utilities, and UI patterns in a Svelte app without copying Bootstrap markup by hand.
+
+## Links
+
+- npm: [`@winkintel/bootstrap-svelte`](https://www.npmjs.com/package/@winkintel/bootstrap-svelte)
+- Repository: [`WinkIntel/bootstrap-svelte`](https://github.com/WinkIntel/bootstrap-svelte)
+- Bootstrap: <https://getbootstrap.com/>
+- Svelte: <https://svelte.dev/>
+
+## Why this exists
+
+Bootstrap is still a practical choice for many product, enterprise, and internal applications: it is familiar, well documented, stable, and easy for mixed frontend/backend teams to work with.
+
+This package is for teams that specifically want Bootstrap in a Svelte 5 app, but would rather use maintained Svelte components than hand-roll Bootstrap's required markup and interactive behavior for every project.
+
+It is not trying to replace Tailwind, shadcn-style workflows, or fully custom design systems.
 
 ## Features
 
 - **Svelte 5 compatible** — built for current Svelte syntax and reactivity.
-- **Bootstrap-oriented components** — implements common Bootstrap UI patterns.
 - **TypeScript support** — component props and public utilities are typed.
+- **Bootstrap-oriented APIs** — keeps components close to Bootstrap's naming and mental model.
 - **Modular exports** — import only the components/utilities you need.
-- **Responsive by default** — intended to work with Bootstrap's responsive CSS.
-- **Package-local showcase** — the SvelteKit docs/showcase app lives in `src/routes`.
+- **Responsive by default** — designed to work with Bootstrap's responsive CSS.
+- **SvelteKit-friendly project structure** — the package-local showcase/docs app lives in `src/routes`.
+- **No bundled Bootstrap CSS** — consumers control their own Bootstrap CSS/SCSS pipeline.
+
+## Requirements
+
+- Svelte 5
+- Bootstrap 5 CSS supplied by the consuming application
+- A modern Svelte/Vite/SvelteKit-style build pipeline
 
 ## Installation
 
@@ -21,6 +45,7 @@ pnpm add @winkintel/bootstrap-svelte bootstrap
 # or
 npm install @winkintel/bootstrap-svelte bootstrap
 
+# or
 yarn add @winkintel/bootstrap-svelte bootstrap
 ```
 
@@ -32,11 +57,11 @@ This package requires Svelte 5:
 pnpm add svelte@^5.0.0
 ```
 
-Bootstrap CSS is expected to be provided by the consuming application.
-
 ## Bootstrap CSS
 
-Import Bootstrap CSS in your application:
+Bootstrap CSS is expected to be provided by your application.
+
+Import Bootstrap CSS in your app entry point or root layout:
 
 ```javascript
 import 'bootstrap/dist/css/bootstrap.min.css';
@@ -109,6 +134,7 @@ Or use Bootstrap SCSS from your app stylesheet/build pipeline:
 - `Placeholder`
 - `Progress`
 - `Spinner`
+- `Table`
 
 ### Navigation
 
@@ -116,6 +142,7 @@ Or use Bootstrap SCSS from your app stylesheet/build pipeline:
 - `Nav`
 - `Navbar`
 - `Pagination`
+- `Scrollspy`
 - `Tab`
 
 ### Interactive
@@ -123,6 +150,7 @@ Or use Bootstrap SCSS from your app stylesheet/build pipeline:
 - `Button`
 - `ButtonGroup`
 - `Carousel`
+- `CloseButton`
 - `Dropdown`
 - `Modal`
 - `Offcanvas`
@@ -138,6 +166,25 @@ Or use Bootstrap SCSS from your app stylesheet/build pipeline:
 - `BreakpointListener`
 - CSS/class/style utilities
 
+## Notes for SvelteKit and SSR
+
+Bootstrap Svelte is designed for Svelte 5 projects, including SvelteKit applications. Bootstrap CSS should be imported through the consuming app's normal CSS pipeline.
+
+Interactive components are implemented as Svelte components rather than requiring consumers to wire Bootstrap's JavaScript snippets manually. If you find an SSR or hydration edge case, please open an issue with a minimal reproduction.
+
+## Status and feedback
+
+This package is published as `1.0.1`, but feedback from Svelte developers is still very welcome. Useful feedback includes:
+
+- Component API ergonomics
+- Svelte 5 idioms and runes compatibility
+- Accessibility issues
+- SvelteKit/SSR edge cases
+- Missing Bootstrap components or variants
+- README/docs gaps
+
+Please use [GitHub Issues](https://github.com/WinkIntel/bootstrap-svelte/issues) for bugs, feature requests, and design/API feedback.
+
 ## Local development
 
 ```bash

package/dist/Carousel/carousel.svelte.js

@@ -66,8 +66,9 @@ export class CarouselRootState {
             };
             document.addEventListener('visibilitychange', this.#visibilityListener);
         }
-        // Start autoplay immediately if ride='carousel', otherwise wait for user interaction
-        if (this.#ride === 'carousel' && !this.#timeoutId) {
+        // Start autoplay immediately in the browser if ride='carousel', otherwise wait for user interaction.
+        // During static prerendering there is no browser timer API, so autoplay starts during hydration instead.
+        if (typeof window !== 'undefined' && this.#ride === 'carousel' && !this.#timeoutId) {
             this.cycle();
         }
     }
@@ -277,7 +278,6 @@ export class CarouselRootState {
      */
     cycle() {
         if (typeof window === 'undefined') {
-            console.warn('[Carousel] Cycle called in non-browser environment, ignoring.');
             return;
         }
         // Don't start cycling if we're hovered and pause='hover'
@@ -306,7 +306,6 @@ export class CarouselRootState {
     }
     pause() {
         if (typeof window === 'undefined') {
-            console.warn('[Carousel] Pause called in non-browser environment, ignoring.');
             return;
         }
         if (this.#timeoutId) {

package/package.json

@@ -1,7 +1,7 @@
 {
     "author": "Wink, Inc.",
     "name": "@winkintel/bootstrap-svelte",
-    "version": "1.0.0",
+    "version": "1.0.2",
     "description": "Bootstrap components for Svelte 5 with TypeScript support.",
     "license": "Apache-2.0",
     "repository": {
@@ -18,6 +18,7 @@
         "bnd": "pnpm build && pnpm dev",
         "bnp": "pnpm build && pnpm preview",
         "build": "vite build && pnpm prepack",
+        "build:site": "vite build",
         "check-types": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
         "check-types:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
         "clean": "rimraf --glob --max-retries=10 --retry-delay=250 '{.svelte-kit,.turbo,.vercel,build,dist,node_modules,playwright-mcp,test-results}'",
@@ -25,8 +26,8 @@
         "format": "prettier --write --ignore-path=.prettierignore $(git diff --name-only --diff-filter d --relative . && git ls-files --others --exclude-standard | sed \"s|^$(git rev-parse --show-prefix)||\")",
         "format-all": "prettier --write --ignore-path=.prettierignore ./src",
         "lint": "prettier --check ./src && eslint ./src",
-        "ncu:check": "ncu --target minor && ncu --target minor --cooldown 0d --filter \"@sveltejs/adapter-vercel,@sveltejs/kit,@sveltejs/vite-plugin-svelte,svelte,svelte-check,svelte-preprocess\"",
-        "ncu:upgrade": "ncu --target minor -u && ncu --target minor --cooldown 0d -u --filter \"@sveltejs/adapter-vercel,@sveltejs/kit,@sveltejs/vite-plugin-svelte,svelte,svelte-check,svelte-preprocess\" && pnpm install",
+        "ncu:check": "ncu --target minor && ncu --target minor --cooldown 0d --filter \"@sveltejs/adapter-static,@sveltejs/kit,@sveltejs/vite-plugin-svelte,svelte,svelte-check,svelte-preprocess\"",
+        "ncu:upgrade": "ncu --target minor -u && ncu --target minor --cooldown 0d -u --filter \"@sveltejs/adapter-static,@sveltejs/kit,@sveltejs/vite-plugin-svelte,svelte,svelte-check,svelte-preprocess\" && pnpm install",
         "prepare": "svelte-kit sync || echo ''",
         "prepack": "svelte-kit sync && svelte-package && publint",
         "preview": "vite preview --port 4176",
@@ -63,7 +64,7 @@
     "devDependencies": {
         "@eslint/compat": "~2.1.0",
         "@eslint/js": "~10.0.1",
-        "@sveltejs/adapter-vercel": "^6.3.3",
+        "@sveltejs/adapter-static": "^3.0.10",
         "@sveltejs/kit": "~2.61.1",
         "@sveltejs/package": "~2.5.7",
         "@sveltejs/vite-plugin-svelte": "~7.1.2",