@kulupu-linku/sona 0.3.7 → 2.1.0

package/generated/v2/words.json

@@ -0,0 +1,459 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "propertyNames": {
+    "$ref": "#/$defs/__schema0"
+  },
+  "additionalProperties": {
+    "$ref": "#/$defs/__schema1"
+  },
+  "description": "A raw data object containing dictionary info about Toki Pona words",
+  "$defs": {
+    "__schema0": {
+      "type": "string",
+      "minLength": 1,
+      "description": "A unique identifier for an object in Linku. Generally named after the object."
+    },
+    "__schema1": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/__schema2"
+        },
+        "word": {
+          "$ref": "#/$defs/__schema3"
+        },
+        "author_verbatim": {
+          "$ref": "#/$defs/__schema4"
+        },
+        "author_source": {
+          "$ref": "#/$defs/__schema6"
+        },
+        "book": {
+          "$ref": "#/$defs/__schema8"
+        },
+        "coined_era": {
+          "$ref": "#/$defs/__schema9"
+        },
+        "creation_date": {
+          "$ref": "#/$defs/__schema10"
+        },
+        "author": {
+          "$ref": "#/$defs/__schema11"
+        },
+        "ku_data": {
+          "$ref": "#/$defs/__schema13"
+        },
+        "parent_id": {
+          "$ref": "#/$defs/__schema16"
+        },
+        "see_also": {
+          "$ref": "#/$defs/__schema18"
+        },
+        "resources": {
+          "$ref": "#/$defs/__schema20"
+        },
+        "representations": {
+          "$ref": "#/$defs/__schema24"
+        },
+        "source_language": {
+          "$ref": "#/$defs/__schema35"
+        },
+        "usage_category": {
+          "$ref": "#/$defs/__schema36"
+        },
+        "deprecated": {
+          "$ref": "#/$defs/__schema37"
+        },
+        "audio": {
+          "$ref": "#/$defs/__schema38"
+        },
+        "pu_verbatim": {
+          "$ref": "#/$defs/__schema41"
+        },
+        "usage": {
+          "$ref": "#/$defs/__schema44"
+        },
+        "glyph_ids": {
+          "$ref": "#/$defs/__schema46"
+        },
+        "primary_glyph_id": {
+          "$ref": "#/$defs/__schema47"
+        },
+        "image": {
+          "$ref": "#/$defs/__schema49"
+        },
+        "svg": {
+          "$ref": "#/$defs/__schema50"
+        },
+        "translations": {
+          "$ref": "#/$defs/__schema51"
+        }
+      },
+      "required": [
+        "id",
+        "word",
+        "book",
+        "coined_era",
+        "creation_date",
+        "author",
+        "see_also",
+        "resources",
+        "representations",
+        "source_language",
+        "usage_category",
+        "deprecated",
+        "audio",
+        "usage",
+        "glyph_ids",
+        "translations"
+      ],
+      "additionalProperties": false,
+      "description": "General info on a Toki Pona word"
+    },
+    "__schema2": {
+      "description": "A unique identifier for the word. May have an integer to distinguish words with the same spelling but distinct coinings.",
+      "$ref": "#/$defs/__schema0"
+    },
+    "__schema3": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The latin alphabet representation of the word."
+    },
+    "__schema4": {
+      "description": "The author's original definition, taken verbatim in their words",
+      "$ref": "#/$defs/__schema5"
+    },
+    "__schema5": {
+      "type": "string"
+    },
+    "__schema6": {
+      "description": "The source or origin of this glyph, often a URL.",
+      "$ref": "#/$defs/__schema7"
+    },
+    "__schema7": {
+      "type": "string",
+      "description": "The source or origin of this object, often a URL."
+    },
+    "__schema8": {
+      "type": "string",
+      "enum": [
+        "pu",
+        "ku suli",
+        "ku lili",
+        "none"
+      ],
+      "description": "Which official Toki Pona book was this word featured in, if any."
+    },
+    "__schema9": {
+      "type": "string",
+      "enum": [
+        "pre-pu",
+        "post-pu",
+        "post-ku"
+      ],
+      "description": "The period of time in which this word was coined, relative to the publication of the first two official Toki Pona books"
+    },
+    "__schema10": {
+      "type": "string",
+      "pattern": "^(?:|(?<year>20\\d{2})(?:-(?<month>0[1-9]|1[0-2])(?:-(?<day>0[1-9]|[12]\\d|3[01]))?)?|(?<startYear>20\\d{2})-(?<endYear>20\\d{2}))$",
+      "description": "When this word was coined, to precision known."
+    },
+    "__schema11": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/__schema12"
+      },
+      "description": "The name or names of those involved in creating this word."
+    },
+    "__schema12": {
+      "type": "string",
+      "minLength": 1
+    },
+    "__schema13": {
+      "description": "The usage data of this word, as described in the Toki Pona Dictionary.",
+      "$ref": "#/$defs/__schema14"
+    },
+    "__schema14": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "minLength": 1,
+        "description": "A possible translation of the word into English, as listed in the Toki Pona dictionary."
+      },
+      "additionalProperties": {
+        "description": "The percentage of Toki Pona Dictionary survey respondents who report this translation as accurate to their usage.",
+        "$ref": "#/$defs/__schema15"
+      }
+    },
+    "__schema15": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 100
+    },
+    "__schema16": {
+      "description": "The most widely used word which is considered to be an exact synonym for this word.",
+      "$ref": "#/$defs/__schema17"
+    },
+    "__schema17": {
+      "description": "The ID of an object related to this one.",
+      "$ref": "#/$defs/__schema0"
+    },
+    "__schema18": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/__schema0"
+      },
+      "description": "The IDs of words related to this one.",
+      "$ref": "#/$defs/__schema19"
+    },
+    "__schema19": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/__schema0"
+      },
+      "description": "The IDs of one or more objects related to this one."
+    },
+    "__schema20": {
+      "type": "object",
+      "properties": {
+        "sona_pona": {
+          "$ref": "#/$defs/__schema21"
+        },
+        "lipamanka_semantic": {
+          "$ref": "#/$defs/__schema23"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Non-Linku resources related to the specific word, such as wiki links."
+    },
+    "__schema21": {
+      "description": "A link to the word's page on sona.pona.la, a Toki Pona wiki. May redirect for words with references but no dedicated page.",
+      "$ref": "#/$defs/__schema22"
+    },
+    "__schema22": {
+      "type": "string",
+      "format": "uri",
+      "description": "A URL pointing to some external resource."
+    },
+    "__schema23": {
+      "description": "A link to lipamanka's description of the word's semantic space.",
+      "$ref": "#/$defs/__schema22"
+    },
+    "__schema24": {
+      "type": "object",
+      "properties": {
+        "sitelen_emosi": {
+          "$ref": "#/$defs/__schema25"
+        },
+        "sitelen_jelo": {
+          "$ref": "#/$defs/__schema27"
+        },
+        "ligatures": {
+          "$ref": "#/$defs/__schema30"
+        },
+        "sitelen_sitelen": {
+          "$ref": "#/$defs/__schema32"
+        },
+        "ucsur": {
+          "$ref": "#/$defs/__schema33"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Ways of representing this word via text/computers"
+    },
+    "__schema25": {
+      "description": "The sitelen emosi representation of this word, a script for writing Toki Pona using emoji",
+      "$ref": "#/$defs/__schema26"
+    },
+    "__schema26": {
+      "type": "string",
+      "minLength": 1,
+      "format": "emoji",
+      "pattern": "^(\\p{Extended_Pictographic}|\\p{Emoji_Component})+$"
+    },
+    "__schema27": {
+      "description": "One or more example emojis for how the word can be written in sitelen jelo",
+      "$ref": "#/$defs/__schema28"
+    },
+    "__schema28": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/__schema29"
+      }
+    },
+    "__schema29": {
+      "type": "string",
+      "minLength": 1,
+      "format": "emoji",
+      "pattern": "^(\\p{Extended_Pictographic}|\\p{Emoji_Component})+$"
+    },
+    "__schema30": {
+      "description": "A list of sitelen Lasina representations of the word, used by ligature fonts to visually convert latin characters into sitelen pona",
+      "$ref": "#/$defs/__schema31"
+    },
+    "__schema31": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "__schema32": {
+      "description": "A URL pointing to an image of this word's sitelen sitelen hieroglyphic block",
+      "$ref": "#/$defs/__schema22"
+    },
+    "__schema33": {
+      "description": "The UCSUR codepoint for this word.",
+      "$ref": "#/$defs/__schema34"
+    },
+    "__schema34": {
+      "type": "string",
+      "pattern": "^U\\+[\\da-fA-F]{4,6}$"
+    },
+    "__schema35": {
+      "type": "string",
+      "minLength": 1,
+      "description": "The language this word originated from"
+    },
+    "__schema36": {
+      "type": "string",
+      "enum": [
+        "core",
+        "common",
+        "uncommon",
+        "obscure",
+        "sandbox"
+      ],
+      "description": "The word's usage category, derived from the data of the annual Linku word survey."
+    },
+    "__schema37": {
+      "type": "boolean",
+      "description": "Whether this word is considered deprecated by its author(s)."
+    },
+    "__schema38": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "author": {
+            "$ref": "#/$defs/__schema39"
+          },
+          "link": {
+            "$ref": "#/$defs/__schema40"
+          }
+        },
+        "required": [
+          "author",
+          "link"
+        ],
+        "additionalProperties": false,
+        "description": "Audio files of the words pronounced out loud"
+      }
+    },
+    "__schema39": {
+      "description": "The author of the audio file in `link`.",
+      "$ref": "#/$defs/__schema12"
+    },
+    "__schema40": {
+      "description": "A link to the audio file for the word, pronounced by `author`.",
+      "$ref": "#/$defs/__schema22"
+    },
+    "__schema41": {
+      "description": "The definition of the word in specific language editions of Toki Pona: The Language of Good",
+      "$ref": "#/$defs/__schema42"
+    },
+    "__schema42": {
+      "type": "object",
+      "properties": {
+        "en": {
+          "description": "The word's definition in the English edition of Toki Pona: The Language of Good",
+          "$ref": "#/$defs/__schema43"
+        },
+        "fr": {
+          "description": "The word's definition in the French edition of Toki Pona: The Language of Good",
+          "$ref": "#/$defs/__schema43"
+        },
+        "de": {
+          "description": "The word's definition in the German edition of Toki Pona: The Language of Good",
+          "$ref": "#/$defs/__schema43"
+        },
+        "eo": {
+          "description": "The word's definition in the Esperanto edition of Toki Pona: The Language of Good",
+          "$ref": "#/$defs/__schema43"
+        }
+      },
+      "required": [
+        "en",
+        "fr",
+        "de",
+        "eo"
+      ],
+      "additionalProperties": false
+    },
+    "__schema43": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Localized definition on the parent, such as a word or luka pona sign"
+    },
+    "__schema44": {
+      "type": "object",
+      "propertyNames": {
+        "$ref": "#/$defs/__schema45"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/__schema15"
+      },
+      "description": "The percentage of respondents to the annual Linku word survey who report to use this word, by the date of the survey."
+    },
+    "__schema45": {
+      "type": "string",
+      "pattern": "^(?<year>20\\d{2})(?:-(?<month>0[1-9]|1[0-2])(?:-(?<day>0[1-9]|[12]\\d|3[01]))?)?$"
+    },
+    "__schema46": {
+      "description": "The IDs of all sitelen pona glyphs which represent the word. The usage category of each fetched glyph may be used to show or hide glyphs.",
+      "$ref": "#/$defs/__schema19"
+    },
+    "__schema47": {
+      "description": "The ID of the glyph most commonly used to represent this word in sitelen pona.",
+      "$ref": "#/$defs/__schema48"
+    },
+    "__schema48": {
+      "type": "string",
+      "minLength": 3,
+      "$ref": "#/$defs/__schema17"
+    },
+    "__schema49": {
+      "description": "Link to a PNG of the primary sitelen pona glyph for this word.",
+      "$ref": "#/$defs/__schema22"
+    },
+    "__schema50": {
+      "description": "Link to an SVG of the primary sitelen pona glyph for this word.",
+      "$ref": "#/$defs/__schema22"
+    },
+    "__schema51": {
+      "type": "object",
+      "properties": {
+        "commentary": {
+          "type": "string",
+          "description": "Localized commentary on this word, such as history, clarifications, or trivia."
+        },
+        "etymology": {
+          "type": "string",
+          "description": "Localized etymology of this word."
+        },
+        "definition": {
+          "description": "Localized definition of this word.",
+          "$ref": "#/$defs/__schema43"
+        }
+      },
+      "required": [
+        "commentary",
+        "etymology",
+        "definition"
+      ],
+      "additionalProperties": false
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kulupu-linku/sona",
-  "version": "0.3.7",
+  "version": "2.1.0",
   "description": "A library providing TypeScript types and Zod schemas for the sona API",
   "homepage": "https://linku.la/",
   "bugs": {
@@ -9,7 +9,7 @@
   "license": "GPL-3.0-or-later",
   "contributors": [
     {
-      "name": "TheOnlyTails",
+      "name": "Shachar Zidon",
       "url": "https://theonlytails.com/",
       "email": "theonlytails@theonlytails.com"
     },
@@ -20,57 +20,88 @@
     }
   ],
   "repository": {
+    "type": "git",
     "url": "https://github.com/lipu-linku/sona.git",
-    "directory": "api",
-    "type": "git"
-  },
-  "dependencies": {
-    "@hono/vite-cloudflare-pages": "^0.4.0",
-    "@hono/vite-dev-server": "^0.14.0",
-    "@hono/zod-validator": "^0.2.1",
-    "hono": "^4.3.0",
-    "p-lazy": "^4.0.0",
-    "zod": "^3.23.6",
-    "zod-validation-error": "^3.2.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.12.8",
-    "prettier": "^3.2.5",
-    "tsx": "^4.9.0",
-    "typescript": "^5.4.5",
-    "vite": "^5.2.11",
-    "vite-plugin-dts": "^4.0.0",
-    "zod-to-json-schema": "^3.23.0"
-  },
-  "engines": {
-    "pnpm": ">=9"
+    "directory": "api"
   },
   "files": [
     "/dist",
     "/generated"
   ],
-  "main": "./dist/index.js",
+  "type": "module",
+  "main": "./dist/lib/v2/index.js",
+  "module": "./dist/lib/v2/index.js",
+  "types": "./dist/lib/v2/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": "./dist/lib/v2/index.js",
+      "types": "./dist/lib/v2/index.d.ts"
     },
     "./utils": {
-      "import": "./dist/utils.js",
-      "types": "./dist/utils.d.ts"
+      "import": "./dist/lib/v2/utils.js",
+      "types": "./dist/lib/v2/utils.d.ts"
     },
     "./client": {
-      "import": "./dist/client.js",
-      "types": "./dist/client.d.ts"
+      "import": "./dist/lib/v2/client.js",
+      "types": "./dist/lib/v2/client.d.ts"
+    },
+    "./v1": {
+      "import": "./dist/lib/v1/index.js",
+      "types": "./dist/lib/v1/index.d.ts"
+    },
+    "./v1/utils": {
+      "import": "./dist/lib/v1/utils.js",
+      "types": "./dist/lib/v1/utils.d.ts"
+    },
+    "./v1/client": {
+      "import": "./dist/lib/v1/client.js",
+      "types": "./dist/lib/v1/client.d.ts"
+    },
+    "./v2": {
+      "import": "./dist/lib/v2/index.js",
+      "types": "./dist/lib/v2/index.d.ts"
+    },
+    "./v2/utils": {
+      "import": "./dist/lib/v2/utils.js",
+      "types": "./dist/lib/v2/utils.d.ts"
+    },
+    "./v2/client": {
+      "import": "./dist/lib/v2/client.js",
+      "types": "./dist/lib/v2/client.d.ts"
     }
   },
