jsbox-cview 1.6.6 → 1.6.8

package/dist/controller/base-controller.js

@@ -5,22 +5,7 @@ const base_1 = require("../components/base");
 const single_views_1 = require("../components/single-views");
 const cvid_1 = require("../utils/cvid");
 const controller_router_1 = require("./controller-router");
-/**
- * status
- *   - created = 0 被创建，未被加载
- *   - loaded = 1 被加载，显示状态未知
- *   - appeared= 2 处于可显示状态
- *   - disappeared = 3 处于不显示状态
- *   - removed = 4 根视图被移除
- * 其中只有 2 和 3 可以相互转化，其他不可以
- */
-const controllerStatus = {
-    created: 0,
-    loaded: 1,
-    appeared: 2,
-    disappeared: 3,
-    removed: 4,
-};
+const controller_status_1 = require("./controller-status");
 class ControllerRootView extends single_views_1.ContentView {
     constructor({ props, layout, events, }) {
         super({ props, layout, events });
@@ -102,7 +87,7 @@ class BaseController {
         this._props = props || {};
         this._events = events;
         this.id = this._props.id || cvid_1.cvid.newId;
-        this._status = controllerStatus.created; // status使用额外的get来使其只读
+        this._status = controller_status_1.controllerStatus.created; // status使用额外的get来使其只读
         this.rootView = new ControllerRootView({
             props: {
                 bgcolor: this._props.bgcolor || $color("primarySurface"),
@@ -116,38 +101,38 @@ class BaseController {
     }
     load() {
         // 只有status为created才可以运行
-        if (this._status !== controllerStatus.created)
+        if (this._status !== controller_status_1.controllerStatus.created)
             return;
-        this._status = controllerStatus.loaded;
+        this._status = controller_status_1.controllerStatus.loaded;
         if (this._events.didLoad)
             this._events.didLoad(this);
         controller_router_1.router.add(this);
     }
     appear() {
         // 只有status为loaded或者disappeared，才可以运行
-        if (this._status !== controllerStatus.loaded && this._status !== controllerStatus.disappeared)
+        if (this._status !== controller_status_1.controllerStatus.loaded && this._status !== controller_status_1.controllerStatus.disappeared)
             return;
         if (this._events.didAppear)
             this._events.didAppear(this);
-        this._status = controllerStatus.appeared;
+        this._status = controller_status_1.controllerStatus.appeared;
     }
     disappear() {
         // 只有status为loaded或者appeared，才可以运行
-        if (this._status !== controllerStatus.loaded && this._status !== controllerStatus.appeared)
+        if (this._status !== controller_status_1.controllerStatus.loaded && this._status !== controller_status_1.controllerStatus.appeared)
             return;
         if (this._events.didDisappear)
             this._events.didDisappear(this);
-        this._status = controllerStatus.disappeared;
+        this._status = controller_status_1.controllerStatus.disappeared;
     }
     // 此方法不能用于移除rootView，其作用是将控制器从Router中移除，并触发didRemove事件
     remove() {
         // 如果已经移除，不可以再次运行
-        if (this._status === controllerStatus.removed)
+        if (this._status === controller_status_1.controllerStatus.removed)
             return;
         if (this._events.didRemove)
             this._events.didRemove(this);
         controller_router_1.router.delete(this);
-        this._status = controllerStatus.removed;
+        this._status = controller_status_1.controllerStatus.removed;
     }
     uirender(props) {
         controller_router_1.router.root = this;

package/dist/controller/controller-router.d.ts

@@ -0,0 +1,48 @@
+import { BaseController } from "./base-controller";
+/**
+ * 控制器的路由器，用于管理控制器的集合和操作。
+ *
+ * ## 属性
+ * - `root`：根控制器。
+ * - `appeared`：状态为appeared的控制器列表。
+ * - `controllerSet`：控制器集合。
+ *
+ * ## 方法
+ * - `add(controller: BaseController)`：添加控制器到路由器中。
+ * - `delete(controller: BaseController)`：从路由器中删除控制器。
+ * - `get(id: string)`：根据控制器的ID获取控制器。
+ *
+ */
+declare class Router {
+    private _set;
+    root?: BaseController;
+    constructor();
+    /**
+     * 添加控制器到路由器中。
+     * @param controller 要添加的控制器。
+     */
+    add(controller: BaseController): void;
+    /**
+     * 从路由器中删除控制器。
+     * @param controller 要删除的控制器。
+     */
+    delete(controller: BaseController): void;
+    /**
+     * 根据控制器的ID获取控制器。
+     * @param id 控制器的ID。
+     * @returns 匹配的控制器，如果找不到则返回undefined。
+     */
+    get(id: string): BaseController | undefined;
+    /**
+     * 获取状态为appeared的控制器集合。
+     * @returns 控制器集合。
+     */
+    get appeared(): BaseController[];
+    /**
+     * 获取控制器集合。
+     * @returns 控制器集合。
+     */
+    get controllerSet(): Set<BaseController>;
+}
+export declare const router: Router;
+export {};

package/dist/controller/controller-router.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.router = void 0;
+const controller_status_1 = require("./controller-status");
 /**
  * 控制器的路由器，用于管理控制器的集合和操作。
  *
@@ -52,7 +53,7 @@ class Router {
     get appeared() {
         const appearedControllers = [];
         for (const c of this._set) {
-            if (c.status === 2)
+            if (c.status === controller_status_1.controllerStatus.appeared)
                 appearedControllers.push(c);
         }
         return appearedControllers;

package/dist/controller/controller-status.d.ts

@@ -0,0 +1,16 @@
+/**
+ * status
+ *   - created = 0 被创建，未被加载
+ *   - loaded = 1 被加载，显示状态未知
+ *   - appeared= 2 处于可显示状态
+ *   - disappeared = 3 处于不显示状态
+ *   - removed = 4 根视图被移除
+ * 其中只有 2 和 3 可以相互转化，其他不可以
+ */
+export declare const controllerStatus: {
+    readonly created: 0;
+    readonly loaded: 1;
+    readonly appeared: 2;
+    readonly disappeared: 3;
+    readonly removed: 4;
+};

package/dist/controller/controller-status.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.controllerStatus = void 0;
+/**
+ * status
+ *   - created = 0 被创建，未被加载
+ *   - loaded = 1 被加载，显示状态未知
+ *   - appeared= 2 处于可显示状态
+ *   - disappeared = 3 处于不显示状态
+ *   - removed = 4 根视图被移除
+ * 其中只有 2 和 3 可以相互转化，其他不可以
+ */
+exports.controllerStatus = {
+    created: 0,
+    loaded: 1,
+    appeared: 2,
+    disappeared: 3,
+    removed: 4,
+};

package/dist/controller/pageviewer-controller.d.ts

@@ -0,0 +1,38 @@
+import { BaseController, BaseControllerProps, BaseControllerEvents } from "./base-controller";
+import { PageViewer } from "../components/pageviewer";
+import { PageViewerTitleBar } from "../components/pageviewer-titlebar";
+import { CustomNavigationBar, NavigationBarProps } from "../components/custom-navigation-bar";
+interface PageViewerControllerProps extends BaseControllerProps {
+    items: {
+        controller: BaseController;
+        title: string;
+    }[];
+    navBarProps?: Partial<NavigationBarProps>;
+    index?: number;
+}
+/**
+ * # CView PageViewer Controller
+ *
+ * 一个可以左右滑动翻页的控制器。
+ *
+ * Props:
+ *
+ * - items: { controller: Controller, title: string }[]
+ * - navBarProps: {} 可用于 navBar 的其他属性，不包括 title 和 titleView
+ */
+export declare class PageViewerController extends BaseController {
+    protected _props: PageViewerControllerProps;
+    cviews: {
+        pageviewer: PageViewer;
+        titlebar: PageViewerTitleBar;
+        navbar: CustomNavigationBar;
+    };
+    constructor({ props, layout, events, }: {
+        props: PageViewerControllerProps;
+        layout?: (make: MASConstraintMaker, view: UIView) => void;
+        events?: BaseControllerEvents;
+    });
+    get index(): number;
+    set index(num: number);
+}
+export {};

package/dist/controller/pageviewer-controller.js

@@ -5,6 +5,7 @@ const base_controller_1 = require("./base-controller");
 const pageviewer_1 = require("../components/pageviewer");
 const pageviewer_titlebar_1 = require("../components/pageviewer-titlebar");
 const custom_navigation_bar_1 = require("../components/custom-navigation-bar");
+const controller_status_1 = require("./controller-status");
 /**
  * # CView PageViewer Controller
  *
@@ -23,7 +24,20 @@ class PageViewerController extends base_controller_1.BaseController {
                 bgcolor: props.bgcolor,
             },
             layout,
-            events,
+            events: {
+                didLoad: events.didLoad,
+                didAppear: (controller) => {
+                    props.items[this.index].controller.appear();
+                    events.didAppear?.(controller);
+                },
+                didDisappear: (controller) => {
+                    props.items.forEach((item) => item.controller.disappear());
+                    events.didDisappear?.(controller);
+                },
+                didRemove: (controller) => {
+                    events.didRemove?.(controller);
+                },
+            },
         });
         this._props = props;
         this.cviews = {};
@@ -37,13 +51,28 @@ class PageViewerController extends base_controller_1.BaseController {
                 make.top.equalTo(view.prev.bottom);
             },
             events: {
-                floatPageChanged: (cview, floatPage) => (this.cviews.titlebar.floatedIndex = floatPage),
+                floatPageChanged: (cview, floatPage) => {
+                    this.cviews.titlebar.floatedIndex = floatPage;
+                },
+                changed: (cview, page) => {
+                    this._props.index = page;
+                    if (this.status !== controller_status_1.controllerStatus.appeared)
+                        return;
+                    this._props.items.forEach((item, i) => {
+                        if (i === page) {
+                            item.controller.appear();
+                        }
+                        else {
+                            item.controller.disappear();
+                        }
+                    });
+                },
             },
         });
         this.cviews.titlebar = new pageviewer_titlebar_1.PageViewerTitleBar({
             props: {
                 items: this._props.items.map((n) => n.title),
-                index: this._props.index || 0,
+                index: this._props.index ?? 0,
             },
             layout: $layout.fill,
             events: {

package/dist/controller/presented-page-controller.d.ts

@@ -0,0 +1,41 @@
+import { BaseController, BaseControllerProps, BaseControllerEvents } from "./base-controller";
+interface PresentedPageControllerProps extends BaseControllerProps {
+    presentMode?: number;
+    animated?: boolean;
+    interactiveDismissalDisabled?: boolean;
+}
+interface PresentedPageControllerEvents extends BaseControllerEvents {
+    dismissed?: (controller: PresentedPageController) => void;
+}
+/** # CView PresentedPageController
+ *
+ * ## Props
+ *
+ * - presentMode?: number = 1
+ * - animated?: boolean = true
+ * - interactiveDismissalDisabled?: boolean = false
+ * - bgcolor?: UIColor = $color("secondarySurface")
+ *
+ * ## 专用事件
+ *
+ * - dismissed: function  退出时的回调
+ *
+ * ## 专用方法
+ *
+ * - present() 在 `sheet.present()` 之后会先后执行 `load()` 和 `appear()`
+ * - dismiss()
+ *
+ * ## 布局
+ * 此控制器的 layout 必定为 `$layout.fill`，无需自行设定
+ */
+export declare class PresentedPageController extends BaseController {
+    private _sheet;
+    constructor({ props, layout, events, }?: {
+        props?: Partial<PresentedPageControllerProps>;
+        layout?: (make: MASConstraintMaker, view: UIView) => void;
+        events?: PresentedPageControllerEvents;
+    });
+    present(): void;
+    dismiss(): void;
+}
+export {};

package/dist/controller/splitview-controller.d.ts

@@ -0,0 +1,90 @@
+import { BaseController, BaseControllerProps, BaseControllerEvents } from "./base-controller";
+import { Base } from "../components/base";
+import { ContentView } from "../components/single-views";
+declare class SecondaryView extends Base<UIView, UiTypes.ViewOptions> {
+    _props: UiTypes.ViewProps;
+    _layouts: {
+        hidden: (make: MASConstraintMaker, view: AllUIView) => void;
+        shown: (make: MASConstraintMaker, view: AllUIView) => void;
+    };
+    line: ContentView;
+    _defineView: () => UiTypes.ViewOptions;
+    constructor({ props, layout, views, }: {
+        props?: UiTypes.ViewProps;
+        layout?: (make: MASConstraintMaker, view: UIView) => void;
+        views?: UiTypes.AllViewOptions[];
+    });
+    add(view: UiTypes.AllViewOptions | Base<any, any>): void;
+    show(): void;
+    hide(): void;
+}
+declare class MaskView extends Base<UIView, UiTypes.ViewOptions> {
+    _props: {
+        bgcolor: UIColor;
+        dismissHandler?: () => void;
+    };
+    _shown: boolean;
+    _dismissEvent: () => void;
+    _gestureObject: any;
+    _defineView: () => UiTypes.ViewOptions;
+    constructor({ props, layout, }: {
+        props: {
+            bgcolor?: UIColor;
+            dismissHandler?: () => void;
+        };
+        layout?: (make: MASConstraintMaker, view: UIView) => void;
+    });
+    _addGesture(view: UIView, event: () => void): void;
+    releaseGestureObject(): void;
+    show(): void;
+    hide(): void;
+}
+interface SplitViewControllerProps extends BaseControllerProps {
+    items: {
+        controller: BaseController;
+        bgcolor: UIColor;
+    }[];
+}
+/** # CView SplitView Controller
+ *
+ * 实现左右分栏布局的控制器, 本身不提供除了分割线以外的视觉效果
+ *
+ * 此控制器加载后，会禁用原本的ScreenEdgePanGesture，此控制器应该作为根控制器使用
+ *
+ * @param options.props.items: { controller: Controller, bgcolor: UIColor }[]
+ *  其中第一个放在主视图上, 第二个放在次视图上
+ *
+ * @property sideBarShown: boolean = false 侧栏是否显示
+ * @property canShowSidebar: boolean = true 是否启动显示侧栏的动作
+ *  （若为false，依然可以用sideBarShown来控制侧栏的显示）
+ */
+export declare class SplitViewController extends BaseController {
+    private _screenEdgePanGestureObject;
+    private _sideBarShown;
+    private _canShowSidebar;
+    private _primaryController;
+    private _secondaryController;
+    cviews: {
+        primaryView: ContentView;
+        secondaryView: SecondaryView;
+        maskView: MaskView;
+    };
+    constructor({ props, layout, events, }: {
+        props: SplitViewControllerProps;
+        layout?: (make: MASConstraintMaker, view: UIView) => void;
+        events?: BaseControllerEvents;
+    });
+    load(): void;
+    remove(): void;
+    uirender(): void;
+    uipush(): void;
+    _defineGestureObject(event: () => void): any;
+    _renewScreenEdgePanGesture(): void;
+    _showSideBar(): void;
+    _hideSideBar(): void;
+    get sideBarShown(): boolean;
+    set sideBarShown(bool: boolean);
+    get canShowSidebar(): boolean;
+    set canShowSidebar(bool: boolean);
+}
+export {};

package/dist/controller/splitview-controller.js

@@ -5,6 +5,7 @@ const base_controller_1 = require("./base-controller");
 const base_1 = require("../components/base");
 const single_views_1 = require("../components/single-views");
 const cvid_1 = require("../utils/cvid");
+const controller_status_1 = require("./controller-status");
 class SecondaryView extends base_1.Base {
     constructor({ props, layout, views = [], }) {
         super();
@@ -207,10 +208,14 @@ class SplitViewController extends base_controller_1.BaseController {
         this.rootView.views = [this.cviews.secondaryView, this.cviews.primaryView];
     }
     load() {
+        if (this.status !== controller_status_1.controllerStatus.created)
+            return;
         super.load();
         this._renewScreenEdgePanGesture();
     }
     remove() {
+        if (this.status === controller_status_1.controllerStatus.removed)
+            return;
         $objc_release(this._screenEdgePanGestureObject);
         this.cviews.maskView.releaseGestureObject();
         super.remove();

package/dist/controller/tabbar-controller.d.ts

@@ -0,0 +1,49 @@
+import { BaseController, BaseControllerProps, BaseControllerEvents } from "./base-controller";
+import { ContentView } from "../components/single-views";
+import { TabBar } from "../components/tabbar";
+interface TabBarControllerProps extends BaseControllerProps {
+    items: {
+        title?: string;
+        symbol?: string;
+        image?: UIImage;
+        tintColor?: UIColor;
+        bgcolor?: UIColor;
+        controller: BaseController;
+    }[];
+    index?: number;
+}
+interface TabBarControllerEvents extends BaseControllerEvents {
+    changed?: (controller: TabBarController, index: number) => void;
+    doubleTapped?: (controller: TabBarController, index: number) => void;
+}
+/**
+ * # CView TabBar Controller
+ *
+ * TabBarController 是一个 PagingController
+ *
+ * ## 属性
+ *
+ * - items: {title?: string,
+ *           symbol?: string,
+ *           image?: UIImage,
+ *           tintColor?: UIColor,
+ *           bgcolor?: UIColor,
+ *           controller: Controller}[]
+ * - index: number = 0
+ */
+export declare class TabBarController extends BaseController {
+    _props: TabBarControllerProps;
+    cviews: {
+        tabbar: TabBar;
+        pageContentView: ContentView;
+    };
+    pages: ContentView[];
+    constructor({ props, layout, events, }: {
+        props: TabBarControllerProps;
+        layout?: (make: MASConstraintMaker, view: UIView) => void;
+        events?: TabBarControllerEvents;
+    });
+    set index(num: number);
+    get index(): number;
+}
+export {};

package/dist/controller/tabbar-controller.js

@@ -4,6 +4,7 @@ exports.TabBarController = void 0;
 const base_controller_1 = require("./base-controller");
 const single_views_1 = require("../components/single-views");
 const tabbar_1 = require("../components/tabbar");
+const controller_status_1 = require("./controller-status");
 /**
  * # CView TabBar Controller
  *
@@ -52,8 +53,6 @@ class TabBarController extends base_controller_1.BaseController {
             events: {
                 changed: (cview, index) => {
                     this.index = index;
-                    this._props.items.find((item) => item.controller.status === 2)?.controller.disappear();
-                    this._props.items[index].controller.appear();
                     events.changed?.(this, index);
                 },
                 doubleTapped: (cview, index) => {
@@ -88,7 +87,7 @@ class TabBarController extends base_controller_1.BaseController {
             n.view.hidden = i !== num;
         });
         this._props.index = num;
-        this._props.items.find((item) => item.controller.status === 2)?.controller.disappear();
+        this._props.items.find((item) => item.controller.status === controller_status_1.controllerStatus.appeared)?.controller.disappear();
         this._props.items[num].controller.appear();
     }
     get index() {

package/{index.ts → dist/index.d.ts}

@@ -1,3 +1,4 @@
+/// <reference types="jsbox-types" preserve="true" />
 export * from "./components/base";
 export * from "./components/custom-navigation-bar";
 export * from "./components/dynamic-contextmenu-view";
@@ -20,6 +21,7 @@ export * from "./components/single-views";
 export * from "./components/static-preference-listview";
 export * from "./components/symbol-button";
 export * from "./components/tabbar";
+export * from "./controller/controller-status";
 export * from "./controller/base-controller";
 export * from "./controller/controller-router";
 export * from "./controller/pageviewer-controller";

package/dist/index.js

@@ -1,4 +1,5 @@
 "use strict";
+/// <reference types="jsbox-types" preserve="true" />
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -36,6 +37,7 @@ __exportStar(require("./components/single-views"), exports);
 __exportStar(require("./components/static-preference-listview"), exports);
 __exportStar(require("./components/symbol-button"), exports);
 __exportStar(require("./components/tabbar"), exports);
+__exportStar(require("./controller/controller-status"), exports);
 __exportStar(require("./controller/base-controller"), exports);
 __exportStar(require("./controller/controller-router"), exports);
 __exportStar(require("./controller/pageviewer-controller"), exports);

package/dist/utils/colors.d.ts

@@ -0,0 +1,7 @@
+export declare const sheetNavBarColor: UIColor;
+export declare const footBarDefaultSegmentColor: UIColor;
+export declare const searchBarSymbolColor: UIColor;
+export declare const searchBarBgcolor: UIColor;
+export declare const gold: UIColor;
+export declare const sectionHeaderColor: UIColor;
+export declare const sliderMaxColor: UIColor;

package/dist/utils/cvid.d.ts

@@ -0,0 +1,11 @@
+declare class CVID {
+    _prefix: string;
+    _index: number;
+    constructor({ prefix, startIndex }?: {
+        prefix?: string | undefined;
+        startIndex?: number | undefined;
+    });
+    get newId(): string;
+}
+export declare const cvid: CVID;
+export {};

package/dist/utils/l10n.d.ts

@@ -0,0 +1 @@
+export declare function l10n(key: string): string;

package/dist/utils/path.d.ts

@@ -0,0 +1,8 @@
+export declare function split(path: string): [string, string];
+export declare function dirname(path: string): string;
+export declare function basename(path: string): string;
+export declare function extname(path: string): string;
+export declare function join(...args: string[]): string;
+export declare function getCreationDate(path: string): number;
+export declare function getModificationDate(path: string): number;
+export declare function getFileSize(path: string): number;

package/dist/utils/rect.d.ts

@@ -0,0 +1,38 @@
+/**
+ * When called without arguments, return the center of the rectangle.
+ * When a Point is passed as an argument, the rectangle’s x and y values
+ * are adjusted, so that the new center of the rectangle is p.
+ */
+export declare function center(rect: JBRect, point?: JBPoint): JBPoint;
+/**
+ * Return true if the given point lies within the bounds of the rectangle,
+ * false otherwise.
+ */
+export declare function containsPoint(rect: JBRect, point: JBPoint): boolean;
+/**
+ * Return true if the given rectangle lies entirely within the bounds of
+ * this rectangle, false otherwise.
+ */
+export declare function containsRect(rect: JBRect, otherRect: JBRect): boolean;
+/**
+ * Return true if this rectangle intersects with the other rectangle,
+ * false otherwise.
+ */
+export declare function intersects(rect: JBRect, otherRect: JBRect): boolean;
+/**
+ * Return a $rect that corresponds to the intersection of this rectangle with
+ * the other one.
+ */
+export declare function intersection(rect: JBRect, otherRect: JBRect): JBRect;
+/**
+ * Return the smallest $rect that encloses both rectangles.
+ */
+export declare function union(rect: JBRect, otherRect: JBRect): JBRect;
+/**
+ * Equivalent to $rect(r.x + x, r.y + y, r.w, r.h)
+ */
+export declare function translate(rect: JBRect, point: JBPoint): JBRect;
+/**
+ * Return a $rect that is adjusted by the given edge insets.
+ */
+export declare function inset(rect: JBRect, insets: JBInsets): JBRect;