@luna-editor/engine 0.1.0

package/dist/plugin/luna-react.d.ts

@@ -0,0 +1,41 @@
+/**
+ * プラグインAPIからReactインスタンスを設定
+ */
+export declare function setReactRuntime(react: any): void;
+/**
+ * JSX Transform用のjsx関数
+ */
+export declare function jsx(type: any, props: any, key?: any): any;
+/**
+ * JSX Transform用のjsxs関数（複数子要素用）
+ */
+export declare function jsxs(type: any, props: any, key?: any): any;
+/**
+ * Fragment用
+ */
+export declare function Fragment(props: {
+    children?: any;
+}): any;
+/**
+ * Reactフックと関数のプロキシ
+ */
+export declare const useState: (...args: any[]) => any;
+export declare const useEffect: (...args: any[]) => any;
+export declare const useCallback: (...args: any[]) => any;
+export declare const useMemo: (...args: any[]) => any;
+export declare const useRef: (...args: any[]) => any;
+export declare const useContext: (...args: any[]) => any;
+export declare const useReducer: (...args: any[]) => any;
+export declare const createElement: (...args: any[]) => any;
+declare const _default: {
+    createElement: (...args: any[]) => any;
+    Fragment: typeof Fragment;
+    useState: (...args: any[]) => any;
+    useEffect: (...args: any[]) => any;
+    useCallback: (...args: any[]) => any;
+    useMemo: (...args: any[]) => any;
+    useRef: (...args: any[]) => any;
+    useContext: (...args: any[]) => any;
+    useReducer: (...args: any[]) => any;
+};
+export default _default;

package/dist/plugin/luna-react.js

@@ -0,0 +1,99 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/* eslint-disable import/no-anonymous-default-export */
+let runtimeReact = null;
+/**
+ * プラグインAPIからReactインスタンスを設定
+ */
+export function setReactRuntime(react) {
+    runtimeReact = react;
+}
+/**
+ * JSX Transform用のjsx関数
+ */
+export function jsx(type, props, key) {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.createElement(type, key ? Object.assign(Object.assign({}, props), { key }) : props);
+}
+/**
+ * JSX Transform用のjsxs関数（複数子要素用）
+ */
+export function jsxs(type, props, key) {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.createElement(type, key ? Object.assign(Object.assign({}, props), { key }) : props);
+}
+/**
+ * Fragment用
+ */
+export function Fragment(props) {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.createElement(runtimeReact.Fragment, null, props.children);
+}
+/**
+ * Reactフックと関数のプロキシ
+ */
+export const useState = (...args) => {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.useState(...args);
+};
+export const useEffect = (...args) => {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.useEffect(...args);
+};
+export const useCallback = (...args) => {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.useCallback(...args);
+};
+export const useMemo = (...args) => {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.useMemo(...args);
+};
+export const useRef = (...args) => {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.useRef(...args);
+};
+export const useContext = (...args) => {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.useContext(...args);
+};
+export const useReducer = (...args) => {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.useReducer(...args);
+};
+export const createElement = (...args) => {
+    if (!runtimeReact) {
+        throw new Error("React runtime not initialized. Make sure plugin is loaded properly.");
+    }
+    return runtimeReact.createElement(...args);
+};
+// デフォルトエクスポート（互換性用）
+export default {
+    createElement,
+    Fragment,
+    useState,
+    useEffect,
+    useCallback,
+    useMemo,
+    useRef,
+    useContext,
+    useReducer,
+};

package/dist/sdk.d.ts

