koishi-plugin-cchess 2.3.0 → 2.4.1

package/lib/material-color.d.ts

@@ -0,0 +1,549 @@
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare var Hct: {
+    new (argb: any): {
+        toInt(): any;
+        /**
+         * A number, in degrees, representing ex. red, orange, yellow, etc.
+         * Ranges from 0 <= hue < 360.
+         */
+        hue: any;
+        chroma: any;
+        /** Lightness. Ranges from 0 to 100. */
+        tone: any;
+        /** Sets a property of the Hct object. */
+        setValue(propertyName: any, value: any): void;
+        toString(): string;
+        setInternalState(argb: any): void;
+        /**
+         * Translates a color into different [ViewingConditions].
+         *
+         * Colors change appearance. They look different with lights on versus off,
+         * the same color, as in hex code, on white looks different when on black.
+         * This is called color relativity, most famously explicated by Josef Albers
+         * in Interaction of Color.
+         *
+         * In color science, color appearance models can account for this and
+         * calculate the appearance of a color in different settings. HCT is based on
+         * CAM16, a color appearance model, and uses it to make these calculations.
+         *
+         * See [ViewingConditions.make] for parameters affecting color appearance.
+         */
+        inViewingConditions(vc: any): /*elided*/ any;
+    };
+    from(hue: any, chroma: any, tone: any): {
+        toInt(): any;
+        /**
+         * A number, in degrees, representing ex. red, orange, yellow, etc.
+         * Ranges from 0 <= hue < 360.
+         */
+        hue: any;
+        chroma: any;
+        /** Lightness. Ranges from 0 to 100. */
+        tone: any;
+        /** Sets a property of the Hct object. */
+        setValue(propertyName: any, value: any): void;
+        toString(): string;
+        setInternalState(argb: any): void;
+        /**
+         * Translates a color into different [ViewingConditions].
+         *
+         * Colors change appearance. They look different with lights on versus off,
+         * the same color, as in hex code, on white looks different when on black.
+         * This is called color relativity, most famously explicated by Josef Albers
+         * in Interaction of Color.
+         *
+         * In color science, color appearance models can account for this and
+         * calculate the appearance of a color in different settings. HCT is based on
+         * CAM16, a color appearance model, and uses it to make these calculations.
+         *
+         * See [ViewingConditions.make] for parameters affecting color appearance.
+         */
+        inViewingConditions(vc: any): /*elided*/ any;
+    };
+    /**
+     * @param argb ARGB representation of a color.
+     * @return HCT representation of a color in default viewing conditions
+     */
+    fromInt(argb: any): {
+        toInt(): any;
+        /**
+         * A number, in degrees, representing ex. red, orange, yellow, etc.
+         * Ranges from 0 <= hue < 360.
+         */
+        hue: any;
+        chroma: any;
+        /** Lightness. Ranges from 0 to 100. */
+        tone: any;
+        /** Sets a property of the Hct object. */
+        setValue(propertyName: any, value: any): void;
+        toString(): string;
+        setInternalState(argb: any): void;
+        /**
+         * Translates a color into different [ViewingConditions].
+         *
+         * Colors change appearance. They look different with lights on versus off,
+         * the same color, as in hex code, on white looks different when on black.
+         * This is called color relativity, most famously explicated by Josef Albers
+         * in Interaction of Color.
+         *
+         * In color science, color appearance models can account for this and
+         * calculate the appearance of a color in different settings. HCT is based on
+         * CAM16, a color appearance model, and uses it to make these calculations.
+         *
+         * See [ViewingConditions.make] for parameters affecting color appearance.
+         */
+        inViewingConditions(vc: any): /*elided*/ any;
+    };
+    isBlue(hue: any): boolean;
+    isYellow(hue: any): boolean;
+    isCyan(hue: any): boolean;
+};
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2023 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2022 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare var SchemeTonalSpot: {
+    new (sourceColorHct: any, isDark: any, contrastLevel: any, specVersion?: any, platform?: any): {
+        toString(): string;
+        getArgb(dynamicColor: any): any;
+        getHct(dynamicColor: any): any;
+        get primaryPaletteKeyColor(): any;
+        get secondaryPaletteKeyColor(): any;
+        get tertiaryPaletteKeyColor(): any;
+        get neutralPaletteKeyColor(): any;
+        get neutralVariantPaletteKeyColor(): any;
+        get errorPaletteKeyColor(): any;
+        get background(): any;
+        get onBackground(): any;
+        get surface(): any;
+        get surfaceDim(): any;
+        get surfaceBright(): any;
+        get surfaceContainerLowest(): any;
+        get surfaceContainerLow(): any;
+        get surfaceContainer(): any;
+        get surfaceContainerHigh(): any;
+        get surfaceContainerHighest(): any;
+        get onSurface(): any;
+        get surfaceVariant(): any;
+        get onSurfaceVariant(): any;
+        get inverseSurface(): any;
+        get inverseOnSurface(): any;
+        get outline(): any;
+        get outlineVariant(): any;
+        get shadow(): any;
+        get scrim(): any;
+        get surfaceTint(): any;
+        get primary(): any;
+        get primaryDim(): any;
+        get onPrimary(): any;
+        get primaryContainer(): any;
+        get onPrimaryContainer(): any;
+        get primaryFixed(): any;
+        get primaryFixedDim(): any;
+        get onPrimaryFixed(): any;
+        get onPrimaryFixedVariant(): any;
+        get inversePrimary(): any;
+        get secondary(): any;
+        get secondaryDim(): any;
+        get onSecondary(): any;
+        get secondaryContainer(): any;
+        get onSecondaryContainer(): any;
+        get secondaryFixed(): any;
+        get secondaryFixedDim(): any;
+        get onSecondaryFixed(): any;
+        get onSecondaryFixedVariant(): any;
+        get tertiary(): any;
+        get tertiaryDim(): any;
+        get onTertiary(): any;
+        get tertiaryContainer(): any;
+        get onTertiaryContainer(): any;
+        get tertiaryFixed(): any;
+        get tertiaryFixedDim(): any;
+        get onTertiaryFixed(): any;
+        get onTertiaryFixedVariant(): any;
+        get error(): any;
+        get errorDim(): any;
+        get onError(): any;
+        get errorContainer(): any;
+        get onErrorContainer(): any;
+    };
+    maybeFallbackSpecVersion(specVersion: any, variant: any): any;
+    /**
+     * Returns a new hue based on a piecewise function and input color hue.
+     *
+     * For example, for the following function:
+     * result = 26 if 0 <= hue < 101
+     * result = 39 if 101 <= hue < 210
+     * result = 28 if 210 <= hue < 360
+     *
+     * call the function as:
+     *
+     * const hueBreakpoints = [0, 101, 210, 360];
+     * const hues = [26, 39, 28];
+     * const result = scheme.piecewise(hue, hueBreakpoints, hues);
+     *
+     * @param sourceColorHct The input value.
+     * @param hueBreakpoints The breakpoints, in sorted order. No default lower or
+     *     upper bounds are assumed.
+     * @param hues The hues that should be applied when source color's hue is >=
+     *     the same index in hueBrakpoints array, and < the hue at the next index
+     *     in hueBrakpoints array. Otherwise, the source color's hue is returned.
+     */
+    getPiecewiseHue(sourceColorHct: any, hueBreakpoints: any, hues: any): any;
+    /**
+     * Returns a shifted hue based on a piecewise function and input color hue.
+     *
+     * For example, for the following function:
+     * result = hue + 26 if 0 <= hue < 101
+     * result = hue - 39 if 101 <= hue < 210
+     * result = hue + 28 if 210 <= hue < 360
+     *
+     * call the function as:
+     *
+     * const hueBreakpoints = [0, 101, 210, 360];
+     * const hues = [26, -39, 28];
+     * const result = scheme.getRotatedHue(hue, hueBreakpoints, hues);
+     *
+     * @param sourceColorHct the source color of the theme, in HCT.
+     * @param hueBreakpoints The "breakpoints", i.e. the hues at which a rotation
+     *     should be apply. No default lower or upper bounds are assumed.
+     * @param rotations The rotation that should be applied when source color's
+     *     hue is >= the same index in hues array, and < the hue at the next
+     *     index in hues array. Otherwise, the source color's hue is returned.
+     */
+    getRotatedHue(sourceColorHct: any, hueBreakpoints: any, rotations: any): any;
+};
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare function hexFromArgb(argb: any): string;
+declare function argbFromHex(hex: any): number;
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export { Hct, SchemeTonalSpot, argbFromHex, hexFromArgb };

package/lib/ux.d.ts

@@ -0,0 +1,31 @@
+import { Context, h, Session } from 'koishi';
+type Owner = {
+    name: string;
+    matches: (session: Session) => boolean | Promise<boolean>;
+};
+/** 图文模式默认只发渲染图；完整文字只在用户切到「文字」模式时出现。偏好只影响本人。 */
+export declare function usePresentation(ctx: Context, command: string): {
+    textOnly: (session: Session) => boolean;
+    /** 图文模式只给图片；图片缺失或用户选了文字模式时才退回文字。 */
+    present(session: Session, image: h.Fragment | null | undefined, text: h.Fragment): h.Fragment;
+};
+/** Plugins register their active input grammar; overlapping messages are never executed. */
+export declare function registerDirectInput(ctx: Context, name: string, matches: Owner['matches']): void;
+export declare function directInputConflict(ctx: Context, session: Session): Promise<boolean>;
+/** No hidden time limit: users can extend the non-game input step without losing context. */
+export declare function promptInput(session: Session, instruction: string): Promise<string | undefined>;
+export declare const IMAGE_FAILURE = "\u56FE\u7247\u6682\u65F6\u65E0\u6CD5\u751F\u6210\uFF0C\u5DF2\u4FDD\u7559\u6587\u5B57\u5185\u5BB9\u3002\u53EF\u4EE5\u7A0D\u540E\u91CD\u8BD5\uFF1B\u82E5\u6301\u7EED\u5931\u8D25\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002";
+/**
+ * 渲染图的等价文字。图文模式随图片一起丢掉、文字模式展开成正文，
+ * 因此它永远不会原样发到聊天平台。
+ */
+export declare const IMAGE_TEXT_TYPE = "ux-image-text";
+export declare function imageText(text: h.Fragment): h;
+/** 图文模式：保留图片与普通文字，去掉图片的等价文字。 */
+export declare function imagesOnly(content: h.Fragment): h[];
+/** 文字模式：去掉图片，把等价文字展开成普通文本。 */
+export declare function withoutImages(content: h.Fragment): h[];
+/** 发送前的统一选择：文字模式去掉图片，图文模式去掉等价文字。 */
+export declare function choosePresentation(content: h.Fragment, textOnly: boolean): h[];
+export declare function isTextOnly(ctx: Context, session: Session): boolean;
+export {};

package/package.json

@@ -1,16 +1,20 @@
 {
   "name": "koishi-plugin-cchess",
-  "description": "Koishi 插件 · 中国象棋。",
-  "version": "2.3.0",
+  "description": "Koishi 中国象棋：支持玩家对战、皮卡鱼引擎和 FEN 局面导入。",
+  "version": "2.4.1",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [
     "lib",
     "LICENSE-APACHE",
-    "LICENSE-MIT"
+    "LICENSE-MIT",
+    "DESIGN_SYSTEM.md",
+    "CHANGELOG.md",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "scripts": {
-    "yakumo:after:esbuild": "node scripts/copy-assets.mjs"
+    "yakumo:after:esbuild": "node scripts/copy-assets.mjs",
+    "check:design": "node scripts/check-design-system.mjs"
   },
   "koishi": {
     "service": {