@lokascript/semantic 2.6.0 → 2.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lokascript/semantic",
-  "version": "2.6.0",
+  "version": "2.7.1",
   "description": "Semantic multilingual parser for hyperscript (24 languages)",
   "type": "module",
   "main": "dist/index.cjs",
@@ -246,7 +246,7 @@
   "author": "LokaScript Contributors",
   "license": "MIT",
   "dependencies": {
-    "@lokascript/framework": "^2.6.0",
+    "@lokascript/framework": "^2.7.1",
     "nearley": "^2.20.1"
   },
   "devDependencies": {
@@ -272,7 +272,7 @@
   },
   "homepage": "https://github.com/codetalcott/hyperfixi/tree/main/packages/semantic#readme",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=24"
   },
   "publishConfig": {
     "access": "public"

package/src/generators/index.ts

@@ -44,6 +44,9 @@ export {
 // Static all-known-profiles manifest (non-deprecated successor to languageProfiles)
 export { KNOWN_PROFILES } from './known-profiles';
 
+// Query helpers over the manifest (public API for mcp-server/LSP/domain bridges)
+export { getKeywordTranslations, getRoleMarkers } from './profile-queries';
+
 // Command schemas
 export {
   type CommandSchema,

package/src/generators/profile-queries.ts

@@ -0,0 +1,53 @@
+/**
+ * Small query helpers over the language-profile manifest.
+ *
+ * Public API for consumers that need per-language profile facts without
+ * hand-rolling profile iteration (mcp-server's profile tools,
+ * language-server hovers, framework-bridge domains). Backed by
+ * `KNOWN_PROFILES` (every defined profile, independent of runtime
+ * registration) — pass an explicit `languages` list to narrow.
+ */
+
+import type { SemanticRole } from '../types';
+import type { KeywordTranslation, RoleMarker } from './profiles/types';
+import { KNOWN_PROFILES } from './known-profiles';
+
+/**
+ * Look up one keyword's translations across languages.
+ *
+ * @param keyword - Profile keyword / action name (e.g. `toggle`, `set`)
+ * @param languages - Language codes to include (default: every known profile)
+ * @returns Map of language code → translation, with entries only for
+ *   languages whose profile defines the keyword
+ */
+export function getKeywordTranslations(
+  keyword: string,
+  languages?: readonly string[]
+): Record<string, KeywordTranslation> {
+  const codes = languages ?? Object.keys(KNOWN_PROFILES);
+  const translations: Record<string, KeywordTranslation> = {};
+  for (const code of codes) {
+    const translation = KNOWN_PROFILES[code]?.keywords[keyword];
+    if (translation) translations[code] = translation;
+  }
+  return translations;
+}
+
+/**
+ * Look up a language's grammatical role markers.
+ *
+ * @param language - Language code (e.g. `ja`)
+ * @param role - Optional semantic role; when given, returns that role's
+ *   marker only
+ * @returns The marker(s), or `undefined` when the language is unknown or
+ *   has no marker for the requested role
+ */
+export function getRoleMarkers(language: string): Partial<Record<SemanticRole, RoleMarker>>;
+export function getRoleMarkers(language: string, role: SemanticRole): RoleMarker | undefined;
+export function getRoleMarkers(
+  language: string,
+  role?: SemanticRole
+): Partial<Record<SemanticRole, RoleMarker>> | RoleMarker | undefined {
+  const markers = KNOWN_PROFILES[language]?.roleMarkers ?? {};
+  return role ? markers[role] : markers;
+}

package/src/index.ts

@@ -302,6 +302,10 @@ export {
   // Static all-known-profiles manifest
   KNOWN_PROFILES,
 
+  // Query helpers over the manifest (for mcp-server/LSP/domain bridges)
+  getKeywordTranslations,
+  getRoleMarkers,
+
   // Command schemas
   type CommandSchema,
   type RoleSpec,