@theaiplatform/miniapp-sdk 0.2.4 → 0.3.0

package/dist/sdk.d.ts

@@ -326,6 +326,8 @@ export declare type MiniAppPlatformApi = {
     credentials?: MiniAppCredentialsApi;
     /** Desktop host capability; feature-detect before use on portable targets. */
     printing?: MiniAppReceiptPrintingApi;
+    /** Desktop host capability; feature-detect before opening a terminal. */
+    terminal?: MiniAppTerminalApi;
     /** Browser capabilities appear only when the selected target supports them. */
     auth?: MiniAppAuthApi;
     vfs?: MiniAppVfsApi;
@@ -591,6 +593,76 @@ export declare type MiniAppStorageSetOptions = MiniAppStorageAddress & {
     expectedRevision: number | null;
 };
 
+export declare type MiniAppTerminalApi = {
+    readonly v1: MiniAppTerminalV1Api;
+};
+
+/** Versioned, desktop-only host terminal capability. */
+export declare type MiniAppTerminalV1Api = {
+    getCapabilities(): Promise<MiniAppTerminalV1Capabilities>;
+    open(options: MiniAppTerminalV1OpenOptions): Promise<MiniAppTerminalV1Session>;
+};
+
+export declare type MiniAppTerminalV1Capabilities = {
+    profiles: MiniAppTerminalV1Profile[];
+    limits: MiniAppTerminalV1Limits;
+};
+
+export declare type MiniAppTerminalV1DataEvent = {
+    type: 'data';
+    sequence: number;
+    data: Uint8Array;
+};
+
+export declare type MiniAppTerminalV1Event = MiniAppTerminalV1DataEvent | MiniAppTerminalV1ExitEvent;
+
+export declare type MiniAppTerminalV1ExitEvent = {
+    type: 'exit';
+    sequence: number;
+    code: number | null;
+    signal: string | null;
+    reason: 'exited' | 'closed' | 'revoked' | 'error';
+};
+
+export declare type MiniAppTerminalV1Limits = {
+    maxSessionsPerDocument: number;
+    maxWriteBytes: number;
+    maxOutputBytesInFlight: number;
+    maxCols: number;
+    maxRows: number;
+};
+
+export declare type MiniAppTerminalV1OpenOptions = {
+    profile: MiniAppTerminalV1ProfileId;
+    cols: number;
+    rows: number;
+};
+
+export declare type MiniAppTerminalV1Profile = {
+    id: MiniAppTerminalV1ProfileId;
+    available: boolean;
+    unavailableReason: string | null;
+};
+
+/** Host-owned terminal runtime profiles exposed by `sdk.terminal.v1`. */
+export declare type MiniAppTerminalV1ProfileId = 'workspace-shell' | 'neovim';
+
+export declare type MiniAppTerminalV1ResizeOptions = {
+    cols: number;
+    rows: number;
+};
+
+export declare type MiniAppTerminalV1Session = {
+    /** Opaque host-minted session identity; it carries no ambient authority. */
+    readonly id: string;
+    readonly profile: MiniAppTerminalV1ProfileId;
+    /** Ordered output with byte-sized backpressure owned by the host session. */
+    readonly events: ReadableStream<MiniAppTerminalV1Event>;
+    write(data: Uint8Array): Promise<void>;
+    resize(options: MiniAppTerminalV1ResizeOptions): Promise<void>;
+    close(): Promise<void>;
+};
+
 export declare type MiniAppUserProfile = {
     sub: string;
     name?: string | null;

package/dist/ui/wasm.js

@@ -6,7 +6,7 @@ import { clsx } from "clsx";
 import { twMerge } from "tailwind-merge";
 import { Slot as react_slot_Slot } from "@radix-ui/react-slot";
 import "prism-react-renderer";
-import { composeRefs } from "@radix-ui/react-compose-refs";
+import { useComposedRefs } from "@radix-ui/react-compose-refs";
 import { useCallback as external_react_useCallback, useEffect, useRef } from "react";
 import "react-resizable-panels";
 import "@radix-ui/react-scroll-area";
@@ -626,6 +626,7 @@ DialogContentPrimitive.displayName = __rspack_external__radix_ui_react_dialog_da
 function DialogContent({ className, children, ref, container, hideCloseButton, onOpenAutoFocus, onEscapeKeyDown, ...props }) {
     const { ref: occlusionRef, ready } = native_view_occlusion_useNativeViewOcclusion();
     const contentRef = __rspack_external_react.useRef(null);
+    const composedContentRef = useComposedRefs(ref, contentRef);
     const closeButtonRef = __rspack_external_react.useRef(null);
     const shouldFocusWhenReadyRef = __rspack_external_react.useRef(false);
     const handleOpenAutoFocus = __rspack_external_react.useCallback((event)=>{
@@ -670,7 +671,7 @@ function DialogContent({ className, children, ref, container, hideCloseButton, o
             bottom: 'var(--chat-input-offset, 0px)'
         } : void 0
     }, /*#__PURE__*/ __rspack_external_react.createElement(DialogContentPrimitive, {
-        ref: composeRefs(ref, contentRef),
+        ref: composedContentRef,
         className: utils_cn('bg-surface-level-1 pointer-events-auto relative grid max-h-full w-full max-w-lg min-w-0 gap-4 overflow-auto rounded-3xl border p-8 break-words shadow-lg', className),
         ...container ? {
             onInteractOutside: (e)=>{
@@ -1348,8 +1349,9 @@ function SelectScrollDownButton({ className, ref, ...props }) {
 SelectScrollDownButton.displayName = __rspack_external__radix_ui_react_select_4606f4d3.ScrollDownButton.displayName;
 function SelectContent({ className, children, position = 'popper', ref, ...props }) {
     const { ref: occlusionRef, ready } = native_view_occlusion_useNativeViewOcclusion();
+    const composedRef = useComposedRefs(ref, occlusionRef);
     return /*#__PURE__*/ __rspack_external_react.createElement(__rspack_external__radix_ui_react_select_4606f4d3.Portal, null, /*#__PURE__*/ __rspack_external_react.createElement(__rspack_external__radix_ui_react_select_4606f4d3.Content, {
-        ref: composeRefs(ref, occlusionRef),
+        ref: composedRef,
         className: utils_cn('bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 relative z-(--z-popover) max-h-[--radix-select-content-available-height] min-w-[8rem] overflow-x-hidden overflow-y-auto rounded-lg shadow-sm data-[side=bottom]:origin-top data-[side=left]:origin-right data-[side=right]:origin-left data-[side=top]:origin-bottom', 'popper' === position && 'data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1', !ready && 'invisible', className),
         position: position,
         ...props

package/dist/ui.js

@@ -4,7 +4,7 @@ import { twMerge } from "tailwind-merge";
 import { Slot } from "@radix-ui/react-slot";
 import { Check, CheckIcon, ChevronDown, ChevronUp, Circle, CopyIcon, GripVertical, X, XIcon } from "lucide-react";
 import { Highlight, themes } from "prism-react-renderer";
-import { composeRefs } from "@radix-ui/react-compose-refs";
+import { useComposedRefs } from "@radix-ui/react-compose-refs";
 import { useCallback, useEffect, useRef } from "react";
 import { Group, Panel, Separator as external_react_resizable_panels_Separator } from "react-resizable-panels";
 import * as __rspack_external_react from "react";
@@ -808,6 +808,7 @@ DialogContentPrimitive.displayName = __rspack_external__radix_ui_react_dialog_da
 function DialogContent({ className, children, ref, container, hideCloseButton, onOpenAutoFocus, onEscapeKeyDown, ...props }) {
     const { ref: occlusionRef, ready } = useNativeViewOcclusion();
     const contentRef = __rspack_external_react.useRef(null);
+    const composedContentRef = useComposedRefs(ref, contentRef);
     const closeButtonRef = __rspack_external_react.useRef(null);
     const shouldFocusWhenReadyRef = __rspack_external_react.useRef(false);
     const handleOpenAutoFocus = __rspack_external_react.useCallback((event)=>{
@@ -852,7 +853,7 @@ function DialogContent({ className, children, ref, container, hideCloseButton, o
             bottom: 'var(--chat-input-offset, 0px)'
         } : void 0
     }, /*#__PURE__*/ __rspack_external_react.createElement(DialogContentPrimitive, {
-        ref: composeRefs(ref, contentRef),
+        ref: composedContentRef,
         className: cn('bg-surface-level-1 pointer-events-auto relative grid max-h-full w-full max-w-lg min-w-0 gap-4 overflow-auto rounded-3xl border p-8 break-words shadow-lg', className),
         ...container ? {
             onInteractOutside: (e)=>{
@@ -1725,8 +1726,9 @@ function SelectScrollDownButton({ className, ref, ...props }) {
 SelectScrollDownButton.displayName = __rspack_external__radix_ui_react_select_4606f4d3.ScrollDownButton.displayName;
 function SelectContent({ className, children, position = 'popper', ref, ...props }) {
     const { ref: occlusionRef, ready } = useNativeViewOcclusion();
+    const composedRef = useComposedRefs(ref, occlusionRef);
     return /*#__PURE__*/ __rspack_external_react.createElement(__rspack_external__radix_ui_react_select_4606f4d3.Portal, null, /*#__PURE__*/ __rspack_external_react.createElement(__rspack_external__radix_ui_react_select_4606f4d3.Content, {
-        ref: composeRefs(ref, occlusionRef),
+        ref: composedRef,
         className: cn('bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 relative z-(--z-popover) max-h-[--radix-select-content-available-height] min-w-[8rem] overflow-x-hidden overflow-y-auto rounded-lg shadow-sm data-[side=bottom]:origin-top data-[side=left]:origin-right data-[side=right]:origin-left data-[side=top]:origin-bottom', 'popper' === position && 'data-[side=bottom]:translate-y-1 data-[side=left]:-translate-x-1 data-[side=right]:translate-x-1 data-[side=top]:-translate-y-1', !ready && 'invisible', className),
         position: position,
         ...props

package/dist/web.d.ts

@@ -367,6 +367,8 @@ export declare type MiniAppPlatformApi = {
     credentials?: MiniAppCredentialsApi;
     /** Desktop host capability; feature-detect before use on portable targets. */
     printing?: MiniAppReceiptPrintingApi;
+    /** Desktop host capability; feature-detect before opening a terminal. */
+    terminal?: MiniAppTerminalApi;
     /** Browser capabilities appear only when the selected target supports them. */
     auth?: MiniAppAuthApi;
     vfs?: MiniAppVfsApi;
@@ -632,6 +634,76 @@ declare type MiniAppStorageSetOptions = MiniAppStorageAddress & {
     expectedRevision: number | null;
 };
 
+declare type MiniAppTerminalApi = {
+    readonly v1: MiniAppTerminalV1Api;
+};
+
+/** Versioned, desktop-only host terminal capability. */
+declare type MiniAppTerminalV1Api = {
+    getCapabilities(): Promise<MiniAppTerminalV1Capabilities>;
+    open(options: MiniAppTerminalV1OpenOptions): Promise<MiniAppTerminalV1Session>;
+};
+
+declare type MiniAppTerminalV1Capabilities = {
+    profiles: MiniAppTerminalV1Profile[];
+    limits: MiniAppTerminalV1Limits;
+};
+
+declare type MiniAppTerminalV1DataEvent = {
+    type: 'data';
+    sequence: number;
+    data: Uint8Array;
+};
+
+declare type MiniAppTerminalV1Event = MiniAppTerminalV1DataEvent | MiniAppTerminalV1ExitEvent;
+
+declare type MiniAppTerminalV1ExitEvent = {
+    type: 'exit';
+    sequence: number;
+    code: number | null;
+    signal: string | null;
+    reason: 'exited' | 'closed' | 'revoked' | 'error';
+};
+
+declare type MiniAppTerminalV1Limits = {
+    maxSessionsPerDocument: number;
+    maxWriteBytes: number;
+    maxOutputBytesInFlight: number;
+    maxCols: number;
+    maxRows: number;
+};
+
+declare type MiniAppTerminalV1OpenOptions = {
+    profile: MiniAppTerminalV1ProfileId;
+    cols: number;
+    rows: number;
+};
+
+declare type MiniAppTerminalV1Profile = {
+    id: MiniAppTerminalV1ProfileId;
+    available: boolean;
+    unavailableReason: string | null;
+};
+
+/** Host-owned terminal runtime profiles exposed by `sdk.terminal.v1`. */
+declare type MiniAppTerminalV1ProfileId = 'workspace-shell' | 'neovim';
+
+declare type MiniAppTerminalV1ResizeOptions = {
+    cols: number;
+    rows: number;
+};
+
+declare type MiniAppTerminalV1Session = {
+    /** Opaque host-minted session identity; it carries no ambient authority. */
+    readonly id: string;
+    readonly profile: MiniAppTerminalV1ProfileId;
+    /** Ordered output with byte-sized backpressure owned by the host session. */
+    readonly events: ReadableStream<MiniAppTerminalV1Event>;
+    write(data: Uint8Array): Promise<void>;
+    resize(options: MiniAppTerminalV1ResizeOptions): Promise<void>;
+    close(): Promise<void>;
+};
+
 export declare type MiniAppTheme = 'light' | 'dark';
 
 export declare type MiniAppUiScale = number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theaiplatform/miniapp-sdk",
-  "version": "0.2.4",
+  "version": "0.3.0",
   "description": "Public SDK for building portable miniapps that run in The AI Platform.",
   "type": "module",
   "engines": {