@miot-rn/common-component 1.0.1

package/README.md

@@ -0,0 +1,9 @@
+# @miot-rn/door-components
+
+## 背景
+
+为了能够提供灵活支持插件开发者的业务组件功能，miot-react-native-plugins 项目提供了一系列丰富的业务UI组件包，其他开发者可以基于此业务UI组件包集合进行插件开发，减少开发工作量。
+
+## 使用
+开发过程中新创建的包，需要在pacakge.json中添加如下配置：min_sdk_api_level字段，以告知使用者支持的最低SKDK版本。
+

package/dist/resources/i18n.d.ts

@@ -0,0 +1,55 @@
+export interface I18nLanguageResources {
+    [key: string]: string | {
+        [pluralForm: string]: string;
+    };
+}
+export interface I18nConfig {
+    cs?: I18nLanguageResources;
+    de?: I18nLanguageResources;
+    el?: I18nLanguageResources;
+    en?: I18nLanguageResources;
+    es_us?: I18nLanguageResources;
+    es?: I18nLanguageResources;
+    fi?: I18nLanguageResources;
+    fr?: I18nLanguageResources;
+    bo?: I18nLanguageResources;
+    hu?: I18nLanguageResources;
+    id?: I18nLanguageResources;
+    it?: I18nLanguageResources;
+    ja?: I18nLanguageResources;
+    ko?: I18nLanguageResources;
+    nb?: I18nLanguageResources;
+    nl?: I18nLanguageResources;
+    pl?: I18nLanguageResources;
+    pt_pt?: I18nLanguageResources;
+    pt?: I18nLanguageResources;
+    ro?: I18nLanguageResources;
+    ru?: I18nLanguageResources;
+    sk?: I18nLanguageResources;
+    sv?: I18nLanguageResources;
+    th?: I18nLanguageResources;
+    tr?: I18nLanguageResources;
+    uk?: I18nLanguageResources;
+    vi?: I18nLanguageResources;
+    zh_hk?: I18nLanguageResources;
+    zh_tw?: I18nLanguageResources;
+    zh?: I18nLanguageResources;
+    ar?: I18nLanguageResources;
+    he?: I18nLanguageResources;
+    [key: string]: I18nLanguageResources | undefined;
+}
+export declare let i18ns: I18nConfig;
+export declare let hasInitI18nConfig: boolean;
+export declare const initI18nConfig: (i18nConfig: I18nConfig) => void;
+export declare class I18n {
+    keyMapper: any;
+    strings: any;
+    i18nValueMapper: any;
+    constructor(i18n: any, hasLang?: boolean, keyMapper?: any, i18nValueMapper?: any);
+    get(key: string, values?: any[], defaultValue?: string): string;
+    getI18nKey(key: string, values: any[]): string;
+}
+declare const _default: {
+    get(key: string, values?: any[], defaultValue?: string): string;
+};
+export default _default;

package/dist/resources/i18n.js