-  "type": "module",
+  "dependencies": {
+    "@hono/zod-validator": "^0.7.6",
+    "hono": "^4.12.10",
+    "p-lazy": "^5.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@cloudflare/vite-plugin": "1.31.0",
+    "@hono/vite-build": "^1.11.1",
+    "@hono/vite-dev-server": "^0.25.1",
+    "@types/node": "^25.5.2",
+    "ajv": "^8.18.0",
+    "ajv-cli": "^5.0.0",
+    "ajv-formats": "^3.0.1",
+    "tsdown": "^0.21.7",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.3",
+    "wrangler": "4.80.0"
+  },
+  "engines": {
+    "pnpm": ">=10"
+  },
   "scripts": {
     "dev": "vite",
     "build": "vite build",
-    "build:lib": "vite build --mode lib",
+    "build:lib": "tsdown",
+    "preview": "vite preview",
+    "prod": "vite preview",
     "generate": "tsx ./generateSchemas.ts",
     "generate:watch": "tsx ./generateSchemas.ts --watch-path=./**/*.ts",
-    "format": "prettier --write ."
+    "format": "oxfmt .",
+    "lint": "oxlint"
   }
 }

package/dist/client.d.ts

@@ -1,2 +0,0 @@
-export * from './lib/client'
-export {}