@ablogcms/plugins 3.2.28-beta.0

package/README.md

@@ -0,0 +1,38 @@
+# @ablogcms/plugins
+
+管理画面 JS 拡張基盤のプラグイン登録レジストリ（`ACMS.plugins`）を提供するパッケージ。
+イベント購読・機能登録（unitEditor/dataview）・UI 差し込み（Slot/Fill）・設定参照を
+1 つの `setup(ctx)` に束ねる。
+
+拡張ポイントの一覧（イベント・Slot・レジストリの対応表）は [HOOKS.md](./HOOKS.md) を参照。
+
+## 使い方
+
+```ts
+import { register } from '@ablogcms/plugins';
+
+register('acms-plugin-sample', {
+  version: '1.0.0',
+  setup(ctx) {
+    // ゲート: アップロード前の確認
+    ctx.events.on('media.upload.before', async (event) => {
+      const ok = await ACMS.Library.dialog.confirm('確認…');
+      return ok ? event : false;
+    });
+
+    // 通知: アップロード完了後の処理
+    ctx.events.on('media.upload.success', (event) => notifyExternal(event.items));
+
+    // レジストリ: カスタムユニットタイプ
+    ctx.unitEditor.registerUnitDefinition('myUnit', myUnitDef);
+
+    // UI: ユニットツールバーへのボタン追加
+    ctx.ui.fill('unit-editor.unit-toolbar', MyToolbarButton);
+  },
+});
+```
+
+- `register(name, definition)`: プラグインを登録する。同名の重複登録は throw する。
+- `unregister(name)`: `setup(ctx)` 内で行ったイベント購読・レジストリ登録・Fill をすべて自動解除する。
+- `get(name)` / `getAll()`: 登録済みプラグインを取得する（デバッグ用）。
+- `setup()` が同期的に throw した場合、途中まで行われた登録は自動でロールバックされる。

package/dist/acms.d.ts

@@ -0,0 +1,11 @@
+import type { AcmsPlugins } from './core/types.js';
+declare module '@ablogcms/types/acms' {
+    interface Acms {
+        /**
+         * プラグイン登録レジストリ。`admin.js` の初期化時に `@ablogcms/plugins/core` の
+         * `createPluginRegistry()` で生成されるシングルトン。`@ablogcms/plugins`（ルートエントリ）の
+         * グローバル委譲ファサードは、これに処理を委譲する。
+         */
+        plugins: AcmsPlugins;
+    }
+}

package/dist/acms.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=acms.mjs.map

package/dist/acms.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-OWV4U7DT.mjs

@@ -0,0 +1,13 @@
+// src/core/with-fill-props.ts
+function withFillProps(Component) {
+  return { kind: "acms-plugins/fill-component", Component };
+}
+function isFillComponentEntry(entry) {
+  return typeof entry === "object" && entry !== null && entry.kind === "acms-plugins/fill-component";
+}
+
+export {
+  withFillProps,
+  isFillComponentEntry
+};
+//# sourceMappingURL=chunk-OWV4U7DT.mjs.map

package/dist/chunk-OWV4U7DT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/with-fill-props.ts"],"sourcesContent":["import type { FunctionComponent } from 'react';\n\n/**\n * `withFillProps` が返すマーカー付きエントリ。`ctx.ui.fill` の判別（`resolve-fill-entry.ts`）が\n * オブジェクトかどうかで即座に見分けられるよう、`kind` に固定のブランド文字列を持たせる。\n *\n * `Component` を `ComponentType<T>`（関数・クラス両対応）ではなく `FunctionComponent<T>` に\n * 限定している Why not: `createElement(Component, fillProps)` を T についてジェネリックなまま\n * 呼ぶと、`ComponentType<T>` が関数・クラスの合併型であるために `createElement` のオーバーロード\n * 解決が失敗する（クラス側 `getDerivedStateFromProps` の反変位置で `T` の消去に起因する型エラー、\n * 実測で確認）。本リポジトリはクラスコンポーネントの新規追加を禁止する規約\n * （development-guidelines.md）のため、関数コンポーネントのみに絞ることで実用上の制約にならない。\n */\nexport interface FillComponentEntry<T> {\n  readonly kind: 'acms-plugins/fill-component';\n  readonly Component: FunctionComponent<T>;\n}\n\n/**\n * `Slot` の `fillProps`（例: `unit-editor.unit-toolbar` の `{ editor, unit }`）を受け取る React\n * コンポーネントを `ctx.ui.fill` に登録するためのラッパー。\n *\n * Why not（関数のままでは表現できない理由）: `resolveFillEntry` は仮引数の個数\n * （0 個 = props なしコンポーネント、1 個以上 = `DomFill`）で判別しており、この規約は\n * `ctx.ui.fill` の当初からの後方互換として維持する。props を要求するコンポーネント\n * （`({ editor, unit }) => ...`）は仮引数が 1 個になり、`DomFill`（`(el) => ...`）と実行時に\n * 構造的に区別できない（`Function.prototype.length` だけでは両者が衝突する）。\n * `withFillProps` は関数ではなくオブジェクトでラップすることで、既存の arity 判別ロジックに\n * 一切手を入れずにこの衝突を回避する。\n *\n * ```tsx\n * ctx.ui.fill('unit-editor.unit-toolbar', withFillProps<UnitToolbarSlotFillProps>(({ editor, unit }) => (\n *   <button type=\"button\">{unit.type}</button>\n * )));\n * ```\n */\nexport function withFillProps<T>(Component: FunctionComponent<T>): FillComponentEntry<T> {\n  return { kind: 'acms-plugins/fill-component', Component };\n}\n\n/** `entry` が `withFillProps` で作られたマーカー付きエントリかどうかを判定する */\nexport function isFillComponentEntry<T>(entry: unknown): entry is FillComponentEntry<T> {\n  return (\n    typeof entry === 'object' && entry !== null && (entry as { kind?: unknown }).kind === 'acms-plugins/fill-component'\n  );\n}\n"],"mappings":";AAoCO,SAAS,cAAiB,WAAwD;AACvF,SAAO,EAAE,MAAM,+BAA+B,UAAU;AAC1D;AAGO,SAAS,qBAAwB,OAAgD;AACtF,SACE,OAAO,UAAU,YAAY,UAAU,QAAS,MAA6B,SAAS;AAE1F;","names":[]}

package/dist/core/create-plugin-registry.d.ts

@@ -0,0 +1,37 @@
+import type { AcmsEvents } from '@ablogcms/events';
+import { type SlotFillStore } from '@ablogcms/components/slot-fill';
+import type { Action, BulkAction, ColumnTypeDef, Menu, RowData } from '@ablogcms/components/dataview/types';
+import type { UnitDefInterface } from '@ablogcms/unit-editor/core/types/unit';
+import { type ViewedRegistry } from './create-viewed-registry.js';
+import type { BlockDefinitionFactory, BlockExtensionFactory } from './global-singletons.js';
+import type { AcmsPlugins, Registry } from './types.js';
+export interface CreatePluginRegistryOptions {
+    /** 委譲先のイベントバス。省略時は自己完結したインスタンスを新規作成する（テスト用の既定値） */
+    eventsBus?: AcmsEvents;
+    /** `ctx.ui.fill` の書き込み先。省略時は自己完結したインスタンスを新規作成する（テスト用の既定値） */
+    fillStore?: SlotFillStore;
+    /** `ctx.unitEditor.registerUnitDefinition` の登録先。省略時は自己完結したインスタンスを新規作成する */
+    unitDefinitionRegistry?: Registry<UnitDefInterface>;
+    /** `ctx.dataview.registerColumnType` の登録先。省略時は自己完結したインスタンスを新規作成する */
+    columnTypeRegistry?: Registry<ColumnTypeDef>;
+    /** `ctx.blockEditor.registerBlockDefinition` の登録先。省略時は自己完結したインスタンスを新規作成する */
+    blockDefinitionRegistry?: Registry<BlockDefinitionFactory>;
+    /** `ctx.blockEditor.registerExtension` の登録先。省略時は自己完結したインスタンスを新規作成する */
+    blockExtensionRegistry?: Registry<BlockExtensionFactory>;
+    /** `ctx.dataview.registerAction` の登録先。省略時は自己完結したインスタンスを新規作成する */
+    dataviewActionRegistry?: ViewedRegistry<Action<RowData>>;
+    /** `ctx.dataview.registerBulkAction` の登録先。省略時は自己完結したインスタンスを新規作成する */
+    dataviewBulkActionRegistry?: ViewedRegistry<BulkAction<RowData>>;
+    /** `ctx.dataview.registerMenu` の登録先。省略時は自己完結したインスタンスを新規作成する */
+    dataviewMenuRegistry?: ViewedRegistry<Menu<RowData>>;
+}
+/**
+ * `ACMS.plugins` の純粋実装（グローバル非依存）。VS Code の `activate(context)` +
+ * `context.subscriptions` を範に、`setup(ctx)` 内でのイベント購読・レジストリ登録・UI 差し込みを
+ * すべて内部の subscriptions 配列に集約し、`unregister(name)` で一括自動回収する。
+ *
+ * 依存（イベントバス・Fill ブリッジ・各レジストリ）はすべて注入可能で、省略時は自己完結した
+ * インスタンスを新規作成する（`@ablogcms/events` の `createEventBus()` と同じ設計。グローバル
+ * シングルトンへの結線は本番の bootstrap（admin.js）が `global-singletons.ts` 経由で明示的に行う）。
+ */
+export declare function createPluginRegistry(options?: CreatePluginRegistryOptions): AcmsPlugins;

package/dist/core/create-registry.d.ts

@@ -0,0 +1,10 @@
+import type { Registry } from './types.js';
+/**
+ * 名前衝突を検知する汎用レジストリの純粋実装。`ctx.unitEditor.registerUnitDefinition` /
+ * `ctx.dataview.registerColumnType` の土台（Directus の `defineInterface` 等と同型）。
+ *
+ * `add()` が返す `Unsubscribe` は、登録時点の値を閉じ込めて比較してから削除する。
+ * 「解除 → 同名で再登録」の後に古い `Unsubscribe` が誤って新しい登録を消してしまう事故を防ぐ
+ * （`name` は一意だが、`Unsubscribe` のライフサイクルは呼び出し側が保持し続けるため）。
+ */
+export declare function createRegistry<T>(label: string): Registry<T>;

