epos 1.39.0 → 1.40.1

package/dist/epos-browser.d.ts

@@ -0,0 +1,103 @@
+import 'chrome';
+export type Browser = {
+    action: Action;
+    extension: Extension;
+    i18n: I18n;
+    management: Management;
+    permissions: Permissions;
+    runtime: Runtime;
+    windows: Windows;
+    alarms: Alarms;
+    declarativeNetRequest: DeclarativeNetRequest;
+    tabs: Tabs;
+    webNavigation: WebNavigation;
+    browsingData: BrowsingData;
+    contextMenus: ContextMenus;
+    cookies: Cookies;
+    downloads: Downloads;
+    notifications: Notifications;
+    sidePanel: SidePanel;
+    storage: Storage;
+};
+export type Alarms = typeof chrome.alarms;
+export type Cookies = typeof chrome.cookies;
+export type WebNavigation = typeof chrome.webNavigation;
+export type Windows = typeof chrome.windows;
+export type Action = Omit<typeof chrome.action, 'openPopup'>;
+export type Extension = Omit<typeof chrome.extension, 'getBackgroundPage' | 'getExtensionTabs' | 'getURL' | 'getViews' | 'lastError' | 'onRequest' | 'onRequestExternal' | 'sendRequest'>;
+export type I18n = Omit<typeof chrome.i18n, 'getMessage'>;
+export type Management = Omit<typeof chrome.management, 'createAppShortcut' | 'generateAppForLink' | 'get' | 'getAll' | 'getPermissionWarningsById' | 'installReplacementWebApp' | 'launchApp' | 'onDisabled' | 'onEnabled' | 'onInstalled' | 'onUninstalled' | 'setEnabled' | 'setLaunchType' | 'uninstall'>;
+export type Permissions = Omit<typeof chrome.permissions, 'contains' | 'getAll' | 'remove' | 'request' | 'addHostAccessRequest' | 'onAdded' | 'onRemoved' | 'removeHostAccessRequest'> & {
+    contains: (query: PermissionQuery) => Promise<boolean>;
+    getAll: () => Promise<{
+        origins: string[];
+        permissions: Permission[];
+    }>;
+    remove: (query: PermissionQuery) => Promise<boolean>;
+    request: (query: PermissionQuery) => Promise<boolean>;
+};
+export type PermissionQuery = {
+    origins?: string[];
+    permissions?: chrome.runtime.ManifestPermission[];
+};
+export type Permission = RequiredPermission | OptionalPermission;
+export type RequiredPermission = 'alarms' | 'declarativeNetRequest' | 'offscreen' | 'scripting' | 'tabs' | 'unlimitedStorage' | 'webNavigation';
+export type OptionalPermission = 'background' | 'browsingData' | 'contextMenus' | 'cookies' | 'downloads' | 'notifications' | 'sidePanel' | 'storage';
+export type Runtime = Omit<typeof chrome.runtime, 'getBackgroundPage' | 'onBrowserUpdateAvailable' | 'connect' | 'connectNative' | 'getPackageDirectoryEntry' | 'lastError' | 'onConnect' | 'onConnectExternal' | 'onConnectNative' | 'onInstalled' | 'OnInstalledReason' | 'onMessage' | 'onMessageExternal' | 'onRestartRequired' | 'OnRestartRequiredReason' | 'onStartup' | 'onSuspend' | 'onSuspendCanceled' | 'onUserScriptConnect' | 'onUserScriptMessage' | 'openOptionsPage' | 'restart' | 'restartAfterDelay' | 'sendMessage' | 'sendNativeMessage'>;
+export type DeclarativeNetRequest = Omit<typeof chrome.declarativeNetRequest, 'updateDynamicRules' | 'updateSessionRules' | 'getAvailableStaticRuleCount' | 'getDisabledRuleIds' | 'getEnabledRulesets' | 'getMatchedRules' | 'onRuleMatchedDebug' | 'setExtensionActionOptions' | 'testMatchOutcome' | 'updateEnabledRulesets' | 'updateStaticRules'> & {
+    /**
+     * Modifies the current set of dynamic rules for the extension. The rules with IDs listed in `options.removeRuleIds` are first removed, and then the rules given in `options.addRules` are added. Notes:
+     *
+     * - In `epos`, `addRules` cannot have IDs, instead IDs will be assigned automatically and returned in the result.
+     * - This update happens as a single atomic operation: either all specified rules are added and removed, or an error is returned.
+     * - These rules are persisted across browser sessions and across extension updates.
+     * - Static rules specified as part of the extension package can not be removed using this function.
+     * - {@link MAX_NUMBER_OF_DYNAMIC_RULES} is the maximum number of dynamic rules an extension can add. The number of [unsafe rules](https://developer.chrome.com/docs/extensions/reference/declarativeNetRequest/#safe_rules) must not exceed {@link MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES}.
+     *
+     * Can return its result via Promise in Manifest V3 or later since Chrome 91.
+     *
+     * @return An array of IDs of the rules that were added.
+     */
+    updateDynamicRules: (options: UpdateRuleOptions) => Promise<number[]>;
+    /**
+     * Modifies the current set of dynamic rules for the extension. The rules with IDs listed in `options.removeRuleIds` are first removed, and then the rules given in `options.addRules` are added. Notes:
+     *
+     * Can return its result via Promise in Manifest V3 or later since Chrome 91.
+     *
+     * - In `epos`, `addRules` cannot have IDs, instead IDs will be assigned automatically and returned in the result.
+     * - This update happens as a single atomic operation: either all specified rules are added and removed, or an error is returned.
+     * - These rules are persisted across browser sessions and across extension updates.
+     * - Static rules specified as part of the extension package can not be removed using this function.
+     * - {@link MAX_NUMBER_OF_DYNAMIC_RULES} is the maximum number of dynamic rules an extension can add. The number of [unsafe rules](https://developer.chrome.com/docs/extensions/reference/declarativeNetRequest/#safe_rules) must not exceed {@link MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES}.
+     *
+     * Can return its result via Promise in Manifest V3 or later since Chrome 91.
+     *
+     * @return An array of IDs of the rules that were added.
+     */
+    updateSessionRules: (options: UpdateRuleOptions) => Promise<number[]>;
+};
+export type UpdateRuleOptions = {
+    /** Rules to add. */
+    addRules?: Omit<chrome.declarativeNetRequest.Rule, 'id'>[] | undefined;
+    /** IDs of the rules to remove. Any invalid IDs will be ignored. */
+    removeRuleIds?: number[] | undefined;
+};
+export type Tabs = Omit<typeof chrome.tabs, 'executeScript' | 'getAllInWindow' | 'getSelected' | 'insertCSS' | 'onActiveChanged' | 'onHighlightChanged' | 'onSelectionChanged' | 'sendRequest' | 'connect' | 'sendMessage' | 'getCurrent'>;
+export type BrowsingData = Omit<typeof chrome.browsingData, 'removePasswords' | 'removePluginData'>;
+export type ContextMenus = Omit<typeof chrome.contextMenus, 'create'> & {
+    /**
+     * Creates a new context menu item.
+     * @return The ID of the newly created item.
+     */
+    create: (createProperties: chrome.contextMenus.CreateProperties) => Promise<string>;
+};
+export type Downloads = Omit<typeof chrome.downloads, 'setShelfEnabled' | 'open' | 'setUiOptions'>;
+export type Notifications = Omit<typeof chrome.notifications, 'onShowSettings' | 'getPermissionLevel' | 'onPermissionLevelChanged'>;
+export type SidePanel = Omit<typeof chrome.sidePanel, 'close' | 'open' | 'setOptions' | 'setPanelBehavior'> & {
+    onClosed: chrome.events.Event<() => void>;
+};
+export type Storage = Omit<typeof chrome.storage, 'local' | 'session' | 'sync' | 'managed'> & {
+    local: Omit<typeof chrome.storage.local, 'setAccessLevel'>;
+    session: Omit<typeof chrome.storage.session, 'setAccessLevel'>;
+    sync: Omit<typeof chrome.storage.sync, 'MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE' | 'setAccessLevel'>;
+};

