@shenora/react 0.15.0 → 0.16.0

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export { createShenoraStore, type ShenoraStore, type ShenoraStoreOptions, type S
 export { BaseModuleService } from './moduleService.js';
 export { IpcRequestStates, IpcRequestEventTypes, IpcRequestRoutes, IpcRequestsModuleName, createRequestsStore, useShenoraRequests, type IpcRequestState, type IpcLabel, type IpcProgress, type IpcRequestStatus, type RequestsState, type RequestsActions, type RequestsStoreOptions, } from './requests.js';
 export { WindowCommands, useWindowMaximized, type WindowResizeEdge, type CaptionButtonKind, type CaptionButtonRect, } from './windowCommands.js';
+export { WindowOrientation, type WindowOrientationKind, } from './windowOrientation.js';
 export { useDropZone, DROP_ZONE_MODULE, type DropZoneFileDrop, type UseDropZoneOptions, } from './useDropZone.js';
 export { useShenora, useShenoraEvent, useShenoraQuery, useShellInfo, type ShenoraQueryResult, } from './hooks.js';
 export { FileDialogs, useFileDialogs, type FileDialogFilter, type FileDialogOptions, type OpenFileOptions, type OpenFolderOptions, type SaveFileOptions, type FileDialogResult, type FileDialogsHandle, } from './fileDialogs.js';

package/dist/index.js

@@ -14,6 +14,7 @@ export { IpcRequestStates,
 // request without `useShenoraRequests` never types the wire literals by hand.
 IpcRequestEventTypes, IpcRequestRoutes, IpcRequestsModuleName, createRequestsStore, useShenoraRequests, } from './requests.js';
 export { WindowCommands, useWindowMaximized, } from './windowCommands.js';
+export { WindowOrientation, } from './windowOrientation.js';
 export { useDropZone, DROP_ZONE_MODULE, } from './useDropZone.js';
 export { useShenora, useShenoraEvent, useShenoraQuery, useShellInfo, } from './hooks.js';
 // Native dialogs, capability-gated. The client half of the host's SHENORA.DIALOGS module.

package/dist/types.d.ts

@@ -131,6 +131,15 @@ export declare const ShellCapabilities: {
      * and allowed roots are the app's, and it says nothing about the URL SCHEME.
      */
     readonly localFiles: "localFiles";
+    /**
+     * The shell can HOLD the window at an orientation — see `WindowOrientation`. Android only today; the
+     * desktop has nothing to hold, and iOS refuses rather than half-doing it.
+     *
+     * ⚠ Branch on it, because the page's own fallback is real but weaker: `screen.orientation.lock()` is
+     * honoured only while the document is FULLSCREEN, and not at all in WKWebView. Absent here means take
+     * fullscreen first or leave rotation alone.
+     */
+    readonly windowOrientation: "windowOrientation";
 };
 /** The response envelope the host returns for an {@link IpcRequest}. */
 export interface IpcResponse<TData = unknown> {

package/dist/types.js

@@ -101,4 +101,13 @@ export const ShellCapabilities = {
      * and allowed roots are the app's, and it says nothing about the URL SCHEME.
      */
     localFiles: 'localFiles',
+    /**
+     * The shell can HOLD the window at an orientation — see `WindowOrientation`. Android only today; the
+     * desktop has nothing to hold, and iOS refuses rather than half-doing it.
+     *
+     * ⚠ Branch on it, because the page's own fallback is real but weaker: `screen.orientation.lock()` is
+     * honoured only while the document is FULLSCREEN, and not at all in WKWebView. Absent here means take
+     * fullscreen first or leave rotation alone.
+     */
+    windowOrientation: 'windowOrientation',
 };

package/dist/windowOrientation.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Hold the window at an orientation. Mirrors `Shenora.Modules.Platform.WindowOrientationModule`, pinned
+ * by `WireMirrorTests`.
+ *
+ * 🔴 **Try `screen.orientation.lock()` first — and know why it usually will not do.** The web API is
+ * honoured only while the document is FULLSCREEN, so a page can hold an orientation only by taking over
+ * the display; and WKWebView does not implement it at all. This route has neither limitation, because the
+ * host asks the platform directly. The common shape — portrait everywhere EXCEPT a media viewer — is
+ * exactly the one the web API cannot express.
+ *
+ * ⚠ **Branch on the `windowOrientation` capability**, which only a shell that can really hold an
+ * orientation advertises. Calling where it is absent is refused with `CAPABILITY_NOT_SUPPORTED` rather
+ * than silently ignored — but a page that checks first never shows a control that cannot work.
+ *
+ * ⚠ **There is no "what is it now".** The page already knows: `screen.orientation.type`, or a CSS media
+ * query that re-renders for it. An IPC answer would be the same fact, later.
+ */
+import type { ShenoraBridge } from './bridge.js';
+import { BaseModuleService } from './moduleService.js';
+/** The orientations a window can be held at — the host's `WindowOrientation` enum, serialized. */
+export type WindowOrientationKind = 'portrait' | 'landscape';
+interface WindowOrientationRequests {
+    LOCK: {
+        orientation: WindowOrientationKind;
+    };
+    UNLOCK: void;
+}
+/**
+ * Typed client for the host's `SHENORA.ORIENTATION` module. Two calls and no state: the app decides
+ * WHEN, the kit never rotates anything by itself.
+ *
+ * ```tsx
+ * const orientation = new WindowOrientation();
+ * useEffect(() => {
+ *   if (!capabilities.has('windowOrientation')) return;
+ *   orientation.lock('landscape');            // entering the viewer
+ *   return () => { void orientation.unlock(); };  // leaving it
+ * }, []);
+ * ```
+ */
+export declare class WindowOrientation extends BaseModuleService<WindowOrientationRequests> {
+    constructor(bridge?: ShenoraBridge);
+    /** Hold the window at `orientation` until {@link unlock}. Idempotent; a second lock replaces the first. */
+    lock(orientation: WindowOrientationKind): Promise<void>;
+    /** Let the platform choose again — whatever the device's own rotation setting says. Idempotent. */
+    unlock(): Promise<void>;
+}
+export {};

package/dist/windowOrientation.js

@@ -0,0 +1,27 @@
+import { BaseModuleService } from './moduleService.js';
+/**
+ * Typed client for the host's `SHENORA.ORIENTATION` module. Two calls and no state: the app decides
+ * WHEN, the kit never rotates anything by itself.
+ *
+ * ```tsx
+ * const orientation = new WindowOrientation();
+ * useEffect(() => {
+ *   if (!capabilities.has('windowOrientation')) return;
+ *   orientation.lock('landscape');            // entering the viewer
+ *   return () => { void orientation.unlock(); };  // leaving it
+ * }, []);
+ * ```
+ */
+export class WindowOrientation extends BaseModuleService {
+    constructor(bridge) {
+        super('SHENORA.ORIENTATION', bridge);
+    }
+    /** Hold the window at `orientation` until {@link unlock}. Idempotent; a second lock replaces the first. */
+    lock(orientation) {
+        return this.send('LOCK', { payload: { orientation } });
+    }
+    /** Let the platform choose again — whatever the device's own rotation setting says. Idempotent. */
+    unlock() {
+        return this.send('UNLOCK');
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shenora/react",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "React client for Shenora hosts on Windows, Android and iOS: correlated invoke/send/subscribe over the desktop postMessage bridge or the MAUI HybridWebView transport, typed module services, host-backed stores, and hooks for request tracking and media playback. Drop zones and window commands are desktop-only, because the capabilities are. Ships a browser fallback for pure-UI development.",
   "license": "MIT",
   "author": "Jiarong Gu",