package/dist/core/create-viewed-registry.d.ts

@@ -0,0 +1,17 @@
+import type { Unsubscribe } from './types.js';
+/**
+ * `view`（`'entry' | 'module'` 等、将来拡張可能な文字列）ごとに独立した名前空間を持つレジストリ。
+ * `ctx.dataview.registerAction(view, name, def)` の土台（design.md Q4「view キー方式」）。
+ *
+ * 内部では `view` ごとに素の {@link createRegistry} インスタンスを遅延生成して保持する
+ * （文字列連結キー方式にしない理由: view 名に区切り文字が含まれた場合の衝突を避けるため）。
+ */
+export interface ViewedRegistry<T> {
+    /** `view` 内で `name` が既に登録済みの場合は throw する */
+    add(view: string, name: string, item: T): Unsubscribe;
+    remove(view: string, name: string): boolean;
+    get(view: string, name: string): T | undefined;
+    /** 指定した `view` に登録された項目のみを返す。未登録の `view` は空オブジェクト */
+    getAll(view: string): Record<string, T>;
+}
+export declare function createViewedRegistry<T>(label: string): ViewedRegistry<T>;

package/dist/core/global-singletons.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ページ全体で 1 つだけ存在するべきシングルトン群。
+ *
+ * 管理画面は dispatcher ごとに独立した React ルートを `createRoot` する構成
+ * （`@ablogcms/utils/react` の `render()`）のため、単一の `<SlotFillProvider>` でページ全体を
+ * 包むことができない。`ctx.ui.fill` が書き込む Fill ブリッジをここでシングルトン化しておき、
+ * 各ツリーの `<SlotFillProvider store={getGlobalFillBridge()}>` がこれを購読することで、
+ * どの独立ツリーの `<Slot>` にも同じ登録内容が届く（design.md「グローバル Fill ブリッジ」節）。
+ *
+ * `unitDefs` / `columnTypes` prop の値計算（react-19-migration フェーズ3-1a/3-1b）も同じ理由で
+ * dispatch 側の複数箇所から同一レジストリを参照する必要があるため、ここでシングルトン化する
+ * （実際の prop 配線はフェーズD）。
+ *
+ * `createPluginRegistry()` 自体は各テストが独立したインスタンスで動かせるよう、これらに依存しない
+ * 素の工場関数のまま保つ（`@ablogcms/events` の `createEventBus()` と同じ設計）。
+ * 本番の結線（admin.js）でのみ、ここのシングルトンを明示的に注入する。
+ */
+import { type SlotFillStore } from '@ablogcms/components/slot-fill';
+import type { Action, BulkAction, ColumnTypeDef, Menu, RowData } from '@ablogcms/components/dataview/types';
+import type { UnitDefInterface } from '@ablogcms/unit-editor/core/types/unit';
+import type { BlockDefinition } from '@ablogcms/block-editor/types';
+import type { AnyExtension } from '@ablogcms/block-editor/tiptap/core';
+import type { Tiptap } from '@ablogcms/block-editor/tiptap';
+import { type ViewedRegistry } from './create-viewed-registry.js';
+import type { Registry } from './types.js';
+/** `ctx.blockEditor.registerBlockDefinition` / `registerExtension` が登録するファクトリの型。 */
+export type BlockDefinitionFactory = (runtime: Tiptap) => BlockDefinition;
+export type BlockExtensionFactory = (runtime: Tiptap) => AnyExtension | AnyExtension[];
+export declare function getGlobalFillBridge(): SlotFillStore;
+export declare function getUnitDefinitionRegistry(): Registry<UnitDefInterface>;
+export declare function getColumnTypeRegistry(): Registry<ColumnTypeDef>;
+export declare function getBlockDefinitionRegistry(): Registry<BlockDefinitionFactory>;
+export declare function getBlockExtensionRegistry(): Registry<BlockExtensionFactory>;
+export declare function getDataviewActionRegistry(): ViewedRegistry<Action<RowData>>;
+export declare function getDataviewBulkActionRegistry(): ViewedRegistry<BulkAction<RowData>>;
+export declare function getDataviewMenuRegistry(): ViewedRegistry<Menu<RowData>>;

