create-ampless 1.0.0-beta.170 → 1.0.0-beta.172

package/dist/templates/_shared/docs/plugin-author-guide.ja.md

@@ -186,6 +186,7 @@ interface AmplessPlugin {
   publicBodyEnd?(ctx): readonly PublicBodyDescriptor[]
   publicBodyForPost?(post: Post, ctx): readonly PublicPostBodyDescriptor[]
   publicHtmlForPost?(post: Post, ctx): readonly PublicPostHtmlDescriptor[]
+  tiptapNodeToMarkdown?: TiptapNodeMarkdownAdapters  // server-safe markdown export adapters
   ogImage?: OgImageConfig
   settings?: {
     public?: readonly PluginSettingField[]
@@ -875,6 +876,48 @@ export function EditorBootstrap({ children }: { children: React.ReactNode }) {
 }
 ```
 
+### アダプターの置き場所: `./editor.tsx` ではなく `./adapters.ts`
+
+`./editor.tsx` は `'use client'` かつ `@tiptap/core` を import している —
+admin バンドルには問題ないが、server コード（や将来の `postToMarkdown`
+public runtime）からこれを import すると両方を巻き込んでしまう。アダプター
+（および `Node.renderHTML` と共有する `placeholderAttrs` のような plain
+object ヘルパ）は、tiptap 非依存の別モジュール `./adapters.ts` に置き、
+`./editor.tsx` からは 2 つの named symbol を **re-export** する:
+
+```ts
+// packages/plugin-youtube/src/adapters.ts — 'use client' なし、@tiptap/* import なし
+export const tiptapNodeToMarkdown: TiptapNodeMarkdownAdapters = { /* ... */ }
+export const tiptapNodeToHtml: TiptapNodeHtmlAdapters = { /* ... */ }
+```
+
+```ts
+// packages/plugin-youtube/src/editor.tsx
+export { tiptapNodeToMarkdown, tiptapNodeToHtml } from './adapters.js'
+```
+
+この re-export により `update-ampless` の codegen 契約は無改修で維持される
+（下記「配線」の通り、`./editor` の namespace import から `ns.tiptapNodeToMarkdown ?? {}` /
+`ns.tiptapNodeToHtml ?? {}` を読む挙動は変わらない）。同時に server 側
+entry（`./index.tsx`）も同じアダプターを `./adapters.js` から import して
+manifest に設定できる:
+
+```ts
+// packages/plugin-youtube/src/index.tsx
+import { tiptapNodeToMarkdown } from './adapters.js'
+
+export default function youtubePlugin(opts = {}) {
+  return definePlugin({
+    // ...
+    tiptapNodeToMarkdown,   // AmplessPlugin.tiptapNodeToMarkdown — server 側 canonical
+  })
+}
+```
+
+`definePlugin()` は `contentFields` の `kind: 'tiptap'` エントリの
+`nodeType` に対応する `tiptapNodeToMarkdown` のキーが無い場合に warn する
+— 両方をセットで宣言し、warning が出ない状態を保つ。
+
 ### フォーマット切り替えの可逆アダプター（`tiptapNodeToMarkdown` + `tiptapNodeToHtml`）
 
 operator が admin UI でポストのフォーマットを切り替える場合（例: `tiptap → markdown`、`tiptap → html`）、admin はボディコンテンツを変換する必要がある。通常の prose node は tiptap の built-in レンダラーで処理されるが、**atom node**（`amplessYoutube` のような embed ブロック）は子要素を持たず、children が空のまま fallthrough し、embed が無音で消えてしまう。
@@ -911,6 +954,7 @@ embed node を持つが `htmlPlaceholder` を**宣言しない** plugin は従
 **文字列**（空文字 `''` も含む）を返すと、その出力を使う。**`null`** を返すとデフォルトの switch へ fallthrough する（対応しない node や video id が欠損している場合などに使う）。
 
 ```ts
+// packages/plugin-youtube/src/adapters.ts
 import type { TiptapNodeMarkdownAdapters, TiptapNodeHtmlAdapters } from 'ampless'
 
 export const tiptapNodeToMarkdown: TiptapNodeMarkdownAdapters = {
@@ -939,7 +983,7 @@ export const tiptapNodeToHtml: TiptapNodeHtmlAdapters = {
 
 #### 配線
 
-`update-ampless` が各プラグインの `./editor` モジュールから `tiptapNodeToMarkdown` と `tiptapNodeToHtml` の named export を読み取り、両方の install に自動で配線する。**手動での配線は不要。** プラグインがいずれかのマップを export しない場合、生成ファイルの `?? {}` fallback が no-op になる。
+`update-ampless` が各プラグインの `./editor` モジュールから `tiptapNodeToMarkdown` と `tiptapNodeToHtml` の named export を読み取り、両方の install に自動で配線する。**手動での配線は不要。** プラグインがいずれかのマップを export しない場合、生成ファイルの `?? {}` fallback が no-op になる。上記の通り、`./editor` が re-export するこれらの export は通常 `./adapters.ts` に実装されている — codegen は `./editor` の namespace から到達可能であることだけを見ており、定義場所は問わない。
 
 #### `markdown → html` 2-hop
 

package/dist/templates/_shared/docs/plugin-author-guide.md

@@ -214,6 +214,7 @@ interface AmplessPlugin {
   publicBodyEnd?(ctx): readonly PublicBodyDescriptor[]
   publicBodyForPost?(post: Post, ctx): readonly PublicPostBodyDescriptor[]
   publicHtmlForPost?(post: Post, ctx): readonly PublicPostHtmlDescriptor[]
+  tiptapNodeToMarkdown?: TiptapNodeMarkdownAdapters  // server-safe markdown export adapters
   ogImage?: OgImageConfig
   settings?: {
     public?: readonly PluginSettingField[]
@@ -1132,6 +1133,48 @@ export function EditorBootstrap({ children }: { children: React.ReactNode }) {
 }
 ```
 
+### Where the adapters live: `./adapters.ts`, not `./editor.tsx`
+
+`./editor.tsx` carries `'use client'` and imports `@tiptap/core` — fine for
+the admin bundle, but importing it from server code (or the future
+`postToMarkdown` public runtime) would drag both along. Put the adapters
+(and any plain-object helpers they share with `Node.renderHTML`, like
+`placeholderAttrs`) in a separate, tiptap-free module — `./adapters.ts` —
+and have `./editor.tsx` **re-export** the two named symbols:
+
+```ts
+// packages/plugin-youtube/src/adapters.ts — no 'use client', no @tiptap/* import
+export const tiptapNodeToMarkdown: TiptapNodeMarkdownAdapters = { /* ... */ }
+export const tiptapNodeToHtml: TiptapNodeHtmlAdapters = { /* ... */ }
+```
+
+```ts
+// packages/plugin-youtube/src/editor.tsx
+export { tiptapNodeToMarkdown, tiptapNodeToHtml } from './adapters.js'
+```
+
+The re-export keeps `update-ampless`'s codegen contract intact (it still
+reads `ns.tiptapNodeToMarkdown ?? {}` / `ns.tiptapNodeToHtml ?? {}` from a
+namespace import of `./editor` — see Wiring below) while also letting your
+server entry (`./index.tsx`) import the same adapter from `./adapters.js`
+and set it on the manifest:
+
+```ts
+// packages/plugin-youtube/src/index.tsx
+import { tiptapNodeToMarkdown } from './adapters.js'
+
+export default function youtubePlugin(opts = {}) {
+  return definePlugin({
+    // ...
+    tiptapNodeToMarkdown,   // AmplessPlugin.tiptapNodeToMarkdown — server-side canonical
+  })
+}
+```
+
+`definePlugin()` warns if a `contentFields` `kind: 'tiptap'` entry's
+`nodeType` has no matching key in `tiptapNodeToMarkdown` — declare both
+together so the warning stays silent.
+
 ### Lossless format-switch adapters (`tiptapNodeToMarkdown` + `tiptapNodeToHtml`)
 
 When the operator switches the post format in the admin UI (e.g. `tiptap →
@@ -1196,7 +1239,7 @@ Return **`null`** to fall through to the default switch (useful for nodes
 you don't handle or for degenerate inputs like a missing video id).
 
 ```ts
-// packages/plugin-youtube/src/editor.tsx
+// packages/plugin-youtube/src/adapters.ts
 import type { TiptapNodeMarkdownAdapters, TiptapNodeHtmlAdapters } from 'ampless'
 
 export const tiptapNodeToMarkdown: TiptapNodeMarkdownAdapters = {
@@ -1232,7 +1275,10 @@ export const tiptapNodeToHtml: TiptapNodeHtmlAdapters = {
 named exports from each plugin's `./editor` module (via namespace import `*
 as`) and wires them into both installs automatically — **no hand-wiring
 required**. If your plugin does not export one of the maps, the `?? {}`
-fallback in the generated file is a no-op.
+fallback in the generated file is a no-op. As noted above, the exports
+`./editor` re-exports normally live in `./adapters.ts` — the codegen only
+cares that they're reachable from the `./editor` namespace, not where
+they're defined.
 
 #### `markdown → html` 2-hop
 

package/dist/templates/_shared/package.json

@@ -26,21 +26,21 @@
     "@tiptap/pm": "^3.23.6",
     "@tiptap/react": "^3.23.6",
     "@tiptap/starter-kit": "^3.23.6",
-    "@ampless/plugin-analytics-ga4": "^0.2.0-beta.38",
-    "@ampless/plugin-cookie-consent": "^0.1.0-beta.29",
-    "@ampless/plugin-gtm": "^0.2.0-beta.37",
-    "@ampless/plugin-og-image": "^0.2.0-beta.54",
-    "@ampless/plugin-plausible": "^0.2.0-beta.37",
-    "@ampless/plugin-reading-time": "^0.1.0-beta.27",
-    "@ampless/plugin-rss": "^0.2.0-beta.54",
-    "@ampless/plugin-schema-jsonld": "^0.1.1-beta.33",
-    "@ampless/plugin-seo": "^0.2.0-beta.54",
-    "@ampless/plugin-webhook": "^0.2.0-beta.55",
-    "@ampless/admin": "^1.0.0-beta.101",
-    "@ampless/backend": "^1.0.0-beta.84",
-    "@ampless/runtime": "^1.0.0-beta.66",
+    "@ampless/plugin-analytics-ga4": "^0.2.0-beta.39",
+    "@ampless/plugin-cookie-consent": "^0.1.0-beta.30",
+    "@ampless/plugin-gtm": "^0.2.0-beta.38",
+    "@ampless/plugin-og-image": "^0.2.0-beta.55",
+    "@ampless/plugin-plausible": "^0.2.0-beta.38",
+    "@ampless/plugin-reading-time": "^0.1.0-beta.28",
+    "@ampless/plugin-rss": "^0.2.0-beta.55",
+    "@ampless/plugin-schema-jsonld": "^0.1.1-beta.34",
+    "@ampless/plugin-seo": "^0.2.0-beta.55",
+    "@ampless/plugin-webhook": "^0.2.0-beta.56",
+    "@ampless/admin": "^1.0.0-beta.102",
+    "@ampless/backend": "^1.0.0-beta.85",
+    "@ampless/runtime": "^1.0.0-beta.67",
     "@digital-go-jp/tailwind-theme-plugin": "^0.3.4",
-    "ampless": "^1.0.0-beta.54",
+    "ampless": "^1.0.0-beta.55",
     "aws-amplify": "^6.17.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ampless",
-  "version": "1.0.0-beta.170",
+  "version": "1.0.0-beta.172",
   "description": "Create a new ampless project",
   "license": "MIT",
   "type": "module",