@kungal/editor-nuxt 0.19.0 → 0.20.0

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @kungal/editor-nuxt
 
+## 0.20.0
+
+### Minor Changes
+
+- 62e14f5: Split view: sync scrolling between the panes, with an off switch.
+
+  Scrolling the markdown source pane now scrolls the WYSIWYG preview to the same
+  position (and vice-versa) — proportional/percentage sync (source↔preview line
+  mapping is impractical across two separate renderers), with an active-pane +
+  idle-timeout guard so the echoed scroll doesn't feed back into a loop.
+
+  Turn it off two ways (for downstream customization):
+
+  - **`scrollSync` prop** on `<KunEditor>` (default `true`) — pass
+    `:scroll-sync="false"` to disable entirely.
+  - **A runtime toggle** in the view switch: `KunEditorViewSwitchApi` gains
+    `scrollSync` / `toggleScrollSync()` (+ `labels.scrollSync`). The default view
+    switch shows a 同步滚动 toggle in split mode; `<KunEditorViewSwitch>` (editor-nuxt)
+    shows a KunUI link/unlink toggle button. Or replace the whole control via the
+    `#view-switch` slot.
+
+  Sync needs each pane to scroll internally, so the reference `kun-editor.css` now
+  gives split panes a bounded height (`--kun-editor-split-height`, default `60vh`,
+  overridable) with `overflow: auto`. editor-vue still ships zero CSS.
+
+  Verified in the docs production build (headless + KunUI view switches): with the
+  panes overflowing, scrolling the source drives the preview to the same ratio;
+  toggling off makes them scroll independently; toggling on resumes; 0 console
+  errors.
+
+### Patch Changes
+
+- Updated dependencies [62e14f5]
+  - @kungal/editor-vue@0.20.0
+  - @kungal/editor-core@0.20.0
+
 ## 0.19.0
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kungal/editor-nuxt",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "KunEditor Nuxt Layer — wraps @kungal/editor-vue and auto-imports <KunEditor> so an existing Nuxt app keeps its exact DX (no import needed).",
   "type": "module",
   "keywords": [
@@ -31,8 +31,8 @@
     "nuxt.config.ts"
   ],
   "dependencies": {
-    "@kungal/editor-core": "0.19.0",
-    "@kungal/editor-vue": "0.19.0"
+    "@kungal/editor-core": "0.20.0",
+    "@kungal/editor-vue": "0.20.0"
   },
   "peerDependencies": {
     "@kungal/ui-vue": "^2.7.0",

package/runtime/KunEditorViewSwitch.vue

@@ -38,15 +38,27 @@ const onChange = (value: string) => {
       size="sm"
       @update:model-value="onChange"
     />
-    <KunButton
-      v-if="mode === 'split'"
-      variant="light"
-      size="sm"
-      :is-icon-only="true"
-      :aria-label="labels.swap"
-      @click="swap()"
-    >
-      <KunIcon name="lucide:arrow-left-right" />
-    </KunButton>
+    <template v-if="mode === 'split'">
+      <KunButton
+        variant="light"
+        size="sm"
+        :is-icon-only="true"
+        :aria-label="labels.swap"
+        @click="swap()"
+      >
+        <KunIcon name="lucide:arrow-left-right" />
+      </KunButton>
+      <KunButton
+        :variant="scrollSync ? 'flat' : 'light'"
+        :color="scrollSync ? 'primary' : 'default'"
+        size="sm"
+        :is-icon-only="true"
+        :aria-label="labels.scrollSync"
+        :aria-pressed="scrollSync"
+        @click="toggleScrollSync()"
+      >
+        <KunIcon :name="scrollSync ? 'lucide:link' : 'lucide:unlink'" />
+      </KunButton>
+    </template>
   </div>
 </template>