package/dist/core/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@ablogcms/plugins` の純粋実装（グローバル非依存）を提供するサブパス。
+ * コアの bootstrap（`admin.js`）と、プラグイン側のユニットテストから利用する。
+ */
+export { createPluginRegistry } from './create-plugin-registry.js';
+export type { CreatePluginRegistryOptions } from './create-plugin-registry.js';
+export { createRegistry } from './create-registry.js';
+export { createViewedRegistry } from './create-viewed-registry.js';
+export type { ViewedRegistry } from './create-viewed-registry.js';
+export { mergeRegistryEntries } from './merge-registry-entries.js';
+export { getBlockDefinitionRegistry, getBlockExtensionRegistry, getColumnTypeRegistry, getDataviewActionRegistry, getDataviewBulkActionRegistry, getDataviewMenuRegistry, getGlobalFillBridge, getUnitDefinitionRegistry, } from './global-singletons.js';
+export type { BlockDefinitionFactory, BlockExtensionFactory } from './global-singletons.js';
+export { resolveFillEntry } from './resolve-fill-entry.js';
+export { withFillProps, isFillComponentEntry } from './with-fill-props.js';
+export * from './types.js';

package/dist/core/index.mjs

@@ -0,0 +1,289 @@
+import {
+  isFillComponentEntry,
+  withFillProps
+} from "../chunk-OWV4U7DT.mjs";
+
+// src/core/create-plugin-registry.ts
+import { createEventBus } from "@ablogcms/events/core";
+import { createSlotFillStore } from "@ablogcms/components/slot-fill";
+
+// src/core/create-registry.ts
+function createRegistry(label) {
+  const items = /* @__PURE__ */ new Map();
+  const add = (name, item) => {
+    if (items.has(name)) {
+      throw new Error(`[@ablogcms/plugins] ${label} "${name}" \u306F\u65E2\u306B\u767B\u9332\u3055\u308C\u3066\u3044\u307E\u3059\u3002`);
+    }
+    items.set(name, item);
+    return () => {
+      if (items.get(name) === item) {
+        items.delete(name);
+      }
+    };
+  };
+  const remove = (name) => items.delete(name);
+  const get = (name) => items.get(name);
+  const getAll = () => Object.fromEntries(items);
+  return { add, remove, get, getAll };
+}
+
+// src/core/create-viewed-registry.ts
+function createViewedRegistry(label) {
+  const registries = /* @__PURE__ */ new Map();
+  const registryFor = (view) => {
+    let registry = registries.get(view);
+    if (!registry) {
+      registry = createRegistry(`${label}(${view})`);
+      registries.set(view, registry);
+    }
+    return registry;
+  };
+  return {
+    add: (view, name, item) => registryFor(view).add(name, item),
+    remove: (view, name) => registryFor(view).remove(name),
+    get: (view, name) => registryFor(view).get(name),
+    getAll: (view) => registries.get(view)?.getAll() ?? {}
+  };
+}
+
+// src/core/resolve-fill-entry.ts
+import { createElement } from "react";
+import { DomFillMount } from "@ablogcms/components/slot-fill";
+function resolveFillEntry(entry) {
+  if (isFillComponentEntry(entry)) {
+    const Component = entry.Component;
+    return (fillProps) => createElement(Component, fillProps);
+  }
+  if (typeof entry === "function" && entry.length > 0) {
+    return createElement(DomFillMount, { mount: entry });
+  }
+  return createElement(entry);
+}
+
+// src/core/create-plugin-registry.ts
+var logHandlerError = (pluginName, eventLabel, err) => {
+  console.error(`[@ablogcms/plugins] \u30D7\u30E9\u30B0\u30A4\u30F3 "${pluginName}" \u306E\u30CF\u30F3\u30C9\u30E9("${eventLabel}")\u304C\u4F8B\u5916\u3092\u6295\u3052\u307E\u3057\u305F\u3002`, err);
+};
+var toEventLabel = (type) => Array.isArray(type) ? type.join(",") : type;
+var readConfig = (pluginName) => {
+  if (typeof window === "undefined") {
+    return {};
+  }
+  const camelName = pluginName.replace(/[-_](\w)/g, (_match, chr) => chr.toUpperCase());
+  const config = window.ACMS?.Config;
+  const value = config?.[camelName];
+  return typeof value === "object" && value !== null ? value : {};
+};
+function createPluginRegistry(options = {}) {
+  const eventsBus = options.eventsBus ?? createEventBus();
+  const fillStore = options.fillStore ?? createSlotFillStore();
+  const unitDefinitionRegistry2 = options.unitDefinitionRegistry ?? createRegistry("unit-definition");
+  const columnTypeRegistry2 = options.columnTypeRegistry ?? createRegistry("column-type");
+  const blockDefinitionRegistry2 = options.blockDefinitionRegistry ?? createRegistry("block-definition");
+  const blockExtensionRegistry2 = options.blockExtensionRegistry ?? createRegistry("extension");
+  const dataviewActionRegistry2 = options.dataviewActionRegistry ?? createViewedRegistry("dataview-action");
+  const dataviewBulkActionRegistry2 = options.dataviewBulkActionRegistry ?? createViewedRegistry("dataview-bulk-action");
+  const dataviewMenuRegistry2 = options.dataviewMenuRegistry ?? createViewedRegistry("dataview-menu");
+  const plugins = /* @__PURE__ */ new Map();
+  let fillIdCounter = 0;
+  const createContext = (plugin) => {
+    const onEvent = (type, handler) => {
+      const label = toEventLabel(type);
+      const wrapped = async (event) => {
+        try {
+          return await handler(event);
+        } catch (err) {
+          logHandlerError(plugin.name, label, err);
+          throw err;
+        }
+      };
+      const unsubscribe = eventsBus.on(type, wrapped);
+      plugin.subscriptions.push(unsubscribe);
+      plugin.registrations.push({ kind: "event", key: label });
+      return unsubscribe;
+    };
+    return {
+      name: plugin.name,
+      config: readConfig(plugin.name),
+      events: {
+        on: onEvent
+      },
+      unitEditor: {
+        registerUnitDefinition: (name, def) => {
+          const unsubscribe = unitDefinitionRegistry2.add(name, def);
+          plugin.subscriptions.push(unsubscribe);
+          plugin.registrations.push({ kind: "unit-definition", key: name });
+          return unsubscribe;
+        }
+      },
+      blockEditor: {
+        registerBlockDefinition: (name, factory) => {
+          const unsubscribe = blockDefinitionRegistry2.add(name, factory);
+          plugin.subscriptions.push(unsubscribe);
+          plugin.registrations.push({ kind: "block-definition", key: name });
+          return unsubscribe;
+        },
+        registerExtension: (name, factory) => {
+          const unsubscribe = blockExtensionRegistry2.add(name, factory);
+          plugin.subscriptions.push(unsubscribe);
+          plugin.registrations.push({ kind: "extension", key: name });
+          return unsubscribe;
+        }
+      },
+      dataview: {
+        registerColumnType: (name, type) => {
+          const unsubscribe = columnTypeRegistry2.add(name, type);
+          plugin.subscriptions.push(unsubscribe);
+          plugin.registrations.push({ kind: "column-type", key: name });
+          return unsubscribe;
+        },
+        registerAction: (view, name, def) => {
+          const unsubscribe = dataviewActionRegistry2.add(view, name, def);
+          plugin.subscriptions.push(unsubscribe);
+          plugin.registrations.push({ kind: "dataview-action", key: `${view}:${name}` });
+          return unsubscribe;
+        },
+        registerBulkAction: (view, name, def) => {
+          const unsubscribe = dataviewBulkActionRegistry2.add(view, name, def);
+          plugin.subscriptions.push(unsubscribe);
+          plugin.registrations.push({ kind: "dataview-bulk-action", key: `${view}:${name}` });
+          return unsubscribe;
+        },
+        registerMenu: (view, name, def) => {
+          const unsubscribe = dataviewMenuRegistry2.add(view, name, def);
+          plugin.subscriptions.push(unsubscribe);
+          plugin.registrations.push({ kind: "dataview-menu", key: `${view}:${name}` });
+          return unsubscribe;
+        }
+      },
+      ui: {
+        fill: (slotName, entry) => {
+          fillIdCounter += 1;
+          const id = `plugin:${plugin.name}:${slotName}:${fillIdCounter}`;
+          const render = resolveFillEntry(entry);
+          fillStore.upsertFill(slotName, id, render);
+          const unsubscribe = () => fillStore.removeFill(slotName, id);
+          plugin.subscriptions.push(unsubscribe);
+          plugin.registrations.push({ kind: "fill", key: slotName });
+          return unsubscribe;
+        }
+      }
+    };
+  };
+  const register = (name, definition) => {
+    if (plugins.has(name)) {
+      throw new Error(`[@ablogcms/plugins] \u30D7\u30E9\u30B0\u30A4\u30F3\u540D "${name}" \u306F\u65E2\u306B\u767B\u9332\u3055\u308C\u3066\u3044\u307E\u3059\u3002`);
+    }
+    const plugin = { name, version: definition.version, registrations: [], subscriptions: [] };
+    plugins.set(name, plugin);
+    try {
+      definition.setup(createContext(plugin));
+    } catch (err) {
+      plugin.subscriptions.forEach((unsubscribe) => unsubscribe());
+      plugins.delete(name);
+      throw err;
+    }
+  };
+  const unregister = (name) => {
+    const plugin = plugins.get(name);
+    if (!plugin) {
+      return false;
+    }
+    plugin.subscriptions.forEach((unsubscribe) => unsubscribe());
+    plugins.delete(name);
+    return true;
+  };
+  const toRegisteredPlugin = (plugin) => ({
+    name: plugin.name,
+    version: plugin.version,
+    registrations: plugin.registrations
+  });
+  const get = (name) => {
+    const plugin = plugins.get(name);
+    return plugin ? toRegisteredPlugin(plugin) : void 0;
+  };
+  const getAll = () => Array.from(plugins.values()).map(toRegisteredPlugin);
+  return { register, unregister, get, getAll, withFillProps };
+}
+
+// src/core/merge-registry-entries.ts
+function mergeRegistryEntries(core, registry) {
+  return { ...core, ...registry.getAll() };
+}
+
+// src/core/global-singletons.ts
+import { createSlotFillStore as createSlotFillStore2 } from "@ablogcms/components/slot-fill";
+var fillBridge;
+function getGlobalFillBridge() {
+  if (!fillBridge) {
+    fillBridge = createSlotFillStore2();
+  }
+  return fillBridge;
+}
+var unitDefinitionRegistry;
+function getUnitDefinitionRegistry() {
+  if (!unitDefinitionRegistry) {
+    unitDefinitionRegistry = createRegistry("unit-definition");
+  }
+  return unitDefinitionRegistry;
+}
+var columnTypeRegistry;
+function getColumnTypeRegistry() {
+  if (!columnTypeRegistry) {
+    columnTypeRegistry = createRegistry("column-type");
+  }
+  return columnTypeRegistry;
+}
+var blockDefinitionRegistry;
+function getBlockDefinitionRegistry() {
+  if (!blockDefinitionRegistry) {
+    blockDefinitionRegistry = createRegistry("block-definition");
+  }
+  return blockDefinitionRegistry;
+}
+var blockExtensionRegistry;
+function getBlockExtensionRegistry() {
+  if (!blockExtensionRegistry) {
+    blockExtensionRegistry = createRegistry("extension");
+  }
+  return blockExtensionRegistry;
+}
+var dataviewActionRegistry;
+function getDataviewActionRegistry() {
+  if (!dataviewActionRegistry) {
+    dataviewActionRegistry = createViewedRegistry("dataview-action");
+  }
+  return dataviewActionRegistry;
+}
+var dataviewBulkActionRegistry;
+function getDataviewBulkActionRegistry() {
+  if (!dataviewBulkActionRegistry) {
+    dataviewBulkActionRegistry = createViewedRegistry("dataview-bulk-action");
+  }
+  return dataviewBulkActionRegistry;
+}
+var dataviewMenuRegistry;
+function getDataviewMenuRegistry() {
+  if (!dataviewMenuRegistry) {
+    dataviewMenuRegistry = createViewedRegistry("dataview-menu");
+  }
+  return dataviewMenuRegistry;
+}
+export {
+  createPluginRegistry,
+  createRegistry,
+  createViewedRegistry,
+  getBlockDefinitionRegistry,
+  getBlockExtensionRegistry,
+  getColumnTypeRegistry,
+  getDataviewActionRegistry,
+  getDataviewBulkActionRegistry,
+  getDataviewMenuRegistry,
+  getGlobalFillBridge,
+  getUnitDefinitionRegistry,
+  isFillComponentEntry,
+  mergeRegistryEntries,
+  resolveFillEntry,
+  withFillProps
+};
+//# sourceMappingURL=index.mjs.map

package/dist/core/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/create-plugin-registry.ts","../../src/core/create-registry.ts","../../src/core/create-viewed-registry.ts","../../src/core/resolve-fill-entry.ts","../../src/core/merge-registry-entries.ts","../../src/core/global-singletons.ts"],"sourcesContent":["import type { AcmsEventType, AcmsEvents, AcmsLooseEvent, Unsubscribe } from '@ablogcms/events';\nimport { createEventBus } from '@ablogcms/events/core';\nimport { createSlotFillStore, type SlotFillStore, type FillRenderer } from '@ablogcms/components/slot-fill';\nimport type { Action, BulkAction, ColumnTypeDef, Menu, RowData } from '@ablogcms/components/dataview/types';\nimport type { UnitDefInterface } from '@ablogcms/unit-editor/core/types/unit';\nimport { createRegistry } from './create-registry';\nimport { createViewedRegistry, type ViewedRegistry } from './create-viewed-registry';\nimport { resolveFillEntry } from './resolve-fill-entry';\nimport { withFillProps } from './with-fill-props';\nimport type { BlockDefinitionFactory, BlockExtensionFactory } from './global-singletons';\nimport type {\n  AcmsPlugins,\n  FillEntry,\n  PluginContext,\n  PluginDefinition,\n  RegisteredEntry,\n  RegisteredPlugin,\n  Registry,\n} from './types';\n\nexport interface CreatePluginRegistryOptions {\n  /** 委譲先のイベントバス。省略時は自己完結したインスタンスを新規作成する（テスト用の既定値） */\n  eventsBus?: AcmsEvents;\n  /** `ctx.ui.fill` の書き込み先。省略時は自己完結したインスタンスを新規作成する（テスト用の既定値） */\n  fillStore?: SlotFillStore;\n  /** `ctx.unitEditor.registerUnitDefinition` の登録先。省略時は自己完結したインスタンスを新規作成する */\n  unitDefinitionRegistry?: Registry<UnitDefInterface>;\n  /** `ctx.dataview.registerColumnType` の登録先。省略時は自己完結したインスタンスを新規作成する */\n  columnTypeRegistry?: Registry<ColumnTypeDef>;\n  /** `ctx.blockEditor.registerBlockDefinition` の登録先。省略時は自己完結したインスタンスを新規作成する */\n  blockDefinitionRegistry?: Registry<BlockDefinitionFactory>;\n  /** `ctx.blockEditor.registerExtension` の登録先。省略時は自己完結したインスタンスを新規作成する */\n  blockExtensionRegistry?: Registry<BlockExtensionFactory>;\n  /** `ctx.dataview.registerAction` の登録先。省略時は自己完結したインスタンスを新規作成する */\n  dataviewActionRegistry?: ViewedRegistry<Action<RowData>>;\n  /** `ctx.dataview.registerBulkAction` の登録先。省略時は自己完結したインスタンスを新規作成する */\n  dataviewBulkActionRegistry?: ViewedRegistry<BulkAction<RowData>>;\n  /** `ctx.dataview.registerMenu` の登録先。省略時は自己完結したインスタンスを新規作成する */\n  dataviewMenuRegistry?: ViewedRegistry<Menu<RowData>>;\n}\n\ninterface InternalPlugin {\n  name: string;\n  version?: string;\n  registrations: RegisteredEntry[];\n  subscriptions: Unsubscribe[];\n}\n\n// AcmsEvents#on は型引数 K ごとにハンドラの戻り値を絞り込むため、type がユニオン\n// （AcmsEventType | AcmsEventType[]）のまま渡すとハンドラの戻り値を厳密に検証できない。\n// create-event-bus.ts と同じく、内部では緩い型で扱い、公開 API の境界（PluginContext）でのみ\n// 厳密な型へキャストする。\ntype LooseOn = (type: AcmsEventType | AcmsEventType[], handler: (event: AcmsLooseEvent) => unknown) => Unsubscribe;\n\n// プラグイン起因の例外をどのプラグインが投げたか特定できるよう帰属を明示する。\n// イベントバス自身も汎用メッセージで同じ例外をログするため、この行は「どのプラグインか」を示す追加の帰属ログになる。\nconst logHandlerError = (pluginName: string, eventLabel: string, err: unknown): void => {\n  console.error(`[@ablogcms/plugins] プラグイン \"${pluginName}\" のハンドラ(\"${eventLabel}\")が例外を投げました。`, err);\n};\n\nconst toEventLabel = (type: AcmsEventType | AcmsEventType[]): string => (Array.isArray(type) ? type.join(',') : type);\n\n/**\n * `window.ACMS.Config` からプラグインの設定値を読む。プラグイン名は `-`/`_` 区切りのことが多いため、\n * `jsModule()` 側の慣例（キャメルケースキー）に合わせて変換する。未初期化・未設定時は空オブジェクトを返し、\n * `setup(ctx)` 内で `ctx.config` を参照しただけで例外にならないようにする。\n */\nconst readConfig = (pluginName: string): Record<string, unknown> => {\n  if (typeof window === 'undefined') {\n    return {};\n  }\n  const camelName = pluginName.replace(/[-_](\\w)/g, (_match, chr: string) => chr.toUpperCase());\n  const config = (window as unknown as { ACMS?: { Config?: Record<string, unknown> } }).ACMS?.Config;\n  const value = config?.[camelName];\n  return typeof value === 'object' && value !== null ? (value as Record<string, unknown>) : {};\n};\n\n/**\n * `ACMS.plugins` の純粋実装（グローバル非依存）。VS Code の `activate(context)` +\n * `context.subscriptions` を範に、`setup(ctx)` 内でのイベント購読・レジストリ登録・UI 差し込みを\n * すべて内部の subscriptions 配列に集約し、`unregister(name)` で一括自動回収する。\n *\n * 依存（イベントバス・Fill ブリッジ・各レジストリ）はすべて注入可能で、省略時は自己完結した\n * インスタンスを新規作成する（`@ablogcms/events` の `createEventBus()` と同じ設計。グローバル\n * シングルトンへの結線は本番の bootstrap（admin.js）が `global-singletons.ts` 経由で明示的に行う）。\n */\nexport function createPluginRegistry(options: CreatePluginRegistryOptions = {}): AcmsPlugins {\n  const eventsBus = options.eventsBus ?? createEventBus();\n  const fillStore = options.fillStore ?? createSlotFillStore();\n  const unitDefinitionRegistry = options.unitDefinitionRegistry ?? createRegistry<UnitDefInterface>('unit-definition');\n  const columnTypeRegistry = options.columnTypeRegistry ?? createRegistry<ColumnTypeDef>('column-type');\n  const blockDefinitionRegistry =\n    options.blockDefinitionRegistry ?? createRegistry<BlockDefinitionFactory>('block-definition');\n  const blockExtensionRegistry = options.blockExtensionRegistry ?? createRegistry<BlockExtensionFactory>('extension');\n  const dataviewActionRegistry =\n    options.dataviewActionRegistry ?? createViewedRegistry<Action<RowData>>('dataview-action');\n  const dataviewBulkActionRegistry =\n    options.dataviewBulkActionRegistry ?? createViewedRegistry<BulkAction<RowData>>('dataview-bulk-action');\n  const dataviewMenuRegistry = options.dataviewMenuRegistry ?? createViewedRegistry<Menu<RowData>>('dataview-menu');\n\n  const plugins = new Map<string, InternalPlugin>();\n  let fillIdCounter = 0;\n\n  const createContext = (plugin: InternalPlugin): PluginContext => {\n    const onEvent = (\n      type: AcmsEventType | AcmsEventType[],\n      handler: (event: AcmsLooseEvent) => unknown\n    ): Unsubscribe => {\n      const label = toEventLabel(type);\n      const wrapped = async (event: AcmsLooseEvent) => {\n        try {\n          return await handler(event);\n        } catch (err) {\n          logHandlerError(plugin.name, label, err);\n          throw err;\n        }\n      };\n      const unsubscribe = (eventsBus.on as LooseOn)(type, wrapped);\n      plugin.subscriptions.push(unsubscribe);\n      plugin.registrations.push({ kind: 'event', key: label });\n      return unsubscribe;\n    };\n\n    return {\n      name: plugin.name,\n      config: readConfig(plugin.name),\n      events: {\n        on: onEvent as PluginContext['events']['on'],\n      },\n      unitEditor: {\n        registerUnitDefinition: (name, def) => {\n          const unsubscribe = unitDefinitionRegistry.add(name, def);\n          plugin.subscriptions.push(unsubscribe);\n          plugin.registrations.push({ kind: 'unit-definition', key: name });\n          return unsubscribe;\n        },\n      },\n      blockEditor: {\n        registerBlockDefinition: (name, factory) => {\n          const unsubscribe = blockDefinitionRegistry.add(name, factory);\n          plugin.subscriptions.push(unsubscribe);\n          plugin.registrations.push({ kind: 'block-definition', key: name });\n          return unsubscribe;\n        },\n        registerExtension: (name, factory) => {\n          const unsubscribe = blockExtensionRegistry.add(name, factory);\n          plugin.subscriptions.push(unsubscribe);\n          plugin.registrations.push({ kind: 'extension', key: name });\n          return unsubscribe;\n        },\n      },\n      dataview: {\n        registerColumnType: (name, type) => {\n          const unsubscribe = columnTypeRegistry.add(name, type);\n          plugin.subscriptions.push(unsubscribe);\n          plugin.registrations.push({ kind: 'column-type', key: name });\n          return unsubscribe;\n        },\n        registerAction: (view, name, def) => {\n          const unsubscribe = dataviewActionRegistry.add(view, name, def);\n          plugin.subscriptions.push(unsubscribe);\n          plugin.registrations.push({ kind: 'dataview-action', key: `${view}:${name}` });\n          return unsubscribe;\n        },\n        registerBulkAction: (view, name, def) => {\n          const unsubscribe = dataviewBulkActionRegistry.add(view, name, def);\n          plugin.subscriptions.push(unsubscribe);\n          plugin.registrations.push({ kind: 'dataview-bulk-action', key: `${view}:${name}` });\n          return unsubscribe;\n        },\n        registerMenu: (view, name, def) => {\n          const unsubscribe = dataviewMenuRegistry.add(view, name, def);\n          plugin.subscriptions.push(unsubscribe);\n          plugin.registrations.push({ kind: 'dataview-menu', key: `${view}:${name}` });\n          return unsubscribe;\n        },\n      },\n      ui: {\n        fill: <T>(slotName: string, entry: FillEntry<T>) => {\n          fillIdCounter += 1;\n          const id = `plugin:${plugin.name}:${slotName}:${fillIdCounter}`;\n          // fillStore（Slot 名ごとに異なる T を型消去した FillRenderer = FillRenderer<unknown> で\n          // 保持する）へ渡す境界。Fill コンポーネント（@ablogcms/components/slot-fill）の\n          // eraseFillRendererType と同じ理由・同じ境界でここでも明示キャストする。\n          const render = resolveFillEntry<T>(entry) as FillRenderer;\n          fillStore.upsertFill(slotName, id, render);\n          const unsubscribe = () => fillStore.removeFill(slotName, id);\n          plugin.subscriptions.push(unsubscribe);\n          plugin.registrations.push({ kind: 'fill', key: slotName });\n          return unsubscribe;\n        },\n      },\n    };\n  };\n\n  const register = (name: string, definition: PluginDefinition): void => {\n    if (plugins.has(name)) {\n      throw new Error(`[@ablogcms/plugins] プラグイン名 \"${name}\" は既に登録されています。`);\n    }\n\n    const plugin: InternalPlugin = { name, version: definition.version, registrations: [], subscriptions: [] };\n    // setup() 実行前に登録しておく。setup() の途中で ctx 経由の登録（例: 名前衝突での throw）が\n    // 失敗した場合に catch 節でロールバックできるようにするため。\n    plugins.set(name, plugin);\n\n    try {\n      definition.setup(createContext(plugin));\n    } catch (err) {\n      // 途中まで行われた登録（イベント購読・レジストリ登録・Fill）をすべて解除し、ゾンビ状態の\n      // 半登録プラグインを残さない。呼び出し元は同じ名前で再度 register し直せる。\n      plugin.subscriptions.forEach((unsubscribe) => unsubscribe());\n      plugins.delete(name);\n      throw err;\n    }\n  };\n\n  const unregister = (name: string): boolean => {\n    const plugin = plugins.get(name);\n    if (!plugin) {\n      return false;\n    }\n    plugin.subscriptions.forEach((unsubscribe) => unsubscribe());\n    plugins.delete(name);\n    return true;\n  };\n\n  const toRegisteredPlugin = (plugin: InternalPlugin): RegisteredPlugin => ({\n    name: plugin.name,\n    version: plugin.version,\n    registrations: plugin.registrations,\n  });\n\n  const get = (name: string): RegisteredPlugin | undefined => {\n    const plugin = plugins.get(name);\n    return plugin ? toRegisteredPlugin(plugin) : undefined;\n  };\n\n  const getAll = (): RegisteredPlugin[] => Array.from(plugins.values()).map(toRegisteredPlugin);\n\n  return { register, unregister, get, getAll, withFillProps };\n}\n","import type { Registry, Unsubscribe } from './types';\n\n/**\n * 名前衝突を検知する汎用レジストリの純粋実装。`ctx.unitEditor.registerUnitDefinition` /\n * `ctx.dataview.registerColumnType` の土台（Directus の `defineInterface` 等と同型）。\n *\n * `add()` が返す `Unsubscribe` は、登録時点の値を閉じ込めて比較してから削除する。\n * 「解除 → 同名で再登録」の後に古い `Unsubscribe` が誤って新しい登録を消してしまう事故を防ぐ\n * （`name` は一意だが、`Unsubscribe` のライフサイクルは呼び出し側が保持し続けるため）。\n */\nexport function createRegistry<T>(label: string): Registry<T> {\n  const items = new Map<string, T>();\n\n  const add = (name: string, item: T): Unsubscribe => {\n    if (items.has(name)) {\n      throw new Error(`[@ablogcms/plugins] ${label} \"${name}\" は既に登録されています。`);\n    }\n    items.set(name, item);\n    return () => {\n      if (items.get(name) === item) {\n        items.delete(name);\n      }\n    };\n  };\n\n  const remove = (name: string): boolean => items.delete(name);\n\n  const get = (name: string): T | undefined => items.get(name);\n\n  const getAll = (): Record<string, T> => Object.fromEntries(items);\n\n  return { add, remove, get, getAll };\n}\n","import type { Registry, Unsubscribe } from './types';\nimport { createRegistry } from './create-registry';\n\n/**\n * `view`（`'entry' | 'module'` 等、将来拡張可能な文字列）ごとに独立した名前空間を持つレジストリ。\n * `ctx.dataview.registerAction(view, name, def)` の土台（design.md Q4「view キー方式」）。\n *\n * 内部では `view` ごとに素の {@link createRegistry} インスタンスを遅延生成して保持する\n * （文字列連結キー方式にしない理由: view 名に区切り文字が含まれた場合の衝突を避けるため）。\n */\nexport interface ViewedRegistry<T> {\n  /** `view` 内で `name` が既に登録済みの場合は throw する */\n  add(view: string, name: string, item: T): Unsubscribe;\n  remove(view: string, name: string): boolean;\n  get(view: string, name: string): T | undefined;\n  /** 指定した `view` に登録された項目のみを返す。未登録の `view` は空オブジェクト */\n  getAll(view: string): Record<string, T>;\n}\n\nexport function createViewedRegistry<T>(label: string): ViewedRegistry<T> {\n  const registries = new Map<string, Registry<T>>();\n\n  const registryFor = (view: string): Registry<T> => {\n    let registry = registries.get(view);\n    if (!registry) {\n      registry = createRegistry<T>(`${label}(${view})`);\n      registries.set(view, registry);\n    }\n    return registry;\n  };\n\n  return {\n    add: (view, name, item) => registryFor(view).add(name, item),\n    remove: (view, name) => registryFor(view).remove(name),\n    get: (view, name) => registryFor(view).get(name),\n    getAll: (view) => registries.get(view)?.getAll() ?? {},\n  };\n}\n","import { createElement, type ComponentType, type FunctionComponent, type ReactNode } from 'react';\nimport { DomFillMount } from '@ablogcms/components/slot-fill';\nimport type { FillRenderer } from '@ablogcms/components/slot-fill';\nimport { isFillComponentEntry } from './with-fill-props';\nimport type { DomFill, FillEntry } from './types';\n\n/**\n * `ctx.ui.fill(slotName, entry)` の `entry` を、Fill ストア（`@ablogcms/components/slot-fill`）に\n * そのまま渡せる `FillRenderer`（`ReactNode`、または `Slot` の `fillProps` を受け取る render-prop\n * 関数）に変換する。\n *\n * 判別は 3 種類:\n * 1. `withFillProps(Component)` が返すマーカーオブジェクト（`FillComponentEntry`）→ `fillProps` を\n *    受け取る render-prop 関数を返す（下記参照）。\n * 2. 仮引数 1 個以上の関数 → `DomFill` として `DomFillMount` でラップする。\n * 3. それ以外（仮引数 0 個の関数）→ props なしの React コンポーネントとして描画する。\n *\n * 2/3 の判別は Why not: 実行時には両者とも「関数」という点で構造的に区別できず\n * （`React.ComponentType` も `DomFill` も型注釈はコンパイル時に消える）、関数名（`.name`）も\n * 拠り所にならない（`vi.fn()` 等のラッパーを経由すると `.name` が `\"Mock\"` 等に上書きされ、\n * テストのモックが大文字始まりになって誤判定するのを実測で確認した）。代わりに\n * `Function.prototype.length`（宣言された仮引数の個数）で判別する（`vi.fn()` 等でラップされても\n * 元関数の `.length` は保たれる）。この 0/1 個の判別は既存の後方互換のため変更しない。\n *\n * 1 のケースをこの判別の外に出している Why not: props を要求するコンポーネント\n * （`({ editor, unit }) => ...`）は仮引数が 1 個になり、`DomFill`（`(el) => ...`）と実行時に\n * 区別できない。`withFillProps` はオブジェクトでラップするため、`typeof entry === 'function'` の\n * 分岐に到達する前に見分けがつき、既存の 0/1 個判別と衝突しない。\n */\nexport function resolveFillEntry(entry: ComponentType | DomFill): ReactNode;\nexport function resolveFillEntry<T>(entry: FillEntry<T>): FillRenderer<T>;\nexport function resolveFillEntry<T>(entry: FillEntry<T>): FillRenderer<T> {\n  if (isFillComponentEntry<T>(entry)) {\n    // createElement<P>(FunctionComponent<P>, props) はここで P=T を推論できない（T は\n    // resolveFillEntry 自身のジェネリックで、createElement 側から見ると「{} と無関係かもしれない\n    // 任意の型」にしか見えないため、TS2769 になる。呼び出し境界でのみ型消去する\n    // （fill.tsx の eraseFillRendererType と同じ「型消去の境界であることを明示するキャスト」）。\n    const Component = entry.Component as FunctionComponent<Record<string, unknown>>;\n    // Slot 側（renderFill）は render が関数なら fillProps を渡して呼ぶ実装を既に持つため、\n    // ここでは呼び出しを fillProps が判明する Slot の描画タイミングまで遅延させるだけでよい。\n    // eslint-disable-next-line react/display-name -- コンポーネント定義ではなく FillRenderer を返す関数（createElement 呼び出しを含むアロー関数がヒューリスティックに誤検知される）\n    return (fillProps: T) => createElement(Component, fillProps as Record<string, unknown>);\n  }\n  if (typeof entry === 'function' && entry.length > 0) {\n    return createElement(DomFillMount, { mount: entry as DomFill });\n  }\n  return createElement(entry as ComponentType);\n}\n","import type { Registry } from './types';\n\n/**\n * コア側の組み込み定義（`core`）と、プラグインが `Registry.add`（`ctx.unitEditor.registerUnitDefinition` /\n * `ctx.dataview.registerColumnType` 経由）で登録した内容をマージする。\n *\n * react-19-migration フェーズ3-1a/3-1b で設計した `unitDefs` / `columnTypes` prop の値計算を\n * レジストリ経由に変える配線（design.md「レジストリ（機能登録）」節）の共通実装。\n * キー衝突時はレジストリ（プラグイン）側を優先する（design.md の例\n * `{ ...coreUnitDefs, ...unitDefinitionRegistry.getAll() }` と同じマージ順）。\n */\nexport function mergeRegistryEntries<T>(core: Record<string, T>, registry: Registry<T>): Record<string, T> {\n  return { ...core, ...registry.getAll() };\n}\n","/**\n * ページ全体で 1 つだけ存在するべきシングルトン群。\n *\n * 管理画面は dispatcher ごとに独立した React ルートを `createRoot` する構成\n * （`@ablogcms/utils/react` の `render()`）のため、単一の `<SlotFillProvider>` でページ全体を\n * 包むことができない。`ctx.ui.fill` が書き込む Fill ブリッジをここでシングルトン化しておき、\n * 各ツリーの `<SlotFillProvider store={getGlobalFillBridge()}>` がこれを購読することで、\n * どの独立ツリーの `<Slot>` にも同じ登録内容が届く（design.md「グローバル Fill ブリッジ」節）。\n *\n * `unitDefs` / `columnTypes` prop の値計算（react-19-migration フェーズ3-1a/3-1b）も同じ理由で\n * dispatch 側の複数箇所から同一レジストリを参照する必要があるため、ここでシングルトン化する\n * （実際の prop 配線はフェーズD）。\n *\n * `createPluginRegistry()` 自体は各テストが独立したインスタンスで動かせるよう、これらに依存しない\n * 素の工場関数のまま保つ（`@ablogcms/events` の `createEventBus()` と同じ設計）。\n * 本番の結線（admin.js）でのみ、ここのシングルトンを明示的に注入する。\n */\nimport { createSlotFillStore, type SlotFillStore } from '@ablogcms/components/slot-fill';\nimport type { Action, BulkAction, ColumnTypeDef, Menu, RowData } from '@ablogcms/components/dataview/types';\nimport type { UnitDefInterface } from '@ablogcms/unit-editor/core/types/unit';\nimport type { BlockDefinition } from '@ablogcms/block-editor/types';\nimport type { AnyExtension } from '@ablogcms/block-editor/tiptap/core';\nimport type { Tiptap } from '@ablogcms/block-editor/tiptap';\nimport { createRegistry } from './create-registry';\nimport { createViewedRegistry, type ViewedRegistry } from './create-viewed-registry';\nimport type { Registry } from './types';\n\n/** `ctx.blockEditor.registerBlockDefinition` / `registerExtension` が登録するファクトリの型。 */\nexport type BlockDefinitionFactory = (runtime: Tiptap) => BlockDefinition;\nexport type BlockExtensionFactory = (runtime: Tiptap) => AnyExtension | AnyExtension[];\n\nlet fillBridge: SlotFillStore | undefined;\n\nexport function getGlobalFillBridge(): SlotFillStore {\n  if (!fillBridge) {\n    fillBridge = createSlotFillStore();\n  }\n  return fillBridge;\n}\n\nlet unitDefinitionRegistry: Registry<UnitDefInterface> | undefined;\n\nexport function getUnitDefinitionRegistry(): Registry<UnitDefInterface> {\n  if (!unitDefinitionRegistry) {\n    unitDefinitionRegistry = createRegistry<UnitDefInterface>('unit-definition');\n  }\n  return unitDefinitionRegistry;\n}\n\nlet columnTypeRegistry: Registry<ColumnTypeDef> | undefined;\n\nexport function getColumnTypeRegistry(): Registry<ColumnTypeDef> {\n  if (!columnTypeRegistry) {\n    columnTypeRegistry = createRegistry<ColumnTypeDef>('column-type');\n  }\n  return columnTypeRegistry;\n}\n\nlet blockDefinitionRegistry: Registry<BlockDefinitionFactory> | undefined;\n\nexport function getBlockDefinitionRegistry(): Registry<BlockDefinitionFactory> {\n  if (!blockDefinitionRegistry) {\n    blockDefinitionRegistry = createRegistry<BlockDefinitionFactory>('block-definition');\n  }\n  return blockDefinitionRegistry;\n}\n\nlet blockExtensionRegistry: Registry<BlockExtensionFactory> | undefined;\n\nexport function getBlockExtensionRegistry(): Registry<BlockExtensionFactory> {\n  if (!blockExtensionRegistry) {\n    blockExtensionRegistry = createRegistry<BlockExtensionFactory>('extension');\n  }\n  return blockExtensionRegistry;\n}\n\nlet dataviewActionRegistry: ViewedRegistry<Action<RowData>> | undefined;\n\nexport function getDataviewActionRegistry(): ViewedRegistry<Action<RowData>> {\n  if (!dataviewActionRegistry) {\n    dataviewActionRegistry = createViewedRegistry<Action<RowData>>('dataview-action');\n  }\n  return dataviewActionRegistry;\n}\n\nlet dataviewBulkActionRegistry: ViewedRegistry<BulkAction<RowData>> | undefined;\n\nexport function getDataviewBulkActionRegistry(): ViewedRegistry<BulkAction<RowData>> {\n  if (!dataviewBulkActionRegistry) {\n    dataviewBulkActionRegistry = createViewedRegistry<BulkAction<RowData>>('dataview-bulk-action');\n  }\n  return dataviewBulkActionRegistry;\n}\n\nlet dataviewMenuRegistry: ViewedRegistry<Menu<RowData>> | undefined;\n\nexport function getDataviewMenuRegistry(): ViewedRegistry<Menu<RowData>> {\n  if (!dataviewMenuRegistry) {\n    dataviewMenuRegistry = createViewedRegistry<Menu<RowData>>('dataview-menu');\n  }\n  return dataviewMenuRegistry;\n}\n"],"mappings":"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","names":["unitDefinitionRegistry","columnTypeRegistry","blockDefinitionRegistry","blockExtensionRegistry","dataviewActionRegistry","dataviewBulkActionRegistry","dataviewMenuRegistry","createSlotFillStore","createSlotFillStore"]}

