@aeriz/wysiwyg 1.0.2 → 1.0.4

package/dist-types/adapters/jquery.d.ts

@@ -0,0 +1,34 @@
+/**
+ * jQuery 플러그인 어댑터.
+ *
+ * `jquery` 를 import 하지 않는다. 전역 `jQuery` 가 있으면 로드 시점에 자동
+ * 등록하고, 모듈 번들 환경에서는 `registerAerizJQuery($)` 로 명시 등록한다.
+ * 덕분에 jQuery 타입 패키지(`@types/jquery`) 없이도 타입이 성립한다.
+ *
+ * @example
+ *   <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
+ *   <script src="/aeriz-wysiwyg.min.js"></script>
+ *   <script src="/adapters/jquery.js"></script>
+ *   <script>
+ *     $('#editor').aerizEditor({ value: '<p>안녕하세요</p>',
+ *                                onChange: (html) => console.log(html) });
+ *     const html = $('#editor').aerizEditor('getHTML');
+ *     $('#editor').aerizEditor('destroy');
+ *   </script>
+ */
+import type { AerizEditor, AerizViewer } from '@aeriz/wysiwyg';
+import type { AerizEditorProps, AerizViewerProps } from './shared.js';
+/** `$.fn` 을 가진 jQuery 정적 객체의 최소 형태. */
+export interface JQueryLike {
+    fn: Record<string, unknown>;
+}
+/** 문자열 명령 없이 호출했을 때 초기화에 쓰이는 옵션. */
+export type AerizEditorPluginOptions = AerizEditorProps;
+export type AerizViewerPluginOptions = AerizViewerProps;
+/**
+ * `$.fn.aerizEditor` / `$.fn.aerizViewer` 를 등록한다.
+ * 이미 등록돼 있으면 아무것도 하지 않으므로 여러 번 불러도 안전하다.
+ */
+export declare function registerAerizJQuery($: JQueryLike): void;
+export type { AerizEditor, AerizViewer, AerizEditorProps, AerizViewerProps };
+//# sourceMappingURL=jquery.d.ts.map

package/dist-types/adapters/jquery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jquery.d.ts","sourceRoot":"","sources":["../../src/adapters/jquery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAEV,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAUlB,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B;AAED,oCAAoC;AACpC,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AACxD,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AA+HxD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI,CAMvD;AAQD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC"}

package/dist-types/adapters/react.d.ts

@@ -0,0 +1,28 @@
+import type { CSSProperties } from 'react';
+import type { AerizEditor as AerizEditorCore, AerizViewer as AerizViewerCore } from '@aeriz/wysiwyg';
+import type { AerizEditorProps, AerizViewerProps } from './shared.js';
+/** 컨테이너 `<div>` 에 직접 전달되는 표현용 prop. */
+interface HostProps {
+    className?: string;
+    style?: CSSProperties;
+    id?: string;
+}
+export interface AerizEditorReactProps extends AerizEditorProps, HostProps {
+}
+export interface AerizViewerReactProps extends AerizViewerProps, HostProps {
+}
+/** `ref` 로 노출되는 명령형 핸들. */
+export interface AerizEditorHandle {
+    /** 코어 인스턴스. `getHTML()` / `setBlockType()` 등 전체 API 접근용. */
+    readonly editor: AerizEditorCore | null;
+    getHTML(): string;
+    setHTML(html: string): void;
+    focus(): void;
+}
+export interface AerizViewerHandle {
+    readonly viewer: AerizViewerCore | null;
+}
+export declare const AerizEditor: import("react").ForwardRefExoticComponent<AerizEditorReactProps & import("react").RefAttributes<AerizEditorHandle>>;
+export declare const AerizViewer: import("react").ForwardRefExoticComponent<AerizViewerReactProps & import("react").RefAttributes<AerizViewerHandle>>;
+export type { AerizEditorProps, AerizViewerProps } from './shared.js';
+//# sourceMappingURL=react.d.ts.map

