@polyglot-bundles/content-shared 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -3,5 +3,6 @@
  *
  * Shared types and utilities for polyglot-bundles content packages.
  */
-export type { PuzzleItem, PuzzleCategory, LevelInfo } from './types';
+export type { LocalizedString, PuzzleItem, PuzzleCategory, LevelInfo, PuzzleLanguageMeta, Character, CharacterVariant, AudioContent, } from './types';
+export { getLocalized, getDefaultLanguage, localized, validateLocalizedString, validatePuzzleItem, } from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,2 +1,38 @@
-
+function u(e, t) {
+  return typeof e == "string" ? e : e[t] || Object.values(e)[0] || "";
+}
+function g(e) {
+  if (typeof e == "string")
+    return "en";
+  const t = Object.keys(e);
+  return t.length > 0 ? t[0] : "en";
+}
+function s(e, t) {
+  return { [e]: t };
+}
+function r(e) {
+  return typeof e == "string" ? e.length > 0 : Object.values(e).some(
+    (t) => typeof t == "string" && t.length > 0
+  );
+}
+function i(e) {
+  const t = [];
+  if (typeof e != "object" || e === null)
+    return t.push({ field: "root", message: "Must be an object" }), t;
+  const n = e;
+  return r(n.targetWord) || t.push({ field: "targetWord", message: "Must be a non-empty string" }), r(n.targetLanguageClue) || t.push({
+    field: "targetLanguageClue",
+    message: "Must be a non-empty string"
+  }), r(n.uiLanguageClue) || t.push({
+    field: "uiLanguageClue",
+    message: "Must be a non-empty string"
+  }), t;
+}
+export {
+  g as getDefaultLanguage,
+  u as getLocalized,
+  s as localized,
+  r as validateLocalizedString,
+  i as validatePuzzleItem
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sources":["../src/utils.ts"],"sourcesContent":["/**\r\n * Utilities for polyglot-bundles content packages.\r\n *\r\n * Provides minimal, reusable helpers for content packages.\r\n */\r\n\r\nimport type { LocalizedString, PuzzleItem } from \"./types\";\r\n\r\n// ============================================================================\r\n// Localization Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Get a localized string value\r\n */\r\nexport function getLocalized(\r\n  value: LocalizedString,\r\n  lang: string\r\n): string {\r\n  if (typeof value === \"string\") {\r\n    return value;\r\n  }\r\n  return value[lang] || Object.values(value)[0] || \"\";\r\n}\r\n\r\n/**\r\n * Get the default language from a LocalizedString\r\n */\r\nexport function getDefaultLanguage(value: LocalizedString): string {\r\n  if (typeof value === \"string\") {\r\n    return \"en\";\r\n  }\r\n  const langs = Object.keys(value);\r\n  return langs.length > 0 ? langs[0] : \"en\";\r\n}\r\n\r\n/**\r\n * Create a LocalizedString for a single language\r\n */\r\nexport function localized(lang: string, text: string): LocalizedString {\r\n  return { [lang]: text };\r\n}\r\n\r\n// ============================================================================\r\n// Validation Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Validate a LocalizedString has at least one language\r\n */\r\nexport function validateLocalizedString(\r\n  value: LocalizedString\r\n): boolean {\r\n  if (typeof value === \"string\") {\r\n    return value.length > 0;\r\n  }\r\n  return Object.values(value).some(\r\n    (v) => typeof v === \"string\" && v.length > 0\r\n  );\r\n}\r\n\r\n/**\r\n * Validate PuzzleItem\r\n */\r\nexport function validatePuzzleItem(\r\n  item: unknown\r\n): { field: string; message: string }[] {\r\n  const errors: { field: string; message: string }[] = [];\r\n\r\n  if (typeof item !== \"object\" || item === null) {\r\n    errors.push({ field: \"root\", message: \"Must be an object\" });\r\n    return errors;\r\n  }\r\n\r\n  const puzzleItem = item as PuzzleItem;\r\n\r\n  if (!validateLocalizedString(puzzleItem.targetWord)) {\r\n    errors.push({ field: \"targetWord\", message: \"Must be a non-empty string\" });\r\n  }\r\n\r\n  if (!validateLocalizedString(puzzleItem.targetLanguageClue)) {\r\n    errors.push({\r\n      field: \"targetLanguageClue\",\r\n      message: \"Must be a non-empty string\",\r\n    });\r\n  }\r\n\r\n  if (!validateLocalizedString(puzzleItem.uiLanguageClue)) {\r\n    errors.push({\r\n      field: \"uiLanguageClue\",\r\n      message: \"Must be a non-empty string\",\r\n    });\r\n  }\r\n\r\n  return errors;\r\n}\r\n\r\n"],"names":["getLocalized","value","lang","getDefaultLanguage","langs","localized","text","validateLocalizedString","v","validatePuzzleItem","item","errors","puzzleItem"],"mappings":"AAeO,SAASA,EACdC,GACAC,GACQ;AACR,SAAI,OAAOD,KAAU,WACZA,IAEFA,EAAMC,CAAI,KAAK,OAAO,OAAOD,CAAK,EAAE,CAAC,KAAK;AACnD;AAKO,SAASE,EAAmBF,GAAgC;AACjE,MAAI,OAAOA,KAAU;AACnB,WAAO;AAET,QAAMG,IAAQ,OAAO,KAAKH,CAAK;AAC/B,SAAOG,EAAM,SAAS,IAAIA,EAAM,CAAC,IAAI;AACvC;AAKO,SAASC,EAAUH,GAAcI,GAA+B;AACrE,SAAO,EAAE,CAACJ,CAAI,GAAGI,EAAA;AACnB;AASO,SAASC,EACdN,GACS;AACT,SAAI,OAAOA,KAAU,WACZA,EAAM,SAAS,IAEjB,OAAO,OAAOA,CAAK,EAAE;AAAA,IAC1B,CAACO,MAAM,OAAOA,KAAM,YAAYA,EAAE,SAAS;AAAA,EAAA;AAE/C;AAKO,SAASC,EACdC,GACsC;AACtC,QAAMC,IAA+C,CAAA;AAErD,MAAI,OAAOD,KAAS,YAAYA,MAAS;AACvC,WAAAC,EAAO,KAAK,EAAE,OAAO,QAAQ,SAAS,qBAAqB,GACpDA;AAGT,QAAMC,IAAaF;AAEnB,SAAKH,EAAwBK,EAAW,UAAU,KAChDD,EAAO,KAAK,EAAE,OAAO,cAAc,SAAS,8BAA8B,GAGvEJ,EAAwBK,EAAW,kBAAkB,KACxDD,EAAO,KAAK;AAAA,IACV,OAAO;AAAA,IACP,SAAS;AAAA,EAAA,CACV,GAGEJ,EAAwBK,EAAW,cAAc,KACpDD,EAAO,KAAK;AAAA,IACV,OAAO;AAAA,IACP,SAAS;AAAA,EAAA,CACV,GAGIA;AACT;"}

