emojistry 1.0.0

package/data/generated/emojis.sample.json

@@ -0,0 +1,35 @@
+{
+	"generatedAt": "2026-06-15T00:00:00.000Z",
+	"source": "sample",
+	"count": 2,
+	"emojis": [
+		{
+			"emoji": "😀",
+			"codepoints": ["U+1F600"],
+			"qualification": "fully-qualified",
+			"emojiVersion": "1.0",
+			"name": "grinning face",
+			"group": "Smileys & Emotion",
+			"subgroup": "face-smiling",
+			"slug": "grinning-face",
+			"category": "faces",
+			"keywords": ["grinning", "face"],
+			"hasSkinTone": false,
+			"isSequence": false
+		},
+		{
+			"emoji": "❤️",
+			"codepoints": ["U+2764", "U+FE0F"],
+			"qualification": "fully-qualified",
+			"emojiVersion": "0.6",
+			"name": "red heart",
+			"group": "Smileys & Emotion",
+			"subgroup": "emotion",
+			"slug": "red-heart",
+			"category": "faces",
+			"keywords": ["red", "heart"],
+			"hasSkinTone": false,
+			"isSequence": true
+		}
+	]
+}

package/dist/categories.d.ts

@@ -0,0 +1,4 @@
+import type { EmojiCategory } from "./types.js";
+export declare function categoryForUnicodeGroup(group: string): EmojiCategory;
+export declare function listCategories(): EmojiCategory[];
+//# sourceMappingURL=categories.d.ts.map

package/dist/categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../src/categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAehD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAEpE;AAED,wBAAgB,cAAc,IAAI,aAAa,EAAE,CAchD"}

package/dist/categories.js