package/dist-types/adapters/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/adapters/react.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,aAAa,EAAmC,MAAM,OAAO,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,IAAI,eAAe,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACrG,OAAO,KAAK,EAEV,gBAAgB,EAEhB,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAGlB,uCAAuC;AACvC,UAAU,SAAS;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB,EAAE,SAAS;CAAG;AAC7E,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB,EAAE,SAAS;CAAG;AAE7E,2BAA2B;AAC3B,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,OAAO,IAAI,MAAM,CAAC;IAClB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CACzC;AA+FD,eAAO,MAAM,WAAW,qHAA8B,CAAC;AAGvD,eAAO,MAAM,WAAW,qHAA8B,CAAC;AAGvD,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist-types/adapters/shared.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 프레임워크 어댑터 공통 코어.
+ *
+ * React / Vue / Svelte / Angular / jQuery / Web Component 어댑터는 모두 이
+ * 모듈의 컨트롤러 위에 얇게 올라간다. 각 프레임워크가 다르게 처리해야 하는
+ * 것은 "언제 update() 를 부르고 언제 destroy() 를 부르는가" 뿐이고,
+ * 값 바인딩 · 캐럿 보존 · 재생성 판단 같은 실제 로직은 여기 한 곳에만 있다.
+ *
+ * 핵심 규칙 두 가지:
+ *
+ * 1. **캐럿 보존** — 외부에서 들어온 `value` 가 에디터의 현재 출력과 같으면
+ *    `setHTML()` 을 부르지 않는다. 부르면 DOM 이 통째로 교체되어 캐럿이 문서
+ *    맨 앞으로 튀고, 한국어 조합 중 입력이 끊긴다.
+ * 2. **되울림 차단** — 프로그램적 `setHTML()` 이 만든 변경은 `onChange` 로
+ *    다시 내보내지 않는다. 부모의 상태 갱신이 다시 prop 으로 내려와 무한 왕복이
+ *    되는 경로를 원천 차단한다.
+ */
+import { AerizEditor, AerizViewer } from '@aeriz/wysiwyg';
+import type { BlockSnapshot, EditorOptions, EditorState, ViewerOptions } from '@aeriz/wysiwyg';
+/**
+ * 모든 어댑터가 공유하는 에디터 prop 집합.
+ *
+ * `EditorOptions` 에서 프레임워크가 스스로 관리하는 두 항목만 뺀 것이다.
+ * - `element` — 어댑터가 마운트 노드를 직접 만든다.
+ * - `onChange` — 컨트롤러가 감싼 뒤 최신 콜백으로 위임한다.
+ */
+export interface AerizEditorProps extends Omit<EditorOptions, 'element' | 'onChange'> {
+    /**
+     * 양방향 바인딩용 HTML. 지정하면 `initialHTML` 보다 우선한다.
+     * 값이 에디터의 현재 출력과 다를 때만 본문이 교체된다.
+     */
+    value?: string;
+    /** 사용자 편집으로 본문이 바뀔 때 호출. 프로그램적 설정에서는 호출되지 않는다. */
+    onChange?: (html: string) => void;
+    /** 블록/선택 상태가 바뀔 때 호출. 커스텀 툴바를 만들 때 쓴다. */
+    onStateChange?: (state: EditorState) => void;
+    /** 인스턴스가 만들어진 직후 1회 호출. 명령형 API 접근 경로. */
+    onReady?: (editor: AerizEditor) => void;
+    /** 인스턴스가 파괴되기 직전 1회 호출. */
+    onDestroy?: (editor: AerizEditor) => void;
+}
+/** 뷰어 어댑터 공통 prop. */
+export interface AerizViewerProps extends Omit<ViewerOptions, 'element'> {
+    /** 표시할 블록 상태. `html` 보다 우선한다. */
+    blocks?: BlockSnapshot[];
+    /** 블록 대신 HTML 문자열로 넣을 때 사용. 내부에서 블록으로 변환된다. */
+    html?: string;
+    onReady?: (viewer: AerizViewer) => void;
+    onDestroy?: (viewer: AerizViewer) => void;
+}
+export interface AerizEditorController {
+    /**
+     * 현재 에디터 인스턴스. 재생성(`toolbar`/`locale` 변경) 시 교체되므로
+     * 장기 보관하지 말고 매번 읽어야 한다.
+     */
+    readonly editor: AerizEditor;
+    /** 새 prop 을 반영한다. 바뀐 항목만 최소 비용으로 적용된다. */
+    update(next: AerizEditorProps): void;
+    destroy(): void;
+}
+export interface AerizViewerController {
+    readonly viewer: AerizViewer;
+    update(next: AerizViewerProps): void;
+    destroy(): void;
+}
+/**
+ * HTML 문자열을 `BlockSnapshot[]` 로 변환한다.
+ *
+ * `AerizViewer` 는 상태 모델만 받으므로, HTML 을 들고 있는 호출자를 위한
+ * 다리 역할을 한다. 에디터 본문과 같은 정규화 경로(`normalizeContent` →
+ * `listBlocks` → `serializeBlocks`) 를 타므로 결과 트리도 동일하다.
+ */
+export declare function htmlToBlocks(html: string): BlockSnapshot[];
+/**
+ * 프레임워크 중립 에디터 컨트롤러를 만든다.
+ *
+ * `host` 안에 에디터를 마운트한다. `host` 의 기존 자식은
+ * `AerizEditor` 생성자가 비운다.
+ */
+export declare function createEditorController(host: HTMLElement, initialProps: AerizEditorProps): AerizEditorController;
+/** 프레임워크 중립 뷰어 컨트롤러를 만든다. */
+export declare function createViewerController(host: HTMLElement, initialProps: AerizViewerProps): AerizViewerController;
+//# sourceMappingURL=shared.d.ts.map

