@featherk/composables 0.13.5 → 0.13.6

package/dist/window/useWindow.d.ts

@@ -1,4 +1,4 @@
-import { type ComponentPublicInstance, type ComputedRef, type Ref } from "vue";
+import { type ComponentPublicInstance, type ComputedRef, type MaybeRefOrGetter, type Ref } from "vue";
 /** Kendo Window's stage values. Distinct from browser fullscreen APIs. */
 export type WindowStage = "DEFAULT" | "MINIMIZED" | "FULLSCREEN";
 export interface WindowMoveEventPayload {
@@ -40,6 +40,8 @@ export interface UseWindowOptions {
      */
     settings?: Partial<WindowSettings> | Ref<Partial<WindowSettings>>;
     initialStage?: WindowStage;
+    /** Enables the native titlebar double-click stage toggle. Defaults to true. */
+    titlebarDoubleClick?: MaybeRefOrGetter<boolean>;
     onMove?: (payload: WindowMoveEventPayload) => void;
     onResize?: (payload: WindowResizeEventPayload) => void;
     onStageChange?: (stage: WindowStage) => void;

package/docs/window/useWindow.md

@@ -63,6 +63,51 @@ A partially-populated ref is fine - any field `myLoadedSettings` doesn't have fa
 
 `open()` respects this: by default it reopens at whatever `left`/`top`/`width`/`height` are already on `settings` (a prior drag/resize, or a value you restored from persistence), rather than recomputing the initial inset position. Pass `open({ resetPosition: true })` to force the Window back to its computed initial position/size instead - see `UseWindowReturn.open` in the API table below.
 
+## Extending Window Behavior
+
+Use the `UseWindowOptions` callbacks when application code needs to react to Window behavior. These callbacks are extension hooks: they run after `useWindow` completes its internal handling, and they do not replace Kendo's event handlers.
+
+This applies to every callback option:
+
+- `onMove` runs after viewport clamping and position updates.
+- `onResize` runs after size/position updates and resize-state tracking.
+- `onStageChange` runs after a valid controlled stage transition.
+- `onOpen` runs after `open()` has shown and sized the Window.
+- `onClose` runs after `close()` has reset the stage and hidden the Window.
+
+For example, use `onMove` and `onResize` when application code needs to observe movement or resizing:
+
+```ts
+const win = useWindow({
+  onMove: (payload) => {
+    console.log("Moved", payload.left, payload.top);
+  },
+  onResize: (payload) => {
+    console.log("Resized", payload.width, payload.height);
+  },
+});
+```
+
+## Titlebar Double-Click
+
+Titlebar double-click stage changes follow normal Windows behavior by default: double-clicking
+the titlebar toggles between `DEFAULT` and `FULLSCREEN`. Set `titlebarDoubleClick: false` to
+disable both transitions. This option is independent of `settings.maximizeButton`; disabling the
+maximize button does not automatically disable titlebar double-click behavior.
+
+Keep binding `v-on="events"` on `<Window>` so viewport clamping, resize tracking, stage handling, and Kendo workarounds remain active:
+
+```vue
+<Window
+  v-if="win.visible.value"
+  ref="windowRef"
+  v-bind="win.props.value"
+  v-on="win.events"
+/>
+```
+
+Do not replace entries on `events` unless you intentionally opt out of the corresponding `useWindow` protections. For most consumers, compose application behavior through the callback options and leave `v-on="events"` intact.
+
 ## API
 
 ### `UseWindowOptions`
@@ -71,6 +116,7 @@ A partially-populated ref is fine - any field `myLoadedSettings` doesn't have fa
 | --------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
 | `settings`      | `Partial<WindowSettings> \| Ref<Partial<WindowSettings>>` | Overrides merged over `WINDOW_SETTINGS_DEFAULTS` internally. Pass a `Ref` for externally-owned/persisted settings. |
 | `initialStage`  | `WindowStage`                                             | Initial `stage` value. Defaults to `"DEFAULT"`.                                                                    |
+| `titlebarDoubleClick` | `MaybeRefOrGetter<boolean>`                         | Enables titlebar double-click stage changes. Defaults to `true`; pass `false` or a reactive ref/getter returning `false` to disable both maximize and restore transitions. |
 | `onMove`        | `(payload) => void`                                       | Called after internal move handling.                                                                               |
 | `onResize`      | `(payload) => void`                                       | Called after internal resize handling.                                                                             |
 | `onStageChange` | `(stage) => void`                                         | Called after a valid stage transition.                                                                             |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@featherk/composables",
-  "version": "0.13.5",
+  "version": "0.13.6",
   "main": "dist/featherk-composables.umd.js",
   "module": "dist/featherk-composables.es.js",
   "types": "dist/index.d.ts",