@takazudo/zdtp 0.1.0-next.0 → 0.1.0-next.1

package/CHANGELOG.md

@@ -1,6 +1,32 @@
 # Changelog
 
-## Unreleased
+## 0.1.0-next.1
+
+### Fixed — Astro consumers: `@takazudo/zdtp/astro` value import broke real npm installs ([#308](https://github.com/Takazudo/zudo-design-token-panel/issues/308))
+
+- The documented Astro host import
+  `import { DesignTokenPanelHost } from '@takazudo/zdtp/astro'` forced
+  `dist/astro/index.js` to statically `import` the raw `.astro` component.
+  Under a `file:` workspace link Vite compiled it, but as a real
+  `node_modules` dependency it was externalized, so Node hit the raw `.astro`
+  at prerender and threw `ERR_UNKNOWN_FILE_EXTENSION`. **Every real npm Astro
+  consumer following the README crashed at build time.**
+- **Fix**: the `@takazudo/zdtp/astro` entry is now JS-helpers-and-types only —
+  it no longer re-exports the component value, so the crashing `.astro`
+  literal can't appear in the bundled JS. Import the host component directly
+  from its dedicated subexport, which the consumer's own Astro toolchain
+  compiles natively:
+
+  ```astro
+  import DesignTokenPanelHost from '@takazudo/zdtp/astro/DesignTokenPanelHost.astro';
+  ```
+
+  Type-only imports (`import type { PanelConfig } from '@takazudo/zdtp/astro'`)
+  are unchanged — they are erased at build. The `./astro/host-adapter`
+  side-effect import is unchanged. Docs (README, PORTABLE-CONTRACT, doc-site
+  recipes) updated to the direct-subexport form.
+
+## 0.1.0-next.0
 
 ### Renamed — npm package is now `@takazudo/zdtp`
 

package/README.md

@@ -290,7 +290,7 @@ The `<DesignTokenPanelHost>` component AND a paired `<script>` block that loads
 ---
 // src/layouts/Layout.astro
 import { ClientRouter } from 'astro:transitions';
-import { DesignTokenPanelHost } from '@takazudo/zdtp/astro';
+import DesignTokenPanelHost from '@takazudo/zdtp/astro/DesignTokenPanelHost.astro';
 import { myPanelConfig } from '../lib/my-panel-config';
 import '@takazudo/zdtp/styles';
 ---
