@astrale-os/shell-react 0.2.5 → 0.2.6

package/dist/index.d.ts

@@ -26,8 +26,8 @@ export { SelectionScope, useSelection } from './selection/index.js';
 export type { Selection, SelectionScopeProps } from './selection/index.js';
 export { useCloseGuard, useTargetNode, useViewsFor, useWindow, useWindowList, useWindows, ViewHost, ViewStage, } from './window/index.js';
 export type { CloseGuard, CloseVerdict, ViewDescriptor, ViewHostProps, ViewSource, ViewHostHandle, ViewsForResult, WindowListEntry, WindowState, WindowView, } from './window/index.js';
-export { useIntent, useSendIntent } from './intents/index.js';
-export type { IntentCtx, IntentPayload, IntentReply, SendIntent } from './intents/index.js';
+export { useEmitIntent, useIntent, useSendIntent } from './intents/index.js';
+export type { EmitIntent, IntentCtx, IntentPayload, IntentReply, SendIntent, } from './intents/index.js';
 export { AppHost, AppLogo, useApps, useCurrentSpace, useOpenApp, useRoles, useSpace, useSpaces, useUser, } from './application/index.js';
 export type { AppHostFallbackState, AppHostProps, AppLogoProps, AppsResult, CurrentSpaceResult, RolesResult, SpaceResult, SpacesResult, } from './application/index.js';
 export type { ApplicationNode, AppSession, RoleNode, SpaceNode, UserNode } from '@astrale-os/shell';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAChG,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGxD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACjE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAKjD,OAAO,EACL,OAAO,EACP,WAAW,EACX,QAAQ,EACR,OAAO,EACP,SAAS,EACT,OAAO,EACP,QAAQ,EACR,SAAS,GACV,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,UAAU,EACV,IAAI,EACJ,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/F,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,EACR,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnE,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAG1E,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,SAAS,EACT,aAAa,EACb,UAAU,EACV,QAAQ,EACR,SAAS,GACV,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,UAAU,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,WAAW,EACX,UAAU,GACX,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC7D,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAG3F,OAAO,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,eAAe,EACf,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,wBAAwB,CAAA;AAE/B,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAGnG,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAGhF,cAAc,yBAAyB,CAAA;AAGvC,OAAO,EACL,eAAe,EACf,QAAQ,EACR,UAAU,EACV,aAAa,EACb,MAAM,EACN,YAAY,EACZ,QAAQ,GACT,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,KAAK,EACL,SAAS,EACT,WAAW,EACX,KAAK,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,SAAS,GACV,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,iCAAiC,CAAA;AACxC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAA;AACpE,YAAY,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAGpD,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,KAAK,EACL,WAAW,EACX,MAAM,GACP,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACxE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAChG,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGxD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACjE,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAKjD,OAAO,EACL,OAAO,EACP,WAAW,EACX,QAAQ,EACR,OAAO,EACP,SAAS,EACT,OAAO,EACP,QAAQ,EACR,SAAS,GACV,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,UAAU,EACV,IAAI,EACJ,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGhF,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/F,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,EACR,kBAAkB,GACnB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnE,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAG1E,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,SAAS,EACT,aAAa,EACb,UAAU,EACV,QAAQ,EACR,SAAS,GACV,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,UAAU,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,WAAW,EACX,UAAU,GACX,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC5E,YAAY,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,GACX,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,OAAO,EACP,OAAO,EACP,OAAO,EACP,eAAe,EACf,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,GACR,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,wBAAwB,CAAA;AAE/B,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAGnG,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAGhF,cAAc,yBAAyB,CAAA;AAGvC,OAAO,EACL,eAAe,EACf,QAAQ,EACR,UAAU,EACV,aAAa,EACb,MAAM,EACN,YAAY,EACZ,QAAQ,GACT,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,KAAK,EACL,SAAS,EACT,WAAW,EACX,KAAK,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,SAAS,GACV,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,iCAAiC,CAAA;AACxC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAA;AACpE,YAAY,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAGpD,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,KAAK,EACL,WAAW,EACX,MAAM,GACP,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/index.js

@@ -25,7 +25,7 @@ export { SelectionScope, useSelection } from './selection/index.js';
 // ─── window (§10) ────────────────────────────────────────────────────────────
 export { useCloseGuard, useTargetNode, useViewsFor, useWindow, useWindowList, useWindows, ViewHost, ViewStage, } from './window/index.js';
 // ─── intents (§11) ───────────────────────────────────────────────────────────
