@florasync/leaflet-geokit 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,17 +1,41 @@
 # Changelog
 
-## 0.1.0
+## Unreleased
 
-- Initial release.
+- Added optional Spec Kitty bootstrap scaffolding via [`.kittify/README.md`](.kittify/README.md) for future spec-driven workflows.
+- Added non-blocking Spec Kitty helper scripts in [`package.json`](package.json) (`spec-kitty:init`, `spec-kitty:doctor`) with no impact on existing CI/release steps.
+- Updated [`.gitignore`](.gitignore) to exclude Spec Kitty/agent runtime state while keeping source artifacts commit-friendly.
+- Added `draw-move` support to all dev harness variants so the Move/Translate toolbar tool is visible in Bundled WC, External WC, React, React (Bundled), Preact, and Preact (Bundled) demos.
+- Improved Move tool drag stability by anchoring translation to the initial drag-start pointer location, reducing jitter while repositioning GeoJSON features.
+- Kept Move confirmation workflow (`Save`/`Cancel`) and ensured docs/examples now include `draw-move` in supported draw attributes.
+- Expanded move-related test coverage for draw option wiring in `MapController`.
 
-## Unreleased
+## 0.4.0
 
-- Django shim no longer auto-initializes; consumers must call `window.GeoKitDjango.init(...)` explicitly.
-- Added `elementAttributes` option to `initDjangoGeokit` for programmatic attribute overrides (takes precedence over textarea data attributes).
-- Corrected framework wrapper naming: removed mistaken React-named Preact wrapper entrypoints.
-- Added explicit Preact wrapper entrypoints: `@florasync/leaflet-geokit/preact` and `@florasync/leaflet-geokit/preact-bundled`.
+- Added multi-page dev harness for live prototyping across all integration variants (Bundled WC, External WC, Preact, React).
+- Added navigation menu to dev harness for easy switching between test scenarios.
+- Improved dev harness UI with consistent geocoder, GeoJSON panel, and toast notifications across all pages.
+- Added `rollup-plugin-visualizer` for bundle analysis across all entrypoints.
+- Updated dependencies (Playwright, Preact, React).
+- Reduced package size to ~130kb rendered (still requires leaflet and leaflet-draw as peer dependencies).
+
+## 0.3.0
+
+- Added first-class Preact wrapper entrypoints: `@florasync/leaflet-geokit/preact` and `@florasync/leaflet-geokit/preact-bundled`.
 - Added first-class React wrapper entrypoints: `@florasync/leaflet-geokit/react` and `@florasync/leaflet-geokit/react-bundled`.
-- Added React shim docs and framework support entries in README.
 - Added real external entrypoint export: `@florasync/leaflet-geokit/external`.
 - Added dedicated external build artifact (`dist/leaflet-geokit.external.es.js`) with Leaflet stack externalized.
 - External mode now hard-falls back to bundled Leaflet/Draw when requested external Draw APIs are incomplete.
+- Django shim no longer auto-initializes; consumers must call `window.GeoKitDjango.init(...)` explicitly.
+- Added `elementAttributes` option to `initDjangoGeokit` for programmatic attribute overrides (takes precedence over textarea data attributes).
+- Corrected framework wrapper naming: removed mistaken React-named Preact wrapper entrypoints.
+
+## 0.2.0
+
+- Added thin Django shim layer for easy integration in Django templates without build tooling.
+- Added `initDjangoGeokit` helper to initialize GeoKit on a textarea with data attributes for configuration.
+- Added `django` export entrypoint for the Django shim.
+
+## 0.1.0
+
+- Initial release.

package/README.md

@@ -60,8 +60,18 @@ Documentation quick-links
 Inside this package directory:
 
 - npm install
-- npm run dev — starts Vite dev server
-- Open http://localhost:5173 in the browser (or whatever port VITE is using
+- npm run dev — starts the multi-page dev harness (Vite)
+- Open http://localhost:5173 to access the interactive test suite.
+
+### Dev Harness & Prototyping
+
+The dev harness is a multi-page environment that allows you to prototype and test the component in various scenarios:
+
+- **Bundled WC**: Standard web component with all dependencies included.
+- **External WC**: Web component using external Leaflet/Draw from a CDN.
+- **Preact / React**: First-class wrappers for Preact and React, testing both bundled and external dependency models.
+
+Use the navigation bar at the top of the harness to switch between these environments. This is the best way to verify changes across different framework integrations and dependency models.
 
 For consumption from another app:
 