package/dist/epos-browser.js

@@ -0,0 +1,2 @@
+import 'chrome';
+//# sourceMappingURL=epos-browser.js.map

package/dist/epos-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epos-browser.js","sourceRoot":"","sources":["../src/epos-browser.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,CAAA"}

package/dist/epos.d.ts

@@ -1,5 +1,4 @@
-/// <reference types="chrome" preserve="true" />
-import { type Spec } from 'epos-spec';
+import type { Spec } from 'epos-spec';
 import type * as mobx from 'mobx';
 import type * as mobxReactLite from 'mobx-react-lite';
 import type * as react from 'react';
@@ -7,6 +6,7 @@ import type * as reactDom from 'react-dom';
 import type * as reactDomClient from 'react-dom/client';
 import type * as reactJsxRuntime from 'react/jsx-runtime';
 import type * as yjs from 'yjs';
+import type { Browser } from './epos-browser.js';
 export type Fn = (...args: any[]) => unknown;
 export type Cls = new (...args: any[]) => unknown;
 export type Obj = Record<PropertyKey, unknown>;
@@ -20,8 +20,9 @@ export type Root<T> = Initial<T> & {
 };
 export type Initial<T> = T extends Obj ? T : Instance<T>;
 export type Versioner<T> = Record<number, (this: Root<T>, state: Root<T>) => void>;
