@vicinae/api 0.8.2 → 0.8.4

package/README.md

@@ -5,6 +5,12 @@ This package lets you extend the [Vicinae](https://docs.vicinae.com/) launcher u
 
 # Getting started
 
+The recommend way to start developing a new extension is to [read the docs](https://docs.vicinae.com/extensions/introduction).
+
+You can stop reading this.
+
+# Installation 
+
 Install the package:
 
 ```

package/dist/api/ai.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AI = void 0;
 const stream_1 = require("stream");
-const bus_1 = require("./bus");
 const crypto_1 = require("crypto");
+const bus_1 = require("./bus");
 var AI;
 (function (AI) {
     /**

package/dist/api/bus.d.ts

@@ -82,6 +82,12 @@ declare class Bus {
     };
     emit(action: string, data: Record<string, any>): void;
     sendMessage(message: ipc.ExtensionMessage): void;
+    addEventHandler(cb: EventListenerInfo['callback']): {
+        id: string;
+        unsubscribe: () => void;
+    };
+    replaceEventHandler(id: string, handler: EventListenerInfo['callback']): void;
+    removeEventHandler(id: string): void;
     request2(data: extension.RequestData, options?: {
         timeout?: number;
     }): Promise<Result<extension.ResponseData, Error>>;
@@ -90,6 +96,9 @@ declare class Bus {
         rejectOnError?: boolean;
     }): Promise<Message<T>>;
 }
-export declare const createHandler: (handler: (...args: any[]) => void) => string;
+/**
+ * IPC bus to communicate with the extension manager.
+ * If you are using this from inside your extension, you are WRONG and you should stop.
+ */
 export declare const bus: Bus;
 export {};

package/dist/api/bus.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bus = exports.createHandler = void 0;
+exports.bus = void 0;
 const crypto_1 = require("crypto");
 const worker_threads_1 = require("worker_threads");
 const ipc = __importStar(require("./proto/ipc"));
@@ -142,6 +142,19 @@ class Bus {
     sendMessage(message) {
         this.port.postMessage(ipc.ExtensionMessage.encode(message).finish());
     }
+    addEventHandler(cb) {
+        const id = `handler-${(0, crypto_1.randomUUID)()}`;
+        const { unsubscribe } = this.subscribe(id, cb);
+        return { id, unsubscribe };
+    }
+    replaceEventHandler(id, handler) {
+        for (const listener of this.eventListeners.get(id) ?? []) {
+            listener.callback = handler;
+        }
+    }
+    removeEventHandler(id) {
+        this.eventListeners.delete(id);
+    }
     request2(data, options = {}) {
         const req = extension.Request.create({ requestId: (0, crypto_1.randomUUID)(), data });
         return new Promise((resolve, reject) => {
@@ -202,10 +215,8 @@ class Bus {
         });
     }
 }
-const createHandler = (handler) => {
-    const id = (0, crypto_1.randomUUID)();
-    exports.bus.subscribe(id, handler);
-    return id;
-};
-exports.createHandler = createHandler;
+/**
+ * IPC bus to communicate with the extension manager.
+ * If you are using this from inside your extension, you are WRONG and you should stop.
+ */
 exports.bus = new Bus(worker_threads_1.parentPort);

package/dist/api/components/action-pannel.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActionPanel = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const image_1 = require("../image");
-const hooks_1 = require("../hooks");
 const ActionPanelRoot = (props) => {
     const nativeProps = props;
     return (0, jsx_runtime_1.jsx)("action-panel", { ...nativeProps });
@@ -15,11 +14,7 @@ const ActionPanelSection = (props) => {
     return ((0, jsx_runtime_1.jsx)("action-panel-section", { ...nativeProps, children: props.children }));
 };
 const ActionPannelSubmenu = ({ icon, children, onOpen, onSearchTextChange, ...props }) => {
-    const onSearchTextChangeHandler = (0, hooks_1.useEventListener)(onSearchTextChange);
-    const onOpenHandler = (0, hooks_1.useEventListener)(onOpen);
     const nativeProps = props;
-    nativeProps.onSearchTextChange = onSearchTextChangeHandler;
-    nativeProps.onOpen = onOpenHandler;
     if (icon)
         nativeProps.icon = (0, image_1.serializeImageLike)(icon);
     return ((0, jsx_runtime_1.jsx)("action-panel-submenu", { ...nativeProps, children: children }));

package/dist/api/components/actions.js

@@ -6,15 +6,11 @@ const index_1 = require("../hooks/index");
 const clipboard_1 = require("../clipboard");
 const image_1 = require("../image");
 const utils_1 = require("../utils");
-const hooks_1 = require("../hooks");
 const icon_1 = require("../icon");
 const controls_1 = require("../controls");
 const ActionRoot = ({ icon, ...props }) => {
-    const handler = (0, hooks_1.useEventListener)(props.onAction);
     const nativeProps = {
         ...props,
-        icon,
-        onAction: handler,
     };
     if (icon) {
         nativeProps.icon = (0, image_1.serializeImageLike)(icon);
@@ -52,15 +48,11 @@ const Push = ({ target, ...props }) => {
             push(target);
         } }));
 };
-const SubmitForm = ({ onSubmit, icon, title = "Submit", ...props }) => {
-    const submitHandler = (0, hooks_1.useEventListener)(onSubmit);
-    const handler = (0, hooks_1.useEventListener)(() => { });
+const SubmitForm = ({ icon, title = "Submit", ...props }) => {
     const nativeProps = {
         ...props,
         title,
-        icon,
-        onSubmit: submitHandler,
-        onAction: handler,
+        onAction: () => { }
     };
     if (icon) {
         nativeProps.icon = (0, image_1.serializeImageLike)(icon);

package/dist/api/components/dropdown.js

@@ -3,14 +3,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Dropdown = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const image_1 = require("../image");
-const hooks_1 = require("../hooks");
 const DropdownRoot = ({ children, ...props }) => {
-    const onSearchTextChange = (0, hooks_1.useEventListener)(props.onSearchTextChange);
-    const onChange = (0, hooks_1.useEventListener)(props.onChange);
-    return ((0, jsx_runtime_1.jsx)("dropdown", { onSearchTextChange: onSearchTextChange, onChange: onChange, children: children }));
+    return ((0, jsx_runtime_1.jsx)("dropdown", { ...props, children: children }));
 };
 const Item = ({ title, value, icon }) => {
-    return ((0, jsx_runtime_1.jsx)("dropdown-item", { title: title, value: value, icon: icon && (0, image_1.serializeImageLike)(icon) }));
+    return ((0, jsx_runtime_1.jsx)("dropdown-item", { title: title, value: value, icon: icon ? (0, image_1.serializeImageLike)(icon) : undefined }));
 };
 const Section = ({ title, children }) => {
     return (0, jsx_runtime_1.jsx)("dropdown-section", { title: title, children: children });

package/dist/api/components/form.js

@@ -3,16 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Form = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const use_imperative_form_handle_1 = require("../hooks/use-imperative-form-handle");
-const hooks_1 = require("../hooks");
 const FormRoot = ({ enableDrafts = false, actions, children, isLoading = false, navigationTitle, searchBarAccessory, }) => {
     return ((0, jsx_runtime_1.jsxs)("form", { enableDrafts: enableDrafts, isLoading: isLoading, navigationTitle: navigationTitle, children: [searchBarAccessory, children, actions] }));
 };
-const TextField = ({ ref, onChange, onBlur, onFocus, ...props }) => {
+const TextField = ({ ref, ...props }) => {
     (0, use_imperative_form_handle_1.useImperativeFormHandle)(ref);
-    const blur = (0, hooks_1.useEventListener)(onBlur);
-    const focus = (0, hooks_1.useEventListener)(onFocus);
-    const change = (0, hooks_1.useEventListener)(onChange);
-    return ((0, jsx_runtime_1.jsx)("text-field", { onBlur: blur, onFocus: focus, onChange: change, ...props }));
+    return ((0, jsx_runtime_1.jsx)("text-field", { ...props }));
 };
 const PasswordField = ({ ...props }) => {
     return (0, jsx_runtime_1.jsx)("password-field", { ...props });
@@ -20,20 +16,12 @@ const PasswordField = ({ ...props }) => {
 const DatePicker = ({ ...props }) => {
     return (0, jsx_runtime_1.jsx)("date-picker-field", { ...props });
 };
-const Checkbox = ({ ref, onBlur, onFocus, onChange, ...props }) => {
+const Checkbox = ({ ref, ...props }) => {
     (0, use_imperative_form_handle_1.useImperativeFormHandle)(ref);
-    const blur = (0, hooks_1.useEventListener)(onBlur);
-    const focus = (0, hooks_1.useEventListener)(onFocus);
-    const change = (0, hooks_1.useEventListener)(onChange);
-    return ((0, jsx_runtime_1.jsx)("checkbox-field", { onBlur: blur, onFocus: focus, onChange: change, ...props }));
+    return ((0, jsx_runtime_1.jsx)("checkbox-field", { ...props }));
 };
-const Dropdown = ({ children, onBlur, onFocus, onChange, ...props }) => {
-    const onSearchTextChange = (0, hooks_1.useEventListener)(props.onSearchTextChange);
-    const blur = (0, hooks_1.useEventListener)(onBlur);
-    const focus = (0, hooks_1.useEventListener)(onFocus);
-    const change = (0, hooks_1.useEventListener)(onChange);
-    const rest = { ...props, onSearchTextChange };
-    return ((0, jsx_runtime_1.jsx)("dropdown-field", { onBlur: blur, onFocus: focus, onChange: change, ...rest, children: children }));
+const Dropdown = ({ children, ...props }) => {
+    return ((0, jsx_runtime_1.jsx)("dropdown-field", { ...props, children: children }));
 };
 exports.Form = Object.assign(FormRoot, {
     TextField,

package/dist/api/components/grid.js

@@ -6,7 +6,6 @@ const react_1 = require("react");
 const image_1 = require("../image");
 const crypto_1 = require("crypto");
 const empty_view_1 = require("./empty-view");
-const hooks_1 = require("../hooks");
 const dropdown_1 = require("./dropdown");
 var GridInset;
 (function (GridInset) {
@@ -19,14 +18,12 @@ var GridFit;
     GridFit["Contain"] = "contain";
     GridFit["Fill"] = "fill";
 })(GridFit || (GridFit = {}));
-const GridRoot = ({ onSearchTextChange, searchBarAccessory, onSelectionChange, children, actions, inset, fit = GridFit.Contain, aspectRatio = "1", ...props }) => {
-    const searchTextChangeHandler = (0, hooks_1.useEventListener)(onSearchTextChange);
-    const selectionChangeHandler = (0, hooks_1.useEventListener)(onSelectionChange);
+const GridRoot = ({ searchBarAccessory, children, actions, inset, fit = GridFit.Contain, aspectRatio = "1", ...props }) => {
     if (typeof props.enableFiltering === "boolean" &&
         typeof props.filtering === "undefined") {
         props.filtering = props.enableFiltering;
     }
-    return ((0, jsx_runtime_1.jsxs)("grid", { fit: fit, inset: inset, aspectRatio: aspectRatio, onSearchTextChange: searchTextChangeHandler, onSelectionChange: selectionChangeHandler, ...props, children: [searchBarAccessory, children, actions] }));
+    return ((0, jsx_runtime_1.jsxs)("grid", { fit: fit, inset: inset, aspectRatio: aspectRatio, ...props, children: [searchBarAccessory, children, actions] }));
 };
 const GridItem = ({ detail, actions, keywords, ...props }) => {
     const id = (0, react_1.useRef)(props.id ?? (0, crypto_1.randomUUID)());

package/dist/api/components/list.js

@@ -7,16 +7,13 @@ const image_1 = require("../image");
 const crypto_1 = require("crypto");
 const metadata_1 = require("./metadata");
 const empty_view_1 = require("./empty-view");
-const hooks_1 = require("../hooks");
 const dropdown_1 = require("./dropdown");
-const ListRoot = ({ onSearchTextChange, searchBarAccessory, onSelectionChange, children, actions, ...props }) => {
-    const searchTextChangeHandler = (0, hooks_1.useEventListener)(onSearchTextChange);
-    const selectionChangeHandler = (0, hooks_1.useEventListener)(onSelectionChange);
+const ListRoot = ({ searchBarAccessory, children, actions, ...props }) => {
     if (typeof props.enableFiltering === "boolean" &&
         typeof props.filtering === "undefined") {
         props.filtering = props.enableFiltering;
     }
-    return ((0, jsx_runtime_1.jsxs)("list", { onSearchTextChange: searchTextChangeHandler, onSelectionChange: selectionChangeHandler, ...props, children: [searchBarAccessory, children, actions] }));
+    return ((0, jsx_runtime_1.jsxs)("list", { ...props, children: [searchBarAccessory, children, actions] }));
 };
 const ListItem = ({ detail, actions, ...props }) => {
     const id = (0, react_1.useRef)(props.id ?? (0, crypto_1.randomUUID)());

package/dist/api/components/tag.js

@@ -4,7 +4,6 @@ exports.TagList = void 0;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const image_1 = require("../image");
 const color_1 = require("../color");
-const hooks_1 = require("../hooks");
 const TagListRoot = ({ title, children }) => {
     const nativeProps = {
         title,
@@ -12,11 +11,10 @@ const TagListRoot = ({ title, children }) => {
     };
     return (0, jsx_runtime_1.jsx)("tag-list", { ...nativeProps });
 };
-const TagItem = ({ color, icon, text, onAction }) => {
-    const onActionHandler = (0, hooks_1.useEventListener)(onAction);
+const TagItem = ({ color, icon, text, ...props }) => {
     const nativeProps = {
+        ...props,
         text,
-        onAction: onActionHandler,
     };
     if (color)
         nativeProps.color = (0, color_1.serializeColorLike)(color);

package/dist/api/context/navigation-provider.js

@@ -14,9 +14,10 @@ const View = ({ children }) => {
 const NavigationProvider = ({ root }) => {
     const [navStack, setNavStack] = (0, react_1.useState)([root]);
     const pop = () => {
-        bus_1.bus.turboRequest("ui.popView", {}).then(() => {
-            setNavStack((cur) => cur.slice(0, -1));
-        });
+        // we ask Vicinae to pop the current view, but we need to wait
+        // for the pop-view event to be fired in order to dismount it from
+        // our local view stack: otherwise Vicinae might miss a render.
+        bus_1.bus.turboRequest("ui.popView", {});
     };
     const push = (node) => {
         bus_1.bus.turboRequest("ui.pushView", {}).then(() => {

package/dist/api/hooks.d.ts

@@ -1 +1 @@
-export declare const useEventListener: (fn: ((...args: any[]) => void) | undefined) => string | undefined;
+export {};

package/dist/api/hooks.js

@@ -1,26 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useEventListener = void 0;
-const react_1 = require("react");
-const bus_1 = require("./bus");
 const handlerIdFactory = {
     nextHandlerId: 0,
     next() {
         return this.nextHandlerId++;
     },
 };
-const useEventListener = (fn) => {
-    const id = (0, react_1.useRef)(`handler:${handlerIdFactory.next()}`);
-    const callback = (0, react_1.useRef)();
-    (0, react_1.useEffect)(() => {
-        const { unsubscribe } = bus_1.bus.subscribe(id.current, (...args) => {
-            callback.current?.(...args);
-        });
-        return unsubscribe;
-    }, []);
-    (0, react_1.useEffect)(() => {
-        callback.current = fn;
-    }, [fn]);
-    return fn && id.current;
+/*
+export const useEventListener = (
+  fn: ((...args: any[]) => void) | undefined,
+) => {
+  const id = useRef(`handler:${handlerIdFactory.next()}`);
+  const callback = useRef<((...args: any[]) => void) | undefined>();
+
+  useEffect(() => {
+    const { unsubscribe } = bus.subscribe(id.current, (...args: any[]) => {
+      callback.current?.(...args);
+    });
+
+    return unsubscribe;
+  }, []);
+
+  useEffect(() => {
+    callback.current = fn;
+  }, [fn]);
+
+  return fn && id.current;
 };
-exports.useEventListener = useEventListener;
+*/

package/dist/api/proto/daemon.d.ts

@@ -0,0 +1,36 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "proto.ext.daemon";
+export interface UrlResponse {
+}
+export interface UrlRequest {
+    url: string;
+}
+export interface Request {
+    url?: UrlRequest | undefined;
+}
+export interface Response {
+    url?: UrlResponse | undefined;
+}
+export declare const UrlResponse: MessageFns<UrlResponse>;
+export declare const UrlRequest: MessageFns<UrlRequest>;
+export declare const Request: MessageFns<Request>;
+export declare const Response: MessageFns<Response>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};

package/dist/api/proto/daemon.js

@@ -0,0 +1,214 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.7.5
+//   protoc               v6.31.1
+// source: daemon.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Response = exports.Request = exports.UrlRequest = exports.UrlResponse = exports.protobufPackage = void 0;
+/* eslint-disable */
+const wire_1 = require("@bufbuild/protobuf/wire");
+exports.protobufPackage = "proto.ext.daemon";
+function createBaseUrlResponse() {
+    return {};
+}
+exports.UrlResponse = {
+    encode(_, writer = new wire_1.BinaryWriter()) {
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseUrlResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(_) {
+        return {};
+    },
+    toJSON(_) {
+        const obj = {};
+        return obj;
+    },
+    create(base) {
+        return exports.UrlResponse.fromPartial(base ?? {});
+    },
+    fromPartial(_) {
+        const message = createBaseUrlResponse();
+        return message;
+    },
+};
+function createBaseUrlRequest() {
+    return { url: "" };
+}
+exports.UrlRequest = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.url !== "") {
+            writer.uint32(10).string(message.url);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseUrlRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.url = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return { url: isSet(object.url) ? globalThis.String(object.url) : "" };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.url !== "") {
+            obj.url = message.url;
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.UrlRequest.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseUrlRequest();
+        message.url = object.url ?? "";
+        return message;
+    },
+};
+function createBaseRequest() {
+    return { url: undefined };
+}
+exports.Request = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.url !== undefined) {
+            exports.UrlRequest.encode(message.url, writer.uint32(10).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseRequest();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.url = exports.UrlRequest.decode(reader, reader.uint32());
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            url: isSet(object.url) ? exports.UrlRequest.fromJSON(object.url) : undefined,
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.url !== undefined) {
+            obj.url = exports.UrlRequest.toJSON(message.url);
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.Request.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseRequest();
+        message.url =
+            object.url !== undefined && object.url !== null
+                ? exports.UrlRequest.fromPartial(object.url)
+                : undefined;
+        return message;
+    },
+};
+function createBaseResponse() {
+    return { url: undefined };
+}
+exports.Response = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.url !== undefined) {
+            exports.UrlResponse.encode(message.url, writer.uint32(10).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseResponse();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.url = exports.UrlResponse.decode(reader, reader.uint32());
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            url: isSet(object.url) ? exports.UrlResponse.fromJSON(object.url) : undefined,
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.url !== undefined) {
+            obj.url = exports.UrlResponse.toJSON(message.url);
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.Response.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseResponse();
+        message.url =
+            object.url !== undefined && object.url !== null
+                ? exports.UrlResponse.fromPartial(object.url)
+                : undefined;
+        return message;
+    },
+};
+function isSet(value) {
+    return value !== null && value !== undefined;
+}

package/dist/api/proto/wlr-clipboard.d.ts

@@ -0,0 +1,30 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+export declare const protobufPackage = "proto.ext.wlrclip";
+export interface Offer {
+    data: Uint8Array;
+    mimeType: string;
+}
+export interface Selection {
+    offers: Offer[];
+}
+export declare const Offer: MessageFns<Offer>;
+export declare const Selection: MessageFns<Selection>;
+type Builtin = Date | Function | Uint8Array | string | number | boolean | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type KeysOfUnion<T> = T extends T ? keyof T : never;
+export type Exact<P, I extends P> = P extends Builtin ? P : P & {
+    [K in keyof P]: Exact<P[K], I[K]>;
+} & {
+    [K in Exclude<keyof I, KeysOfUnion<P>>]: never;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create<I extends Exact<DeepPartial<T>, I>>(base?: I): T;
+    fromPartial<I extends Exact<DeepPartial<T>, I>>(object: I): T;
+}
+export {};

package/dist/api/proto/wlr-clipboard.js

@@ -0,0 +1,166 @@
+"use strict";
+// Code generated by protoc-gen-ts_proto. DO NOT EDIT.
+// versions:
+//   protoc-gen-ts_proto  v2.7.5
+//   protoc               v6.31.1
+// source: wlr-clipboard.proto
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Selection = exports.Offer = exports.protobufPackage = void 0;
+/* eslint-disable */
+const wire_1 = require("@bufbuild/protobuf/wire");
+exports.protobufPackage = "proto.ext.wlrclip";
+function createBaseOffer() {
+    return { data: new Uint8Array(0), mimeType: "" };
+}
+exports.Offer = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        if (message.data.length !== 0) {
+            writer.uint32(10).bytes(message.data);
+        }
+        if (message.mimeType !== "") {
+            writer.uint32(18).string(message.mimeType);
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseOffer();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.data = reader.bytes();
+                    continue;
+                }
+                case 2: {
+                    if (tag !== 18) {
+                        break;
+                    }
+                    message.mimeType = reader.string();
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            data: isSet(object.data)
+                ? bytesFromBase64(object.data)
+                : new Uint8Array(0),
+            mimeType: isSet(object.mimeType)
+                ? globalThis.String(object.mimeType)
+                : "",
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.data.length !== 0) {
+            obj.data = base64FromBytes(message.data);
+        }
+        if (message.mimeType !== "") {
+            obj.mimeType = message.mimeType;
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.Offer.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseOffer();
+        message.data = object.data ?? new Uint8Array(0);
+        message.mimeType = object.mimeType ?? "";
+        return message;
+    },
+};
+function createBaseSelection() {
+    return { offers: [] };
+}
+exports.Selection = {
+    encode(message, writer = new wire_1.BinaryWriter()) {
+        for (const v of message.offers) {
+            exports.Offer.encode(v, writer.uint32(10).fork()).join();
+        }
+        return writer;
+    },
+    decode(input, length) {
+        const reader = input instanceof wire_1.BinaryReader ? input : new wire_1.BinaryReader(input);
+        const end = length === undefined ? reader.len : reader.pos + length;
+        const message = createBaseSelection();
+        while (reader.pos < end) {
+            const tag = reader.uint32();
+            switch (tag >>> 3) {
+                case 1: {
+                    if (tag !== 10) {
+                        break;
+                    }
+                    message.offers.push(exports.Offer.decode(reader, reader.uint32()));
+                    continue;
+                }
+            }
+            if ((tag & 7) === 4 || tag === 0) {
+                break;
+            }
+            reader.skip(tag & 7);
+        }
+        return message;
+    },
+    fromJSON(object) {
+        return {
+            offers: globalThis.Array.isArray(object?.offers)
+                ? object.offers.map((e) => exports.Offer.fromJSON(e))
+                : [],
+        };
+    },
+    toJSON(message) {
+        const obj = {};
+        if (message.offers?.length) {
+            obj.offers = message.offers.map((e) => exports.Offer.toJSON(e));
+        }
+        return obj;
+    },
+    create(base) {
+        return exports.Selection.fromPartial(base ?? {});
+    },
+    fromPartial(object) {
+        const message = createBaseSelection();
+        message.offers = object.offers?.map((e) => exports.Offer.fromPartial(e)) || [];
+        return message;
+    },
+};
+function bytesFromBase64(b64) {
+    if (globalThis.Buffer) {
+        return Uint8Array.from(globalThis.Buffer.from(b64, "base64"));
+    }
+    else {
+        const bin = globalThis.atob(b64);
+        const arr = new Uint8Array(bin.length);
+        for (let i = 0; i < bin.length; ++i) {
+            arr[i] = bin.charCodeAt(i);
+        }
+        return arr;
+    }
+}
+function base64FromBytes(arr) {
+    if (globalThis.Buffer) {
+        return globalThis.Buffer.from(arr).toString("base64");
+    }
+    else {
+        const bin = [];
+        arr.forEach((byte) => {
+            bin.push(globalThis.String.fromCharCode(byte));
+        });
+        return globalThis.btoa(bin.join(""));
+    }
+}
+function isSet(value) {
+    return value !== null && value !== undefined;
+}

package/dist/api/toast.js

@@ -43,13 +43,15 @@ class Toast {
         };
         if (props.primaryAction) {
             const { onAction } = props.primaryAction;
+            const { id } = bus_1.bus.addEventHandler(() => onAction(this));
             this.options.primaryAction = props.primaryAction;
-            this.callbacks.primary = (0, bus_1.createHandler)(() => onAction(this));
+            this.callbacks.primary = id;
         }
         if (props.secondaryAction) {
             const { onAction } = props.secondaryAction;
+            const { id } = bus_1.bus.addEventHandler(() => onAction(this));
             this.options.secondaryAction = props.secondaryAction;
-            this.callbacks.secondary = (0, bus_1.createHandler)(() => onAction(this));
+            this.callbacks.secondary = id;
         }
     }
     /**

package/dist/commands/develop/index.js

@@ -67,17 +67,20 @@ class Develop extends core_1.Command {
         const { flags } = await this.parse(Develop);
         const logger = new logger_js_1.Logger();
         const pkgPath = (0, node_path_1.join)(flags.target, "package.json");
-        if (!(0, node_fs_1.existsSync)(pkgPath)) {
-            logger.logError(`No package.json found at ${pkgPath}. Does this location point to a valid extension repository?`);
-            process.exit(1);
-        }
-        const json = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, "utf8"));
-        const e = manifest_js_1.default.safeParse(json);
-        if (e.error) {
-            logger.logError(`${pkgPath} is not a valid extension manifest: ${e.error}`);
-            process.exit(1);
-        }
-        const manifest = e.data;
+        const parseManifest = () => {
+            if (!(0, node_fs_1.existsSync)(pkgPath)) {
+                logger.logError(`No package.json found at ${pkgPath}. Does this location point to a valid extension repository?`);
+                process.exit(1);
+            }
+            const json = JSON.parse((0, node_fs_1.readFileSync)(pkgPath, "utf8"));
+            const e = manifest_js_1.default.safeParse(json);
+            if (e.error) {
+                logger.logError(`${pkgPath} is not a valid extension manifest: ${e.error}`);
+                process.exit(1);
+            }
+            return e.data;
+        };
+        let manifest = parseManifest();
         const vicinae = new vicinae_js_1.VicinaeClient();
         const typeCheck = async () => {
             const spawned = (0, node_child_process_1.spawn)("npx", ["tsc", "--noEmit"]);
@@ -90,14 +93,17 @@ class Develop extends core_1.Command {
             });
         };
         const build = async (outDir) => {
+            /*
             logger.logInfo("Started type checking in background thread");
             typeCheck().then(({ error, ok }) => {
-                if (!ok) {
-                    logger.logInfo(`Type checking error: ${error}`);
-                }
-                logger.logInfo("Done type checking");
+              if (!ok) {
+                logger.logInfo(`Type checking error: ${error}`);
+              }
+      
+              logger.logInfo("Done type checking");
             });
-            const entryPoints = manifest.commands.map((cmd) => (0, node_path_1.join)("src", `${cmd.name}.tsx`));
+            */
+            const entryPoints = manifest.commands.map((cmd) => (0, node_path_1.join)("src", `${cmd.name}.tsx`)).filter(node_fs_1.existsSync);
             logger.logInfo(`entrypoints [${entryPoints.join(", ")}]`);
             const promises = manifest.commands.map((cmd) => {
                 const base = (0, node_path_1.join)(process.cwd(), "src", `${cmd.name}`);
@@ -105,14 +111,14 @@ class Develop extends core_1.Command {
                 const tsSource = `${base}.ts`;
                 let source = tsxSource;
                 if (cmd.mode == "view" && !(0, node_fs_1.existsSync)(tsxSource)) {
-                    throw new Error(`Unable to find view command ${cmd.name} at ${tsxSource}`);
+                    throw new Error(`could not find entrypoint src/${cmd.name}.tsx for command ${cmd.name}.`);
                 }
                 // we allow .ts or .tsx for no-view
                 if (cmd.mode == "no-view") {
                     if (!(0, node_fs_1.existsSync)(tsxSource)) {
                         source = tsSource;
                         if (!(0, node_fs_1.existsSync)(tsSource)) {
-                            throw new Error(`Unable to find no-view command ${cmd.name} at ${base}.{ts,tsx}`);
+                            throw new Error(`could not find entrypoint src/${cmd.name}.{ts,tsx} for command ${cmd.name}.`);
                         }
                     }
                 }
@@ -141,6 +147,23 @@ class Develop extends core_1.Command {
             console.error(`Failed to ping vicinae\n`, pingError.message);
             return;
         }
+        const safeBuild = async (extensionDir) => {
+            try {
+                const start = performance.now();
+                await build(extensionDir);
+                const time = performance.now() - start;
+                logger.logReady(`Extension built in ${Math.round(time)}ms 🚀`);
+                vicinae.refreshDevSession(id);
+            }
+            catch (error) {
+                if (error instanceof Error) {
+                    logger.logError(`Failed to build extension: ${error.message}`);
+                }
+                else {
+                    logger.logError(`Failed to build extension: ${error}`);
+                }
+            }
+        };
         process.chdir(flags.target);
         const dataDir = (0, utils_js_1.extensionDataDir)();
         const id = `${manifest.name}`;
@@ -148,10 +171,9 @@ class Develop extends core_1.Command {
         const logFile = (0, node_path_1.join)(extensionDir, "dev.log");
         const pidFile = (0, node_path_1.join)(extensionDir, "cli.pid");
         (0, node_fs_1.mkdirSync)(extensionDir, { recursive: true });
-        await build(extensionDir);
-        logger.logReady("built extension successfully");
         (0, node_fs_1.writeFileSync)(pidFile, `${process.pid}`);
         (0, node_fs_1.writeFileSync)(logFile, "");
+        await safeBuild(extensionDir);
         process.on("SIGINT", () => {
             logger.logInfo("Shutting down...");
             vicinae.stopDevSession(id);
@@ -167,16 +189,12 @@ class Develop extends core_1.Command {
             awaitWriteFinish: { pollInterval: 100, stabilityThreshold: 100 },
             ignoreInitial: true,
         })
-            .on("all", (_, path) => {
-            logger.logEvent(`changed file ${path}:`);
-            try {
-                build(extensionDir);
-                logger.logReady("built extension successfully");
-                vicinae.refreshDevSession(id);
-            }
-            catch (error) {
-                logger.logEvent(`Failed to build extension: ${error}`);
+            .on("all", async (_, path) => {
+            if (path.endsWith('package.json')) {
+                manifest = parseManifest();
             }
+            logger.logEvent(`changed file ${path}`);
+            await safeBuild(extensionDir);
         });
         const logFiles = new Map();
         chokidar.watch(logFile).on("all", async (_, path) => {
@@ -184,7 +202,7 @@ class Develop extends core_1.Command {
             if (!stats.isFile())
                 return;
             if (!logFiles.has(path)) {
-                logger.logInfo(`Monitoring new log file at ${path}`);
+                //logger.logInfo(`Monitoring new log file at ${path}`);
                 logFiles.set(path, { cursor: 0, path });
             }
             const info = logFiles.get(path);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vicinae/api",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "TypeScript SDK to build Vicinae extensions",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
@@ -29,8 +29,8 @@
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^5",
-    "@types/react": "^18.1.0",
     "@types/node": ">=18",
+    "@types/react": "^18.1.0",
     "chalk": "^5.6.0",
     "chokidar": "^4.0.3",
     "esbuild": "^0.25.2",

package/types/jsx.d.ts

@@ -0,0 +1,178 @@
+import * as React from "react";
+ 
+import type { ListItemDetailProps } from "../api/components/list";
+import { SerializedImageLike } from "../api/image";
+import { SerializedColorLike } from "../api/color";
+import { Keyboard } from "../api/keyboard";
+import { Grid } from "../api/components/grid";
+
+import 'react';
+
+declare module "react" {
+  namespace JSX {
+    interface IntrinsicElements {
+      detail: {
+        navigationTitle?: string;
+        markdown: string;
+      };
+      list: {
+        children?: React.ReactNode;
+        filtering?: boolean;
+        isLoading?: boolean;
+        isShowingDetail?: boolean;
+        searchBarPlaceholder?: string;
+        navigationTitle?: string;
+        onSearchTextChange?: (text: string) => void;
+        onSelectionChange?: (selectedItemId: string) => void;
+      };
+      "list-section": {
+        title?: string;
+        subtitle?: string;
+        children?: React.ReactNode;
+      };
+      "list-item": {
+        title: string;
+        id?: string;
+        subtitle?: string;
+        icon?: SerializedImageLike;
+        keywords?: string[];
+      };
+      "list-item-detail": ListItemDetailProps;
+      "list-item-detail-metadata": any;
+      "list-accessory": {};
+
+      grid: {
+        inset?: Grid.Inset;
+        columns?: number;
+        fit: Grid.Fit;
+        aspectRatio: Grid.AspectRatio;
+
+        children?: React.ReactNode;
+        filtering?: boolean;
+        isLoading?: boolean;
+        isShowingDetail?: boolean;
+        searchBarPlaceholder?: string;
+        navigationTitle?: string;
+        onSearchTextChange?: (text: string) => void;
+        onSelectionChange?: (selectedItemId: string) => void;
+      };
+      "grid-section": {
+        inset?: Grid.Inset;
+        columns?: number;
+        fit: Grid.Fit;
+        aspectRatio: Grid.AspectRatio;
+
+        title?: string;
+        subtitle?: string;
+        children?: React.ReactNode;
+      };
+      "grid-item": {
+        title?: string;
+        id?: string;
+        subtitle?: string;
+        content?: SerializedImageLike | { color: ColorLike } | { value: SerializedImageLike, tooltip?: string };
+        keywords?: string[];
+      };
+
+      "empty-view": {
+        description?: string;
+        title?: string;
+        icon?: SerializedImageLike;
+      };
+      metadata: {
+        children?: React.ReactNode;
+      };
+      "metadata-label": {
+        title: string;
+        text: string;
+        icon?: SerializedImageLike;
+      };
+      "metadata-separator": {};
+      "metadata-link": {
+        title: string;
+        target: string;
+        text: string;
+      };
+      "action-panel": {
+        title?: string;
+        children?: React.ReactNode;
+      };
+      "action-panel-submenu": {
+        title: string;
+        icon?: SerializedImageLike;
+        onOpen?: () => void;
+        onSearchTextChange?: (text: string) => void;
+        children?: React.ReactNode;
+      };
+      "action-panel-section": {
+        title?: string;
+        children?: React.ReactNode;
+      };
+      action: {
+        title: string;
+        onAction: () => void;
+        onSubmit?: Function;
+        shortcut?: Keyboard.Shortcut;
+        icon?: SerializedImageLike;
+        autoFocus?: boolean;
+      };
+      "tag-list": {
+        title?: string;
+        children?: React.ReactNode;
+      };
+      "tag-item": {
+        color?: SerializedColorLike;
+        icon?: SerializedImageLike;
+        text?: string;
+        onAction?: () => void;
+      };
+      form: {
+        enableDrafts: boolean;
+        isLoading: boolean;
+        navigationTitle?: string;
+        children?: React.ReactNode;
+      };
+      "text-field": {
+        onBlur?: Function;
+        onFocus?: Function;
+        onChange?: Function;
+      };
+      "dropdown-field": {
+        onBlur?: Function;
+        onFocus?: Function;
+        onChange?: Function;
+        children?: ReactNode;
+      };
+      "date-picker-field": {};
+      "checkbox-field": {
+        onBlur?: Function;
+        onFocus?: Function;
+        onChange?: Function;
+      };
+      "password-field": {};
+      "textarea-field": {};
+
+      dropdown: {
+        onChange?: Function;
+        onSearchTextChange?: (text: string) => void;
+        children?: ReactNode;
+      };
+      "dropdown-section": {
+        title?: string;
+        children: ReactNode;
+      };
+      "dropdown-item": {
+        title: string;
+        value: string;
+        icon?: SerializedImageLike;
+        keywords?: string[];
+      };
+
+      separator: {};
+      "menu-bar": {};
+      "menu-bar-item": {};
+      "menu-bar-submenu": {};
+      "menu-bar-section": {};
+    }
+  }
+}