package/dist/types.d.ts

@@ -1,12 +1,21 @@
 /**
  * Shared types for polyglot-bundles content packages.
+ *
+ * This package provides minimal, truly reusable types across all content packages.
+ * Types specific to lalia-prism (KubitId, Lesson, Syllabus, etc.) should stay there.
  */
 export type LocalizedString = string | Record<string, string>;
+/**
+ * PuzzleItem for puzzle content (crosswords, word search, etc.)
+ */
 export type PuzzleItem = {
     targetWord: string;
     targetLanguageClue: string;
     uiLanguageClue: LocalizedString;
 };
+/**
+ * PuzzleCategory for organizing puzzles by level/theme
+ */
 export type PuzzleCategory = {
     level: number;
     category: string;
@@ -17,14 +26,47 @@ export type PuzzleCategory = {
     src?: string;
     disabled?: boolean;
 };
+/**
+ * LevelInfo for hierarchical puzzle content
+ */
 export type LevelInfo = {
     level: number;
     title: LocalizedString;
     description: LocalizedString;
     disabled?: boolean;
 };
+/**
+ * PuzzleLanguageMeta for language-level puzzle configuration
+ */
 export type PuzzleLanguageMeta = {
     levels: LevelInfo[];
     categories: PuzzleCategory[];
 };
+/**
+ * Character with its variants and metadata
+ */
+export type Character = {
+    id: string;
+    character: string;
+    name: string;
+    transcription?: string;
+    frequency?: number;
+    variants?: CharacterVariant[];
+};
+export type CharacterVariant = {
+    type: "uppercase" | "lowercase" | "final" | "initial" | "medial";
+    value: string;
+    context?: string;
+};
+/**
+ * Audio content reference
+ */
+export type AudioContent = {
+    id: string;
+    url: string;
+    type: "pronunciation" | "sentence" | "dialogue" | "instruction";
+    language: string;
+    duration?: number;
+    speaker?: string;
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,eAAe,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAM9D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,eAAe,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,25 @@
+import { LocalizedString } from './types';
+/**
+ * Get a localized string value
+ */
+export declare function getLocalized(value: LocalizedString, lang: string): string;
+/**
+ * Get the default language from a LocalizedString
+ */
+export declare function getDefaultLanguage(value: LocalizedString): string;
+/**
+ * Create a LocalizedString for a single language
+ */
+export declare function localized(lang: string, text: string): LocalizedString;
+/**
+ * Validate a LocalizedString has at least one language
+ */
+export declare function validateLocalizedString(value: LocalizedString): boolean;
+/**
+ * Validate PuzzleItem
+ */
+export declare function validatePuzzleItem(item: unknown): {
+    field: string;
+    message: string;
+}[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,SAAS,CAAC;AAM3D;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,MAAM,GACX,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAMjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAErE;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,eAAe,GACrB,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CA6BtC"}

package/package.json

@@ -1,10 +1,16 @@
 {
   "name": "@polyglot-bundles/content-shared",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Shared types and utilities for polyglot-bundles content packages",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "files": [
     "dist"
   ],