-export type { Spec };
+export type { Browser, Spec };
 export type Mode = 'development' | 'production';
+export type Manifest = chrome.runtime.ManifestV3;
 export type Sources = {
     [path: string]: string;
 };
@@ -46,8 +47,19 @@ export type ProjectBase = {
     mode: Mode;
     enabled: boolean;
     spec: Spec;
+    manifest: Manifest;
 };
-export type Project<T = {}> = ProjectBase & (T extends {
+export type ProjectFull = ProjectBase & {
+    sources: Sources;
+    assets: Assets;
+};
+export type ProjectWithSources = ProjectBase & {
+    sources: Sources;
+};
+export type ProjectWithAssets = ProjectBase & {
+    assets: Assets;
+};
+export type Project<T extends ProjectQuery = {}> = ProjectBase & (T extends {
     sources: true;
 } ? {
     sources: Sources;
@@ -77,22 +89,29 @@ export type Res = {
     status: Response['status'];
     statusText: Response['statusText'];
     redirected: Response['redirected'];
+    headers: Response['headers'];
     text: Response['text'];
     json: Response['json'];
     blob: Response['blob'];
-    headers: {
-        get: Response['headers']['get'];
-        has: Response['headers']['has'];
-        /** Get all header keys. */
-        keys: () => string[];
-    };
 };
 export interface Epos {
     fetch: (url: string | URL, init?: ReqInit) => Promise<Res>;
-    browser: typeof chrome;
+    browser: Browser;
     render(node: react.ReactNode, container?: reactDomClient.Container): void;
     component<T>(Component: react.FC<T>): react.FC<T>;
     container: HTMLDivElement;
+    env: {
+        /** `tabId` is `-1` for iframes, including `<background>` iframe. */
+        tabId: -1 | number;
+        project: {
+            id: string;
+            mode: Mode;
+            spec: Spec;
+        };
+        isPopup: boolean;
+        isSidePanel: boolean;
+        isBackground: boolean;
+    };
     bus: {
         /** Register event listener. */
         on<T extends Fn>(name: string, callback: T, thisArg?: unknown): void;
@@ -211,16 +230,18 @@ export interface Epos {
             loaded: boolean;
         }[];
     };
-    env: {
-        tabId: number;
-        project: {
-            id: string;
-            mode: Mode;
-            spec: Spec;
-        };
-        isPopup: boolean;
-        isSidePanel: boolean;
-        isBackground: boolean;
+    projects: {
+        get<T extends ProjectQuery>(id: string, query?: T): Promise<Project<T> | null>;
+        has(id: string): Promise<boolean>;
+        list<T extends ProjectQuery>(query?: T): Promise<Project<T>[]>;
+        watch(listener: () => void): void;
+        fetch(url: string): Promise<Bundle>;
+        create<T extends string>(params: Bundle & Partial<{
+            id: T;
+        } & ProjectSettings>): Promise<T>;
+        update(id: string, updates: Partial<Bundle & ProjectSettings>): Promise<void>;
+        remove(id: string): Promise<void>;
+        export(id: string, mode?: Mode): Promise<Record<string, Blob>>;
     };
     libs: {
         mobx: typeof mobx;
@@ -231,19 +252,6 @@ export interface Epos {
         reactJsxRuntime: typeof reactJsxRuntime;
         yjs: typeof yjs;
     };
-    projects: {
-        create<T extends string>(params: {
-            id?: T;
-        } & Partial<ProjectSettings> & Bundle): Promise<T>;
-        update(id: string, updates: Partial<ProjectSettings & Bundle>): Promise<void>;
-        remove(id: string): Promise<void>;
-        has(id: string): Promise<boolean>;
-        get<T extends ProjectQuery>(id: string, query?: T): Promise<Project<T> | null>;
-        list<T extends ProjectQuery>(query?: T): Promise<Project<T>[]>;
-        watch(listener: () => void): void;
-        fetch(url: string): Promise<Bundle>;
-    };
-    engine: any;
 }
 declare global {
     var epos: Epos;

package/dist/epos.js

@@ -1,5 +1,3 @@
-/// <reference types="chrome" preserve="true" />
-import {} from 'epos-spec';
 const _epos = epos;
 export { _epos as epos };
 export default epos;

package/dist/epos.js.map

@@ -1 +1 @@
-{"version":3,"file":"epos.js","sourceRoot":"","sources":["../src/epos.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,OAAO,EAAa,MAAM,WAAW,CAAA;AA4OrC,MAAM,KAAK,GAAG,IAAI,CAAA;AAClB,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,CAAA;AAExB,eAAe,IAAI,CAAA"}
+{"version":3,"file":"epos.js","sourceRoot":"","sources":["../src/epos.ts"],"names":[],"mappings":"AAkOA,MAAM,KAAK,GAAG,IAAI,CAAA;AAClB,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,CAAA;AAExB,eAAe,IAAI,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "epos",
-  "version": "1.39.0",
+  "version": "1.40.1",
   "type": "module",
   "license": "MIT",
   "author": "imkost",
@@ -9,22 +9,22 @@
   "scripts": {
     "dev": "rimraf dist && tsgo --watch",
     "build": "rimraf dist && tsgo",
-    "lint": "tsgo --noEmit",
-    "release": "sh -c 'npm version ${1:-minor} && npm run build && npm publish' --"
+    "lint": "tsgo --build --noEmit"
   },
   "exports": {
     ".": "./dist/epos.js",
-    "./vite": "./dist/epos-vite.js"
+    "./vite": "./dist/epos-vite.js",
+    "./browser": "./dist/epos-browser.js"
   },
   "files": [
     "dist"
   ],
   "dependencies": {
     "@parcel/watcher": "^2.5.4",
-    "@types/chrome": "^0.1.33",
-    "@types/react": "^19.2.8",
+    "@types/chrome": "^0.1.36",
+    "@types/react": "^19.2.9",
     "@types/react-dom": "^19.2.3",
-    "epos-spec": "^1.6.0",
+    "epos-spec": "^1.8.1",
     "mobx": "^6.15.0",
     "mobx-react-lite": "^4.1.1",
     "portfinder": "^1.0.38",
@@ -33,9 +33,9 @@
     "yjs": "^13.6.29"
   },
   "devDependencies": {
-    "vite": "^7.3.1"
+    "vite": "npm:rolldown-vite@^7.3.1"
   },
   "peerDependencies": {
-    "vite": "^7.3.0"
+    "vite": "npm:rolldown-vite@^7.3.1"
   }
 }