-export { useIntent, useSendIntent } from './intents/index.js';
+export { useEmitIntent, useIntent, useSendIntent } from './intents/index.js';
 // ─── application — the OS plane (§12) ────────────────────────────────────────
 export { AppHost, AppLogo, useApps, useCurrentSpace, useOpenApp, useRoles, useSpace, useSpaces, useUser, } from './application/index.js';
 // ─── error taxonomy (§1.4) — guards + classes, re-exported from kernel-client ─

package/dist/intents/emit-intent.hook.d.ts

@@ -0,0 +1,17 @@
+import type { IntentRegistry } from '@astrale-os/shell';
+import type { IntentPayload } from './envelope.js';
+/** Fire-and-forget intent sender returned by {@link useEmitIntent}. */
+export interface EmitIntent {
+    <K extends keyof IntentRegistry>(name: K, payload: IntentPayload<K>, 
+    /** `to`: `'parent'` (reserved) or a child windowId. Default: the parent, if any. */
+    opts?: {
+        to?: 'parent' | string;
+    }): void;
+}
+/**
+ * Return a stable sender for intents that do not need a reply. Emitted messages
+ * carry no correlation id, so listeners can handle navigation and notifications
+ * without retaining a pending request.
+ */
+export declare function useEmitIntent(): EmitIntent;
+//# sourceMappingURL=emit-intent.hook.d.ts.map

package/dist/intents/emit-intent.hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-intent.hook.d.ts","sourceRoot":"","sources":["../../src/intents/emit-intent.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAIvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAMlD,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAChC,IAAI,CAAA;CACR;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAgB1C"}

package/dist/intents/emit-intent.hook.js

@@ -0,0 +1,22 @@
+import { useCallback } from 'react';
+import { useShell } from '../session/shell.hook.js';
+import { intentMessage } from './envelope.js';
+import { resolveIntentTarget } from './resolve-intent-target.js';
+/**
+ * Return a stable sender for intents that do not need a reply. Emitted messages
+ * carry no correlation id, so listeners can handle navigation and notifications
+ * without retaining a pending request.
+ */
+export function useEmitIntent() {
+    const shell = useShell();
+    return useCallback((name, payload, opts) => {
+        const target = resolveIntentTarget(shell, opts?.to);
+        if (target.kind === 'invalid')
+            throw new Error(`useEmitIntent: ${target.reason}`);
+        const message = intentMessage(name, payload);
+        if (target.kind === 'parent')
+            shell.parent.send(message);
+        else
+            shell.children.send(target.windowId, message);
+    }, [shell]);
+}

package/dist/intents/index.d.ts

@@ -1,5 +1,7 @@
 export { useIntent } from './listen-intent.hook.js';
 export type { IntentCtx } from './listen-intent.hook.js';
+export { useEmitIntent } from './emit-intent.hook.js';
+export type { EmitIntent } from './emit-intent.hook.js';
 export { useSendIntent } from './send-intent.hook.js';
 export type { SendIntent } from './send-intent.hook.js';
 export type { IntentPayload, IntentReply } from './envelope.js';

package/dist/intents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intents/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intents/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACvD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/intents/index.js

@@ -1,3 +1,4 @@
 // intents — API §11 (useIntent, useSendIntent). See SHELL_REACT_API.md.
 export { useIntent } from './listen-intent.hook.js';
+export { useEmitIntent } from './emit-intent.hook.js';
 export { useSendIntent } from './send-intent.hook.js';

package/dist/intents/resolve-intent-target.d.ts

@@ -0,0 +1,12 @@
+import type { Shell } from '@astrale-os/shell';
+export type IntentTarget = {
+    readonly kind: 'parent';
+} | {
+    readonly kind: 'child';
+    readonly windowId: string;
+} | {
+    readonly kind: 'invalid';
+    readonly reason: string;
+};
+export declare function resolveIntentTarget(shell: Shell, to: string | undefined): IntentTarget;
+//# sourceMappingURL=resolve-intent-target.d.ts.map

package/dist/intents/resolve-intent-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-intent-target.d.ts","sourceRoot":"","sources":["../../src/intents/resolve-intent-target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEzD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAYtF"}

package/dist/intents/resolve-intent-target.js

