feat: add versions package (#132)

<!-- This is an auto-generated comment: release notes by coderabbit.ai -->
## Summary by CodeRabbit

- **New Features**
  - Introduced the `@mojis/versions` package, providing utilities for emoji and Unicode version handling.
- **Bug Fixes**
  - Improved accuracy and reliability of emoji and Unicode version extraction, mapping, and validation.
- **Refactor**
  - Migrated version-related logic from internal utilities to the new `@mojis/versions` package for better modularity.
- **Documentation**
  - Added comprehensive documentation and licensing for the new package.
- **Tests**
  - Introduced extensive test coverage for version extraction, conversion, validation, and API utilities.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: luxass

.changeset/petite-bananas-divide.md

@@ -0,0 +1,8 @@
+---
+"@mojis/internal-utils": minor
+"@mojis/adapters": minor
+"@mojis/versions": minor
+"@mojis/cli": minor
+---
+
+feat: add new mojis versions package

packages/adapters/package.json

@@ -40,6 +40,7 @@
     "@mojis/moji-compare": "catalog:prod",
     "@mojis/parsers": "workspace:*",
     "@mojis/schemas": "workspace:*",
+    "@mojis/versions": "workspace:*",
     "arktype": "catalog:prod",
     "defu": "catalog:prod",
     "fs-extra": "catalog:prod"

packages/adapters/src/handlers/source/metadata.ts

@@ -1,6 +1,7 @@
 import type { EmojiGroup, GroupedEmojiMetadata } from "@mojis/schemas/emojis";
-import { extractEmojiVersion, extractUnicodeVersion, isBefore } from "@mojis/internal-utils";
+import { isBefore } from "@mojis/internal-utils";
 import { EMOJI_GROUPS_SCHEMA, GROUPED_BY_GROUP_EMOJI_METADATA_SCHEMA, GROUPED_BY_HEXCODE_EMOJI_METADATA_SCHEMA } from "@mojis/schemas/emojis";
+import { extractEmojiVersion, extractUnicodeVersion } from "@mojis/versions";
 import { type } from "arktype";
 import { createSourceAdapter } from "../../builders/source-builder/builder";
 import { joinPath } from "../../utils";

packages/cli/package.json

@@ -36,6 +36,7 @@
     "@mojis/internal-utils": "workspace:*",
     "@mojis/moji-compare": "catalog:prod",
     "@mojis/schemas": "workspace:*",
+    "@mojis/versions": "workspace:*",
     "arktype": "catalog:prod",
     "farver": "catalog:prod",
     "fs-extra": "catalog:prod",

packages/cli/src/cmd/emoji-versions.ts

@@ -1,6 +1,6 @@
 import type { EmojiSpecRecord } from "@mojis/schemas/emojis";
 import type { CLIArguments } from "../cli-utils";
-import { getAllEmojiVersions, getLatestEmojiVersion } from "@mojis/internal-utils";
+import { getAllEmojiVersions, getLatestEmojiVersion } from "@mojis/versions";
 import { green, red, yellow } from "farver/fast";
 import { printHelp } from "../cli-utils";
 import { writeFileSafe } from "../files";

packages/cli/src/cmd/generate.ts

@@ -1,13 +1,13 @@
 import type { EmojiSpecRecord } from "@mojis/schemas/emojis";
 import type { CLIArguments } from "../cli-utils";
 import { runSourceAdapter, sourceHandlers } from "@mojis/adapters";
+import mojiCompare from "@mojis/moji-compare";
 import {
   getAllEmojiVersions,
   getLatestEmojiVersion,
   mapEmojiVersionToUnicodeVersion,
   OFFICIAL_SUPPORTED_VERSIONS,
-} from "@mojis/internal-utils";
-import mojiCompare from "@mojis/moji-compare";
+} from "@mojis/versions";
 import { green, yellow } from "farver/fast";
 import fs from "fs-extra";
 import { printHelp } from "../cli-utils";

packages/cli/test/cmd/emoji-versions.test.ts

@@ -1,15 +1,15 @@
 /* eslint-disable no-console */
 import fs from "node:fs/promises";
 import path from "node:path";