@@ -131,6 +141,13 @@ Scripts (see [package.json](package.json))
 - npm run format — Prettier write
 - npm run test:e2e — Playwright (currently a minimal smoke test under e2e/)
 
+Optional workflow tooling
+
+- Spec Kitty is pre-wired as an optional, non-blocking workflow bootstrap.
+- `npm run spec-kitty:init` — initialize Spec Kitty in-place (requires `spec-kitty` CLI installed on your machine).
+- `npm run spec-kitty:doctor` — validate local Spec Kitty setup (requires `spec-kitty` CLI).
+- Build/test/publish scripts do **not** depend on Spec Kitty.
+
 Bundle analysis
 
 - The analyzer is opt-in and does not change normal production outputs.
@@ -221,6 +238,7 @@ Enable specific drawing tools by adding boolean attributes (presence = enabled):
 - **`draw-circle`**: Enable circle drawing tool
 - **`draw-layer-cake`**: Enable Layer Cake tool for creating concentric donut polygons
 - **`draw-marker`**: Enable point marker drawing tool
+- **`draw-move`**: Enable move/translate tool for repositioning existing features (with Save/Cancel confirmation)
 - **`draw-ruler`**: Enable measurement/ruler tool for distances and areas
 
 ```html
@@ -231,6 +249,7 @@ Enable specific drawing tools by adding boolean attributes (presence = enabled):
   draw-circle
   draw-layer-cake
   draw-marker
+  draw-move
   draw-ruler
 ></leaflet-geokit>
 ```
@@ -707,6 +726,7 @@ A. Basic HTML, served by Vite (development)
   draw-circle
   draw-layer-cake
   draw-marker
+  draw-move
   edit-features
   delete-features
   log-level="debug"
@@ -803,14 +823,13 @@ import { initDjangoGeokit } from "@florasync/leaflet-geokit/django";
 
 ### Preact
 
-Use the Preact wrappers when you want component-level integration in Preact apps.
+Use the Preact wrappers when you want component-level integration in Preact apps. We provide pre-baked wrappers that handle the custom element lifecycle and event synchronization.
 
-- Runtime dependency model: Preact is consumer-provided (peer dependency), so wrapper bundles stay thin.
+- **Runtime dependency model**: Preact is consumer-provided (peer dependency), so wrapper bundles stay thin.
+- **Shim docs**: [docs/shims/preact.md](docs/shims/preact.md)
+- **Entrypoints**: [src/preact/index.tsx](src/preact/index.tsx), [src/preact-bundled/index.tsx](src/preact-bundled/index.tsx)
 
-- Shim docs: [docs/shims/preact.md](docs/shims/preact.md)
-- Entrypoints: [src/preact/index.tsx](src/preact/index.tsx), [src/preact-bundled/index.tsx](src/preact-bundled/index.tsx)
-
-### Preact wrapper (additive Leaflet mode)
+#### Preact wrapper (additive Leaflet mode)
 
 If your Preact app already loads Leaflet + Leaflet.draw, use the Preact shim:
 
@@ -847,14 +866,13 @@ See full Preact shim docs: [docs/shims/preact.md](docs/shims/preact.md)
 
 ### React
 
-Use the React wrappers when you want component-level integration in React apps.
-
-- Runtime dependency model: React/ReactDOM are consumer-provided (peer dependencies), so wrapper bundles stay thin.
+Use the React wrappers when you want component-level integration in React apps. These wrappers provide a first-class React experience for the web component.
 
-- Shim docs: [docs/shims/react.md](docs/shims/react.md)
-- Entrypoints: [src/react/index.tsx](src/react/index.tsx), [src/react-bundled/index.tsx](src/react-bundled/index.tsx)
+- **Runtime dependency model**: React/ReactDOM are consumer-provided (peer dependencies), so wrapper bundles stay thin.
+- **Shim docs**: [docs/shims/react.md](docs/shims/react.md)
+- **Entrypoints**: [src/react/index.tsx](src/react/index.tsx), [src/react-bundled/index.tsx](src/react-bundled/index.tsx)
 
-### React wrapper (additive Leaflet mode)
+#### React wrapper (additive Leaflet mode)
 
 If your React app already loads Leaflet + Leaflet.draw, use the React shim: