@chatluna/qface 0.0.0-stage → 1.4.1

package/lib/index.d.ts

@@ -0,0 +1,23 @@
+import { data } from './data.ts';
+export interface Face {
+    /** Face id, the `sid` in a QQ face element. */
+    QSid: string;
+    /** Chinese display name with a leading `/`. */
+    QDes: string;
+    IQLid: string;
+    AQLid: string;
+    EMCode: string;
+    /** `'1'` when the face is served as a png instead of a gif. */
+    isStatic?: '1';
+    isCMEmoji?: '1';
+    AniStickerType?: 1;
+    AniStickerPackId?: '1';
+    AniStickerId?: string;
+    QHide?: '1';
+    /** Pinyin aliases accepted by `findFace`, full name first then abbreviations. */
+    Input?: string[];
+}
+export { data };
+export declare function getFace(id: string | number): Face | undefined;
+export declare function findFace(input: string): string | null;
+export declare function getFaceUrl(id: string | number, base?: string): string;

package/lib/index.js

@@ -0,0 +1,21 @@
+// The table lives in data.json and is synced from github.com/koishijs/QFace by `yarn sync`.
+import { data } from './data.js';
+export { data };
+export function getFace(id) {
+    const sid = String(id);
+    return data.find((el) => el.QSid === sid);
+}
+export function findFace(input) {
+    if (input[0] === '/')
+        input = input.substring(1);
+    const match = data.find((el) => el.QDes.substring(1) === input) ||
+        data.find((el) => el.Input?.includes(input)) ||
+        data.find((el) => el.Input?.some((i) => i.startsWith(input)));
+    return match ? match.QSid : null;
+}
+export function getFaceUrl(id, base = 'https://koishi.js.org/QFace') {
+    const item = getFace(id);
+    if (!item)
+        return '';
+    return `${base}${item.isStatic ? `/static/s${id}.png` : `/gif/s${id}.gif`}`;
+}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@chatluna/qface",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.4.1",
+  "description": "Tencent QQ system face catalog: ids, names and pinyin shortcuts, with links to the gif or png each face is served as. Maintenance fork of koishijs/QFace",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ChatLunaLab/qface.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ChatLunaLab/qface/issues"
+  },
+  "keywords": [
+    "qface",
+    "tencent",
+    "qq",
+    "face",
+    "oicq",
+    "emoji",
+    "reaction",
+    "chatluna"
+  ],
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./data.json": "./lib/data.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && cp src/data.json lib/data.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "yarn build && node --test tests/*.test.ts",
+    "sync": "node scripts/sync.ts",
+    "prepack": "yarn build"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "typescript": "7.0.2"
+  },
+  "packageManager": "yarn@4.18.0"
+}