@@ -0,0 +1,212 @@
+import { Resources, Host } from 'miot';
+import { getStringGenerator } from "../utils/fns";
+import { getPluralRules } from "../utils/i18n";
+import { isTypeOf } from "../utils/types";
+const lang = Host.locale.language;
+function replaceHolder(v = '') {
+  if (typeof v !== 'string') return v;
+  let ret = v;
+  let index = 1;
+  while (ret.indexOf('${}') !== -1) {
+    ret = ret.replace('${}', `{${index}}`);
+    index += 1;
+  }
+  return ret;
+}
+
+/* eslint-disable global-require, @typescript-eslint/no-var-requires, camelcase, @typescript-eslint/no-explicit-any */
+
+// Type definition for i18n language resources
+
+// Type definition for i18n config
+
+// eslint-disable-next-line import/no-mutable-exports
+export let i18ns = {};
+//   get cs() {
+//     return require('../assets/i18n/cs').default;
+//   },
+//   get de() {
+//     return require('../assets/i18n/de').default;
+//   },
+//   get el() {
+//     return require('../assets/i18n/el').default;
+//   },
+//   get en() {
+//     return require('../assets/i18n/en').default;
+//   },
+//   get es_us() {
+//     return require('../assets/i18n/es_us').default;
+//   },
+//   get es() {
+//     return require('../assets/i18n/es').default;
+//   },
+//   get fi() {
+//     return require('../assets/i18n/fi').default;
+//   },
+//   get fr() {
+//     return require('../assets/i18n/fr').default;
+//   },
+//   get bo() {
+//     return require('../assets/i18n/bo').default;
+//   },
+//   get hu() {
+//     return require('../assets/i18n/hu').default;
+//   },
+//   get id() {
+//     return require('../assets/i18n/id').default;
+//   },
+//   get it() {
+//     return require('../assets/i18n/it').default;
+//   },
+//   get ja() {
+//     return require('../assets/i18n/ja').default;
+//   },
+//   get ko() {
+//     return require('../assets/i18n/ko').default;
+//   },
+//   get nb() {
+//     return require('../assets/i18n/nb').default;
+//   },
+//   get nl() {
+//     return require('../assets/i18n/nl').default;
+//   },
+//   get pl() {
+//     return require('../assets/i18n/pl').default;
+//   },
+//   get pt_pt() {
+//     return require('../assets/i18n/pt_pt').default;
+//   },
+//   get pt() {
+//     return require('../assets/i18n/pt').default;
+//   },
+//   get ro() {
+//     return require('../assets/i18n/ro').default;
+//   },
+//   get ru() {
+//     return require('../assets/i18n/ru').default;
+//   },
+//   get sk() {
+//     return require('../assets/i18n/sk').default;
+//   },
+//   get sv() {
+//     return require('../assets/i18n/sv').default;
+//   },
+//   get th() {
+//     return require('../assets/i18n/th').default;
+//   },
+//   get tr() {
+//     return require('../assets/i18n/tr').default;
+//   },
+//   get uk() {
+//     return require('../assets/i18n/uk').default;
+//   },
+//   get vi() {
+//     return require('../assets/i18n/vi').default;
+//   },
+//   get zh_hk() {
+//     return require('../assets/i18n/zh_hk').default;
+//   },
+//   get zh_tw() {
+//     return require('../assets/i18n/zh_tw').default;
+//   },
+//   get zh() {
+//     return require('../assets/i18n/zh').default;
+//   },
+//   get ar() {
+//     return require('../assets/i18n/ar').default;
+//   },
+//   get he() {
+//     return require('../assets/i18n/he').default;
+//   },
+// };
+/* eslint-enable global-require, @typescript-eslint/no-var-requires, camelcase */
+export let hasInitI18nConfig = false;
+let LocalI18n = i18ns[lang] || i18ns.en || i18ns.zh || {};
+export const initI18nConfig = i18nConfig => {
+  if (hasInitI18nConfig) {
+    return;
+  }
+  i18ns = i18nConfig;
+  LocalI18n = i18ns[lang] || i18ns.en || i18ns.zh || {};
+  hasInitI18nConfig = true;
+};
+
+// 根据传参返回多语言解析器
+export class I18n {
+  /**
+   * Creates an instance of I18n.
+   * @param {object} i18n { title: 'xxx' } 或{ zh: { title: 'xxx' } }
+   * @param {boolean} [hasLang=false]
+   * @param {object} keyMapper
+   * @param {(values) => values} [i18nValueMapper=null] 将控件的 values 根据需求进行转换，供多语言求值
+   * @memberof I18n
+   */
+  // eslint-disable-next-line default-param-last
+  constructor(i18n, hasLang = false, keyMapper, i18nValueMapper = null) {
+    this.keyMapper = keyMapper || {};
+    const tI18n = (hasLang ? i18n[lang] || i18n.en || i18n.zh : i18n) || {};
+    const rI18n = Object.entries(tI18n).reduce((r, [k, v]) => {
+      if (!isTypeOf('Object', v)) {
+        return {
+          ...r,
+          [k]: replaceHolder(v)
+        };
+      }
+      return {
+        ...r,
+        ...Object.entries(v).reduce((rr, [kk, vv]) => {
+          return {
+            ...rr,
+            [`${k}:${kk}`]: replaceHolder(vv)
+          };
+        }, {})
+      };
+    }, {});
+    this.strings = i18n ? (Resources.createI18n({
+      [lang]: rI18n
+    }, lang) || {}).strings : null;
+    this.i18nValueMapper = i18nValueMapper;
+  }
+  get(key, values, defaultValue = '') {
+    let _values = JSON.parse(JSON.stringify(values || []));
+    if (this.i18nValueMapper && values?.length) {
+      _values = this.i18nValueMapper(_values, key) || [];
+    }
+    const strings = this.strings || {};
+    const i18nKey = this.getI18nKey(key, _values || []);
+    const firstNumber = _values.find(v => isTypeOf('Number', v));
+    const isNumber = isTypeOf('Number', firstNumber);
+    let finalI18nKey = i18nKey;
+    const pluralKey = `${i18nKey}:${getPluralRules(lang, firstNumber)}`;
+    if (isNumber && strings[pluralKey]) {
+      finalI18nKey = pluralKey;
+    }
+    if (!finalI18nKey || !strings[finalI18nKey]) {
+      return defaultValue;
+    }
+    let result = strings[finalI18nKey](...(_values || []));
+    // 不显示 {1} 这样的占位符
+    const placeholderReg = /^\{\d+\}$/;
+    if (typeof result === 'string' && result.match(placeholderReg)) {
+      result = '';
+    }
+    return result;
+  }
+  getI18nKey(key, values) {
+    const keyGenerator = this.keyMapper[key] ? getStringGenerator(this.keyMapper[key]) : null;
+    const ret = keyGenerator ? keyGenerator(...values) : key;
+    return ret;
+  }
+}
+
+// 根据固定模块返回多语言解析器
+
+export default {
+  get(key, values, defaultValue = '') {
+    const i18nValue = LocalI18n[key];
+    const t = new I18n({
+      [key]: i18nValue
+    }, false);
+    return t.get(key, values, defaultValue);
+  }
+};