package/dist/core/merge-registry-entries.d.ts

@@ -0,0 +1,11 @@
+import type { Registry } from './types.js';
+/**
+ * コア側の組み込み定義（`core`）と、プラグインが `Registry.add`（`ctx.unitEditor.registerUnitDefinition` /
+ * `ctx.dataview.registerColumnType` 経由）で登録した内容をマージする。
+ *
+ * react-19-migration フェーズ3-1a/3-1b で設計した `unitDefs` / `columnTypes` prop の値計算を
+ * レジストリ経由に変える配線（design.md「レジストリ（機能登録）」節）の共通実装。
+ * キー衝突時はレジストリ（プラグイン）側を優先する（design.md の例
+ * `{ ...coreUnitDefs, ...unitDefinitionRegistry.getAll() }` と同じマージ順）。
+ */
+export declare function mergeRegistryEntries<T>(core: Record<string, T>, registry: Registry<T>): Record<string, T>;

package/dist/core/resolve-fill-entry.d.ts

@@ -0,0 +1,28 @@
+import { type ComponentType, type ReactNode } from 'react';
+import type { FillRenderer } from '@ablogcms/components/slot-fill';
+import type { DomFill, FillEntry } from './types.js';
+/**
+ * `ctx.ui.fill(slotName, entry)` の `entry` を、Fill ストア（`@ablogcms/components/slot-fill`）に
+ * そのまま渡せる `FillRenderer`（`ReactNode`、または `Slot` の `fillProps` を受け取る render-prop
+ * 関数）に変換する。
+ *
+ * 判別は 3 種類:
+ * 1. `withFillProps(Component)` が返すマーカーオブジェクト（`FillComponentEntry`）→ `fillProps` を
+ *    受け取る render-prop 関数を返す（下記参照）。
+ * 2. 仮引数 1 個以上の関数 → `DomFill` として `DomFillMount` でラップする。
+ * 3. それ以外（仮引数 0 個の関数）→ props なしの React コンポーネントとして描画する。
+ *
+ * 2/3 の判別は Why not: 実行時には両者とも「関数」という点で構造的に区別できず
+ * （`React.ComponentType` も `DomFill` も型注釈はコンパイル時に消える）、関数名（`.name`）も
+ * 拠り所にならない（`vi.fn()` 等のラッパーを経由すると `.name` が `"Mock"` 等に上書きされ、
+ * テストのモックが大文字始まりになって誤判定するのを実測で確認した）。代わりに
+ * `Function.prototype.length`（宣言された仮引数の個数）で判別する（`vi.fn()` 等でラップされても
+ * 元関数の `.length` は保たれる）。この 0/1 個の判別は既存の後方互換のため変更しない。
+ *
+ * 1 のケースをこの判別の外に出している Why not: props を要求するコンポーネント
+ * （`({ editor, unit }) => ...`）は仮引数が 1 個になり、`DomFill`（`(el) => ...`）と実行時に
+ * 区別できない。`withFillProps` はオブジェクトでラップするため、`typeof entry === 'function'` の
+ * 分岐に到達する前に見分けがつき、既存の 0/1 個判別と衝突しない。
+ */
+export declare function resolveFillEntry(entry: ComponentType | DomFill): ReactNode;
+export declare function resolveFillEntry<T>(entry: FillEntry<T>): FillRenderer<T>;

