tassello 0.2.0 → 0.3.0

package/dist/server/util.js

@@ -1,4 +1,5 @@
-import { existsSync } from 'node:fs';
+import { createHash, randomBytes } from 'node:crypto';
+import { existsSync, promises as fs } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 // The share directory of a ROS package, from the ament index of the sourced
@@ -26,6 +27,27 @@ export function absoluteTopic(topic) {
     const trimmed = topic.trim().replace(/\/+$/, '');
     return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
 }
+// Whether the page that opened a WebSocket is one of the dashboard's own.
+// Browsers say which site a page is from (Origin), and another site's page
+// cannot change it; the dashboard's is the host the page reached: the Host
+// header, or the X-Forwarded-Host of a reverse proxy. Programs other than
+// browsers send no Origin.
+export function ownPage(headers) {
+    if (headers.origin === undefined) {
+        return true;
+    }
+    let host;
+    try {
+        host = new URL(headers.origin).host.toLowerCase();
+    }
+    catch {
+        // "null": a sandboxed frame, a file
+        return false;
+    }
+    const forwarded = headers['x-forwarded-host'];
+    const proxied = (Array.isArray(forwarded) ? forwarded[0] : forwarded)?.split(',')[0].trim();
+    return [headers.host, proxied].some((reached) => reached?.toLowerCase() === host);
+}
 export function errorMessage(e) {
     return e instanceof Error ? e.message : String(e);
 }
@@ -52,3 +74,25 @@ export function toJson(value) {
     }
     return value;
 }
+// Of a file's content
+export function contentVersion(text) {
+    return createHash('sha256').update(text).digest('hex').slice(0, 16);
+}
+// Writes the file anew, at once: a temporary file renamed over it, keeping
+// its mode; in place if that cannot be (a folder the server cannot write in,
+// a file of another user's)
+export async function replaceFile(file, text) {
+    const stat = await fs.stat(file);
+    if (stat.uid === process.getuid?.()) {
+        const temporary = path.join(path.dirname(file), `.${path.basename(file)}.${randomBytes(4).toString('hex')}.tmp`);
+        try {
+            await fs.writeFile(temporary, text, { mode: stat.mode & 0o7777, flag: 'wx' });
+            await fs.rename(temporary, file);
+            return;
+        }
+        catch {
+            await fs.rm(temporary, { force: true });
+        }
+    }
+    await fs.writeFile(file, text);
+}

package/dist/shared/file_manager.d.ts

@@ -0,0 +1,130 @@
+export interface FsEntry {
+    name: string;
+    kind: 'dir' | 'file' | 'other';
+    link: string | null;
+    size: number;
+    modified: number;
+    mode: number;
+    owner: string;
+    group: string;
+    readable: boolean;
+    writable: boolean;
+    bag: boolean;
+}
+export interface FsSpace {
+    mount: string;
+    total: number;
+    free: number;
+}
+export interface FsListing {
+    path: string;
+    parent: string | null;
+    entries: FsEntry[];
+    truncated: number;
+    writable: boolean;
+    version: string;
+    space: FsSpace | null;
+}
+export interface FsPlaces {
+    home: string;
+    user: string;
+    ros: {
+        name: string;
+        path: string;
+    }[];
+}
+export interface FsDetails extends FsEntry {
+    path: string;
+    realPath: string | null;
+    created: number | null;
+    accessed: number;
+    changed: number;
+    inode: number;
+    links: number;
+    items: number | null;
+    hidden: number | null;
+    space: FsSpace | null;
+}
+export interface FsDisk extends FsSpace {
+    device: string;
+    type: string;
+    readOnly: boolean;
+    used: number;
+    inodes: {
+        total: number;
+        free: number;
+    } | null;
+}
+export interface FsAnalysis {
+    path: string;
+    size: number;
+    disk: number;
+    files: number;
+    folders: number;
+    links: number;
+    children: {
+        name: string;
+        kind: FsEntry['kind'];
+        size: number;
+        files: number;
+    }[];
+    types: {
+        type: string;
+        files: number;
+        size: number;
+    }[];
+    largest: {
+        path: string;
+        size: number;
+    }[];
+    recent: {
+        path: string;
+        modified: number;
+    }[];
+    partial: string | null;
+    unreadable: number;
+    mounts: number;
+    elapsedMs: number;
+}
+export interface FsText {
+    path: string;
+    text: string;
+    version: string;
+    stamp: string;
+    readOnly: string | null;
+}
+export interface FsSaved {
+    version: string;
+    stamp: string;
+    conflict: boolean;
+}
+export type FsConflict = 'ask' | 'skip' | 'keep-both' | 'replace';
+export type FsOperation = {
+    op: 'mkdir';
+    path: string;
+} | {
+    op: 'create';
+    path: string;
+} | {
+    op: 'rename';
+    path: string;
+    name: string;
+} | {
+    op: 'move' | 'copy';
+    paths: string[];
+    to: string;
+    conflict: FsConflict;
+} | {
+    op: 'delete';
+    paths: string[];
+} | {
+    op: 'chmod';
+    path: string;
+    mode: number;
+};
+export interface FsResult {
+    paths: string[];
+    conflicts: string[];
+}
+export declare const FS_MAX_ENTRIES = 5000;
+export declare const FS_MAX_TEXT_BYTES: number;