-import * as internalUtils from "@mojis/internal-utils";
+import * as versions from "@mojis/versions";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { testdir } from "vitest-testdirs";
 import * as cliUtils from "../../src/cli-utils";
 import { runEmojiVersions } from "../../src/cmd/emoji-versions";
 import * as files from "../../src/files";
 
-vi.mock("@mojis/internal-utils", async () => {
-  const actual = await vi.importActual("@mojis/internal-utils");
+vi.mock("@mojis/versions", async () => {
+  const actual = await vi.importActual("@mojis/versions");
   return {
     ...actual,
     getAllEmojiVersions: vi.fn(),
@@ -49,8 +49,8 @@ describe("emoji-versions command", () => {
 
   beforeEach(() => {
     vi.resetAllMocks();
-    vi.mocked(internalUtils.getAllEmojiVersions).mockResolvedValue(mockEmojiVersions);
-    vi.mocked(internalUtils.getLatestEmojiVersion)
+    vi.mocked(versions.getAllEmojiVersions).mockResolvedValue(mockEmojiVersions);
+    vi.mocked(versions.getLatestEmojiVersion)
       .mockImplementation((versions, includeDrafts) =>
         includeDrafts ? mockLatestVersionWithDrafts : mockLatestVersion);
     console.log = vi.fn();
@@ -120,7 +120,7 @@ describe("emoji-versions command", () => {
           force: false,
         },
       });
-      expect(internalUtils.getLatestEmojiVersion).toHaveBeenCalledWith(mockEmojiVersions, true);
+      expect(versions.getLatestEmojiVersion).toHaveBeenCalledWith(mockEmojiVersions, true);
       expect(console.log).toHaveBeenCalled();
       expect(vi.mocked(console.log).mock.calls[0]?.[0]).toContain("15.1");
     });
@@ -141,7 +141,7 @@ describe("emoji-versions command", () => {
     });
 
     it("should handle case when no versions are found", async () => {
-      vi.mocked(internalUtils.getLatestEmojiVersion).mockReturnValue(null);
+      vi.mocked(versions.getLatestEmojiVersion).mockReturnValue(null);
       await runEmojiVersions("latest", {
         flags: {
           _: ["latest"],
@@ -200,7 +200,7 @@ describe("emoji-versions command", () => {
     });
 
     it("should handle empty results after filtering", async () => {
-      vi.mocked(internalUtils.getAllEmojiVersions).mockResolvedValue([
+      vi.mocked(versions.getAllEmojiVersions).mockResolvedValue([
         {
           emoji_version: "15.1",
           unicode_version: "",

packages/internal-utils/package.json

@@ -22,7 +22,6 @@
     ".": "./dist/index.js",
     "./shortcodes": "./dist/shortcodes.js",
     "./constants": "./dist/constants.js",
-    "./versions": "./dist/versions.js",
     "./package.json": "./package.json"
   },
   "main": "./dist/index.js",

packages/internal-utils/src/constants.ts

@@ -1,27 +1,2 @@
-export const OFFICIAL_SUPPORTED_VERSIONS = [
-  "1.0",
-  "2.0",
-  "3.0",
-  "4.0",
-  "5.0",
-  "11.0",
-  "12.0",
-  "12.1",
-  "13.0",
-  "13.1",
-  "14.0",
-  "15.0",
-  "15.1",
-  "16.0",
-];
-
 export const FEMALE_SIGN = "2640"; // FEMALE SIGN
 export const MALE_SIGN = "2642"; // MALE SIGN
-
-/**
- * These versions don't exist in the Unicode Consortium's emoji versioning scheme.
- * This is because they aligned the emoji version with the Unicode version starting from v11.
- *
- * So actually, the emoji version v11.0 is v6.0
- */
-export const NON_EXISTING_VERSIONS = ["6.x", "7.x", "8.x", "9.x", "10.x"];

packages/internal-utils/src/index.ts

@@ -6,7 +6,6 @@ export * from "./hexcode";
 export * from "./predicates";
 export * from "./shortcodes";
 export type * from "./types";
-export * from "./versions";
 
 interface ArkTypeResultError {
   success: false;