@lokascript/semantic 1.0.0

package/package.json

@@ -0,0 +1,202 @@
+{
+  "name": "@lokascript/semantic",
+  "version": "1.0.0",
+  "description": "Semantic multilingual parser for hyperscript (23 languages)",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "browser": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.global.js"
+    },
+    "./browser/en": {
+      "default": "./dist/browser-en.en.global.js"
+    },
+    "./browser/es-en": {
+      "default": "./dist/browser-es-en.es-en.global.js"
+    },
+    "./browser/es": {
+      "default": "./dist/browser-es.es.global.js"
+    },
+    "./browser/tr": {
+      "default": "./dist/browser-tr.tr.global.js"
+    },
+    "./browser/western": {
+      "default": "./dist/browser-western.western.global.js"
+    },
+    "./browser/east-asian": {
+      "default": "./dist/browser-east-asian.east-asian.global.js"
+    },
+    "./browser/priority": {
+      "default": "./dist/browser-priority.priority.global.js"
+    },
+    "./browser/lazy": {
+      "default": "./dist/browser-lazy.lazy.global.js"
+    },
+    "./languages": {
+      "types": "./dist/languages/index.d.ts",
+      "import": "./dist/languages/index.mjs"
+    },
+    "./languages/en": {
+      "types": "./dist/languages/en.d.ts",
+      "import": "./dist/languages/en.mjs"
+    },
+    "./languages/es": {
+      "types": "./dist/languages/es.d.ts",
+      "import": "./dist/languages/es.mjs"
+    },
+    "./languages/ja": {
+      "types": "./dist/languages/ja.d.ts",
+      "import": "./dist/languages/ja.mjs"
+    },
+    "./languages/ar": {
+      "types": "./dist/languages/ar.d.ts",
+      "import": "./dist/languages/ar.mjs"
+    },
+    "./languages/ko": {
+      "types": "./dist/languages/ko.d.ts",
+      "import": "./dist/languages/ko.mjs"
+    },
+    "./languages/zh": {
+      "types": "./dist/languages/zh.d.ts",
+      "import": "./dist/languages/zh.mjs"
+    },
+    "./languages/tr": {
+      "types": "./dist/languages/tr.d.ts",
+      "import": "./dist/languages/tr.mjs"
+    },
+    "./languages/pt": {
+      "types": "./dist/languages/pt.d.ts",
+      "import": "./dist/languages/pt.mjs"
+    },
+    "./languages/fr": {
+      "types": "./dist/languages/fr.d.ts",
+      "import": "./dist/languages/fr.mjs"
+    },
+    "./languages/de": {
+      "types": "./dist/languages/de.d.ts",
+      "import": "./dist/languages/de.mjs"
+    },
+    "./languages/id": {
+      "types": "./dist/languages/id.d.ts",
+      "import": "./dist/languages/id.mjs"
+    },
+    "./languages/qu": {
+      "types": "./dist/languages/qu.d.ts",
+      "import": "./dist/languages/qu.mjs"
+    },
+    "./languages/sw": {
+      "types": "./dist/languages/sw.d.ts",
+      "import": "./dist/languages/sw.mjs"
+    },
+    "./explicit": {
+      "types": "./dist/explicit/index.d.ts",
+      "import": "./dist/explicit/index.mjs",
+      "require": "./dist/explicit/index.js"
+    },
+    "./browser/ja": {
+      "default": "./dist/browser-ja.ja.global.js"
+    },
+    "./browser/ar": {
+      "default": "./dist/browser-ar.ar.global.js"
+    },
+    "./browser/ko": {
+      "default": "./dist/browser-ko.ko.global.js"
+    },
+    "./browser/zh": {
+      "default": "./dist/browser-zh.zh.global.js"
+    },
+    "./browser/pt": {
+      "default": "./dist/browser-pt.pt.global.js"
+    },
+    "./browser/fr": {
+      "default": "./dist/browser-fr.fr.global.js"
+    },
+    "./browser/de": {
+      "default": "./dist/browser-de.de.global.js"
+    },
+    "./browser/id": {
+      "default": "./dist/browser-id.id.global.js"
+    },
+    "./browser/qu": {
+      "default": "./dist/browser-qu.qu.global.js"
+    },
+    "./browser/sw": {
+      "default": "./dist/browser-sw.sw.global.js"
+    },
+    "./browser/core": {
+      "default": "./dist/browser-core.core.global.js"
+    },
+    "./browser/en-tr": {
+      "default": "./dist/browser-en-tr.en-tr.global.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:browser": "tsup src/browser.ts --format iife --global-name HyperFixiSemantic --minify",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "add-language": "npx tsx scripts/add-language.ts",
+    "update-keywords": "npx tsx scripts/update-keywords.ts",
+    "generate:indexes": "npx tsx scripts/generate-indexes.ts",
+    "prebuild": "npm run generate:indexes",
+    "benchmark": "npx tsx scripts/benchmark-all.ts",
+    "benchmark:json": "npx tsx scripts/benchmark-all.ts --json",
+    "benchmark:save": "npx tsx scripts/benchmark-all.ts --save",
+    "benchmark:ci": "npx tsx scripts/benchmark-all.ts --save --compare",
+    "benchmark:lookup": "npx tsx scripts/benchmark-tokenizer-lookup.ts"
+  },
+  "sideEffects": [
+    "./src/languages/*.ts",
+    "./dist/languages/*.mjs",
+    "./src/patterns/index.ts"
+  ],
+  "keywords": [
+    "hyperscript",
+    "semantic",
+    "multilingual",
+    "i18n",
+    "parser",
+    "natural-language"
+  ],
+  "author": "Hyperfixi Team",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^4.0.17",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.0"
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hyperfixi/hyperfixi.git",
+    "directory": "packages/semantic"
+  },
+  "bugs": {
+    "url": "https://github.com/hyperfixi/hyperfixi/issues"
+  },
+  "homepage": "https://github.com/hyperfixi/hyperfixi/tree/main/packages/semantic#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/__test-utils__/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Type-safe test utilities for semantic package
+ * Central export for semantic test helper functions and types
+ */
+
+// Semantic test helpers
+export * from './test-helpers';

