@getodk/xpath 0.5.0 → 0.7.0

package/dist/xforms/XFormsItextTranslations.d.ts

@@ -3,6 +3,7 @@ import { XPathNode } from '../adapter/interface/XPathNode.ts';
 import { XPathDOMProvider } from '../adapter/xpathDOMProvider.ts';
 import { XFormsElementRepresentation } from './XFormsElementRepresentation.ts';
 type XFormsItextTextID = string;
+export type XFormsItextTranslationValueElement<T extends XPathNode> = XFormsElementRepresentation<T, 'value', 'form'>;
 type XFormsItextTranslationTextElement<T extends XPathNode> = XFormsElementRepresentation<T, 'text'>;
 export type XFormsItextTranslationElement<T extends XPathNode> = XFormsElementRepresentation<T, 'translation', 'lang'>;
 type XFormsItextTextMap<T extends XPathNode> = ReadonlyMap<XFormsItextTextID, XFormsItextTranslationTextElement<T>>;
@@ -42,35 +43,34 @@ export declare class XFormsItextTranslations<T extends XPathNode> implements XFo
     private getTranslationMetadata;
     private getTranslationTextElement;
     /**
+     * Retrieves all translation value elements for a given Itext in the active language.
+     *
      * @package
      *
-     * Here, "default" is meant as more precise language than "regular" as
-     * {@link https://getodk.github.io/xforms-spec/#languages | specified by ODK XForms}. In other words, this is equivalent to the following hypothetical XPath pseudo-code (whitespace added to improve structural clarity):
+     * This method fetches the `text` element matching `itextID` and returns its child `value` elements,
+     * which may have an optional `@form` attribute.
+     *
+     * The operation is conceptually similar to the following XPath query:
      *
      * ```xpath
-     * string(
-     *   imaginary:itext-translation(
-     *     xpath3-fn:environment-variable('activeLanguage')
-     *   )
-     *     /text[@id = $itextID]
-     *       /value[not(@form)]
+     * imaginary:itext-translation(
+     *   xpath3-fn:environment-variable('activeLanguage')
      * )
+     *   /text[@id = $itextID]
+     *     /value
      * ```
      *
      * Or alternately:
      *
      * ```xpath
-     * string(
-     *   imaginary:itext-root()
-     *     /translation[@lang = xpath3-fn:environment-variable('activeLanguage')]
-     *       /text[@id = $itextID]
-     *         /value[not(@form)]
-     * )
+     * imaginary:itext-root()
+     *   /translation[@lang = xpath3-fn:environment-variable('activeLanguage')]
+     *     /text[@id = $itextID]
+     *       /value
      * ```
-     *
-     * @todo The above really feels like it adds some helpful clarity to how `jr:itext()` is designed to work, and the kinds of structures, state and input involved. Since there's already some discomfort around that API as specified, it's worth considering
+     * Returns an array of `XFormsItextTranslationValueElement<T>`
      */
-    getDefaultTranslationText(itextID: string): string;
+    getTranslationValues(itextID: string): Array<XFormsItextTranslationValueElement<T>>;
     getLanguages(): readonly XFormsItextTranslationLanguage[];
     getActiveLanguage(): XFormsItextTranslationLanguage | null;
     setActiveLanguage(language: XFormsItextTranslationLanguage | null): XFormsItextTranslationLanguage | null;

package/dist/xforms/XFormsXPathEvaluator.d.ts

@@ -3,7 +3,7 @@ import { XPathNode } from '../adapter/interface/XPathNode.ts';
 import { AdapterParentNode } from '../adapter/interface/XPathNodeKindAdapter.ts';
 import { EvaluationContext } from '../context/EvaluationContext.ts';
 import { EvaluatorOptions, Evaluator } from '../evaluator/Evaluator.ts';
-import { XFormsItextTranslationLanguage, XFormsItextTranslationMap, XFormsItextTranslationsState } from './XFormsItextTranslations.ts';
+import { XFormsItextTranslationLanguage, XFormsItextTranslationMap, XFormsItextTranslationsState, XFormsItextTranslationValueElement } from './XFormsItextTranslations.ts';
 import { XFormsSecondaryInstanceElement, XFormsSecondaryInstanceMap } from './XFormsSecondaryInstances.ts';
 /**
  * @todo We accept an arbitrary parent node specifically for legacy WHATWG DOM
@@ -18,7 +18,7 @@ export interface XFormsXPathEvaluatorOptions<T extends XPathNode> extends Evalua
 }
 export declare class XFormsXPathEvaluator<T extends XPathNode> extends Evaluator<T> implements XFormsItextTranslationsState {
     static getSecondaryInstance<T extends XPathNode>(context: EvaluationContext<T>, id: string): XFormsSecondaryInstanceElement<T> | null;
-    static getDefaultTranslationText<T extends XPathNode>(context: EvaluationContext<T>, itextID: string): string;
+    static getTranslationValues<T extends XPathNode>(context: EvaluationContext<T>, itextID: string): Array<XFormsItextTranslationValueElement<T>>;
     readonly rootNode: AdapterParentNode<T>;
     /**
      * @package

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getodk/xpath",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "license": "Apache-2.0",
   "description": "XPath implementation for ODK Web Forms",
   "type": "module",
@@ -31,7 +31,7 @@
     "README.md"
   ],
   "engines": {
-    "node": "^18.20.5 || ^20.18.1 || ^22.12.0",
+    "node": "^20.19.3 || ^22.12.0 || ^24.3.0",
     "yarn": "1.22.22"
   },
   "scripts": {
@@ -54,23 +54,23 @@
     "test:types:test": "tsc --project ./test/tsconfig.json --emitDeclarationOnly false --noEmit"
   },
   "dependencies": {
-    "@getodk/common": "0.6.0",
+    "@getodk/common": "0.7.0",
     "crypto-js": "^4.2.0",
     "temporal-polyfill": "^0.3.0"
   },
   "devDependencies": {
-    "@babel/core": "^7.26.10",
-    "@getodk/tree-sitter-xpath": "0.1.3",
-    "@playwright/test": "^1.49.1",
+    "@babel/core": "^7.28.0",
+    "@getodk/tree-sitter-xpath": "0.2.0",
+    "@playwright/test": "^1.53.2",
     "@types/crypto-js": "^4.2.2",
-    "@vitest/browser": "^3.0.9",
+    "@vitest/browser": "^3.2.4",
     "babel-plugin-transform-jsbi-to-bigint": "^1.4.2",
-    "jsdom": "^26.0.0",
-    "vite": "^6.2.3",
-    "vite-plugin-babel": "^1.3.0",
-    "vite-plugin-dts": "^4.5.3",
+    "jsdom": "^26.1.0",
+    "vite": "^7.0.3",
+    "vite-plugin-babel": "^1.3.2",
+    "vite-plugin-dts": "^4.5.4",
     "vite-plugin-no-bundle": "^4.0.0",
-    "vitest": "^3.0.9",
+    "vitest": "^3.2.4",
     "web-tree-sitter": "0.24.5"
   },
   "publishConfig": {

package/dist/functions/javarosa/string.d.ts

@@ -1,9 +0,0 @@
-import { StringFunction } from '../../evaluator/functions/StringFunction.ts';
-/**
- * @todo This could be a {@link NodeSetFunction}. If it were, that might be a
- * good starting point for thinking about how we'll support:
- *
- * - `<output>` in itext translations
- * - `<value form="...">` (short, guidance, various media types)
- */
-export declare const itext: StringFunction;