@@ -0,0 +1,13 @@
+export function resolveIntentTarget(shell, to) {
+    if (to === undefined) {
+        return shell.parent !== null
+            ? { kind: 'parent' }
+            : { kind: 'invalid', reason: 'no target — pass opts.to (a child windowId) from a root shell' };
+    }
+    if (to === 'parent') {
+        return shell.parent !== null
+            ? { kind: 'parent' }
+            : { kind: 'invalid', reason: "opts.to 'parent' but this shell has no parent channel" };
+    }
+    return { kind: 'child', windowId: to };
+}

package/dist/intents/send-intent.hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"send-intent.hook.d.ts","sourceRoot":"","sources":["../../src/intents/send-intent.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAS,MAAM,mBAAmB,CAAA;AAW7E,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAK/D,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;CAClC;AAqBD,wBAAgB,aAAa,IAAI,UAAU,CAiE1C"}
+{"version":3,"file":"send-intent.hook.d.ts","sourceRoot":"","sources":["../../src/intents/send-intent.hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAWtE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAM/D,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,CAAC,CAAC,SAAS,MAAM,cAAc,EAC7B,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IACzB,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;CAClC;AAED,wBAAgB,aAAa,IAAI,UAAU,CAiE1C"}

package/dist/intents/send-intent.hook.js

@@ -8,19 +8,7 @@
 import { useCallback, useEffect, useRef } from 'react';
 import { useShell } from '../session/shell.hook.js';
 import { INTENT_REPLY, NOOP, intentMessage } from './envelope.js';
-function resolveTarget(shell, to) {
-    if (to === undefined) {
-        return shell.parent !== null
-            ? { kind: 'parent' }
-            : { kind: 'invalid', reason: 'no target — pass opts.to (a child windowId) from a root shell' };
-    }
-    if (to === 'parent') {
-        return shell.parent !== null
-            ? { kind: 'parent' }
-            : { kind: 'invalid', reason: "opts.to 'parent' but this shell has no parent channel" };
-    }
-    return { kind: 'child', windowId: to };
-}
+import { resolveIntentTarget } from './resolve-intent-target.js';
 export function useSendIntent() {
     const shell = useShell();
     // Unmount settlers for in-flight sends, so a pending reply resolves on teardown.
@@ -34,7 +22,7 @@ export function useSendIntent() {
         };
     }, []);
     return useCallback((name, payload, opts) => {
-        const target = resolveTarget(shell, opts?.to);
+        const target = resolveIntentTarget(shell, opts?.to);
         if (target.kind === 'invalid') {
             return Promise.reject(new Error(`useSendIntent: ${target.reason}`));
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/shell-react",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Astrale shell-react — the React face of the shell (provider, hooks, view components)",
   "license": "Apache-2.0",
   "repository": {

package/src/index.ts

@@ -117,8 +117,14 @@ export type {
 } from './window/index.js'
 
 // ─── intents (§11) ───────────────────────────────────────────────────────────
-export { useIntent, useSendIntent } from './intents/index.js'
-export type { IntentCtx, IntentPayload, IntentReply, SendIntent } from './intents/index.js'
+export { useEmitIntent, useIntent, useSendIntent } from './intents/index.js'
+export type {
+  EmitIntent,
+  IntentCtx,
+  IntentPayload,
+  IntentReply,
+  SendIntent,
+} from './intents/index.js'
 
 // ─── application — the OS plane (§12) ────────────────────────────────────────
 export {

package/src/intents/emit-intent.hook.ts

@@ -0,0 +1,42 @@
+import type { IntentRegistry } from '@astrale-os/shell'
+
+import { useCallback } from 'react'
+
+import type { IntentPayload } from './envelope.js'
+
+import { useShell } from '../session/shell.hook.js'
+import { intentMessage } from './envelope.js'
+import { resolveIntentTarget } from './resolve-intent-target.js'
+
+/** Fire-and-forget intent sender returned by {@link useEmitIntent}. */
+export interface EmitIntent {
+  <K extends keyof IntentRegistry>(
+    name: K,
+    payload: IntentPayload<K>,
+    /** `to`: `'parent'` (reserved) or a child windowId. Default: the parent, if any. */
+    opts?: { to?: 'parent' | string },
+  ): void
+}
+
+/**
+ * Return a stable sender for intents that do not need a reply. Emitted messages
+ * carry no correlation id, so listeners can handle navigation and notifications
+ * without retaining a pending request.
+ */
+export function useEmitIntent(): EmitIntent {
+  const shell = useShell()
+  return useCallback(
+    <K extends keyof IntentRegistry>(
+      name: K,
+      payload: IntentPayload<K>,
+      opts?: { to?: 'parent' | string },
+    ): void => {
+      const target = resolveIntentTarget(shell, opts?.to)
+      if (target.kind === 'invalid') throw new Error(`useEmitIntent: ${target.reason}`)
+      const message = intentMessage(name, payload)
+      if (target.kind === 'parent') shell.parent!.send(message)
+      else shell.children.send(target.windowId, message)
+    },
+    [shell],
+  )
+}

package/src/intents/index.ts

@@ -1,6 +1,8 @@
 // intents — API §11 (useIntent, useSendIntent). See SHELL_REACT_API.md.
 export { useIntent } from './listen-intent.hook.js'
 export type { IntentCtx } from './listen-intent.hook.js'
+export { useEmitIntent } from './emit-intent.hook.js'
+export type { EmitIntent } from './emit-intent.hook.js'
 export { useSendIntent } from './send-intent.hook.js'
 export type { SendIntent } from './send-intent.hook.js'
 export type { IntentPayload, IntentReply } from './envelope.js'

package/src/intents/resolve-intent-target.ts

@@ -0,0 +1,20 @@
+import type { Shell } from '@astrale-os/shell'
+
+export type IntentTarget =
+  | { readonly kind: 'parent' }
+  | { readonly kind: 'child'; readonly windowId: string }
+  | { readonly kind: 'invalid'; readonly reason: string }
+
+export function resolveIntentTarget(shell: Shell, to: string | undefined): IntentTarget {
+  if (to === undefined) {
+    return shell.parent !== null
+      ? { kind: 'parent' }
+      : { kind: 'invalid', reason: 'no target — pass opts.to (a child windowId) from a root shell' }
+  }
+  if (to === 'parent') {
+    return shell.parent !== null
+      ? { kind: 'parent' }
+      : { kind: 'invalid', reason: "opts.to 'parent' but this shell has no parent channel" }
+  }
+  return { kind: 'child', windowId: to }
+}

package/src/intents/send-intent.hook.ts

@@ -1,4 +1,4 @@
-import type { IntentMessage, IntentRegistry, Shell } from '@astrale-os/shell'
+import type { IntentMessage, IntentRegistry } from '@astrale-os/shell'
 
 /**
  * useSendIntent (API §11) — a stable typed sender. Each call attaches a
@@ -13,6 +13,7 @@ import type { IntentPayload, IntentReply } from './envelope.js'
 
 import { useShell } from '../session/shell.hook.js'
 import { INTENT_REPLY, NOOP, intentMessage } from './envelope.js'
+import { resolveIntentTarget } from './resolve-intent-target.js'
 
 /** The typed sender returned by {@link useSendIntent}. */
 export interface SendIntent {
@@ -24,25 +25,6 @@ export interface SendIntent {
   ): Promise<IntentReply<K> | void>
 }
 
-type Target =
-  | { readonly kind: 'parent' }
-  | { readonly kind: 'child'; readonly windowId: string }
-  | { readonly kind: 'invalid'; readonly reason: string }
-
-function resolveTarget(shell: Shell, to: string | undefined): Target {
-  if (to === undefined) {
-    return shell.parent !== null
-      ? { kind: 'parent' }
-      : { kind: 'invalid', reason: 'no target — pass opts.to (a child windowId) from a root shell' }
-  }
-  if (to === 'parent') {
-    return shell.parent !== null
-      ? { kind: 'parent' }
-      : { kind: 'invalid', reason: "opts.to 'parent' but this shell has no parent channel" }
-  }
-  return { kind: 'child', windowId: to }
-}
-
 export function useSendIntent(): SendIntent {
   const shell = useShell()
   // Unmount settlers for in-flight sends, so a pending reply resolves on teardown.
@@ -61,7 +43,7 @@ export function useSendIntent(): SendIntent {
       payload: IntentPayload<K>,
       opts?: { to?: 'parent' | string },
     ): Promise<IntentReply<K> | void> => {
-      const target = resolveTarget(shell, opts?.to)
+      const target = resolveIntentTarget(shell, opts?.to)
       if (target.kind === 'invalid') {
         return Promise.reject(new Error(`useSendIntent: ${target.reason}`))
       }