package/dist/service/specs/error-code.d.ts

@@ -0,0 +1,19 @@
+export declare const OK = 0;
+export declare const IN_PROCESS = 1;
+export declare const SERVICE_NOT_FOUND = -704040002;
+export declare const PROP_NOT_FOUND = -702000003;
+export declare const EVENT_NOT_FOUND = -704040004;
+export declare const ACTION_NOT_FOUND = -704040005;
+export declare const PROP_READ_ERROR = -704030013;
+export declare const PROP_WRITE_ERROR = -704030023;
+export declare const DEVICE__OFFLINE = -704042011;
+export declare const DEVICE_RESET = -16;
+export declare const PLUGIN_UNKNOWN_ERROR = -1;
+export declare const PLUGIN_NULL_ERROR = -2;
+export declare const PLUGIN_ILLEGAL_ARGS_ERROR = -3;
+export declare const PLUGIN_ILLEGAL_STATE_ERROR = -4;
+export declare const BT_NONSUPPORT = -5;
+export declare const BT_DISABLED = -6;
+export declare const ACTION_CANCELED = -7;
+export declare function isSuccess(code: number): boolean;
+export declare function getCustomErrorCode(code: number): number | string;

package/dist/service/specs/error-code.js

@@ -0,0 +1,41 @@
+/**
+ * DataSource 操作错误码定义
+ *
+ * 参考文档：
+ * 1 [错误码定义] {@link https://iot.mi.com/new/doc/extension-development/basic-functions/communication#%E9%94%99%E8%AF%AF%E7%A0%81}
+ * 2 [内部文档] {@link https://wiki.n.miui.com/pages/viewpage.action?pageId=369793016}
+ */
+
+export const OK = 0;
+export const IN_PROCESS = 1;
+
+// 和云端保持一致
+export const SERVICE_NOT_FOUND = -704040002;
+export const PROP_NOT_FOUND = -702000003;
+export const EVENT_NOT_FOUND = -704040004;
+export const ACTION_NOT_FOUND = -704040005;
+export const PROP_READ_ERROR = -704030013;
+export const PROP_WRITE_ERROR = -704030023;
+export const DEVICE__OFFLINE = -704042011;
+export const DEVICE_RESET = -16;
+
+// 插件引擎内部错误
+export const PLUGIN_UNKNOWN_ERROR = -1;
+export const PLUGIN_NULL_ERROR = -2;
+export const PLUGIN_ILLEGAL_ARGS_ERROR = -3;
+export const PLUGIN_ILLEGAL_STATE_ERROR = -4;
+export const BT_NONSUPPORT = -5;
+export const BT_DISABLED = -6;
+export const ACTION_CANCELED = -7;
+export function isSuccess(code) {
+  return code === OK || code === IN_PROCESS;
+}
+
+// 某些情况会需要自定义code
+// 比如action 的返回值，会与内置错误码冲突
+export function getCustomErrorCode(code) {
+  if (!code) {
+    return code;
+  }
+  return `customErrorCode${code}`;
+}

