@notehub.md/cli 0.1.10 → 0.1.11

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@notehub.md/cli",
-    "version": "0.1.10",
+    "version": "0.1.11",
     "description": "CLI tool for building Notehub plugins",
     "type": "module",
     "repository": {

package/templates/PLUGIN_GUIDE.md

@@ -276,19 +276,18 @@ const theme = await ctx.invokeApi<string>('theme:get-current');
 const themes = await ctx.invokeApi<string[]>('theme:list');
 ```
 
-## Editor Widget API
+## Editor Portal API
 
 ```typescript
-// Register widget
-await ctx.invokeApi(
-    'editor:register-widget',
-    'my-plugin:progress-bar',
-    /\[progress:(\d+)\]/g,
-    ProgressBarComponent
-);
+// Register portal (inline widget)
+await ctx.invokeApi('editor:register-portal', {
+    id: 'my-plugin:progress-bar',
+    regex: /\[progress:(\d+)\]/g,
+    component: ProgressBarComponent
+});
 
-// Unregister (optional - auto-cleaned)
-await ctx.invokeApi('editor:unregister-widget', 'my-plugin:progress-bar');
+// Unregister (optional - auto-cleaned on plugin unload)
+await ctx.invokeApi('editor:unregister-portal', 'my-plugin:progress-bar');
 ```
 
 ## Settings API
@@ -407,14 +406,15 @@ const ProgressBar: React.FC<{ match: RegExpExecArray }> = ({ match }) => {
     );
 };
 
+// Plugin
 export default class ProgressBarPlugin extends NotehubPlugin {
     async onload(ctx: PluginContext): Promise<void> {
-        await ctx.invokeApi(
-            'editor:register-widget',
-            'progress-bar',
-            /\[progress:(\d+)\]/g,
-            ProgressBar
-        );
+        // Match: [progress:XX] where XX is a number
+        await ctx.invokeApi('editor:register-portal', {
+            id: 'progress-bar',
+            regex: /\[progress:(\d+)\]/g,
+            component: ProgressBar
+        });
     }
     
     async onunload(): Promise<void> {}
@@ -523,12 +523,11 @@ const WordCounter: React.FC<{ match: RegExpExecArray }> = ({ match }) => {
 };
 
 // Register with pattern: {{count: your text here}}
-await ctx.invokeApi(
-    'editor:register-widget',
-    'word-counter',
-    /\{\{count:\s*(.+?)\}\}/g,
-    WordCounter
-);
+await ctx.invokeApi('editor:register-portal', {
+    id: 'word-counter',
+    regex: /\{\{count:\s*(.+?)\}\}/g,
+    component: WordCounter
+});
 ```
 
 ## Full-Featured Plugin

package/templates/PLUGIN_GUIDE_RU.md

@@ -276,19 +276,18 @@ const theme = await ctx.invokeApi<string>('theme:get-current');
 const themes = await ctx.invokeApi<string[]>('theme:list');
 ```
 
-## Editor Widget API
+## Editor Portal API
 
 ```typescript
-// Регистрация виджета
-await ctx.invokeApi(
-    'editor:register-widget',
-    'my-plugin:progress-bar',
-    /\[progress:(\d+)\]/g,
-    ProgressBarComponent
-);
+// Регистрация портала (инлайн-виджета)
+await ctx.invokeApi('editor:register-portal', {
+    id: 'my-plugin:progress-bar',
+    regex: /\[progress:(\d+)\]/g,
+    component: ProgressBarComponent
+});
 
 // Отмена регистрации (опционально - очищается автоматически)
-await ctx.invokeApi('editor:unregister-widget', 'my-plugin:progress-bar');
+await ctx.invokeApi('editor:unregister-portal', 'my-plugin:progress-bar');
 ```
 
 ## Settings API
@@ -407,14 +406,17 @@ const ProgressBar: React.FC<{ match: RegExpExecArray }> = ({ match }) => {
     );
 };
 
+// Плагин
 export default class ProgressBarPlugin extends NotehubPlugin {
     async onload(ctx: PluginContext): Promise<void> {
-        await ctx.invokeApi(
-            'editor:register-widget',
-            'progress-bar',
-            /\[progress:(\d+)\]/g,
-            ProgressBar
-        );
+        // Совпадение: [progress:XX] где XX — число
+        await ctx.invokeApi('editor:register-portal', {
+            id: 'progress-bar',
+            regex: /\[progress:(\d+)\]/g,
+            component: ProgressBar
+        });
+        
+        await ctx.invokeApi('logger:info', 'ProgressBar', 'Портал зарегистрирован');
     }
     
     async onunload(): Promise<void> {}
@@ -523,12 +525,11 @@ const WordCounter: React.FC<{ match: RegExpExecArray }> = ({ match }) => {
 };
 
 // Регистрация с паттерном: {{count: ваш текст здесь}}
-await ctx.invokeApi(
-    'editor:register-widget',
-    'word-counter',
-    /\{\{count:\s*(.+?)\}\}/g,
-    WordCounter
-);
+await ctx.invokeApi('editor:register-portal', {
+    id: 'word-counter',
+    regex: /\{\{count:\s*(.+?)\}\}/g,
+    component: WordCounter
+});
 ```
 
 ## Полноценный плагин

package/templates/docs/en/04-widgets.md

@@ -14,17 +14,16 @@ View Mode:     [████████░░] 80%     ← Your rendered compon
 Edit Mode:     [progress:80]        ← Source text visible when cursor inside
 ```
 
-## Registering a Widget
+## Registering a Portal
 
-Use the `editor:register-widget` API:
+Use the `editor:register-portal` API:
 
 ```typescript
-await ctx.invokeApi(
-    'editor:register-widget',
-    'unique-id',           // Unique identifier
-    /regex-pattern/g,      // Pattern to match (MUST have global flag 'g')
-    ReactComponent         // Component to render
-);
+await ctx.invokeApi('editor:register-portal', {
+    id: 'unique-id',           // Unique identifier
+    regex: /regex-pattern/g,   // Pattern to match (MUST have global flag 'g')
+    component: ReactComponent  // Component to render
+});
 ```
 
 ## Component Props
@@ -87,18 +86,17 @@ const ProgressBar: React.FC<{ match: RegExpExecArray }> = ({ match }) => {
 export default class ProgressBarPlugin extends NotehubPlugin {
     async onload(ctx: PluginContext): Promise<void> {
         // Match: [progress:XX] where XX is a number
-        await ctx.invokeApi(
-            'editor:register-widget',
-            'progress-bar',
-            /\[progress:(\d+)\]/g,
-            ProgressBar
-        );
+        await ctx.invokeApi('editor:register-portal', {
+            id: 'progress-bar',
+            regex: /\[progress:(\d+)\]/g,
+            component: ProgressBar
+        });
         
-        await ctx.invokeApi('logger:info', 'ProgressBar', 'Widget registered');
+        await ctx.invokeApi('logger:info', 'ProgressBar', 'Portal registered');
     }
     
     async onunload(): Promise<void> {
-        // Widget is automatically unregistered!
+        // Portal is automatically unregistered!
     }
 }
 ```
@@ -142,12 +140,11 @@ const ButtonWidget: React.FC<{ match: RegExpExecArray }> = ({ match }) => {
 };
 
 // Register
-await ctx.invokeApi(
-    'editor:register-widget',
-    'btn-widget',
-    /\[btn:([^\]:]+):([^\]]+)\]/g,
-    ButtonWidget
-);
+await ctx.invokeApi('editor:register-portal', {
+    id: 'btn-widget',
+    regex: /\[btn:([^\]:]+):([^\]]+)\]/g,
+    component: ButtonWidget
+});
 ```
 
 **Usage:**
@@ -185,12 +182,11 @@ const StatusBadge: React.FC<{ match: RegExpExecArray }> = ({ match }) => {
     );
 };
 
-await ctx.invokeApi(
-    'editor:register-widget',
-    'status-badge',
-    /\[status:([^\]]+)\]/g,
-    StatusBadge
-);
+await ctx.invokeApi('editor:register-portal', {
+    id: 'status-badge',
+    regex: /\[status:([^\]]+)\]/g,
+    component: StatusBadge
+});
 ```
 
 **Usage:**