package/dist/core/types.d.ts

@@ -0,0 +1,127 @@
+/**
+ * `@ablogcms/plugins` の型定義。React・グローバル（window.ACMS）いずれにも依存しない。
+ *
+ * VS Code の `activate(context)` + `context.subscriptions` を範に、イベント購読・機能登録
+ * （unitEditor/dataview）・UI 差し込み（Slot/Fill）・設定参照を 1 つの `setup(ctx)` に束ねる。
+ */
+import type { ComponentType, FunctionComponent } from 'react';
+import type { AcmsEventType, AcmsHandler, Unsubscribe } from '@ablogcms/events';
+import type { Action, BulkAction, ColumnTypeDef, Menu, RowData } from '@ablogcms/components/dataview/types';
+import type { UnitDefInterface } from '@ablogcms/unit-editor/core/types/unit';
+import type { BlockDefinition } from '@ablogcms/block-editor/types';
+import type { AnyExtension } from '@ablogcms/block-editor/tiptap/core';
+import type { Tiptap } from '@ablogcms/block-editor/tiptap';
+import type { FillComponentEntry } from './with-fill-props.js';
+/**
+ * dataview アクション/一括アクション/メニューレジストリの名前空間キー。
+ * `'entry' | 'module'` を主要値としつつ、将来 `'user'` / `'category'` 等へ拡張できるよう
+ * 文字列全般も受け付ける（design.md Q4「view キー方式」）。
+ */
+export type DataviewView = 'entry' | 'module' | (string & {});
+export type { Unsubscribe };
+export type { FillComponentEntry } from './with-fill-props.js';
+/**
+ * React を書けない制作者向けの DOM コールバック Fill（kintone の公認マウントポイント方式）。
+ * 渡された要素に自由に DOM 操作でき、戻り値（あれば）はアンマウント時のクリーンアップとして呼ばれる。
+ */
+export type DomFill = (el: HTMLElement) => void | (() => void);
+/**
+ * `ctx.ui.fill` に渡せるエントリ。実行時は「関数」という点で `ComponentType` と `DomFill` を
+ * 構造的に区別できないため、実際の判別は `resolve-fill-entry.ts` が仮引数の個数
+ * （0 個 = コンポーネント、1 個以上 = DomFill）に基づいて行う。`FillComponentEntry`
+ * （`withFillProps` で作る）はオブジェクトのため、この arity 判別とは独立に見分けられる。
+ */
+export type FillEntry<T = unknown> = ComponentType | DomFill | FillComponentEntry<T>;
+/** `setup(ctx)` に渡されるコンテキスト */
+export interface PluginContext {
+    /** プラグイン自身の名前（読み取り専用） */
+    readonly name: string;
+    /** イベント購読。`unregister` 時に自動 off される */
+    events: {
+        on<K extends AcmsEventType>(type: K | K[], handler: AcmsHandler<K>): Unsubscribe;
+    };
+    /** ユニットタイプの登録。`unregister` 時に自動解除される */
+    unitEditor: {
+        registerUnitDefinition(name: string, def: UnitDefInterface): Unsubscribe;
+    };
+    /**
+     * ブロックタイプ・Tiptap 拡張の登録。`unregister` 時に自動解除される。
+     * どちらも「Tiptap ランタイムを受け取って値を返すファクトリ」を渡す（値そのものではない）。
+     * ブロックエディターは lazy チャンクのため、登録時点（プラグイン JS 読み込み時）ではまだ
+     * チャンクがロードされておらず Tiptap の値を要求できない。ファクトリはチャンクロード後、
+     * 実際にメニュー解決・拡張構築が必要になった時点で呼ばれる。
+     */
+    blockEditor: {
+        /** BLOCK_DEFINITIONS マスターへの追加（メニューに現れた type の実装）。 */
+        registerBlockDefinition(name: string, factory: (runtime: Tiptap) => BlockDefinition): Unsubscribe;
+        /** Tiptap スキーマ層への追加（新規 node/mark type、メニューを持たない挙動拡張等）。 */
+        registerExtension(name: string, factory: (runtime: Tiptap) => AnyExtension | AnyExtension[]): Unsubscribe;
+    };
+    /** dataview カラム型・アクション・一括アクション・メニューの登録。`unregister` 時に自動解除される */
+    dataview: {
+        registerColumnType(name: string, type: ColumnTypeDef): Unsubscribe;
+        /**
+         * 一覧画面の行アクション（編集/削除ボタン等）を登録する。`view` ごとに名前空間が独立する
+         * （`'entry'` と `'module'` で同じ `name` を使っても衝突しない）。
+         * 行の型はレジストリ境界で消去される（`RowData` は実質 `unknown`）ため、実際の型は
+         * 消費側の feature（`use-entry-admin-actions.tsx` 等）が `Action<EntryType>` 等へキャストする。
+         */
+        registerAction(view: DataviewView, name: string, def: Action<RowData>): Unsubscribe;
+        /** 一覧画面の一括アクション（複数選択後のフォーム送信）を登録する。`registerAction` と同じ view 名前空間規約 */
+        registerBulkAction(view: DataviewView, name: string, def: BulkAction<RowData>): Unsubscribe;
+        /** 一覧画面のドロップダウンメニュー項目を登録する。`registerAction` と同じ view 名前空間規約 */
+        registerMenu(view: DataviewView, name: string, def: Menu<RowData>): Unsubscribe;
+    };
+    /** UI 差し込み（React コンポーネント・DOM コールバックの両対応）。`unregister` 時に自動解除される */
+    ui: {
+        fill<T = unknown>(slotName: string, entry: FillEntry<T>): Unsubscribe;
+    };
+    /** PHP 側から `jsModule()` 経由で渡された当該プラグインの設定値（キャメルケース変換で対応） */
+    readonly config: Record<string, unknown>;
+}
+export interface PluginDefinition {
+    version?: string;
+    setup(ctx: PluginContext): void;
+}
+/** ctx 経由で行った登録 1 件分の帰属情報（`getAll()` によるデバッグ列挙用） */
+export interface RegisteredEntry {
+    kind: 'event' | 'unit-definition' | 'column-type' | 'block-definition' | 'extension' | 'fill' | 'dataview-action' | 'dataview-bulk-action' | 'dataview-menu';
+    /**
+     * イベント名（複数指定時はカンマ区切り） / unit-definition 名 / column-type 名 /
+     * block-definition 名 / extension 名 / slot 名 / `dataview-action` 等は `${view}:${name}`
+     */
+    key: string;
+}
+export interface RegisteredPlugin {
+    name: string;
+    version?: string;
+    /** そのプラグインが ctx 経由で行った登録の一覧（登録順） */
+    registrations: readonly RegisteredEntry[];
+}
+export interface AcmsPlugins {
+    /** プラグインを登録する。`name` が既に登録済みの場合は throw する */
+    register(name: string, definition: PluginDefinition): void;
+    /** プラグインを登録解除する。ctx 経由の登録をすべて自動回収する。存在した場合のみ true を返す */
+    unregister(name: string): boolean;
+    get(name: string): RegisteredPlugin | undefined;
+    getAll(): RegisteredPlugin[];
+    /**
+     * `ctx.ui.fill` の `fillProps` を受け取る React コンポーネントを登録するためのラッパー
+     * （`with-fill-props.ts` 参照）。外部プラグイン（`InjectTemplate::add()` で読み込まれ、
+     * npm パッケージを import できない環境）はここ（`ACMS.plugins.withFillProps`）からのみ
+     * 入手できる。内部コード（本体・パッケージ）は `@ablogcms/plugins` からの直接 import も使える。
+     */
+    withFillProps<T>(Component: FunctionComponent<T>): FillComponentEntry<T>;
+}
+/**
+ * 汎用の名前付きレジストリ。`ctx.unitEditor.registerUnitDefinition` / `ctx.dataview.registerColumnType`
+ * の土台。名前衝突を検知し、登録済み項目を列挙できる（Directus の `defineInterface` 等と同型）。
+ */
+export interface Registry<T> {
+    /** `name` が既に登録済みの場合は throw する。戻り値の `Unsubscribe` でその登録だけを解除できる */
+    add(name: string, item: T): Unsubscribe;
+    /** `name` の登録を解除する。存在した場合のみ true を返す */
+    remove(name: string): boolean;
+    get(name: string): T | undefined;
+    getAll(): Record<string, T>;
+}