@@ -0,0 +1,512 @@
+import React from "react";
+import type { ActionNode, BacklogEntry, Character, EntityState, ScenarioBlock } from "./types";
+export interface LunaPlugin {
+    name: string;
+    version: string;
+    description: string;
+    /** プラグインインストール時の処理（オプション） */
+    onInstall?(api: PluginInstallAPI): Promise<void>;
+    /** プラグインアンインストール時の処理（オプション） */
+    onUninstall?(api: PluginInstallAPI): Promise<void>;
+    setup(api: PluginAPI): void;
+}
+/**
+ * シナリオ再生の動的データ
+ */
+export interface ScenarioPlaybackData {
+    /** 現在のブロックインデックス（0始まり） */
+    currentBlockIndex: number;
+    /** 総ブロック数 */
+    totalBlocks: number;
+    /** 現在のシナリオID */
+    scenarioId: string;
+    /** シナリオ名 */
+    scenarioName: string;
+    /** 現在のブロック */
+    currentBlock: ScenarioBlock | null;
+    /** 表示中のテキスト */
+    displayText?: string;
+    /** テキストアニメーション中かどうか */
+    isTyping?: boolean;
+    /** 表示中のキャラクター */
+    displayedCharacters?: any[];
+}
+/**
+ * バックログデータ
+ */
+export interface BacklogData {
+    /** バックログエントリ */
+    entries: BacklogEntry[];
+    /** 総エントリ数 */
+    totalEntries: number;
+    /** ログエントリを追加 */
+    addLogEntry?: (entry: BacklogEntry) => void;
+    /** ログをクリア */
+    clearLogs?: () => void;
+}
+/**
+ * プレイヤー設定データ
+ */
+export interface PlayerSettingsData extends PlayerSettings {
+    /** テキスト速度 (1-10) */
+    textSpeed: number;
+    /** 自動再生速度 (秒) */
+    autoPlaySpeed: number;
+    /** BGM音量 (0-1) */
+    bgmVolume: number;
+    /** SE音量 (0-1) */
+    seVolume: number;
+    /** ボイス音量 (0-1) */
+    voiceVolume: number;
+    /** スキップ設定 */
+    skipMode?: "all" | "unread" | "none";
+}
+/**
+ * プラグインアセットデータ
+ */
+export interface PluginAssetsData {
+    /**
+     * プラグインのアセットURLを取得
+     * @param pluginName - プラグインのパッケージ名
+     * @param filename - アセットファイル名
+     * @returns アセットのURL
+     */
+    getAssetUrl: (pluginName: string, filename: string) => string;
+}
+/**
+ * 全データコンテキスト
+ */
+export interface DataContext {
+    /** シナリオ再生情報 */
+    playback: ScenarioPlaybackData;
+    /** バックログ情報 */
+    backlog: BacklogData;
+    /** プレイヤー設定 */
+    settings: PlayerSettingsData;
+    /** プラグインアセット */
+    pluginAssets: PluginAssetsData;
+}
+/**
+ * データ購読コールバック
+ */
+export type DataSubscriber<T> = (data: T) => void;
+/**
+ * データAPI - プラグインからのデータアクセスインターフェース
+ *
+ * @example Pull型（現在値の取得）
+ * ```typescript
+ * const blockIndex = api.data.get('playback', 'currentBlockIndex');
+ * const playback = api.data.get('playback');
+ * ```
+ *
+ * @example Push型（変更の監視）
+ * ```typescript
+ * const unsubscribe = api.data.subscribe('playback', (data) => {
+ *   console.log('Playback updated:', data);
+ * });
+ * // cleanup
+ * unsubscribe();
+ * ```
+ *
+ * @example プロパティ単位での監視
+ * ```typescript
+ * api.data.watch('playback', 'currentBlockIndex', (index) => {
+ *   console.log('Block changed to:', index);
+ * });
+ * ```
+ */
+/**
+ * UI表示管理API - プラグインUIコンポーネントの表示/非表示を制御
+ */
+export interface UIAPI {
+    /**
+     * 指定したUIコンポーネントを表示
+     * @param type - コンポーネントタイプ
+     */
+    show(type: ComponentType): void;
+    /**
+     * 指定したUIコンポーネントを非表示
+     * @param type - コンポーネントタイプ
+     */
+    hide(type: ComponentType): void;
+    /**
+     * 指定したUIコンポーネントの表示/非表示を切り替え
+     * @param type - コンポーネントタイプ
+     */
+    toggle(type: ComponentType): void;
+    /**
+     * 指定したUIコンポーネントの表示状態を取得
+     * @param type - コンポーネントタイプ
+     * @returns 表示中ならtrue
+     */
+    isVisible(type: ComponentType): boolean;
+}
+export interface DataAPI {
+    /**
+     * データの現在値を取得（Pull型）
+     * @param key - データカテゴリ
+     */
+    get<K extends keyof DataContext>(key: K): DataContext[K];
+    /**
+     * データの特定プロパティを取得（Pull型）
+     * @param key - データカテゴリ
+     * @param property - プロパティ名
+     */
+    get<K extends keyof DataContext, P extends keyof DataContext[K]>(key: K, property: P): DataContext[K][P];
+    /**
+     * データカテゴリ全体の変更を監視（Push型）
+     * @param key - データカテゴリ
+     * @param callback - 変更時のコールバック
+     * @returns unsubscribe関数
+     */
+    subscribe<K extends keyof DataContext>(key: K, callback: DataSubscriber<DataContext[K]>): () => void;
+    /**
+     * 特定プロパティの変更を監視（Push型）
+     * @param key - データカテゴリ
+     * @param property - プロパティ名
+     * @param callback - 変更時のコールバック
+     * @returns unsubscribe関数
+     */
+    watch<K extends keyof DataContext, P extends keyof DataContext[K]>(key: K, property: P, callback: DataSubscriber<DataContext[K][P]>): () => void;
+}
+export interface PluginAPI {
+    style: StyleAPI;
+    defineActionNode(definition: ActionNodeDefinition): void;
+    hooks: PluginHooks;
+    effects: EffectAPI;
+    storage: StorageAPI;
+    assets: AssetAPI;
+    components: ComponentAPI;
+    data: DataAPI;
+    ui: UIAPI;
+    React: typeof React;
+    setNextCharacterSpeakHandler(callback: (context: CharacterSpeakContext) => void): void;
+    getConfig?(): unknown;
+}
+export interface StyleAPI {
+    elements: {
+        speakerName: StyleElement;
+        scenarioBlockContent: StyleElement;
+        dialogueBox: StyleElement;
+        gameScreen: StyleElement;
+        characterSprite: StyleElement;
+        background: StyleElement;
+    };
+    injectCSS(css: string): void;
+    enableTailwind(): void;
+}
+export interface OverlayOptions {
+    color: string;
+    opacity?: number;
+    blendMode?: string;
+    duration?: number;
+    zIndex?: number;
+    id?: string;
+}
+export interface StyleElement {
+    setClassName(className: string): void;
+    addClassName(className: string): void;
+    removeClassName(className: string): void;
+    toggleClassName(className: string): void;
+    setStyle(style: Partial<CSSStyleDeclaration>): void;
+    when(condition: () => boolean, className: string): void;
+    setOverlay(options: OverlayOptions): string;
+    removeOverlay(overlayId: string): void;
+    clearOverlays(): void;
+}
+export interface ActionNodeDefinition {
+    type: string;
+    displayName: string;
+    icon?: string;
+    attributes: AttributeDefinition[];
+    execute(context: ActionExecutionContext): void | Promise<void>;
+}
+export interface AttributeDefinition {
+    name: string;
+    type: "text" | "textarea" | "number" | "select" | "entity";
+    label: string;
+    default?: any;
+    required?: boolean;
+    placeholder?: string;
+    min?: number;
+    max?: number;
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    /**
+     * entity型の場合、選択可能なオブジェクトタイプ名を制限
+     * 指定されない場合は全てのオブジェクトタイプから選択可能
+     */
+    entityObjectTypeName?: string;
+    /**
+     * 条件付き表示設定
+     * 他の属性の値に基づいて、この属性を表示するかどうかを制御
+     */
+    conditionalDisplay?: {
+        dependsOn: string;
+        showWhen: string | string[];
+    };
+}
+/**
+ * プラグインインストール時に利用可能なAPI
+ */
+export interface PluginInstallAPI {
+    /** オブジェクトタイプを作成 */
+    createObjectType(definition: ObjectTypeDefinition): Promise<void>;
+    /** オブジェクトタイプを名前で検索 */
+    findObjectType(name: string): Promise<ObjectType | null>;
+    /** オブジェクトタイプを更新 */
+    updateObjectType(name: string, definition: Partial<ObjectTypeDefinition>): Promise<void>;
+}
+/** オブジェクトタイプの定義 */
+export interface ObjectTypeDefinition {
+    name: string;
+    description?: string;
+    isEntity: boolean;
+    attributes: ObjectAttributeDefinition[];
+}
+/** オブジェクト属性の定義 */
+export interface ObjectAttributeDefinition {
+    name: string;
+    displayName: string;
+    dataType: "string" | "number" | "boolean" | "text";
+    isRequired: boolean;
+    defaultValue?: any;
+    sortOrder?: number;
+}
+/** 簡易的なオブジェクトタイプ情報 */
+export interface ObjectType {
+    id: string;
+    name: string;
+    description?: string;
+    isEntity: boolean;
+}
+export interface ActionExecutionContext {
+    attributes: Record<string, unknown>;
+    currentBlock: ScenarioBlock;
+    currentSpeaker?: Character;
+    displayedCharacters: Character[];
+    api: PluginAPI;
+}
+export interface PluginHooks {
+    onInit(callback: () => void): void;
+    onScenarioReady(callback: (context: ScenarioReadyContext) => void): void;
+    onBlockChange(callback: (context: BlockChangeContext) => void): void;
+    onCharacterEnter(callback: (context: CharacterContext) => void): void;
+    onCharacterExit(callback: (context: CharacterContext) => void): void;
+    onDialogueShow(callback: (context: DialogueContext) => void): void;
+    onActionExecute(callback: (context: ActionExecutionContext) => void): void;
+    onScenarioStart(callback: (context: ScenarioContext) => void): void;
+    onScenarioEnd(callback: (context: ScenarioContext) => void): void;
+}
+export interface BlockChangeContext {
+    previousBlock?: ScenarioBlock;
+    currentBlock: ScenarioBlock;
+    blockIndex: number;
+}
+export interface CharacterContext {
+    character: Character;
+    state: EntityState;
+    position?: number;
+}
+export interface DialogueContext {
+    dialogue: {
+        content: string;
+        speakerName?: string;
+        speakerState?: string;
+    };
+    speakerElement?: HTMLElement;
+    dialogueElement: HTMLElement;
+}
+export interface CharacterSpeakContext {
+    speaker: {
+        id: string;
+        name: string;
+        state?: string;
+        position?: number;
+    };
+    dialogue: {
+        content: string;
+        isNewSpeaker: boolean;
+    };
+    speakerElement?: HTMLElement;
+    characterElement?: HTMLElement;
+    previousSpeaker?: {
+        id?: string;
+        name?: string;
+    };
+    facePosition?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+export interface ScenarioContext {
+    scenario: {
+        id: string;
+        name: string;
+    };
+}
+export interface ScenarioReadyContext {
+    scenario: {
+        id: string;
+        name: string;
+    };
+    allBlocks: ScenarioBlock[];
+    currentBlockIndex: number;
+    currentBlock: ScenarioBlock;
+}
+export interface EffectAPI {
+    show(options: EffectOptions): string;
+    hide(effectId: string): void;
+    hideAll(): void;
+}
+export interface EffectOptions {
+    target?: "speaker" | "dialogue" | "screen" | HTMLElement;
+    html: string;
+    duration?: number;
+    className?: string;
+    position?: "above" | "below" | "left" | "right" | "center" | "precise";
+    animation?: "fade" | "slide" | "bounce" | "none";
+}
+export interface StorageAPI {
+    get<T = any>(key: string): T | null;
+    set<T = any>(key: string, value: T): void;
+    remove(key: string): void;
+    clear(): void;
+}
+export interface AssetAPI {
+    getUrl(filename: string): string;
+    preload(filenames: string[]): Promise<void>;
+    playSound(filename: string, options?: SoundOptions): void;
+    stopSound(filename: string): void;
+}
+export interface SoundOptions {
+    volume?: number;
+    loop?: boolean;
+    fadeDuration?: number;
+}
+export declare enum ComponentType {
+    Backlog = "Backlog",
+    DialogueBox = "DialogueBox",
+    CharacterDisplay = "CharacterDisplay",
+    ActionMenu = "ActionMenu",
+    SaveLoadMenu = "SaveLoadMenu",
+    SaveMenu = "SaveMenu",
+    LoadMenu = "LoadMenu",
+    SettingsMenu = "SettingsMenu",
+    GameMenu = "GameMenu",
+    Config = "Config"
+}
+/**
+ * コンポーネント登録API
+ * すべてのデータはDataContext経由で提供されるため、propsは使用しません
+ */
+export interface ComponentAPI {
+    registerComponent(type: ComponentType, component: React.ComponentType): void;
+}
+export type { BacklogEntry };
+export interface DisplayedCharacter {
+    objectId: string;
+    stateId?: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    scale?: number;
+}
+export interface PlayerSettings {
+    textSpeed: number;
+    autoPlaySpeed: number;
+    bgmVolume: number;
+    seVolume: number;
+    voiceVolume: number;
+}
+export type { ScenarioBlock, Character, EntityState, ActionNode };
+export declare function definePlugin(plugin: LunaPlugin): LunaPlugin;
+export declare function defineComponent(type: ComponentType, component: React.ComponentType): {
+    type: ComponentType;
+    component: React.ComponentType;
+};
+export interface FaceRelativeEffectOptions {
+    facePosition: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    relativePosition: "forehead" | "cheek_left" | "cheek_right" | "chin" | "center";
+    offsetX?: number;
+    offsetY?: number;
+}
+/**
+ * Calculate effect position relative to face
+ * Utility function for plugins to position effects relative to character face
+ */
+export declare function calculateFaceRelativePosition(options: FaceRelativeEffectOptions): {
+    x: number;
+    y: number;
+};
+export { React };
+/**
+ * 画面サイズ変換ユーティリティの型定義
+ */
+export interface PixelConverter {
+    /** 高さ基準でピクセル値を変換 */
+    pixel: (basisX: number) => number;
+    /** 幅基準でピクセル値を変換 */
+    pixelWidth: (basisX: number) => number;
+    /** アスペクト比を考慮したサイズを返す */
+    aspectSize: (basisSize: number) => {
+        width: number;
+        height: number;
+    };
+    /** 2D座標を変換 */
+    pos: (basisPos: {
+        x: number;
+        y: number;
+    }) => {
+        x: number;
+        y: number;
+    };
+    /** 3D座標を変換 */
+    vec3d: (basisPos: {
+        x: number;
+        y: number;
+        z: number;
+    }) => {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** 相対幅を実際のピクセル幅に変換 */
+    relativeWidth: (basisWidth: number) => number;
+    /** 相対高さを実際のピクセル高さに変換 */
+    relativeHeight: (basisHeight: number) => number;
+    /** 相対座標を実際のピクセル座標に変換 */
+    relativePos: (basisPos: {
+        x: number;
+        y: number;
+    }) => {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * 画面サイズの型定義
+ */
+export interface ScreenSize {
+    width: number;
+    height: number;
+}
+export declare function useToPixel(): PixelConverter;
+export declare function useScreenSize(): ScreenSize;
+export declare function useScreenScale(): number;
+export declare function useScreenSizeAtom(): [
+    ScreenSize,
+    (size: ScreenSize) => void
+];
+export { OverlayUI } from "./components/OverlayUI";
+export { aspectRatio, BasisHeight, BasisWidth } from "./constants/screen-size";