@@ -736,7 +736,7 @@ export const myPanelConfig: PanelConfig = {
 
 ```astro
 ---
-import { DesignTokenPanelHost } from '@takazudo/zdtp/astro';
+import DesignTokenPanelHost from '@takazudo/zdtp/astro/DesignTokenPanelHost.astro';
 import { myPanelConfig } from '../lib/my-panel-config';
 ---
 
@@ -999,7 +999,7 @@ This recipe walks through wiring the panel into a project that does not currentl
 
    ```astro
    ---
-   import { DesignTokenPanelHost } from '@takazudo/zdtp/astro';
+   import DesignTokenPanelHost from '@takazudo/zdtp/astro/DesignTokenPanelHost.astro';
    import { myPanelConfig } from '../lib/panel-config';
    ---
 

package/dist/astro/DesignTokenPanelHost.astro

@@ -7,7 +7,7 @@
  *
  * ```astro
  * ---
- * import { DesignTokenPanelHost } from '@takazudo/zdtp/astro';
+ * import DesignTokenPanelHost from '@takazudo/zdtp/astro/DesignTokenPanelHost.astro';
  * import { panelConfig } from './my-design-token-config';
  * // Required side-effect import for the package's bundled chrome CSS —
  * // Vite library mode strips the source CSS import from the emitted JS,

package/dist/astro/index.d.ts

@@ -1,24 +1,27 @@
 /**
- * Astro sub-export entry.
+ * Astro sub-export entry — JS helpers and TypeScript types only.
  *
- * Consumers import the host component via:
+ * The host **component** is NOT re-exported here. Import it directly from
+ * its dedicated `.astro` subexport so the consumer's Astro toolchain
+ * compiles it natively:
  *
  * ```astro
- * import { DesignTokenPanelHost } from '@takazudo/zdtp/astro';
+ * import DesignTokenPanelHost from '@takazudo/zdtp/astro/DesignTokenPanelHost.astro';
  * ```
  *
- * The named-export pattern is preserved verbatim through the lib build:
- * `vite.config.ts` marks `*.astro` external (regex) so Vite leaves the
- * `from './DesignTokenPanelHost.astro'` literal in `dist/astro/index.js`,
- * and a postbuild copy step (`scripts/copy-astro-assets.mjs`) places the
- * raw `.astro` file alongside it. The consumer's own Astro toolchain then
- * resolves the relative path at build time.
+ * Why not `import { DesignTokenPanelHost } from '@takazudo/zdtp/astro'`?
+ * That named-export form forced `dist/astro/index.js` to statically
+ * `import ... from './DesignTokenPanelHost.astro'`. As a `file:` workspace
+ * link Vite compiles the `.astro`; as a real node_modules dependency it is
+ * externalized, so Node hits the raw `.astro` at prerender and throws
+ * `ERR_UNKNOWN_FILE_EXTENSION` (zdtp#308). Keeping this entry value-free
+ * means that crash can't be reintroduced by following the docs.
  *
- * `PanelConfig` is re-exported here so callers don't need a deep
- * `@takazudo/zdtp/dist/config/panel-config` import to
- * type their config object.
+ * Type-only imports from this entry (`import type { PanelConfig } ...`) are
+ * erased at build and stay safe — `PanelConfig` is re-exported here so
+ * callers don't need a deep `@takazudo/zdtp/dist/config/panel-config`
+ * import to type their config object.
  */
-export { default as DesignTokenPanelHost } from './DesignTokenPanelHost.astro';
 export type { PanelConfig } from '../config/panel-config';
 export type { ColorScheme, ColorRef } from '../config/color-schemes';
 export type { ColorClusterConfig } from '../state/tweak-state';

package/dist/astro/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/astro/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAK9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAKvD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAKvG,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnG,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/astro/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAK9D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAKvD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAKvG,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnG,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/astro/index.js

@@ -1,7 +1,6 @@
-import { default as t } from "./DesignTokenPanelHost.astro";
-import { s as d } from "../panel-config-DP2_P7dD.js";
-import { c as r } from "../color-schemes-CgzOBqGO.js";
-import { F as g, G as f, a as l, S as z } from "../manifest-DCReQE0k.js";
+import { s as t } from "../panel-config-DP2_P7dD.js";
+import { c as d } from "../color-schemes-CgzOBqGO.js";
+import { F as r, G as m, a as g, S as z } from "../manifest-DCReQE0k.js";
 const e = {
   colorScheme: "Default Dark",
   colorMode: !1
@@ -41,14 +40,13 @@ const e = {
   active: "--zd-semantic-active"
 };
 export {
-  t as DesignTokenPanelHost,
-  g as FONT_GROUP_ORDER,
-  f as GROUP_ORDER,
-  l as GROUP_TITLES,
+  r as FONT_GROUP_ORDER,
+  m as GROUP_ORDER,
+  g as GROUP_TITLES,
   s as SEMANTIC_CSS_NAMES,
   c as SEMANTIC_DEFAULTS_ZD,
   z as SIZE_GROUP_ORDER,
-  r as colorSchemes,
+  d as colorSchemes,
   e as panelSettings,
-  d as setPanelColorPresets
+  t as setPanelColorPresets
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zdtp",
-  "version": "0.1.0-next.0",
+  "version": "0.1.0-next.1",
   "description": "Dynamic design-token tweak panel — host-config-driven, framework-agnostic Preact UI.",
   "private": false,
   "license": "MIT",