@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 +26 -0
- package/PORTABLE-CONTRACT.md +7 -0
- package/README.md +22 -13
- package/dist/{index-BtjPws6K.js → index-Byasm3Xo.js} +1 -1
- package/dist/{index-DD2WOdSn.js → index-CAajoSLj.js} +3600 -3596
- package/dist/index.js +1 -1
- package/package.json +2 -4
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
|
package/PORTABLE-CONTRACT.md
CHANGED
|
@@ -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 (
|
|
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
|
|
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
|
|
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.
|
|
196
|
-
}
|
|
197
|
-
"peerDependencies": {
|
|
198
|
-
"preact": "^10.29.1",
|
|
199
|
-
},
|
|
196
|
+
"@takazudo/zdtp": "^0.8.6"
|
|
197
|
+
}
|
|
200
198
|
}
|
|
201
199
|
```
|
|
202
200
|
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
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-
|
|
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);
|