package/dist/service/specs/index.d.ts

@@ -0,0 +1,95 @@
+import { CACHE_SOURCE } from './specCache';
+import { Spec } from '../../types';
+export { CACHE_SOURCE };
+export declare function enableCache(enabled: boolean): void;
+export declare function isCacheEnabled(): boolean;
+export interface GetPropsOptions {
+    useCache?: boolean;
+    forceRefresh?: boolean;
+    fromSourceIfNeed?: boolean;
+}
+export interface SetPropsOptions {
+    updateCache?: boolean;
+}
+export interface SubscribeOptions {
+    publishImmediately?: boolean;
+    updateCache?: boolean;
+}
+export interface SpecResult {
+    siid: number;
+    piid?: number;
+    eiid?: number;
+    aiid?: number;
+    miid?: number;
+    value?: unknown;
+    code: number;
+    updateTime?: number;
+    specDataSource?: string;
+    fromCache?: boolean;
+    did?: string;
+    in?: unknown[];
+    dataSource?: number;
+}
+export interface SubscribeResult {
+    props: SpecResult[];
+    unsubscribe: () => void;
+}
+export interface CachedProp {
+    value: unknown;
+    updateTime: number;
+    specDataSource: string;
+}
+export declare function getProps(props: Spec[], options?: GetPropsOptions): Promise<any>;
+export declare function getCachedProps(props: Spec[]): ({
+    value: any;
+    updateTime: any;
+    code: number;
+    specDataSource: any;
+    did?: string | undefined;
+    siid: number;
+    piid?: number | undefined;
+    aiid?: number | undefined;
+    miid?: number | undefined;
+    in?: any[] | undefined;
+    dataSource?: number | undefined;
+} | {
+    code: number;
+    did?: string | undefined;
+    siid: number;
+    piid?: number | undefined;
+    aiid?: number | undefined;
+    miid?: number | undefined;
+    value?: any;
+    in?: any[] | undefined;
+    dataSource?: number | undefined;
+})[];
+export declare function setProps(props: Spec[], options?: SetPropsOptions): Promise<SpecResult[]>;
+export declare function setCachedProps(props: Spec[]): Promise<{
+    code: number;
+    did?: string | undefined;
+    siid: number;
+    piid?: number | undefined;
+    aiid?: number | undefined;
+    miid?: number | undefined;
+    value?: any;
+    in?: any[] | undefined;
+    dataSource?: number | undefined;
+}[]>;
+export declare function doAction(prop: Spec): Promise<{
+    code: number;
+    message: string;
+}> | Promise<{
+    code: number;
+    did?: string | undefined;
+    siid: number;
+    piid?: number | undefined;
+    aiid?: number | undefined;
+    miid?: number | undefined;
+    value?: any;
+    in?: any[] | undefined;
+    dataSource?: number | undefined;
+}>;
+export declare function subscribe(props: Spec[], listener: (data: SpecResult) => void, options?: SubscribeOptions): Promise<{
+    props: SpecResult[];
+    unsubscribe: () => void;
+}>;