package/dist-types/adapters/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,WAAW,EACX,WAAW,EAMZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,aAAa,EACd,MAAM,gBAAgB,CAAC;AAExB;;;;;;GAMG;AACH,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,UAAU,CAAC;IACnD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,0CAA0C;IAC1C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,0CAA0C;IAC1C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,2BAA2B;IAC3B,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AAED,sBAAsB;AACtB,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC;IACtE,iCAAiC;IACjC,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,0CAA0C;IAC1C,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAS1D;AA4CD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,gBAAgB,GAC7B,qBAAqB,CA2HvB;AAgBD,6BAA6B;AAC7B,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,WAAW,EACjB,YAAY,EAAE,gBAAgB,GAC7B,qBAAqB,CAwCvB"}

package/dist-types/adapters/svelte.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Svelte 어댑터. Svelte 3 / 4 / 5 에서 동일하게 동작한다.
+ *
+ * `.svelte` 컴포넌트가 아니라 **액션**(`use:`) 으로 제공한다. 컴파일된 Svelte
+ * 컴포넌트는 메이저 버전 간 런타임 계약이 달라(특히 4 → 5) 배포본 하나로 세
+ * 버전을 만족시킬 수 없지만, 액션은 순수 함수 계약이라 전부 통과한다.
+ *
+ * @example
+ *   <script>
+ *     import { aerizEditor } from '@aeriz/wysiwyg/svelte';
+ *     import '@aeriz/wysiwyg/style.css';
+ *     let html = '<p>안녕하세요</p>';
+ *   </script>
+ *
+ *   <div use:aerizEditor={{ value: html, onChange: (v) => (html = v), theme: 'dark' }} />
+ */
+import type { AerizEditorProps, AerizViewerProps } from './shared.js';
+/**
+ * Svelte 액션의 반환 계약. `svelte/action` 의 `ActionReturn` 과 구조적으로
+ * 같지만, `svelte` 를 import 하지 않기 위해 여기서 직접 선언한다.
+ */
+export interface AerizAction<P> {
+    update(next: P): void;
+    destroy(): void;
+}
+/**
+ * 에디터를 노드에 마운트하는 액션.
+ *
+ * 파라미터가 바뀌면 Svelte 가 `update` 를 호출하고, 컨트롤러가 바뀐 항목만
+ * 반영한다. `value` 가 에디터 현재 출력과 같으면 본문을 건드리지 않으므로
+ * `onChange` 로 받은 값을 그대로 되돌려줘도 캐럿이 튀지 않는다.
+ */
+export declare function aerizEditor(node: HTMLElement, props?: AerizEditorProps): AerizAction<AerizEditorProps>;
+/** 읽기 전용 뷰어를 노드에 마운트하는 액션. */
+export declare function aerizViewer(node: HTMLElement, props?: AerizViewerProps): AerizAction<AerizViewerProps>;
+export type { AerizEditorProps, AerizViewerProps } from './shared.js';
+export { createEditorController, createViewerController } from './shared.js';
+//# sourceMappingURL=svelte.d.ts.map