package/dist/core/with-fill-props.d.ts

@@ -0,0 +1,37 @@
+import type { FunctionComponent } from 'react';
+/**
+ * `withFillProps` が返すマーカー付きエントリ。`ctx.ui.fill` の判別（`resolve-fill-entry.ts`）が
+ * オブジェクトかどうかで即座に見分けられるよう、`kind` に固定のブランド文字列を持たせる。
+ *
+ * `Component` を `ComponentType<T>`（関数・クラス両対応）ではなく `FunctionComponent<T>` に
+ * 限定している Why not: `createElement(Component, fillProps)` を T についてジェネリックなまま
+ * 呼ぶと、`ComponentType<T>` が関数・クラスの合併型であるために `createElement` のオーバーロード
+ * 解決が失敗する（クラス側 `getDerivedStateFromProps` の反変位置で `T` の消去に起因する型エラー、
+ * 実測で確認）。本リポジトリはクラスコンポーネントの新規追加を禁止する規約
+ * （development-guidelines.md）のため、関数コンポーネントのみに絞ることで実用上の制約にならない。
+ */
+export interface FillComponentEntry<T> {
+    readonly kind: 'acms-plugins/fill-component';
+    readonly Component: FunctionComponent<T>;
+}
+/**
+ * `Slot` の `fillProps`（例: `unit-editor.unit-toolbar` の `{ editor, unit }`）を受け取る React
+ * コンポーネントを `ctx.ui.fill` に登録するためのラッパー。
+ *
+ * Why not（関数のままでは表現できない理由）: `resolveFillEntry` は仮引数の個数
+ * （0 個 = props なしコンポーネント、1 個以上 = `DomFill`）で判別しており、この規約は
+ * `ctx.ui.fill` の当初からの後方互換として維持する。props を要求するコンポーネント
+ * （`({ editor, unit }) => ...`）は仮引数が 1 個になり、`DomFill`（`(el) => ...`）と実行時に
+ * 構造的に区別できない（`Function.prototype.length` だけでは両者が衝突する）。
+ * `withFillProps` は関数ではなくオブジェクトでラップすることで、既存の arity 判別ロジックに
+ * 一切手を入れずにこの衝突を回避する。
+ *
+ * ```tsx
+ * ctx.ui.fill('unit-editor.unit-toolbar', withFillProps<UnitToolbarSlotFillProps>(({ editor, unit }) => (
+ *   <button type="button">{unit.type}</button>
+ * )));
+ * ```
+ */
+export declare function withFillProps<T>(Component: FunctionComponent<T>): FillComponentEntry<T>;
+/** `entry` が `withFillProps` で作られたマーカー付きエントリかどうかを判定する */
+export declare function isFillComponentEntry<T>(entry: unknown): entry is FillComponentEntry<T>;