package/src/__test-utils__/test-helpers.ts

@@ -0,0 +1,8 @@
+/**
+ * Semantic Test Helpers
+ *
+ * Placeholder module for semantic package test utilities.
+ */
+
+// Re-export core testing utilities
+export { parse, canParse, render, renderExplicit, translate } from '../parser/semantic-parser';

package/src/__types__/test-helpers.ts

@@ -0,0 +1,122 @@
+/**
+ * Type-safe test helpers for semantic parsing
+ * Provides properly typed interfaces for test assertions on semantic nodes
+ */
+
+import type { SemanticRole } from '../types';
+
+/**
+ * Semantic node result for testing
+ */
+export interface SemanticNodeResult {
+  action: string;
+  roles: Map<SemanticRole, SemanticValue>;
+  confidence: number;
+  errors?: ValidationError[];
+  tokens?: unknown[];
+  metadata?: Record<string, unknown>;
+}
+
+/**
+ * Semantic value in role maps
+ */
+export interface SemanticValue {
+  value: unknown;
+  type?: string;
+  raw?: string;
+  [key: string]: unknown;
+}
+
+/**
+ * Validation error from semantic parsing
+ */
+export interface ValidationError {
+  message: string;
+  code?: string;
+  position?: number;
+  [key: string]: unknown;
+}
+
+/**
+ * Type-safe role accessor for semantic nodes
+ */
+export interface RoleAccessor<T extends string = SemanticRole> {
+  get(role: T): SemanticValue | undefined;
+  has(role: T): boolean;
+  keys(): T[];
+  values(): SemanticValue[];
+  entries(): Array<[T, SemanticValue]>;
+}
+
+/**
+ * Create a type-safe role accessor from a Map
+ */
+export function createRoleAccessor<T extends string = SemanticRole>(
+  roles: Map<T, SemanticValue>
+): RoleAccessor<T> {
+  return {
+    get(role: T): SemanticValue | undefined {
+      return roles.get(role);
+    },
+    has(role: T): boolean {
+      return roles.has(role);
+    },
+    keys(): T[] {
+      return Array.from(roles.keys());
+    },
+    values(): SemanticValue[] {
+      return Array.from(roles.values());
+    },
+    entries(): Array<[T, SemanticValue]> {
+      return Array.from(roles.entries());
+    },
+  };
+}
+
+/**
+ * Type guard to check if a value is a SemanticNodeResult
+ */
+export function isSemanticNodeResult(value: unknown): value is SemanticNodeResult {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    'action' in value &&
+    typeof (value as SemanticNodeResult).action === 'string' &&
+    'roles' in value &&
+    (value as SemanticNodeResult).roles instanceof Map &&
+    'confidence' in value &&
+    typeof (value as SemanticNodeResult).confidence === 'number'
+  );
+}
+
+/**
+ * Assert that a value is a SemanticNodeResult
+ */
+export function assertSemanticNodeResult(value: unknown): asserts value is SemanticNodeResult {
+  if (!isSemanticNodeResult(value)) {
+    throw new Error(`Expected SemanticNodeResult, got ${typeof value}`);
+  }
+}
+
+/**
+ * Type-safe role value extractor
+ */
+export function getRoleValue<T = unknown>(
+  node: SemanticNodeResult,
+  role: SemanticRole
+): T | undefined {
+  const value = node.roles.get(role);
+  return value?.value as T | undefined;
+}
+
+/**
+ * Assert that a role exists on a semantic node
+ */
+export function assertNodeHasRole(
+  node: SemanticNodeResult,
+  role: SemanticRole
+): asserts node is SemanticNodeResult & { roles: Map<SemanticRole, SemanticValue> } {
+  if (!node.roles.has(role)) {
+    throw new Error(`Expected node to have role '${role}'`);
+  }
+}