c063 1.6.3 → 1.6.5

package/dist/utils/index.d.ts

@@ -1,5 +1,16 @@
 import React from "react";
 import { CodeTokenBuilder, CodeTokenProps, CodeTokenType } from "../types";
+/**
+ * 檢查給定的值是否為有效的 `CodeTokenType`。
+ * @param value 要檢查的值
+ * @returns 如果值是有效的 `CodeTokenType`，則返回 `true`，否則返回 `false`
+ * @example
+ * ```ts
+ * isCodeTokenType("keyword1"); // true
+ * isCodeTokenType("invalidType"); // false
+ * ```
+ */
+export declare const isCodeTokenType: (value: any) => value is CodeTokenType;
 /**
  * `c063` 是一組語法高亮 token 建構器集合。
  * 每個 key 對應一種語法分類（如 `keyword1`, `string`, `comment` 等），

package/dist/utils/index.js

@@ -1,4 +1,33 @@
 import React from "react";
+const CODE_TOKEN_TYPES = new Set([
+    "keyword1",
+    "keyword2",
+    "function",
+    "string",
+    "number",
+    "comment",
+    "type",
+    "variable",
+    "constant",
+    "brackets1",
+    "brackets2",
+    "brackets3",
+    "operator",
+    "default",
+]);
+/**
+ * 檢查給定的值是否為有效的 `CodeTokenType`。
+ * @param value 要檢查的值
+ * @returns 如果值是有效的 `CodeTokenType`，則返回 `true`，否則返回 `false`
+ * @example
+ * ```ts
+ * isCodeTokenType("keyword1"); // true
+ * isCodeTokenType("invalidType"); // false
+ * ```
+ */
+export const isCodeTokenType = (value) => {
+    return CODE_TOKEN_TYPES.has(value);
+};
 /**
  * `c063` 是一組語法高亮 token 建構器集合。
  * 每個 key 對應一種語法分類（如 `keyword1`, `string`, `comment` 等），
@@ -22,6 +51,9 @@ const c063 = new Proxy({}, {
          * @returns 一個 CodeToken 物件
          */
         const builder = (children, props) => {
+            if (!isCodeTokenType(prop)) {
+                throw new Error(`Invalid CodeTokenType: ${String(prop)}`);
+            }
             return {
                 children,
                 type: prop,
@@ -87,6 +119,9 @@ export const extractTokenContent = (token) => {
  * @returns 是否相等
  */
 export const isTokenEqual = (a, b) => {
+    if (!isCodeTokenType(a.type) || !isCodeTokenType(b.type)) {
+        return false;
+    }
     return a.type === b.type && extractTokenContent(a) === extractTokenContent(b);
 };
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "c063",
-  "version": "1.6.3",
+  "version": "1.6.5",
   "description": "A React component for displaying code snippets with syntax highlighting.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/utils/index.tsx

@@ -6,6 +6,36 @@ import {
   ParsableLanguage,
 } from "../types";
 
+const CODE_TOKEN_TYPES = new Set<CodeTokenType>([
+  "keyword1",
+  "keyword2",
+  "function",
+  "string",
+  "number",
+  "comment",
+  "type",
+  "variable",
+  "constant",
+  "brackets1",
+  "brackets2",
+  "brackets3",
+  "operator",
+  "default",
+]);
+/**
+ * 檢查給定的值是否為有效的 `CodeTokenType`。
+ * @param value 要檢查的值
+ * @returns 如果值是有效的 `CodeTokenType`，則返回 `true`，否則返回 `false`
+ * @example
+ * ```ts
+ * isCodeTokenType("keyword1"); // true
+ * isCodeTokenType("invalidType"); // false
+ * ```
+ */
+export const isCodeTokenType = (value: any): value is CodeTokenType => {
+  return CODE_TOKEN_TYPES.has(value);
+};
+
 /**
  * `c063` 是一組語法高亮 token 建構器集合。
  * 每個 key 對應一種語法分類（如 `keyword1`, `string`, `comment` 等），
@@ -34,6 +64,9 @@ const c063 = new Proxy(
         children: React.ReactNode,
         props?: CodeTokenProps<T>
       ) => {
+        if (!isCodeTokenType(prop)) {
+          throw new Error(`Invalid CodeTokenType: ${String(prop)}`);
+        }
         return {
           children,
           type: prop,
@@ -108,6 +141,9 @@ export const isTokenEqual = <T extends React.ElementType>(
   a: CodeTokenProps<T>,
   b: CodeTokenProps<T>
 ): boolean => {
+  if (!isCodeTokenType(a.type) || !isCodeTokenType(b.type)) {
+    return false;
+  }
   return a.type === b.type && extractTokenContent(a) === extractTokenContent(b);
 };