package/dist-types/adapters/svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte.d.ts","sourceRoot":"","sources":["../../src/adapters/svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGnE;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,WAAW,EACjB,KAAK,GAAE,gBAAqB,GAC3B,WAAW,CAAC,gBAAgB,CAAC,CAU/B;AAED,8BAA8B;AAC9B,wBAAgB,WAAW,CACzB,IAAI,EAAE,WAAW,EACjB,KAAK,GAAE,gBAAqB,GAC3B,WAAW,CAAC,gBAAgB,CAAC,CAU/B;AAED,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC"}

package/dist-types/adapters/vue.d.ts

@@ -0,0 +1,189 @@
+import type { PropType } from 'vue';
+import type { AerizEditor as AerizEditorCore, AerizViewer as AerizViewerCore, BlockSnapshot, EditorState, ToolbarConfig } from '@aeriz/wysiwyg';
+type Theme = 'light' | 'dark';
+type Locale = 'en' | 'ko' | 'ja' | 'zh';
+type HtmlStyles = 'inline' | 'class';
+type UploadFn = (file: File) => Promise<string>;
+export declare const AerizEditor: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** `v-model` 바인딩 값 (HTML). */
+    modelValue: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /** `v-model` 없이 초기값만 줄 때 사용. */
+    initialHTML: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    placeholder: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /** `false` 면 툴바를 렌더하지 않는다. */
+    toolbar: {
+        type: PropType<ToolbarConfig | false>;
+        default: undefined;
+    };
+    theme: {
+        type: PropType<Theme>;
+        default: undefined;
+    };
+    locale: {
+        type: PropType<Locale>;
+        default: undefined;
+    };
+    /** `getHTML()` · `onChange` 출력 전략. 기본 `'inline'`. */
+    htmlStyles: {
+        type: PropType<HtmlStyles>;
+        default: undefined;
+    };
+    onImageUpload: {
+        type: PropType<UploadFn>;
+        default: undefined;
+    };
+    imageUploadUrl: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    onFileUpload: {
+        type: PropType<UploadFn>;
+        default: undefined;
+    };
+    fileUploadUrl: {
+        type: StringConstructor;
+        default: undefined;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    'update:modelValue': (html: string) => boolean;
+    change: (html: string) => boolean;
+    'state-change': (_state: EditorState) => true;
+    ready: (_editor: AerizEditorCore) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** `v-model` 바인딩 값 (HTML). */
+    modelValue: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /** `v-model` 없이 초기값만 줄 때 사용. */
+    initialHTML: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    placeholder: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    /** `false` 면 툴바를 렌더하지 않는다. */
+    toolbar: {
+        type: PropType<ToolbarConfig | false>;
+        default: undefined;
+    };
+    theme: {
+        type: PropType<Theme>;
+        default: undefined;
+    };
+    locale: {
+        type: PropType<Locale>;
+        default: undefined;
+    };
+    /** `getHTML()` · `onChange` 출력 전략. 기본 `'inline'`. */
+    htmlStyles: {
+        type: PropType<HtmlStyles>;
+        default: undefined;
+    };
+    onImageUpload: {
+        type: PropType<UploadFn>;
+        default: undefined;
+    };
+    imageUploadUrl: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    onFileUpload: {
+        type: PropType<UploadFn>;
+        default: undefined;
+    };
+    fileUploadUrl: {
+        type: StringConstructor;
+        default: undefined;
+    };
+}>> & Readonly<{
+    onChange?: (html: string) => any;
+    "onUpdate:modelValue"?: (html: string) => any;
+    "onState-change"?: (_state: EditorState) => any;
+    onReady?: (_editor: AerizEditorCore) => any;
+}>, {
+    toolbar: false | ToolbarConfig;
+    theme: Theme;
+    placeholder: string;
+    initialHTML: string;
+    locale: Locale;
+    htmlStyles: HtmlStyles;
+    onImageUpload: UploadFn;
+    imageUploadUrl: string;
+    onFileUpload: UploadFn;
+    fileUploadUrl: string;
+    modelValue: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const AerizViewer: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** 표시할 블록 상태. `html` 보다 우선한다. */
+    blocks: {
+        type: PropType<BlockSnapshot[]>;
+        default: undefined;
+    };
+    /** 블록 대신 HTML 문자열을 넣을 때 사용. */
+    html: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    theme: {
+        type: PropType<Theme>;
+        default: undefined;
+    };
+    /** `getHTML()` 출력 전략. 기본 `'inline'`. */
+    htmlStyles: {
+        type: PropType<HtmlStyles>;
+        default: undefined;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    ready: (_viewer: AerizViewerCore) => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** 표시할 블록 상태. `html` 보다 우선한다. */
+    blocks: {
+        type: PropType<BlockSnapshot[]>;
+        default: undefined;
+    };
+    /** 블록 대신 HTML 문자열을 넣을 때 사용. */
+    html: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    theme: {
+        type: PropType<Theme>;
+        default: undefined;
+    };
+    /** `getHTML()` 출력 전략. 기본 `'inline'`. */
+    htmlStyles: {
+        type: PropType<HtmlStyles>;
+        default: undefined;
+    };
+}>> & Readonly<{
+    onReady?: (_viewer: AerizViewerCore) => any;
+}>, {
+    html: string;
+    theme: Theme;
+    htmlStyles: HtmlStyles;
+    blocks: BlockSnapshot[];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** `app.use(AerizWysiwygPlugin)` 로 두 컴포넌트를 전역 등록한다. */
+export declare const AerizWysiwygPlugin: {
+    install(app: {
+        component(name: string, def: unknown): unknown;
+    }): void;
+};
+export type { AerizEditorProps, AerizViewerProps } from './shared.js';
+//# sourceMappingURL=vue.d.ts.map

package/dist-types/adapters/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/adapters/vue.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,KAAK,EACV,WAAW,IAAI,eAAe,EAC9B,WAAW,IAAI,eAAe,EAC9B,aAAa,EACb,WAAW,EACX,aAAa,EACd,MAAM,gBAAgB,CAAC;AASxB,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAC9B,KAAK,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AACxC,KAAK,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AACrC,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEhD,eAAO,MAAM,WAAW;IAIpB,8BAA8B;;;;;IAE9B,gCAAgC;;;;;;;;;IAGhC,8BAA8B;;cAED,QAAQ,CAAC,aAAa,GAAG,KAAK,CAAC;;;;cAGnC,QAAQ,CAAC,KAAK,CAAC;;;;cACd,QAAQ,CAAC,MAAM,CAAC;;;IAC1C,qDAAqD;;cACvB,QAAQ,CAAC,UAAU,CAAC;;;;cACf,QAAQ,CAAC,QAAQ,CAAC;;;;;;;;cAEnB,QAAQ,CAAC,QAAQ,CAAC;;;;;;;;;;gCAKxB,MAAM;mBACnB,MAAM;6BACI,WAAW;qBACnB,eAAe;;IAxBhC,8BAA8B;;;;;IAE9B,gCAAgC;;;;;;;;;IAGhC,8BAA8B;;cAED,QAAQ,CAAC,aAAa,GAAG,KAAK,CAAC;;;;cAGnC,QAAQ,CAAC,KAAK,CAAC;;;;cACd,QAAQ,CAAC,MAAM,CAAC;;;IAC1C,qDAAqD;;cACvB,QAAQ,CAAC,UAAU,CAAC;;;;cACf,QAAQ,CAAC,QAAQ,CAAC;;;;;;;;cAEnB,QAAQ,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;4EAuEtD,CAAC;AAEH,eAAO,MAAM,WAAW;IAIpB,iCAAiC;;cAEhB,QAAQ,CAAC,aAAa,EAAE,CAAC;;;IAG1C,+BAA+B;;;;;;cAEN,QAAQ,CAAC,KAAK,CAAC;;;IACxC,wCAAwC;;cACV,QAAQ,CAAC,UAAU,CAAC;;;;;;qBAIjC,eAAe;;IAbhC,iCAAiC;;cAEhB,QAAQ,CAAC,aAAa,EAAE,CAAC;;;IAG1C,+BAA+B;;;;;;cAEN,QAAQ,CAAC,KAAK,CAAC;;;IACxC,wCAAwC;;cACV,QAAQ,CAAC,UAAU,CAAC;;;;;;;;;;4EA8CpD,CAAC;AAEH,uDAAuD;AACvD,eAAO,MAAM,kBAAkB;iBAChB;QAAE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI;CAIvE,CAAC;AAEF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist-types/adapters/vue2.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Vue 2 어댑터 (2.6 / 2.7). `v-model` 을 그대로 지원한다.
+ *
+ * Vue 2 컴포넌트는 순수 옵션 객체이므로 이 모듈은 `vue` 를 import 하지
+ * **않는다**. 따라서 Vue 3 를 devDependency 로 가진 이 저장소에서도 Vue 2 용
+ * 산출물을 정확히 만들 수 있고, 소비자 쪽 Vue 2 버전과의 이중 인스턴스 문제도
+ * 생기지 않는다.
+ *
+ * Vue 2 관례에 따라 `v-model` 은 `value` prop + `input` 이벤트를 쓴다.
+ *
+ * @example
+ *   import { AerizEditor } from '@aeriz/wysiwyg/vue2';
+ *   import '@aeriz/wysiwyg/style.css';
+ *
+ *   export default {
+ *     components: { AerizEditor },
+ *     data: () => ({ html: '<p>안녕하세요</p>' }),
+ *     template: '<AerizEditor v-model="html" theme="dark" />',
+ *   };
+ */
+import type { AerizEditor as AerizEditorCore, AerizViewer as AerizViewerCore, BlockSnapshot, ToolbarConfig } from '@aeriz/wysiwyg';
+import type { AerizEditorController, AerizEditorProps, AerizViewerController, AerizViewerProps } from './shared.js';
+type Theme = 'light' | 'dark';
+type Locale = 'en' | 'ko' | 'ja' | 'zh';
+type HtmlStyles = 'inline' | 'class';
+type UploadFn = (file: File) => Promise<string>;
+/**
+ * Vue 2 런타임이 컴포넌트 메서드에 주입하는 `this` 의 최소 형태.
+ *
+ * `vue` 패키지를 참조하지 않기 위해 필요한 멤버만 구조적으로 선언한다.
+ * Vue 2 인스턴스는 이 멤버들을 모두 갖고 있으므로 호환된다.
+ */
+interface Vue2Host<P> {
+    $el: HTMLElement;
+    $props: P;
+    $emit(event: string, ...args: unknown[]): void;
+    $watch(getter: () => unknown, cb: () => void, options?: {
+        deep?: boolean;
+        immediate?: boolean;
+    }): () => void;
+}
+/** Vue 2 의 `createElement` (render 함수 인자 `h`) 최소 형태. */
+type CreateElement = (tag: string) => unknown;
+interface EditorProps {
+    value?: string;
+    initialHTML?: string;
+    placeholder?: string;
+    toolbar?: ToolbarConfig | false;
+    theme?: Theme;
+    locale?: Locale;
+    htmlStyles?: HtmlStyles;
+    onImageUpload?: UploadFn;
+    imageUploadUrl?: string;
+    onFileUpload?: UploadFn;
+    fileUploadUrl?: string;
+}
+interface EditorHost extends Vue2Host<EditorProps> {
+    aerizController: AerizEditorController | null;
+    aerizProps(): AerizEditorProps;
+}
+interface ViewerProps {
+    blocks?: BlockSnapshot[];
+    html?: string;
+    theme?: Theme;
+    htmlStyles?: HtmlStyles;
+}
+interface ViewerHost extends Vue2Host<ViewerProps> {
+    aerizController: AerizViewerController | null;
+    aerizProps(): AerizViewerProps;
+}
+export declare const AerizEditor: {
+    name: string;
+    props: {
+        /** `v-model` 바인딩 값 (HTML). */
+        value: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        initialHTML: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        placeholder: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        toolbar: {
+            type: (ObjectConstructor | BooleanConstructor)[];
+            default: undefined;
+        };
+        theme: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        locale: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        /** `getHTML()` · `onChange` 출력 전략. 기본 `'inline'`. */
+        htmlStyles: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        onImageUpload: {
+            type: FunctionConstructor;
+            default: undefined;
+        };
+        imageUploadUrl: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        onFileUpload: {
+            type: FunctionConstructor;
+            default: undefined;
+        };
+        fileUploadUrl: {
+            type: StringConstructor;
+            default: undefined;
+        };
+    };
+    data(): {
+        aerizController: AerizEditorController | null;
+    };
+    methods: {
+        aerizProps(this: EditorHost): AerizEditorProps;
+        /** 코어 인스턴스. `this.$refs.editor.getEditor()` 로 접근한다. */
+        getEditor(this: EditorHost): AerizEditorCore | null;
+        getHTML(this: EditorHost): string;
+        setHTML(this: EditorHost, html: string): void;
+        focus(this: EditorHost): void;
+    };
+    mounted(this: EditorHost): void;
+    beforeDestroy(this: EditorHost): void;
+    render(this: EditorHost, h: CreateElement): unknown;
+};
+export declare const AerizViewer: {
+    name: string;
+    props: {
+        blocks: {
+            type: ArrayConstructor;
+            default: undefined;
+        };
+        html: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        theme: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        /** `getHTML()` 출력 전략. 기본 `'inline'`. */
+        htmlStyles: {
+            type: StringConstructor;
+            default: undefined;
+        };
+    };
+    data(): {
+        aerizController: AerizViewerController | null;
+    };
+    methods: {
+        aerizProps(this: ViewerHost): AerizViewerProps;
+        getViewer(this: ViewerHost): AerizViewerCore | null;
+    };
+    mounted(this: ViewerHost): void;
+    beforeDestroy(this: ViewerHost): void;
+    render(this: ViewerHost, h: CreateElement): unknown;
+};
+/** `Vue.use(AerizWysiwygPlugin)` 로 두 컴포넌트를 전역 등록한다. */
+export declare const AerizWysiwygPlugin: {
+    install(Vue: {
+        component(name: string, def: unknown): unknown;
+    }): void;
+};
+export type { AerizEditorProps, AerizViewerProps } from './shared.js';
+//# sourceMappingURL=vue2.d.ts.map

package/dist-types/adapters/vue2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue2.d.ts","sourceRoot":"","sources":["../../src/adapters/vue2.ts"],"names":[],"mappings":"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"}