@@ -0,0 +1,30 @@
+const GROUP_TO_CATEGORY = {
+    "Smileys & Emotion": "faces",
+    "People & Body": "people",
+    "Animals & Nature": "animals-nature",
+    "Food & Drink": "food-drink",
+    "Travel & Places": "travel-places",
+    Activities: "activities",
+    Objects: "objects",
+    Symbols: "symbols",
+    Flags: "flags",
+    Component: "components",
+};
+export function categoryForUnicodeGroup(group) {
+    return GROUP_TO_CATEGORY[group] ?? "other";
+}
+export function listCategories() {
+    return [
+        "faces",
+        "people",
+        "animals-nature",
+        "food-drink",
+        "travel-places",
+        "activities",
+        "objects",
+        "symbols",
+        "flags",
+        "components",
+        "other",
+    ];
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { categoryForUnicodeGroup, listCategories } from "./categories.js";
+export { fetchEmojiTest, parseEmojiTest } from "./ingest/unicode.js";
+export { normalizeEmojiEntries, normalizeEmojiEntry, slugify } from "./normalize/emoji.js";
+export { findEmoji, groupByCategory, searchEmojis } from "./search.js";
+export type { EmojiCategory, EmojiQualification, EmojiRecord, EmojiRegistrySnapshot, UnicodeEmojiEntry, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,iBAAiB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { categoryForUnicodeGroup, listCategories } from "./categories.js";
+export { fetchEmojiTest, parseEmojiTest } from "./ingest/unicode.js";
+export { normalizeEmojiEntries, normalizeEmojiEntry, slugify } from "./normalize/emoji.js";
+export { findEmoji, groupByCategory, searchEmojis } from "./search.js";

package/dist/ingest/unicode.d.ts

@@ -0,0 +1,4 @@
+import type { UnicodeEmojiEntry } from "../types.js";
+export declare function parseEmojiTest(input: string): UnicodeEmojiEntry[];
+export declare function fetchEmojiTest(url: string): Promise<string>;
+//# sourceMappingURL=unicode.d.ts.map

package/dist/ingest/unicode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unicode.d.ts","sourceRoot":"","sources":["../../src/ingest/unicode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAsB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIzE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA0CjE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUjE"}

package/dist/ingest/unicode.js

@@ -0,0 +1,45 @@
+const EMOJI_LINE_PATTERN = /^([0-9A-F ]+)\s*;\s*([a-z-]+)\s*#\s*(\S+)\s+E([0-9.]+)\s+(.+)$/u;
+export function parseEmojiTest(input) {
+    const entries = [];
+    let group = "Other";
+    let subgroup = "other";
+    for (const rawLine of input.split("\n")) {
+        const line = rawLine.trim();
+        if (line.startsWith("# group:")) {
+            group = line.replace("# group:", "").trim();
+            continue;
+        }
+        if (line.startsWith("# subgroup:")) {
+            subgroup = line.replace("# subgroup:", "").trim();
+            continue;
+        }
+        const match = line.match(EMOJI_LINE_PATTERN);
+        if (!match)
+            continue;
+        const codepointText = match[1];
+        const qualification = match[2];
+        const emoji = match[3];
+        const emojiVersion = match[4];
+        const name = match[5];
+        entries.push({
+            emoji,
+            codepoints: codepointText
+                .trim()
+                .split(/\s+/u)
+                .map((value) => `U+${value}`),
+            qualification: qualification,
+            emojiVersion,
+            name,
+            group,
+            subgroup,
+        });
+    }
+    return entries;
+}
+export async function fetchEmojiTest(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch Unicode emoji data: ${response.status} ${response.statusText}`);
+    }
+    return response.text();
+}

package/dist/normalize/emoji.d.ts

@@ -0,0 +1,5 @@
+import type { EmojiRecord, UnicodeEmojiEntry } from "../types.js";
+export declare function normalizeEmojiEntry(entry: UnicodeEmojiEntry): EmojiRecord;
+export declare function normalizeEmojiEntries(entries: UnicodeEmojiEntry[]): EmojiRecord[];
+export declare function slugify(value: string): string;
+//# sourceMappingURL=emoji.d.ts.map

package/dist/normalize/emoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emoji.d.ts","sourceRoot":"","sources":["../../src/normalize/emoji.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIlE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,WAAW,CASzE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,WAAW,EAAE,CAEjF;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAM7C"}

package/dist/normalize/emoji.js

@@ -0,0 +1,30 @@
+import { categoryForUnicodeGroup } from "../categories.js";
+const SKIN_TONE_CODEPOINTS = new Set(["U+1F3FB", "U+1F3FC", "U+1F3FD", "U+1F3FE", "U+1F3FF"]);
+export function normalizeEmojiEntry(entry) {
+    return {
+        ...entry,
+        slug: slugify(entry.name),
+        category: categoryForUnicodeGroup(entry.group),
+        keywords: keywordsForName(entry.name),
+        hasSkinTone: entry.codepoints.some((codepoint) => SKIN_TONE_CODEPOINTS.has(codepoint)),
+        isSequence: entry.codepoints.length > 1,
+    };
+}
+export function normalizeEmojiEntries(entries) {
+    return entries.map(normalizeEmojiEntry);
+}
+export function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/&/gu, " and ")
+        .replace(/[^a-z0-9]+/gu, "-")
+        .replace(/^-|-$/gu, "");
+}
+function keywordsForName(name) {
+    return [
+        ...new Set(name
+            .toLowerCase()
+            .split(/[^a-z0-9]+/u)
+            .filter(Boolean)),
+    ];
+}

package/dist/search.d.ts

@@ -0,0 +1,5 @@
+import type { EmojiCategory, EmojiRecord } from "./types.js";
+export declare function searchEmojis(emojis: readonly EmojiRecord[], query: string): EmojiRecord[];
+export declare function groupByCategory(emojis: readonly EmojiRecord[]): Partial<Record<EmojiCategory, EmojiRecord[]>>;
+export declare function findEmoji(emojis: readonly EmojiRecord[], value: string): EmojiRecord | undefined;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAazF;AAED,wBAAgB,eAAe,CAC9B,MAAM,EAAE,SAAS,WAAW,EAAE,GAC5B,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC,CAAC,CAM/C;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAWhG"}

package/dist/search.js

@@ -0,0 +1,28 @@
+export function searchEmojis(emojis, query) {
+    const normalizedQuery = query.trim().toLowerCase();
+    if (!normalizedQuery)
+        return [...emojis];
+    return emojis.filter((emoji) => {
+        return (emoji.emoji === query ||
+            emoji.name.toLowerCase().includes(normalizedQuery) ||
+            emoji.slug.includes(normalizedQuery) ||
+            emoji.keywords.some((keyword) => keyword.includes(normalizedQuery)) ||
+            emoji.codepoints.some((codepoint) => codepoint.toLowerCase() === normalizedQuery));
+    });
+}
+export function groupByCategory(emojis) {
+    return emojis.reduce((groups, emoji) => {
+        groups[emoji.category] ??= [];
+        groups[emoji.category]?.push(emoji);
+        return groups;
+    }, {});
+}
+export function findEmoji(emojis, value) {
+    const normalizedValue = value.trim().toLowerCase();
+    return emojis.find((emoji) => {
+        return (emoji.emoji === value ||
+            emoji.slug === normalizedValue ||
+            emoji.name.toLowerCase() === normalizedValue ||
+            emoji.codepoints.some((codepoint) => codepoint.toLowerCase() === normalizedValue));
+    });
+}

package/dist/types.d.ts

@@ -0,0 +1,25 @@
+export type EmojiQualification = "fully-qualified" | "minimally-qualified" | "unqualified" | "component";
+export type EmojiCategory = "faces" | "people" | "animals-nature" | "food-drink" | "travel-places" | "activities" | "objects" | "symbols" | "flags" | "components" | "other";
+export interface UnicodeEmojiEntry {
+    emoji: string;
+    codepoints: string[];
+    qualification: EmojiQualification;
+    emojiVersion: string;
+    name: string;
+    group: string;
+    subgroup: string;
+}
+export interface EmojiRecord extends UnicodeEmojiEntry {
+    slug: string;
+    category: EmojiCategory;
+    keywords: string[];
+    hasSkinTone: boolean;
+    isSequence: boolean;
+}
+export interface EmojiRegistrySnapshot {
+    generatedAt: string;
+    source: string;
+    count: number;
+    emojis: EmojiRecord[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC3B,iBAAiB,GACjB,qBAAqB,GACrB,aAAa,GACb,WAAW,CAAC;AAEf,MAAM,MAAM,aAAa,GACtB,OAAO,GACP,QAAQ,GACR,gBAAgB,GAChB,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,SAAS,GACT,SAAS,GACT,OAAO,GACP,YAAY,GACZ,OAAO,CAAC;AAEX,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,kBAAkB,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,EAAE,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,56 @@
+{
+	"name": "emojistry",
+	"version": "1.0.0",
+	"description": "Versioned emoji registry, Unicode ingestion, categorization, and search data for apps.",
+	"license": "MIT",
+	"module": "dist/index.js",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"type": "module",
+	"private": false,
+	"sideEffects": false,
+	"files": [
+		"dist",
+		"data/generated",
+		"README.md"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		},
+		"./data": "./data/generated/emojis.json",
+		"./data/emojis.json": "./data/generated/emojis.json",
+		"./package.json": "./package.json"
+	},
+	"scripts": {
+		"build": "rm -rf dist && tsc -p tsconfig.build.json",
+		"dev": "bun run src/cli.ts",
+		"generate": "bun run src/cli.ts generate",
+		"server": "bun run src/server.ts",
+		"start": "bun run src/server.ts",
+		"worker:dev": "bunx wrangler dev",
+		"worker:deploy": "bunx wrangler deploy",
+		"lint": "eslint .",
+		"lint:fix": "eslint . --fix",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
+		"check": "bun run typecheck && bun run lint && bun run format:check && bun test",
+		"pack:dry": "npm pack --dry-run",
+		"prepack": "bun run check && bun run build",
+		"test": "bun test",
+		"typecheck": "bunx tsc --noEmit"
+	},
+	"devDependencies": {
+		"@eslint/js": "^10.0.1",
+		"@types/bun": "latest",
+		"eslint": "^10.5.0",
+		"prettier": "^3.8.4",
+		"typescript": "^6.0.3",
+		"typescript-eslint": "^8.61.0"
+	}
+}