jsbox-cview 1.6.5 → 1.6.7

package/dist/components/static-preference-listview.d.ts

@@ -0,0 +1,389 @@
+import { Base } from "./base";
+type PreferenceCellTypes = "string" | "number" | "integer" | "stepper" | "boolean" | "slider" | "list" | "tab" | "date" | "info" | "interactive-info" | "link" | "symbol-action" | "action";
+export interface PreferenceSection {
+    title: string;
+    rows: PrefsRow[];
+}
+export type PrefsRow = PrefsRowString | PrefsRowNumber | PrefsRowInteger | PrefsRowStepper | PrefsRowBoolean | PrefsRowSlider | PrefsRowList | PrefsRowTab | PrefsRowDate | PrefsRowInfo | PrefsRowInteractiveInfo | PrefsRowLink | PrefsRowSymbolAction | PrefsRowAction;
+interface PrefsRowBase {
+    type: PreferenceCellTypes;
+    key?: string;
+    title?: string;
+    titleColor?: UIColor;
+    changedEvent?: () => void;
+}
+export interface PrefsRowString extends PrefsRowBase {
+    type: "string";
+    value?: string;
+    placeholder?: string;
+    textColor?: UIColor;
+}
+export interface PrefsRowNumber extends PrefsRowBase {
+    type: "number";
+    value?: number;
+    placeholder?: string;
+    textColor?: UIColor;
+    min?: number;
+    max?: number;
+}
+export interface PrefsRowInteger extends PrefsRowBase {
+    type: "integer";
+    value?: number;
+    placeholder?: string;
+    textColor?: UIColor;
+    min?: number;
+    max?: number;
+}
+export interface PrefsRowStepper extends PrefsRowBase {
+    type: "stepper";
+    value?: number;
+    min?: number;
+    max?: number;
+}
+export interface PrefsRowBoolean extends PrefsRowBase {
+    type: "boolean";
+    value?: boolean;
+    onColor?: UIColor;
+    thumbColor?: UIColor;
+}
+export interface PrefsRowSlider extends PrefsRowBase {
+    type: "slider";
+    value?: number;
+    min?: number;
+    max?: number;
+    decimal?: number;
+    minColor?: UIColor;
+    maxColor?: UIColor;
+    thumbColor?: UIColor;
+}
+export interface PrefsRowList extends PrefsRowBase {
+    type: "list";
+    value?: number;
+    items: string[];
+}
+export interface PrefsRowTab extends PrefsRowBase {
+    type: "tab";
+    value?: number;
+    items: string[];
+}
+export interface PrefsRowDate extends PrefsRowBase {
+    type: "date";
+    value?: Date;
+    min?: Date;
+    max?: Date;
+    mode?: number;
+    interval?: number;
+}
+export interface PrefsRowInfo extends PrefsRowBase {
+    type: "info";
+    value?: string;
+}
+export interface PrefsRowInteractiveInfo extends PrefsRowBase {
+    type: "interactive-info";
+    value?: string;
+    copyable?: boolean;
+}
+export interface PrefsRowLink extends PrefsRowBase {
+    type: "link";
+    value?: string;
+}
+export interface PrefsRowSymbolAction extends PrefsRowBase {
+    type: "symbol-action";
+    symbol?: string;
+    tintColor?: UIColor;
+    contentMode?: number;
+    symbolSize?: JBSize;
+    value?: () => void;
+}
+export interface PrefsRowAction extends PrefsRowBase {
+    type: "action";
+    value?: () => void;
+    destructive?: boolean;
+}
+export declare const selectableTypes: string[];
+export declare const excludedTypes: string[];
+type PreferenceValues = {
+    [key: string]: any;
+};
+type AllCells = StringCell | NumberCell | IntegerCell | StepperCell | BooleanCell | SliderCell | ListCell | TabCell | DateCell | InteractiveInfoCell | InfoCell | LinkCell | SymbolActionCell | ActionCell;
+declare abstract class Cell extends Base<UIView, UiTypes.ViewOptions> {
+    abstract _type: string;
+    _key?: string;
+    _title?: string;
+    _value?: any;
+    _values: PreferenceValues;
+    _titleColor: UIColor;
+    _changedEvent?: () => void;
+    _defineView: () => UiTypes.ViewOptions;
+    constructor({ key, title, value, titleColor, changedEvent, }: {
+        key?: string;
+        title?: string;
+        value?: any;
+        titleColor?: UIColor;
+        changedEvent?: () => void;
+    }, values: PreferenceValues);
+    set value(value: any);
+    get value(): any;
+    get type(): string;
+    get key(): string | undefined;
+    abstract _handleValue(value: any): any;
+    abstract _defineValueView(): UiTypes.AllViewOptions;
+    _defineTitleView(): UiTypes.LabelOptions;
+}
+declare abstract class BaseStringCell extends Cell {
+    abstract _type: string;
+    _placeholder?: string;
+    _textColor?: UIColor;
+    constructor(props: PrefsRowString | PrefsRowNumber | PrefsRowInteger, values: PreferenceValues);
+    _defineValueView(): UiTypes.AllViewOptions;
+    _handleValue(text: string): string | number | undefined;
+    abstract _handleText(text: string): string | number | undefined;
+}
+declare class StringCell extends BaseStringCell {
+    readonly _type = "string";
+    constructor(props: PrefsRowString, values: PreferenceValues);
+    _handleText(text: string): string;
+}
+declare class NumberCell extends BaseStringCell {
+    readonly _type = "number";
+    _min?: number;
+    _max?: number;
+    constructor(props: PrefsRowNumber, values: PreferenceValues);
+    _handleText(text: string): number | undefined;
+}
+declare class IntegerCell extends BaseStringCell {
+    readonly _type = "integer";
+    _min: number;
+    _max?: number;
+    constructor(props: PrefsRowInteger, values: PreferenceValues);
+    _handleText(text: string): number | undefined;
+}
+declare class StepperCell extends Cell {
+    readonly _type = "stepper";
+    _max?: number;
+    _min: number;
+    constructor(props: PrefsRowStepper, values: PreferenceValues);
+    _defineValueView(): UiTypes.ViewOptions;
+    _handleValue(num: number): number;
+}
+declare class BooleanCell extends Cell {
+    readonly _type = "boolean";
+    _onColor: UIColor;
+    _thumbColor?: UIColor;
+    constructor(props: PrefsRowBoolean, values: PreferenceValues);
+    _defineValueView(): UiTypes.SwitchOptions;
+    _handleValue(bool: boolean): boolean;
+}
+declare class SliderCell extends Cell {
+    readonly _type = "slider";
+    _decimal: number;
+    _min: number;
+    _max: number;
+    _minColor: UIColor;
+    _maxColor?: UIColor;
+    _thumbColor?: UIColor;
+    constructor(props: PrefsRowSlider, values: PreferenceValues);
+    _defineValueView(): UiTypes.ViewOptions;
+    _handleValue(num: number): number;
+}
+declare class ListCell extends Cell {
+    readonly _type = "list";
+    _items: string[];
+    constructor(props: PrefsRowList, values: PreferenceValues);
+    _defineValueView(): UiTypes.ViewOptions;
+    _handleValue(num: number): number;
+}
+declare class TabCell extends Cell {
+    readonly _type = "tab";
+    _items: string[];
+    constructor(props: PrefsRowTab, values: PreferenceValues);
+    _defineValueView(): UiTypes.TabOptions;
+    _handleValue(num: number): number;
+}
+export declare function dateToString(mode: number, date?: Date): string;
+declare class DateCell extends Cell {
+    readonly _type = "date";
+    _mode: number;
+    _interval?: number;
+    _min?: Date;
+    _max?: Date;
+    constructor(props: PrefsRowDate, values: PreferenceValues);
+    _defineValueView(): UiTypes.ViewOptions;
+    _handleValue(date: Date): Date;
+}
+declare class InfoCell extends Cell {
+    readonly _type = "info";
+    constructor(props: PrefsRowInfo, values: PreferenceValues);
+    _defineValueView(): UiTypes.LabelOptions;
+    _handleValue(text: string): string;
+}
+declare class InteractiveInfoCell extends Cell {
+    readonly _type = "interactive-info";
+    _copyable: boolean;
+    constructor(props: PrefsRowInteractiveInfo, values: PreferenceValues);
+    _defineValueView(): UiTypes.LabelOptions;
+    _handleValue(text: string): string;
+}
+declare class LinkCell extends Cell {
+    readonly _type = "link";
+    constructor(props: PrefsRowLink, values: PreferenceValues);
+    _defineValueView(): UiTypes.LabelOptions;
+    _handleValue(text: string): string;
+}
+declare class SymbolActionCell extends Cell {
+    readonly _type = "symbol-action";
+    _symbol: string;
+    _tintColor: UIColor;
+    _contentMode: number;
+    _symbolSize: JBSize;
+    constructor(props: PrefsRowSymbolAction, values: PreferenceValues);
+    _defineValueView(): UiTypes.ImageOptions;
+    _handleValue(): void;
+}
+declare class ActionCell extends Cell {
+    readonly _type = "action";
+    _destructive: boolean;
+    constructor(props: PrefsRowAction, values: PreferenceValues);
+    _defineTitleView(): UiTypes.LabelOptions;
+    _defineValueView(): UiTypes.LabelOptions;
+    _handleValue(): void;
+}
+/**
+ * # cview PreferenceListView_static
+ *
+ * 便捷的设置列表实现. 其所有 cell 均为静态 cell,
+ * 可以同时使用 list 控件的 props(除了 template, data)和 events(除了 didSelect),
+ * 同时具有独特方法 set(key, value), 以及独特方法 changed
+ *
+ * sections 为 Array, 里面的 section 定义:
+ *
+ * - title?: string 标题.
+ * - rows: {type: string}[] 内容
+ *
+ * row定义:
+ *
+ * - 通用:
+ *
+ *     - type: string 类型. 包括'string', 'number', 'integer', 'stepper',
+ *       'boolean', 'slider', 'list', 'tab', 'interactive-info', 'info',
+ *       'link', 'action'
+ *     - key?: string 键. 如没有则不会返回其值.
+ *     - title?: string 标题
+ *     - value?: any 在下面专项里详解.
+ *     - titleColor?: $color = $color("primaryText") 标题颜色
+ *
+ * -  string:
+ *
+ *     - value?: string
+ *     - placeholder?: string
+ *     - textColor?: $color = $color("primaryText")
+ *
+ * -  number, integer:
+ *
+ *     - value?: number
+ *     - placeholder?: string
+ *     - textColor?: $color = $color("primaryText")
+ *     - min?: number 最小值
+ *     - max?: number 最大值
+ *
+ * - stepper:
+ *
+ *     - value?: number
+ *     - placeholder?: string
+ *     - min?: number 最小值
+ *     - max?: number 最大值
+ *
+ * - boolean:
+ *
+ *     - value?: boolean
+ *     - onColor?: $color = $color("#34C85A")
+ *     - thumbColor
+ *
+ * - slider:
+ *
+ *     - value?: number 即 slider.value
+ *     - decimal?: number = 1 精度
+ *     - min?: number
+ *     - max?: number
+ *     - minColor?: $color = $color("systemLink")
+ *     - maxColor?: $color
+ *     - thumbColor?: $color
+ *
+ * - list:
+ *
+ *     - value?: number 即 index, -1 时为不选
+ *     - items?: string[]
+ *
+ * - tab:
+ *
+ *     - value?: number 即 index, -1 时为不选
+ *     - items?: string[]
+ *
+ * - date:
+ *
+ *    - value?: Date
+ *    - min?: Date
+ *    - max?: Date
+ *    - mode?: number = 2
+ *    - interval?: number
+ *
+ * - info:
+ *
+ *     - value?: string
+ *
+ * - interactive-info:
+ *
+ *    - value?: string
+ *    - copyable?: boolean = false
+ *
+ * - link:
+ *
+ *     - value?: string url
+ *
+ * - symbol-action:
+ *
+ *    - symbol?: string;
+ *    - tintColor?: UIColor;
+ *    - contentMode?: number;
+ *    - symbolSize?: JBSize;
+ *    - value?: function 点击后会执行的函数
+ *
+ * - action:
+ *
+ *     - value?: function 点击后会执行的函数
+ *     - destructive?: boolean = false 是否为危险动作，若是则为红色
+ *
+ * Methods:
+ *
+ * - set(key, value) 设定 key 对应的 value
+ * - cview.values 获取全部的 values
+ *
+ * Events:
+ *
+ * - changed: values => {}
+ */
+export declare class PreferenceListView extends Base<UIListView, UiTypes.ListOptions> {
+    _defineView: () => UiTypes.ListOptions;
+    _sections: PreferenceSection[];
+    _props: Partial<UiTypes.ListProps>;
+    _layout?: (make: MASConstraintMaker, view: UIListView) => void;
+    _values: PreferenceValues;
+    _cells: {
+        title: string;
+        rows: AllCells[];
+    }[];
+    constructor({ sections, props, layout, events, }: {
+        sections: PreferenceSection[];
+        props?: Partial<UiTypes.ListProps>;
+        layout?: (make: MASConstraintMaker, view: UIListView) => void;
+        events?: {
+            changed?: (values: {
+                [key: string]: any;
+            }) => void;
+        };
+    });
+    private _createCell;
+    get values(): PreferenceValues;
+    set(key: string, value: any): void;
+}
+export {};