package/dist/shared/file_manager.js

@@ -0,0 +1,7 @@
+// The robot's files, as the file manager widgets see them: the REST API of
+// /api/fs (see src/server/http.ts). The server acts as its user, anywhere that
+// user can: see the README's Security.
+// Of a folder's entries, at most, listed
+export const FS_MAX_ENTRIES = 5000;
+// Of the files edited as text
+export const FS_MAX_TEXT_BYTES = 5 * 1024 * 1024;

package/dist/shared/protocol.d.ts

@@ -192,7 +192,44 @@ export interface RosoutSubscribe {
     id: number;
     topic: string;
 }
-export type ClientMessage = TwistCommand | ImageSubscribe | GridSubscribe | TfSubscribe | PathSubscribe | TopicSubscribe | ServicesSubscribe | ServiceAction | LogsSubscribe | Unsubscribe | FrameAck | PosePublish | CommandRun | CommandStop | ArmSubscribe | ArmJog | RosPublish | RosCall | PluginRequest | PluginSubscribe | BehaviorTreeSubscribe | BehaviorTreeRecord | BehaviorTreePlaybackSubscribe | BehaviorTreePlaybackControl | BehaviorTreeFileSubscribe | BehaviorTreeFileSave | RosoutSubscribe;
+export interface DiagnosticsSubscribe {
+    type: 'diagnostics.subscribe';
+    id: number;
+    topic: string;
+}
+export interface TerminalOpen {
+    type: 'terminal.open';
+    id: number;
+    terminal: string;
+    command: string;
+    folder: string;
+    cols: number;
+    rows: number;
+    started: number | null;
+    offset: number | null;
+}
+export interface TerminalInput {
+    type: 'terminal.input';
+    id: number;
+    data: string;
+}
+export interface TerminalResize {
+    type: 'terminal.resize';
+    id: number;
+    cols: number;
+    rows: number;
+}
+export interface TerminalAck {
+    type: 'terminal.ack';
+    id: number;
+    started: number;
+    offset: number;
+}
+export interface TerminalRestart {
+    type: 'terminal.restart';
+    id: number;
+}
+export type ClientMessage = TwistCommand | ImageSubscribe | GridSubscribe | TfSubscribe | PathSubscribe | TopicSubscribe | ServicesSubscribe | ServiceAction | LogsSubscribe | Unsubscribe | FrameAck | PosePublish | CommandRun | CommandStop | ArmSubscribe | ArmJog | RosPublish | RosCall | PluginRequest | PluginSubscribe | BehaviorTreeSubscribe | BehaviorTreeRecord | BehaviorTreePlaybackSubscribe | BehaviorTreePlaybackControl | BehaviorTreeFileSubscribe | BehaviorTreeFileSave | RosoutSubscribe | DiagnosticsSubscribe | TerminalOpen | TerminalInput | TerminalResize | TerminalAck | TerminalRestart;
 export interface Hello {
     type: 'hello';
     clientId: string;
@@ -429,7 +466,51 @@ export interface RosoutUpdate {
     skipped: number;
     nodes: string[] | null;
 }
-export type ServerMessage = Hello | CommandStates | CommandUpdate | StreamStatus | TfUpdate | PathUpdate | TopicMessage | ServicesUpdate | ServiceResult | LogsUpdate | ArmUpdate | Result | PluginData | BehaviorTreeInfo | BehaviorTreeUpdate | BehaviorTreeRecording | BehaviorTreePlaybackState | BehaviorTreeFile | BehaviorTreeModels | RosoutUpdate | PanelsChanged | ErrorMessage;
+export interface DiagnosticEntry {
+    id: number;
+    name: string;
+    level: number;
+    message: string;
+    hardwareId: string;
+    values: {
+        key: string;
+        value: string;
+    }[];
+    stale: boolean;
+    updated: number;
+    since: number;
+}
+export interface DiagnosticChange {
+    seq: number;
+    time: number;
+    status: number;
+    level: number;
+    message: string;
+}
+export interface DiagnosticsUpdate {
+    type: 'diagnostics';
+    id: number;
+    reset: boolean;
+    started: number;
+    statuses: DiagnosticEntry[];
+    changes: DiagnosticChange[];
+}
+export interface TerminalOutput {
+    type: 'terminal.output';
+    id: number;
+    started: number;
+    offset: number;
+    reset: boolean;
+    data: string;
+    title: string | null;
+}
+export interface TerminalExit {
+    type: 'terminal.exit';
+    id: number;
+    started: number;
+    exitCode: number | null;
+}
+export type ServerMessage = Hello | CommandStates | CommandUpdate | StreamStatus | TfUpdate | PathUpdate | TopicMessage | ServicesUpdate | ServiceResult | LogsUpdate | ArmUpdate | Result | PluginData | BehaviorTreeInfo | BehaviorTreeUpdate | BehaviorTreeRecording | BehaviorTreePlaybackState | BehaviorTreeFile | BehaviorTreeModels | RosoutUpdate | DiagnosticsUpdate | TerminalOutput | TerminalExit | PanelsChanged | ErrorMessage;
 export declare const FRAME_HEADER_BYTES = 11;
 export declare const IMAGE_FORMATS: readonly ['image/jpeg', 'image/png'];
 export interface GridInfo {
@@ -452,6 +533,10 @@ export declare const ARM_STATE_RATE = 10;
 export declare const BT_RATE = 10;
 export declare const ROSOUT_RATE = 10;
 export declare const ROSOUT_HISTORY = 10000;
+export declare const DIAGNOSTICS_RATE = 4;
+export declare const DIAGNOSTICS_CHANGES = 1000;
+export declare const TERMINAL_SCROLLBACK = 2000;
+export declare const TERMINAL_WINDOW: number;
 export declare const DASHBOARD_CLIENT_HEADER = "X-Dashboard-Client";
 export interface PluginInfo {
     name: string;

package/dist/shared/protocol.js

@@ -19,4 +19,12 @@ export const BT_RATE = 10;
 export const ROSOUT_RATE = 10;
 // Messages of the ROS log kept by the server, and by the page
 export const ROSOUT_HISTORY = 10_000;
+// Diagnostics come about once a second
+export const DIAGNOSTICS_RATE = 4;
+// Changes of level kept by the server, and by the page
+export const DIAGNOSTICS_CHANGES = 1000;
+// Lines of a terminal kept above its screen, by the server and by the page
+export const TERMINAL_SCROLLBACK = 2000;
+// Characters of a terminal's output sent to a page and not yet written by it
+export const TERMINAL_WINDOW = 256 * 1024;
 export const DASHBOARD_CLIENT_HEADER = 'X-Dashboard-Client';

package/dist/types/client/api.d.ts

@@ -1,5 +1,10 @@
+import type { FsAnalysis, FsConflict, FsDetails, FsDisk, FsListing, FsOperation, FsPlaces, FsResult, FsSaved, FsText } from '../shared/file_manager.ts';
 import type { Panel, PanelSummary, TopicInfo } from '../shared/panel.ts';
 import { type PluginInfo } from '../shared/protocol.ts';
+export declare class ApiError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
 export type FileKind = 'image' | 'behavior-tree' | 'bag' | 'folder';
 export interface DirectoryListing {
     dir: string;
@@ -21,3 +26,20 @@ export declare const api: {
     listFiles: (dir: string, kind?: FileKind) => Promise<DirectoryListing>;
     uploadFile: (file: Blob) => Promise<string>;
 };
+export interface Upload {
+    result: Promise<FsResult>;
+    abort: () => void;
+}
+export declare const fsApi: {
+    places: () => Promise<FsPlaces>;
+    list: (path: string, known?: string) => Promise<FsListing | undefined>;
+    details: (path: string) => Promise<FsDetails>;
+    disks: () => Promise<FsDisk[]>;
+    analyze: (path: string) => Promise<FsAnalysis>;
+    readText: (path: string, stamp?: string) => Promise<FsText | undefined>;
+    saveText: (path: string, text: string, base: string | null, create?: boolean) => Promise<FsSaved>;
+    operate: (operation: FsOperation) => Promise<FsResult>;
+    downloadUrl: (paths: string[]) => string;
+    viewUrl: (path: string, stamp?: string) => string;
+    upload(folder: string, name: string, file: Blob, conflict: FsConflict, onProgress: (sent: number) => void): Upload;
+};

package/dist/types/client/connection.d.ts

@@ -1,4 +1,4 @@
-import { type ArmSubscribe, type ArmUpdate, type BehaviorTreeFile, type BehaviorTreeFileSubscribe, type BehaviorTreeInfo, type BehaviorTreeModels, type BehaviorTreePlaybackControl, type BehaviorTreePlaybackState, type BehaviorTreePlaybackSubscribe, type BehaviorTreeRecording, type BehaviorTreeSaved, type BehaviorTreeSubscribe, type BehaviorTreeUpdate, type ClientMessage, type CommandState, type GridSubscribe, type ImageSubscribe, type LogsSubscribe, type LogsUpdate, type PathSubscribe, type PathUpdate, type RosoutSubscribe, type RosoutUpdate, type ServerMessage, type ServiceScope, type ServicesSubscribe, type ServicesUpdate, type ServiceVerb, type StreamStatus, type TfSubscribe, type TfUpdate, type TopicSubscribe } from '../shared/protocol.ts';
+import { type ArmSubscribe, type ArmUpdate, type BehaviorTreeFile, type BehaviorTreeFileSubscribe, type BehaviorTreeInfo, type BehaviorTreeModels, type BehaviorTreePlaybackControl, type BehaviorTreePlaybackState, type BehaviorTreePlaybackSubscribe, type BehaviorTreeRecording, type BehaviorTreeSaved, type BehaviorTreeSubscribe, type BehaviorTreeUpdate, type ClientMessage, type CommandState, type DiagnosticsSubscribe, type DiagnosticsUpdate, type GridSubscribe, type ImageSubscribe, type LogsSubscribe, type LogsUpdate, type PathSubscribe, type PathUpdate, type RosoutSubscribe, type RosoutUpdate, type ServerMessage, type ServiceScope, type ServicesSubscribe, type ServicesUpdate, type ServiceVerb, type StreamStatus, type TerminalExit, type TerminalOpen, type TerminalOutput, type TfSubscribe, type TfUpdate, type TopicSubscribe } from '../shared/protocol.ts';
 export type ConnectionStatus = 'connecting' | 'open' | 'closed';
 export type ImageOptions = Omit<ImageSubscribe, 'type' | 'id'>;
 export type GridOptions = Omit<GridSubscribe, 'type' | 'id'>;
@@ -13,6 +13,8 @@ export type BehaviorTreePlaybackOptions = Omit<BehaviorTreePlaybackSubscribe, 't
 export type BehaviorTreePlaybackRequest = Omit<BehaviorTreePlaybackControl, 'type' | 'id'>;
 export type BehaviorTreeFileOptions = Omit<BehaviorTreeFileSubscribe, 'type' | 'id'>;
 export type RosoutOptions = Omit<RosoutSubscribe, 'type' | 'id'>;
+export type DiagnosticsOptions = Omit<DiagnosticsSubscribe, 'type' | 'id'>;
+export type TerminalOptions = Pick<TerminalOpen, 'terminal' | 'command' | 'folder'>;
 export interface TopicHandlers {
     status: (state: StreamStatus['state'], message: string) => void;
     message: (messageType: string, message: unknown) => void;
@@ -32,6 +34,16 @@ export interface RosoutHandlers {
     status: (state: StreamStatus['state'], message: string) => void;
     update: (update: RosoutUpdate) => void;
 }
+export interface DiagnosticsHandlers {
+    status: (state: StreamStatus['state'], message: string) => void;
+    update: (update: DiagnosticsUpdate) => void;
+}
+export interface TerminalHandlers {
+    status: (state: StreamStatus['state'], message: string) => void;
+    output: (output: TerminalOutput) => void;
+    exit: (exit: TerminalExit) => void;
+    shown: () => Pick<TerminalOpen, 'cols' | 'rows' | 'started' | 'offset'>;
+}
 export interface FrameInfo {
     width: number;
     height: number;
@@ -81,6 +93,15 @@ export declare class Connection {
     subscribeBehaviorTreeFile(options: BehaviorTreeFileOptions, handlers: BehaviorTreeFileHandlers): () => void;
     saveBehaviorTreeFile(path: string, text: string, base: string | null, create?: boolean): Promise<BehaviorTreeSaved>;
     subscribeRosout(options: RosoutOptions, handlers: RosoutHandlers): () => void;
+    subscribeDiagnostics(options: DiagnosticsOptions, handlers: DiagnosticsHandlers): () => void;
+    subscribeTerminal(options: TerminalOptions, handlers: TerminalHandlers): {
+        id: number;
+        unsubscribe: () => void;
+    };
+    terminalInput(id: number, data: string): boolean;
+    resizeTerminal(id: number, cols: number, rows: number): boolean;
+    ackTerminal(id: number, started: number, offset: number): boolean;
+    restartTerminal(id: number): boolean;
     serviceAction(unit: string, scope: ServiceScope, verb: ServiceVerb): Promise<string | null>;
     publish(topic: string, messageType: string, message: unknown): boolean;
     callService<T = unknown>(service: string, serviceType: string, request?: unknown, timeoutMs?: number): Promise<T>;

package/dist/types/client/icons.d.ts

@@ -56,3 +56,30 @@ export declare const BanIcon: (props: SVGProps<SVGSVGElement>) => import("react"
 export declare const FilterIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
 export declare const DownloadIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
 export declare const ArrowDownToLineIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const DiagnosticsIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const UnfoldIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const FolderIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const FolderPlusIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const FileIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const FileTextIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const FilePlusIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const UploadIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const ArrowUpIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const ArrowLeftIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const HomeIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const HardDriveIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const BookmarkIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const SidebarIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const PieChartIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const InfoIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const WrapIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const LinkIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const LockIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const ArchiveIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const ShellIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const KeyboardIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const MaximizeIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const MinimizeIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const ClipboardIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const TextSmallerIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;
+export declare const TextLargerIcon: (props: SVGProps<SVGSVGElement>) => import("react").JSX.Element;

package/dist/types/client/sdk/index.d.ts

@@ -1,10 +1,11 @@
 export { defineWidget, definePlugin, type WidgetDefinition, type WidgetProps, type PropertySchema, type Property, type RegisteredWidget, type TasselloClientPlugin, } from '../widgets/types.ts';
-export { connection, useConnectionStatus, useTopic, useTf, useCommandState, type BehaviorTreeFileHandlers, type BehaviorTreeFileOptions, type BehaviorTreeHandlers, type BehaviorTreeOptions, type BehaviorTreePlaybackOptions, type BehaviorTreePlaybackRequest, type Connection, type ConnectionStatus, type TopicState, type TopicHandlers, type TopicOptions, type PluginStreamHandlers, type RosoutHandlers, type RosoutOptions, type StreamHandlers, type FrameInfo, type ImageOptions, type TfOptions, } from '../connection.ts';
-export { imageUrl } from '../api.ts';
+export { connection, useConnectionStatus, useTopic, useTf, useCommandState, type BehaviorTreeFileHandlers, type BehaviorTreeFileOptions, type BehaviorTreeHandlers, type BehaviorTreeOptions, type BehaviorTreePlaybackOptions, type BehaviorTreePlaybackRequest, type Connection, type ConnectionStatus, type TopicState, type TopicHandlers, type TopicOptions, type PluginStreamHandlers, type RosoutHandlers, type RosoutOptions, type DiagnosticsHandlers, type DiagnosticsOptions, type TerminalHandlers, type TerminalOptions, type StreamHandlers, type FrameInfo, type ImageOptions, type TfOptions, } from '../connection.ts';
+export { imageUrl, fsApi, ApiError, type Upload } from '../api.ts';
 export { useDialogs, Modal, type Dialogs, type ConfirmOptions, type PromptOptions } from '../dialogs.tsx';
 export { notify } from '../notifications.tsx';
 export { Joystick, type JoystickProps } from '../widgets/Joystick.tsx';
 export * from '../icons.tsx';
-export type { BehaviorTreeFile, BehaviorTreeInfo, BehaviorTreeModels, BehaviorTreePlaybackState, BehaviorTreeRecording, BehaviorTreeSaved, BehaviorTreeUpdate, BtNode, BtNodeLibrary, BtNodeState, BtTransition, CommandState, ClientMessage, LogEntry, RosoutUpdate, ServerMessage, StreamStatus, TfUpdate, Transform2D, } from '../../shared/protocol.ts';
+export type { BehaviorTreeFile, BehaviorTreeInfo, BehaviorTreeModels, BehaviorTreePlaybackState, BehaviorTreeRecording, BehaviorTreeSaved, BehaviorTreeUpdate, BtNode, BtNodeLibrary, BtNodeState, BtTransition, CommandState, ClientMessage, DiagnosticChange, DiagnosticEntry, DiagnosticsUpdate, LogEntry, RosoutUpdate, ServerMessage, StreamStatus, TerminalExit, TerminalOutput, TfUpdate, Transform2D, } from '../../shared/protocol.ts';
 export type { BtNodeModel, BtPortModel } from '../../shared/bt_nodes.ts';
+export type { FsAnalysis, FsConflict, FsDetails, FsDisk, FsEntry, FsListing, FsOperation, FsPlaces, FsResult, FsSaved, FsSpace, FsText, } from '../../shared/file_manager.ts';
 export type { Panel, WidgetInstance } from '../../shared/panel.ts';

package/dist/types/shared/file_manager.d.ts

@@ -0,0 +1,130 @@
+export interface FsEntry {
+    name: string;
+    kind: 'dir' | 'file' | 'other';
+    link: string | null;
+    size: number;
+    modified: number;
+    mode: number;
+    owner: string;
+    group: string;
+    readable: boolean;
+    writable: boolean;
+    bag: boolean;
+}
+export interface FsSpace {
+    mount: string;
+    total: number;
+    free: number;
+}
+export interface FsListing {
+    path: string;
+    parent: string | null;
+    entries: FsEntry[];
+    truncated: number;
+    writable: boolean;
+    version: string;
+    space: FsSpace | null;
+}
+export interface FsPlaces {
+    home: string;
+    user: string;
+    ros: {
+        name: string;
+        path: string;
+    }[];
+}
+export interface FsDetails extends FsEntry {
+    path: string;
+    realPath: string | null;
+    created: number | null;
+    accessed: number;
+    changed: number;
+    inode: number;
+    links: number;
+    items: number | null;
+    hidden: number | null;
+    space: FsSpace | null;
+}
+export interface FsDisk extends FsSpace {
+    device: string;
+    type: string;
+    readOnly: boolean;
+    used: number;
+    inodes: {
+        total: number;
+        free: number;
+    } | null;
+}
+export interface FsAnalysis {
+    path: string;
+    size: number;
+    disk: number;
+    files: number;
+    folders: number;
+    links: number;
+    children: {
+        name: string;
+        kind: FsEntry['kind'];
+        size: number;
+        files: number;
+    }[];
+    types: {
+        type: string;
+        files: number;
+        size: number;
+    }[];
+    largest: {
+        path: string;
+        size: number;
+    }[];
+    recent: {
+        path: string;
+        modified: number;
+    }[];
+    partial: string | null;
+    unreadable: number;
+    mounts: number;
+    elapsedMs: number;
+}
+export interface FsText {
+    path: string;
+    text: string;
+    version: string;
+    stamp: string;
+    readOnly: string | null;
+}
+export interface FsSaved {
+    version: string;
+    stamp: string;
+    conflict: boolean;
+}
+export type FsConflict = 'ask' | 'skip' | 'keep-both' | 'replace';
+export type FsOperation = {
+    op: 'mkdir';
+    path: string;
+} | {
+    op: 'create';
+    path: string;
+} | {
+    op: 'rename';
+    path: string;
+    name: string;
+} | {
+    op: 'move' | 'copy';
+    paths: string[];
+    to: string;
+    conflict: FsConflict;
+} | {
+    op: 'delete';
+    paths: string[];
+} | {
+    op: 'chmod';
+    path: string;
+    mode: number;
+};
+export interface FsResult {
+    paths: string[];
+    conflicts: string[];
+}
+export declare const FS_MAX_ENTRIES = 5000;
+export declare const FS_MAX_TEXT_BYTES: number;