@@ -305,12 +301,12 @@ onClick={(e) => {
 
 ## Unregistering Widgets
 
-Widgets are **automatically unregistered** when your plugin unloads.
+Portals are **automatically unregistered** when your plugin unloads.
 
 For manual unregistration:
 
 ```typescript
-await ctx.invokeApi('editor:unregister-widget', 'my-widget-id');
+await ctx.invokeApi('editor:unregister-portal', 'my-portal-id');
 ```
 
 ---

package/templates/docs/ru/04-widgets.md

@@ -14,17 +14,16 @@
 Режим редактирования: [progress:80]   ← Исходный текст виден когда курсор внутри
 ```
 
-## Регистрация виджета
+## Регистрация портала
 
-Используйте API `editor:register-widget`:
+Используйте API `editor:register-portal`:
 
 ```typescript
-await ctx.invokeApi(
-    'editor:register-widget',
-    'unique-id',           // Уникальный идентификатор
-    /regex-pattern/g,      // Паттерн для поиска (ДОЛЖЕН иметь флаг 'g')
-    ReactComponent         // Компонент для рендеринга
-);
+await ctx.invokeApi('editor:register-portal', {
+    id: 'unique-id',           // Уникальный идентификатор
+    regex: /regex-pattern/g,   // Паттерн для поиска (ДОЛЖЕН иметь флаг 'g')
+    component: ReactComponent  // Компонент для рендеринга
+});
 ```
 
 ## Пропсы компонента
@@ -87,18 +86,17 @@ const ProgressBar: React.FC<{ match: RegExpExecArray }> = ({ match }) => {
 export default class ProgressBarPlugin extends NotehubPlugin {
     async onload(ctx: PluginContext): Promise<void> {
         // Совпадение: [progress:XX] где XX — число
-        await ctx.invokeApi(
-            'editor:register-widget',
-            'progress-bar',
-            /\[progress:(\d+)\]/g,
-            ProgressBar
-        );
+        await ctx.invokeApi('editor:register-portal', {
+            id: 'progress-bar',
+            regex: /\[progress:(\d+)\]/g,
+            component: ProgressBar
+        });
         
-        await ctx.invokeApi('logger:info', 'ProgressBar', 'Виджет зарегистрирован');
+        await ctx.invokeApi('logger:info', 'ProgressBar', 'Портал зарегистрирован');
     }
     
     async onunload(): Promise<void> {
-        // Виджет автоматически отменяет регистрацию!
+        // Портал автоматически отменяет регистрацию!
     }
 }
 ```
@@ -140,12 +138,11 @@ const ButtonWidget: React.FC<{ match: RegExpExecArray }> = ({ match }) => {
 };
 
 // Регистрация
-await ctx.invokeApi(
-    'editor:register-widget',
-    'btn-widget',
-    /\[btn:([^\]:]+):([^\]]+)\]/g,
-    ButtonWidget
-);
+await ctx.invokeApi('editor:register-portal', {
+    id: 'btn-widget',
+    regex: /\[btn:([^\]:]+):([^\]]+)\]/g,
+    component: ButtonWidget
+});
 ```
 
 **Использование:**
@@ -183,12 +180,11 @@ const StatusBadge: React.FC<{ match: RegExpExecArray }> = ({ match }) => {
     );
 };
 
-await ctx.invokeApi(
-    'editor:register-widget',
-    'status-badge',
-    /\[status:([^\]]+)\]/g,
-    StatusBadge
-);
+await ctx.invokeApi('editor:register-portal', {
+    id: 'status-badge',
+    regex: /\[status:([^\]]+)\]/g,
+    component: StatusBadge
+});
 ```
 
 **Использование:**
@@ -276,12 +272,12 @@ style={{
 
 ## Отмена регистрации виджетов
 
-Виджеты **автоматически отменяют регистрацию** при выгрузке вашего плагина.
+Порталы **автоматически отменяют регистрацию** при выгрузке вашего плагина.
 
 Для ручной отмены:
 
 ```typescript
-await ctx.invokeApi('editor:unregister-widget', 'my-widget-id');
+await ctx.invokeApi('editor:unregister-portal', 'my-portal-id');
 ```
 
 ---