package/dist/components/static-preference-listview.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PreferenceListView = exports.dateToString = exports.excludedTypes = exports.selectableTypes = void 0;
+exports.PreferenceListView = exports.excludedTypes = exports.selectableTypes = void 0;
+exports.dateToString = dateToString;
 const base_1 = require("./base");
 const uitools_1 = require("../utils/uitools");
 exports.selectableTypes = [
@@ -78,7 +79,6 @@ class BaseStringCell extends Cell {
         this._textColor = textColor;
     }
     _defineValueView() {
-        var _a;
         return {
             type: "view",
             props: {},
@@ -105,7 +105,7 @@ class BaseStringCell extends Cell {
                     type: "label",
                     props: {
                         id: "label",
-                        text: (_a = this._handleText(this._value)) === null || _a === void 0 ? void 0 : _a.toString(),
+                        text: this._handleText(this._value)?.toString(),
                         align: $align.right,
                         font: $font(17),
                         textColor: this._textColor,
@@ -483,7 +483,6 @@ function dateToString(mode, date) {
         return `${year}-${month}-${day} ${hours}:${minutes}`;
     }
 }
-exports.dateToString = dateToString;
 class DateCell extends Cell {
     constructor(props, values) {
         super(props, values);
@@ -642,13 +641,12 @@ class LinkCell extends Cell {
 }
 class SymbolActionCell extends Cell {
     constructor(props, values) {
-        var _a, _b, _c;
         super(props, values);
         this._type = "symbol-action";
         this._symbol = props.symbol || "";
-        this._tintColor = (_a = props.tintColor) !== null && _a !== void 0 ? _a : $color("primaryText");
-        this._contentMode = (_b = props.contentMode) !== null && _b !== void 0 ? _b : 1;
-        this._symbolSize = (_c = props.symbolSize) !== null && _c !== void 0 ? _c : $size(24, 24);
+        this._tintColor = props.tintColor ?? $color("primaryText");
+        this._contentMode = props.contentMode ?? 1;
+        this._symbolSize = props.symbolSize ?? $size(24, 24);
     }
     _defineValueView() {
         return {
@@ -845,10 +843,15 @@ class PreferenceListView extends base_1.Base {
         this._defineView = () => {
             return {
                 type: "list",
-                props: Object.assign(Object.assign({ style: 2 }, this._props), { id: this.id, data: this._cells.map((section) => ({
+                props: {
+                    style: 2,
+                    ...this._props,
+                    id: this.id,
+                    data: this._cells.map((section) => ({
                         title: section.title,
                         rows: section.rows.map((cell) => cell.definition),
-                    })) }),
+                    })),
+                },
                 layout: this._layout,
                 events: {
                     didSelect: (sender, indexPath, data) => {

package/dist/components/symbol-button.d.ts

@@ -0,0 +1,39 @@
+import { Base } from "./base";
+interface SymbolButtonProps {
+    enabled: boolean;
+    symbol?: string;
+    image?: UIImage;
+    src?: string;
+    tintColor: UIColor;
+    contentMode: number;
+    insets: JBInsets;
+    menu?: UiTypes.ContextMenuOptions<UIButtonView>;
+    hidden: boolean;
+}
+/**
+ * 创建可以自动规范symbol大小的button，兼容image，可以设定insets
+ * props:
+ *   - symbol
+ *   - image
+ *   - tintColor
+ *   - insets
+ *   - enabled
+ *   - menu
+ *   - hidden
+ * events:
+ *   - tapped
+ */
+export declare class SymbolButton extends Base<UIButtonView, UiTypes.ButtonOptions> {
+    _props: SymbolButtonProps;
+    _defineView: () => UiTypes.ButtonOptions;
+    constructor({ props, layout, events, }: {
+        props: Partial<SymbolButtonProps>;
+        layout?: (make: MASConstraintMaker, view: UIButtonView) => void;
+        events?: UiTypes.BaseViewEvents<UIButtonView>;
+    });
+    set tintColor(tintColor: UIColor);
+    set image(image: UIImage);
+    set symbol(symbol: string);
+    set src(src: string);
+}
+export {};

package/dist/components/symbol-button.js

@@ -18,7 +18,14 @@ const base_1 = require("./base");
 class SymbolButton extends base_1.Base {
     constructor({ props, layout, events = {}, }) {
         super();
-        this._props = Object.assign({ enabled: true, contentMode: 1, insets: $insets(12.5, 12.5, 12.5, 12.5), tintColor: $color("primaryText"), hidden: false }, props);
+        this._props = {
+            enabled: true,
+            contentMode: 1,
+            insets: $insets(12.5, 12.5, 12.5, 12.5),
+            tintColor: $color("primaryText"),
+            hidden: false,
+            ...props,
+        };
         this._layout = layout;
         this._defineView = () => {
             const props = this._props.menu

package/dist/components/tabbar.d.ts

@@ -0,0 +1,140 @@
+import { Base } from "./base";
+declare class ImageLabelCell extends Base<UIView, UiTypes.ViewOptions> {
+    _props: {
+        symbol?: string;
+        image?: UIImage;
+        text: string;
+        index: number;
+        selectedSegmentTintColor: UIColor;
+        defaultSegmentTintColor: UIColor;
+        selected?: boolean;
+    };
+    layouts: {
+        image_tightened: (make: MASConstraintMaker, view: AllUIView) => void;
+        label_tightened: (make: MASConstraintMaker, view: AllUIView) => void;
+        image_loosed: (make: MASConstraintMaker, view: AllUIView) => void;
+        label_loosed: (make: MASConstraintMaker, view: AllUIView) => void;
+    };
+    _defineView: () => UiTypes.ViewOptions;
+    constructor({ props, events, }: {
+        props: {
+            symbol?: string;
+            image?: UIImage;
+            text: string;
+            index: number;
+            selectedSegmentTintColor: UIColor;
+            defaultSegmentTintColor: UIColor;
+            selected?: boolean;
+        };
+        events: {
+            tapped?: (index: number) => void;
+        };
+    });
+    set selected(selected: boolean | undefined);
+    get selected(): boolean | undefined;
+    _useTightenedLayout(): void;
+    _useLoosedLayout(): void;
+}
+declare class ImageCell extends Base<UIView, UiTypes.ViewOptions> {
+    _props: {
+        symbol?: string;
+        image?: UIImage;
+        index: number;
+        selectedSegmentTintColor: UIColor;
+        defaultSegmentTintColor: UIColor;
+        selected?: boolean;
+    };
+    layouts: {
+        image_tightened: (make: MASConstraintMaker, view: AllUIView) => void;
+        image_loosed: (make: MASConstraintMaker, view: AllUIView) => void;
+    };
+    _defineView: () => UiTypes.ViewOptions;
+    constructor({ props, events, }: {
+        props: {
+            symbol?: string;
+            image?: UIImage;
+            index: number;
+            selectedSegmentTintColor: UIColor;
+            defaultSegmentTintColor: UIColor;
+            selected?: boolean;
+        };
+        events: {
+            tapped?: (index: number) => void;
+        };
+    });
+    set selected(selected: boolean | undefined);
+    get selected(): boolean | undefined;
+    _useTightenedLayout(): void;
+    _useLoosedLayout(): void;
+}
+/**
+ * 本组件是为了仿制 UITabBar
+ * 本组件不能指定布局而是应该指定 height（如果需要的话）
+ * 典型的使用方式是添加在布局为$layout.fill的视图中，并指定 items
+ *
+ * props:
+ *
+ * - 只写 height: number = 50
+ * - 只写 items: {symbol?: string, image?:UIImage, title?: string}[]
+ * - 只写 bgcolor?: UIColor 如果不指定则背景使用blur（style 10），若指定则使用纯色视图
+ * - 读写 index: number = 0
+ * - 只写 selectedSegmentTintColor = $color("tintColor")
+ * - 只写 defaultSegmentTintColor = colors.footBarDefaultSegmentColor
+ *
+ * events:
+ *
+ * - changed: (cview, index) => void
+ * - doubleTapped: (cview, index) => void
+ *
+ * methods:
+ *
+ * - hide(animated=true) 隐藏
+ * - show(animated=true) 显示
+ */
+export declare class TabBar extends Base<UIView | UIBlurView, UiTypes.ViewOptions | UiTypes.BlurOptions> {
+    _props: {
+        height: number;
+        items: {
+            symbol?: string;
+            image?: UIImage;
+            title?: string;
+        }[];
+        index: number;
+        selectedSegmentTintColor: UIColor;
+        defaultSegmentTintColor: UIColor;
+        bgcolor?: UIColor;
+    };
+    _index: number;
+    _cells: (ImageLabelCell | ImageCell)[];
+    _events: {
+        changed?: (cview: TabBar, index: number) => void;
+        doubleTapped?: (cview: TabBar, index: number) => void;
+    };
+    _defineView: () => UiTypes.ViewOptions | UiTypes.BlurOptions;
+    constructor({ props, events, }: {
+        props: {
+            height?: number;
+            items: {
+                symbol?: string;
+                image?: UIImage;
+                title?: string;
+            }[];
+            index?: number;
+            selectedSegmentTintColor?: UIColor;
+            defaultSegmentTintColor?: UIColor;
+            bgcolor?: UIColor;
+        };
+        events: {
+            changed?: (cview: TabBar, index: number) => void;
+            doubleTapped?: (cview: TabBar, index: number) => void;
+        };
+    });
+    _defineCells(): (ImageLabelCell | ImageCell)[];
+    get index(): number;
+    set index(index: number);
+    hide(animated?: boolean): void;
+    show(animated?: boolean): void;
+    _useTightenedLayout(): void;
+    _useLoosedLayout(): void;
+}
+export {};

package/dist/components/tabbar.js

@@ -168,7 +168,14 @@ class ImageCell extends base_1.Base {
 class TabBar extends base_1.Base {
     constructor({ props, events = {}, }) {
         super();
-        this._props = Object.assign({ height: 50, index: 0, selectedSegmentTintColor: $color("systemLink"), defaultSegmentTintColor: colors_1.footBarDefaultSegmentColor }, props);
+        this._props = {
+            height: 50,
+            index: 0,
+            selectedSegmentTintColor: $color("systemLink"),
+            defaultSegmentTintColor: colors_1.footBarDefaultSegmentColor,
+            //bgcolor: $color("secondarySurface"),
+            ...props,
+        };
         this._index = this._props.index;
         this._events = events;
         this._cells = this._defineCells();