package/dist/events.d.ts

@@ -0,0 +1,66 @@
+/**
+ * entry/module admin（一覧画面）のライフサイクル操作（trash/duplicate/一括ステータス変更等）を
+ * `AcmsEventMap`（`@ablogcms/events`）へ登録する module augmentation。
+ *
+ * Why not（`ablogcms/js/src/features/{entry,module}` に置かない理由）: `EntryType`/`ModuleType` は
+ * それぞれの機能ディレクトリ配下にのみ存在するアプリ側の型だが、実測でアプリ側（ablogcms 配下）の
+ * ファイルから `declare module '@ablogcms/events'` で `AcmsEventMap` を拡張すると、他パッケージ
+ * （`packages/frontend/media` 等）側の `AcmsEventOf<K>` 解決が緩い `AcmsLooseEvent` に落ちる
+ * （`gateResult.event.formData` が `unknown` になる等）ビルド不整合が発生した
+ * （コメント記法や型の複雑さとは無関係に、単一の空エントリでも再現する）。行の型を消去した
+ * `RowData`（`@ablogcms/components/dataview/types`。`ctx.dataview.registerAction` 等が既に
+ * 使っている型）で宣言することで、この問題を避けつつ `@ablogcms/plugins` が dataview 関連の
+ * 型をまとめて持つ既存の構成に合わせる。実際の型は消費側の feature
+ * （`use-entry-admin-actions.tsx` 等）が `EntryType`/`ModuleType` へキャストする。
+ */
+import type { AcmsGateEvent, AcmsNotifyEvent } from '@ablogcms/events';
+import type { RowData } from '@ablogcms/components/dataview/types';
+declare module '@ablogcms/events' {
+    interface AcmsEventMap {
+        /** 単発の「ゴミ箱へ移動」実行直前のゲート。`use-entry-admin-actions.tsx` の trash アクション */
+        'entry.trash.before': AcmsGateEvent<{
+            entry: RowData;
+        }>;
+        /** 上記の実行成功後の通知 */
+        'entry.trash.success': AcmsNotifyEvent<{
+            entry: RowData;
+        }>;
+        /**
+         * 単発の複製実行成功後の通知。`use-entry-admin-actions.tsx` の duplicate アクション。
+         * 複製確認ダイアログが無く取り消し不能な操作のため before ゲートは設けない
+         */
+        'entry.duplicate.success': AcmsNotifyEvent<{
+            entry: RowData;
+        }>;
+        /**
+         * 一括ステータス変更（公開/非公開切替）実行直前のゲート。`use-entry-admin-bulk-actions.tsx`。
+         * `formData` を差し替えて return すると実際に送信される内容を変えられる
+         */
+        'entry.bulk-status.before': AcmsGateEvent<{
+            formData: FormData;
+        }>;
+        /** 上記の実行成功後の通知 */
+        'entry.bulk-status.success': AcmsNotifyEvent<{
+            formData: FormData;
+        }>;
+        /** 一括「ゴミ箱へ移動」実行成功後の通知。`use-entry-admin-bulk-actions.tsx` */
+        'entry.bulk-trash.success': AcmsNotifyEvent<{
+            formData: FormData;
+        }>;
+        /** 一括複製実行成功後の通知。`use-entry-admin-bulk-actions.tsx` */
+        'entry.bulk-duplicate.success': AcmsNotifyEvent<{
+            formData: FormData;
+        }>;
+        /**
+         * 一括ステータス変更実行直前のゲート。`use-module-admin-bulk-actions.tsx`。
+         * entry 側の `entry.bulk-status.*` と同型の横展開
+         */
+        'module.bulk-status.before': AcmsGateEvent<{
+            formData: FormData;
+        }>;
+        /** 上記の実行成功後の通知 */
+        'module.bulk-status.success': AcmsNotifyEvent<{
+            formData: FormData;
+        }>;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@ablogcms/plugins` のルートエントリ（グローバル委譲ファサード）。
+ *
+ * `window.ACMS.plugins`（管理画面コアが `/core` の `createPluginRegistry()` で生成したシングルトン）に
+ * 処理を委譲する薄いラッパー。プラグイン・テーマの JS バンドルに同梱されても、実体は常にコアが
+ * 保持する単一インスタンスに到達するため、別インスタンス問題（登録が黙って無効になる事故）が起きない。
+ *
+ * グローバル未初期化（管理画面外・初期化前に読み込まれた等）の場合は明確なエラーを投げる。
+ * レジストリ本体の純粋実装・グローバル非依存のユニットテストは `@ablogcms/plugins/core` を使う。
+ */
+import type { AcmsPlugins, PluginDefinition, RegisteredPlugin } from './core/types.js';
+export * from './core/types.js';
+import { withFillProps } from './core/with-fill-props.js';
+export { withFillProps };
+export declare function register(name: string, definition: PluginDefinition): void;
+export declare function unregister(name: string): boolean;
+export declare function get(name: string): RegisteredPlugin | undefined;
+export declare function getAll(): RegisteredPlugin[];
+declare const plugins: AcmsPlugins;
+export default plugins;

package/dist/index.mjs

@@ -0,0 +1,43 @@
+import {
+  withFillProps
+} from "./chunk-OWV4U7DT.mjs";
+
+// src/index.ts
+var getGlobalPlugins = () => {
+  if (typeof window === "undefined") {
+    return void 0;
+  }
+  return window.ACMS?.plugins;
+};
+var requireGlobalPlugins = () => {
+  const plugins2 = getGlobalPlugins();
+  if (!plugins2) {
+    throw new Error(
+      "[@ablogcms/plugins] window.ACMS.plugins \u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002\u7BA1\u7406\u753B\u9762\u306E\u521D\u671F\u5316\u524D\u3001\u307E\u305F\u306F\u7BA1\u7406\u753B\u9762\u5916\uFF08\u516C\u958B\u5074\u30C6\u30FC\u30DE\u7B49\uFF09\u3067\u8AAD\u307F\u8FBC\u307E\u308C\u3066\u3044\u308B\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002"
+    );
+  }
+  return plugins2;
+};
+function register(name, definition) {
+  requireGlobalPlugins().register(name, definition);
+}
+function unregister(name) {
+  return requireGlobalPlugins().unregister(name);
+}
+function get(name) {
+  return requireGlobalPlugins().get(name);
+}
+function getAll() {
+  return requireGlobalPlugins().getAll();
+}
+var plugins = { register, unregister, get, getAll, withFillProps };
+var index_default = plugins;
+export {
+  index_default as default,
+  get,
+  getAll,
+  register,
+  unregister,
+  withFillProps
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@ablogcms/plugins` のルートエントリ（グローバル委譲ファサード）。\n *\n * `window.ACMS.plugins`（管理画面コアが `/core` の `createPluginRegistry()` で生成したシングルトン）に\n * 処理を委譲する薄いラッパー。プラグイン・テーマの JS バンドルに同梱されても、実体は常にコアが\n * 保持する単一インスタンスに到達するため、別インスタンス問題（登録が黙って無効になる事故）が起きない。\n *\n * グローバル未初期化（管理画面外・初期化前に読み込まれた等）の場合は明確なエラーを投げる。\n * レジストリ本体の純粋実装・グローバル非依存のユニットテストは `@ablogcms/plugins/core` を使う。\n */\nimport type { AcmsPlugins, PluginDefinition, RegisteredPlugin } from './core/types';\n\nexport * from './core/types';\n// withFillProps はグローバル（window.ACMS.plugins）非依存の純粋なヘルパー（マーカーオブジェクトを\n// 作るだけ）なので、他の register/unregister 等と違いグローバル委譲のラップを必要としない。\n// プラグイン作者が setup(ctx) 内で ctx.ui.fill(...) と組み合わせて直接使うため、\n// `@ablogcms/plugins/core`（コア bootstrap・テスト用）だけでなくこちらからも公開する。\n// 外部プラグイン（import 不可）向けには `ACMS.plugins.withFillProps` としても公開する\n// （`create-plugin-registry.ts` の返り値に同じ関数を生やす。確定事項 Q3）。\nimport { withFillProps } from './core/with-fill-props';\nexport { withFillProps };\n\ninterface AcmsGlobal {\n  plugins?: AcmsPlugins;\n}\n\nconst getGlobalPlugins = (): AcmsPlugins | undefined => {\n  if (typeof window === 'undefined') {\n    return undefined;\n  }\n  return (window as unknown as { ACMS?: AcmsGlobal }).ACMS?.plugins;\n};\n\nconst requireGlobalPlugins = (): AcmsPlugins => {\n  const plugins = getGlobalPlugins();\n  if (!plugins) {\n    throw new Error(\n      '[@ablogcms/plugins] window.ACMS.plugins が見つかりません。管理画面の初期化前、または管理画面外（公開側テーマ等）で読み込まれている可能性があります。'\n    );\n  }\n  return plugins;\n};\n\nexport function register(name: string, definition: PluginDefinition): void {\n  requireGlobalPlugins().register(name, definition);\n}\n\nexport function unregister(name: string): boolean {\n  return requireGlobalPlugins().unregister(name);\n}\n\nexport function get(name: string): RegisteredPlugin | undefined {\n  return requireGlobalPlugins().get(name);\n}\n\nexport function getAll(): RegisteredPlugin[] {\n  return requireGlobalPlugins().getAll();\n}\n\nconst plugins: AcmsPlugins = { register, unregister, get, getAll, withFillProps };\n\nexport default plugins;\n"],"mappings":";;;;;AA0BA,IAAM,mBAAmB,MAA+B;AACtD,MAAI,OAAO,WAAW,aAAa;AACjC,WAAO;AAAA,EACT;AACA,SAAQ,OAA4C,MAAM;AAC5D;AAEA,IAAM,uBAAuB,MAAmB;AAC9C,QAAMA,WAAU,iBAAiB;AACjC,MAAI,CAACA,UAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAOA;AACT;AAEO,SAAS,SAAS,MAAc,YAAoC;AACzE,uBAAqB,EAAE,SAAS,MAAM,UAAU;AAClD;AAEO,SAAS,WAAW,MAAuB;AAChD,SAAO,qBAAqB,EAAE,WAAW,IAAI;AAC/C;AAEO,SAAS,IAAI,MAA4C;AAC9D,SAAO,qBAAqB,EAAE,IAAI,IAAI;AACxC;AAEO,SAAS,SAA6B;AAC3C,SAAO,qBAAqB,EAAE,OAAO;AACvC;AAEA,IAAM,UAAuB,EAAE,UAAU,YAAY,KAAK,QAAQ,cAAc;AAEhF,IAAO,gBAAQ;","names":["plugins"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@ablogcms/plugins",
+  "version": "3.2.28-beta.0",
+  "type": "module",
+  "description": "管理画面 JS 拡張基盤のプラグイン登録レジストリ",
+  "license": "MIT",
+  "homepage": "https://www.a-blogcms.jp",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@bitbucket.org:appleple/ablogcms.git",
+    "directory": "packages/frontend/plugins"
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@ablogcms/block-editor": "3.2.28-beta.0",
+    "@ablogcms/events": "3.2.28-beta.0",
+    "@ablogcms/types": "3.2.28-beta.0",
+    "@ablogcms/components": "3.2.28-beta.0",
+    "@ablogcms/unit-editor": "3.2.28-beta.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.2",
+    "vitest": "^4.1.9"
+  },
+  "peerDependencies": {
+    "react": "^19",
+    "@types/react": "^19.2.17"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./acms": {
+      "types": "./dist/acms.d.ts",
+      "import": "./dist/acms.mjs",
+      "default": "./dist/acms.mjs"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.mjs",
+      "default": "./dist/core/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "node ../../../tools/build-package.mjs"
+  }
+}