@takazudo/zdtp 0.8.4 → 0.8.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -8,6 +8,32 @@ The format is based on Keep a Changelog, and release notes are generated from th
8
8
 
9
9
  No unreleased changes yet.
10
10
 
11
+ ## [0.8.6] - 2026-10-10
12
+
13
+ ### Fixed
14
+
15
+ - fix(package): own Preact for imperative consumers (03df715)
16
+ - fix(playground): complete published zfb 4.1 migration checks (4695484)
17
+ - fix(playground): isolate development artifacts from deploy output (e602459)
18
+
19
+ ### Other Changes
20
+
21
+ - ci: allow release-only commits to skip site deployment (dd92459)
22
+ - chore(playground): pin published zfb 4.3.0 without preview uploads (c6a6621)
23
+ - chore(playground): adopt published zfb 4.2 watcher fix (dd23bba)
24
+ - chore(playground): migrate to published zfb 4 with visual parity (28c3ff2)
25
+ - chore(playground): prepare isolated zfb 3 migration (93bda4f)
26
+
27
+ ## [0.8.5] - 2026-09-27
28
+
29
+ ### Fixed
30
+
31
+ - Stop a fresh panel mount persisting closed state for one flush: the open-state persist effect no longer writes the initial `open=false` over the intent that `showInstance` or a toggle had just stored. A reload or navigation in that window used to restore the panel closed, and a toggle in that window was lost ([#1000](https://github.com/Takazudo/zudo-design-token-panel/issues/1000), [#1001](https://github.com/Takazudo/zudo-design-token-panel/pull/1001)) (fc61431)
32
+
33
+ ### Other Changes
34
+
35
+ - Move the liveness comment onto the check it explains (f3c9bc7)
36
+
11
37
  ## [0.8.4] - 2026-09-26
12
38
 
13
39
  ### Fixed
@@ -1389,6 +1389,13 @@ window.zdtp.toggle = () => void | Promise<void>; // toggle the panel
1389
1389
 
1390
1390
  ## 7. CSS contract
1391
1391
 
1392
+ The panel owns Preact as a regular package dependency. Imperative hosts, including
1393
+ ZFB 3/4 zudo-react islands, can install only `@takazudo/zdtp`; lazy-load it inside
1394
+ activation and keep its mounted tree separate from the host renderer. Public
1395
+ Preact declaration imports resolve through that dependency. The Preact dashboard
1396
+ renderer remains Preact-specific; a host rendering it directly still owns its JSX
1397
+ and server-rendering dependencies. No private Preact copy is bundled.
1398
+
1392
1399
  ### 7.1 Panel-private namespace
1393
1400
 
1394
1401
  The panel ships its own bundled CSS. Panel-private color, font, spacing,
package/README.md CHANGED
@@ -172,7 +172,7 @@ A Preact-rendered side panel that:
172
172
  - Exposes a small console API (`window.<namespace>.showDesignPanel()` etc.) so a developer can pop the panel without it being mounted on every page.
173
173
  - Plugs into Astro's view-transition lifecycle (`astro:before-swap` / `astro:page-load`) so soft navigation does not double-mount the panel.
174
174
 
175
- The package builds against Preact (declared as a `peerDependency`) and ships its own bundled CSS scoped under the `--tokentweak-*` namespace. **It does not require Tailwind** in the consumer; see §11.
175
+ The package builds against Preact (installed as its own regular dependency) and ships its own bundled CSS scoped under the `--tokentweak-*` namespace. **It does not require Tailwind** in the consumer; see §11.
176
176
 
177
177
  > Visual: a screenshot or short capture would go here. Skipped in the v1 README — a placeholder is worse than nothing. See the external example repos linked in §15 for live demos.
178
178
 
@@ -182,29 +182,38 @@ The package builds against Preact (declared as a `peerDependency`) and ships its
182
182
 
183
183
  ## 2. Install
184
184
 
185
- Install from npm. Preact is a peer dependency — bring your own copy so the panel shares one runtime with any other Preact islands you mount.
185
+ Install the panel from npm. Preact is a regular dependency owned by ZDTP, so
186
+ an imperative host does not need to declare Preact or use it as its JSX runtime.
186
187
 
187
188
  ```sh
188
- pnpm add @takazudo/zdtp preact
189
+ pnpm add @takazudo/zdtp
189
190
  ```
190
191
 
191
192
  ```jsonc
192
193
  // consumer/package.json
193
194
  {
194
195
  "dependencies": {
195
- "@takazudo/zdtp": "^0.1.0",
196
- },
197
- "peerDependencies": {
198
- "preact": "^10.29.1",
199
- },
196
+ "@takazudo/zdtp": "^0.8.6"
197
+ }
200
198
  }
201
199
  ```
202
200
 
203
- ### Peer dependencies
204
-
205
- | Peer | Range | Why |
206
- | -------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------- |
207
- | `preact` | `^10.29.1` | The panel UI is rendered with Preact. The consumer must bring its own copy so the panel and any other Preact islands share one runtime. |
201
+ ZDTP's public declarations still use Preact types; its regular dependency makes
202
+ those types available to TypeScript without a host-level Preact dependency.
203
+ Preact hosts and users of the Preact `./dashboard` renderer should keep their own
204
+ Preact dependency for their JSX and rendering code. A compatible installed copy
205
+ can still be shared; ZDTP does not bundle a private Preact runtime.
206
+
207
+ For ZFB 3 and 4, load ZDTP inside the host island's activation callback and mount
208
+ it through `configurePanel()`. Keep ZDTP's Preact tree separate from zudo-react's
209
+ VNode tree. The panel injects its CSS on mount, so no static CSS import is needed;
210
+ `@takazudo/zdtp/styles.css` remains an optional public CSS export for hosts that
211
+ want a static stylesheet. The static dashboard instead requires its separate
212
+ `@takazudo/zdtp/dashboard/styles.css` asset.
213
+
214
+ The DOM Tweaker's Tailwind browser runtime remains behind its existing lazy
215
+ activation boundary. Those dependencies are still installed with the package;
216
+ ordinary panel mounting does not load that runtime.
208
217
 
209
218
  The package's CSS is self-contained — it ships its own bundled stylesheet under the panel-private `--tokentweak-*` namespace and does not depend on any host design-system package.
210
219
 
@@ -1,6 +1,6 @@
1
1
  import { jsx as y, jsxs as K, Fragment as kt } from "preact/jsx-runtime";
2
2
  import { useEffect as P, useState as Y, useRef as O, useMemo as J, useCallback as X } from "preact/hooks";
3
- import { b as ft, p as wt, u as ht, a as Ne, A as bt, Z as gt } from "./index-DD2WOdSn.js";
3
+ import { b as ft, p as wt, u as ht, a as Ne, A as bt, Z as gt } from "./index-CAajoSLj.js";
4
4
  import { g as vt, m as j } from "./panel-config-DKfob-1r.js";
5
5
  const xt = (e, o) => {
6
6
  const t = new Array(e.length + o.length);