zerocodejs 1.0.1-beta.19 → 1.0.1-beta.20

package/README.ja.md

@@ -104,6 +104,10 @@ import 'zerocodejs/style.css';
 </script>
 ```
 
+### スタイルシートの読み込み順
+
+**`zerocodejs/style.css`**（または `dist/zerocodejs.css`）は、**強いグローバルリセット（Tailwind の Preflight、`input { appearance: none }` など）より後に**読み込むことを推奨します。クラスは `zcode-` でスコープされますが、チェックボックス・ラジオ・`select` などネイティブ要素は広い `input` / `select` リセットの影響を受けることがあります。
+
 ## コンポーネント
 
 ### `<zcode-editor>`
@@ -130,6 +134,16 @@ import 'zerocodejs/style.css';
 
 詳細は [技術仕様書 – zcode-studio](./TECHNICAL_SPECIFICATION.md#zcode-studio)。
 
+## サーバーサイドレンダリング（SSR）
+
+**Node.js** や Next.js などでは、公式サブパス **`zerocodejs/ssr`** から `renderToHtml` / `renderCssToHtml` を import することを推奨します。Vue・Web Components を含まない軽量バンドル（`package.json` の `exports["./ssr"]`）です。テンプレート処理には **jsdom** が必要です（`zerocodejs` の依存として入ります）。
+
+```javascript
+import { renderToHtml, renderCssToHtml } from 'zerocodejs/ssr';
+```
+
+従来どおり **`zerocodejs`** 本体から同じ関数を import することもできます。
+
 ## 既存データの読み込み
 
 既存データを読み込む場合は、JavaScriptで属性を設定します：

package/README.md

@@ -97,6 +97,10 @@ import 'zerocodejs/style.css';
 </script>
 ```
 
+### Stylesheet load order
+
+Import **`zerocodejs/style.css`** after any aggressive global reset (for example Tailwind Preflight or rules that set `input { appearance: none }`). ZeroCode scopes UI with `zcode-` classes, but native checkboxes, radios, and selects can still be affected by broad `input` / `select` resets.
+
 ## Components
 
 ### `<zcode-editor>`
@@ -123,6 +127,16 @@ For **trusted users / agencies**: same **shell as `zcode-editor`** (page, parts,
 
 See [Technical Specification – zcode-studio](./TECHNICAL_SPECIFICATION.md#zcode-studio).
 
+## Server-side rendering (SSR)
+
+For **Node.js** or app frameworks (e.g. Next.js), import from the **`zerocodejs/ssr`** subpath. It is the supported `package.json` export for the SSR bundle (no Vue / Web Components). Template processing needs **jsdom** (already a dependency of `zerocodejs`).
+
+```javascript
+import { renderToHtml, renderCssToHtml } from 'zerocodejs/ssr';
+```
+
+The main **`zerocodejs`** entry also exports these functions if you prefer one resolution from the full library.
+
 ## Loading Existing Data
 
 To load existing data, set attributes via JavaScript:

package/dist/core/utils/dom-utils.d.ts

@@ -2,6 +2,9 @@
  * DOM操作のユーティリティ
  * 環境に応じて適切なDOMParserを返す
  */
+/** WHATWG nodeType — Node.js has no global `Node`; use these in SSR paths. */
+export declare const DOM_NODE_TYPE_ELEMENT = 1;
+export declare const DOM_NODE_TYPE_TEXT = 3;
 export declare function getDOMParser(): typeof DOMParser;
 /**
  * Shadow DOM内で実行されるスクリプトに対して、そのShadow DOM内の要素にアクセスできるようにする拡張スクリプトを生成

package/dist/core/utils/dom-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom-utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/dom-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,YAAY,IAAI,OAAO,SAAS,CAuB/C;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CA8V7E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,EACtB,aAAa,GAAE,OAAe,GAC7B,IAAI,CAyCN;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAkCzC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI,CAuB9E"}
+{"version":3,"file":"dom-utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/dom-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,8EAA8E;AAC9E,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,wBAAgB,YAAY,IAAI,OAAO,SAAS,CAuB/C;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CA8V7E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,UAAU,EACtB,aAAa,GAAE,OAAe,GAC7B,IAAI,CAyCN;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAkCzC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,GAAE,MAAU,GAAG,IAAI,CAuB9E"}