@getodk/xpath 0.2.0 → 0.3.0

package/dist/expressionParser.d.ts

@@ -1,3 +1,2 @@
 import { ExpressionParser } from './static/grammar/ExpressionParser.ts';
-
 export declare const expressionParser: ExpressionParser;

package/dist/expressionParser.js

@@ -1,2 +1,2 @@
-export { e as expressionParser } from './expressionParser-BRkDdCO9.js';
+export { e as expressionParser } from './expressionParser-DpqfmhIO.js';
 //# sourceMappingURL=expressionParser.js.map

package/dist/functions/_shared/number.d.ts

@@ -1,12 +1,12 @@
+import { XPathNode } from '../../adapter/interface/XPathNode.ts';
 import { EvaluationContext } from '../../context/EvaluationContext.ts';
 import { EvaluableArgument } from '../../evaluator/functions/FunctionImplementation.ts';
 import { NumberFunction } from '../../evaluator/functions/NumberFunction.ts';
-
-export declare const evaluateInt: (context: EvaluationContext, expression: EvaluableArgument) => number;
+export declare const evaluateInt: <T extends XPathNode>(context: EvaluationContext<T>, expression: EvaluableArgument) => number;
 type MathAliasMethodName = 'abs' | 'acos' | 'asin' | 'atan' | 'ceil' | 'cos' | 'exp' | 'floor' | 'log' | 'log10' | 'round' | 'sin' | 'sqrt' | 'tan';
-export declare const mathAlias: (method: MathAliasMethodName) => NumberFunction<number>;
+export declare const mathAlias: (method: MathAliasMethodName) => NumberFunction;
 type Math2AliasMethodName = 'atan2' | 'pow';
-export declare const math2Alias: (method: Math2AliasMethodName) => NumberFunction<number>;
+export declare const math2Alias: (method: Math2AliasMethodName) => NumberFunction;
 type MathNAliasMethodName = 'max' | 'min';
-export declare const mathNAlias: (method: MathNAliasMethodName) => NumberFunction<number>;
+export declare const mathNAlias: (method: MathNAliasMethodName) => NumberFunction;
 export {};

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

@@ -1,4 +1,4 @@
+import { XPathNode } from '../../adapter/interface/XPathNode.ts';
 import { EvaluationContext } from '../../context/EvaluationContext.ts';
 import { EvaluableArgument } from '../../evaluator/functions/FunctionImplementation.ts';
-
-export declare const toStrings: (context: EvaluationContext, expressions: readonly EvaluableArgument[]) => readonly string[];
+export declare const toStrings: <T extends XPathNode>(context: EvaluationContext<T>, expressions: readonly EvaluableArgument[]) => readonly string[];

package/dist/functions/enketo/index.d.ts

@@ -1,3 +1,2 @@
 import { FunctionLibrary } from '../../evaluator/functions/FunctionLibrary.ts';
-
 export declare const enk: FunctionLibrary;

package/dist/functions/fn/boolean.d.ts

@@ -1,9 +1,8 @@
 import { BooleanFunction } from '../../evaluator/functions/BooleanFunction.ts';
-
-declare const falseFn: BooleanFunction<number>;
+declare const falseFn: BooleanFunction;
 export { falseFn as false };
-declare const trueFn: BooleanFunction<number>;
+declare const trueFn: BooleanFunction;
 export { trueFn as true };
-export declare const boolean: BooleanFunction<number>;
-export declare const lang: BooleanFunction<number>;
-export declare const not: BooleanFunction<number>;
+export declare const boolean: BooleanFunction;
+export declare const lang: BooleanFunction;
+export declare const not: BooleanFunction;

package/dist/functions/fn/index.d.ts

@@ -1,3 +1,2 @@
 import { FunctionLibrary } from '../../evaluator/functions/FunctionLibrary.ts';
-
 export declare const fn: FunctionLibrary;

package/dist/functions/fn/node-set.d.ts

@@ -1,12 +1,11 @@
 import { NodeSetFunction } from '../../evaluator/functions/NodeSetFunction.ts';
 import { NumberFunction } from '../../evaluator/functions/NumberFunction.ts';
 import { StringFunction } from '../../evaluator/functions/StringFunction.ts';
-
-export declare const count: NumberFunction<number>;
-export declare const current: NodeSetFunction<number>;
-export declare const id: NodeSetFunction<number>;
-export declare const last: NumberFunction<number>;
-export declare const localName: StringFunction<number>;
-export declare const name: StringFunction<number>;
-export declare const namespaceURI: StringFunction<number>;
-export declare const position: NumberFunction<number>;
+export declare const count: NumberFunction;
+export declare const current: NodeSetFunction;
+export declare const id: NodeSetFunction;
+export declare const last: NumberFunction;
+export declare const localName: StringFunction;
+export declare const name: StringFunction;
+export declare const namespaceURI: StringFunction;
+export declare const position: NumberFunction;

package/dist/functions/fn/number.d.ts

@@ -1,8 +1,7 @@
 import { FunctionAlias } from '../../evaluator/functions/FunctionAlias.ts';
 import { NumberFunction } from '../../evaluator/functions/NumberFunction.ts';
-
-export declare const ceiling: FunctionAlias<number>;
-export declare const floor: NumberFunction<number>;
-export declare const number: NumberFunction<number>;
-export declare const round: NumberFunction<number>;
-export declare const sum: NumberFunction<number>;
+export declare const ceiling: FunctionAlias;
+export declare const floor: NumberFunction;
+export declare const number: NumberFunction;
+export declare const round: NumberFunction;
+export declare const sum: NumberFunction;

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

@@ -1,14 +1,13 @@
 import { BooleanFunction } from '../../evaluator/functions/BooleanFunction.ts';
 import { NumberFunction } from '../../evaluator/functions/NumberFunction.ts';
 import { StringFunction } from '../../evaluator/functions/StringFunction.ts';
-
-export declare const concat: StringFunction<number>;
-export declare const contains: BooleanFunction<number>;
-export declare const normalizeSpace: StringFunction<number>;
-export declare const startsWith: BooleanFunction<number>;
-export declare const stringLength: NumberFunction<number>;
-export declare const substringAfter: StringFunction<number>;
-export declare const substringBefore: StringFunction<number>;
-export declare const substring: StringFunction<number>;
-export declare const string: StringFunction<number>;
-export declare const translate: StringFunction<number>;
+export declare const concat: StringFunction;
+export declare const contains: BooleanFunction;
+export declare const normalizeSpace: StringFunction;
+export declare const startsWith: BooleanFunction;
+export declare const stringLength: NumberFunction;
+export declare const substringAfter: StringFunction;
+export declare const substringBefore: StringFunction;
+export declare const substring: StringFunction;
+export declare const string: StringFunction;
+export declare const translate: StringFunction;

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

@@ -1,3 +1,2 @@
 import { FunctionLibrary } from '../../evaluator/functions/FunctionLibrary';
-
 export declare const jr: FunctionLibrary;

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

@@ -1,3 +1,9 @@
 import { StringFunction } from '../../evaluator/functions/StringFunction.ts';
-
-export declare const itext: StringFunction<number>;
+/**
+ * @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;

package/dist/functions/xforms/boolean.d.ts

@@ -1,7 +1,6 @@
 import { BooleanFunction } from '../../evaluator/functions/BooleanFunction.ts';
 import { FunctionImplementation } from '../../evaluator/functions/FunctionImplementation.ts';
-
-export declare const booleanFromString: BooleanFunction<number>;
-export declare const checklist: BooleanFunction<number>;
-export declare const weightedChecklist: BooleanFunction<number>;
-export declare const xfIf: FunctionImplementation<number>;
+export declare const booleanFromString: BooleanFunction;
+export declare const checklist: BooleanFunction;
+export declare const weightedChecklist: BooleanFunction;
+export declare const xfIf: FunctionImplementation;

package/dist/functions/xforms/datetime.d.ts

@@ -1,11 +1,10 @@
 import { FunctionImplementation } from '../../evaluator/functions/FunctionImplementation.ts';
 import { NumberFunction } from '../../evaluator/functions/NumberFunction.ts';
 import { StringFunction } from '../../evaluator/functions/StringFunction.ts';
-
-export declare const today: FunctionImplementation<number>;
-export declare const xfNow: FunctionImplementation<number>;
-export declare const formatDate: StringFunction<number>;
-export declare const formatDateTime: StringFunction<number>;
-export declare const date: FunctionImplementation<number>;
-export declare const decimalDateTime: NumberFunction<number>;
-export declare const decimalTime: NumberFunction<number>;
+export declare const today: FunctionImplementation;
+export declare const xfNow: FunctionImplementation;
+export declare const formatDate: StringFunction;
+export declare const formatDateTime: StringFunction;
+export declare const date: FunctionImplementation;
+export declare const decimalDateTime: NumberFunction;
+export declare const decimalTime: NumberFunction;

package/dist/functions/xforms/geo.d.ts

@@ -1,4 +1,3 @@
 import { NumberFunction } from '../../evaluator/functions/NumberFunction.ts';
-
-export declare const area: NumberFunction<number>;
-export declare const distance: NumberFunction<number>;
+export declare const area: NumberFunction;
+export declare const distance: NumberFunction;

package/dist/functions/xforms/index.d.ts

@@ -1,3 +1,2 @@
 import { FunctionLibrary } from '../../evaluator/functions/FunctionLibrary.ts';
-
 export declare const xf: FunctionLibrary;

package/dist/functions/xforms/node-set.d.ts

@@ -1,10 +1,19 @@
 import { NodeSetFunction } from '../../evaluator/functions/NodeSetFunction.ts';
 import { NumberFunction } from '../../evaluator/functions/NumberFunction.ts';
 import { StringFunction } from '../../evaluator/functions/StringFunction.ts';
-
-export declare const countNonEmpty: NumberFunction<number>;
-export declare const indexedRepeat: NodeSetFunction<number>;
-export declare const instance: NodeSetFunction<number>;
-export declare const once: StringFunction<number>;
-export declare const position: NumberFunction<number>;
-export declare const randomize: NodeSetFunction<number>;
+export declare const countNonEmpty: NumberFunction;
+export declare const indexedRepeat: NodeSetFunction;
+export declare const instance: NodeSetFunction;
+export declare const once: StringFunction;
+/**
+ * ~~@todo this probably belongs in `fn`?~~
+ *
+ * @todo the baseline behavior of this belongs in `fn`. The contiguous same-name
+ * node behavior belongs here, presumably as an override.
+ *
+ * @todo we have at least a couple other override cases. They all extend the
+ * baseline behavior. Consider ability to call into overridden baseline (similar
+ * to `super` in class inheritance?).
+ */
+export declare const position: NumberFunction;
+export declare const randomize: NodeSetFunction;

package/dist/functions/xforms/number.d.ts

@@ -1,30 +1,29 @@
 import { FunctionImplementation } from '../../evaluator/functions/FunctionImplementation.ts';
 import { NumberFunction } from '../../evaluator/functions/NumberFunction.ts';
-
-export declare const abs: NumberFunction<number>;
-export declare const acos: NumberFunction<number>;
-export declare const asin: NumberFunction<number>;
-export declare const atan: NumberFunction<number>;
-export declare const atan2: NumberFunction<number>;
-export declare const cos: NumberFunction<number>;
-export declare const exp: NumberFunction<number>;
-export declare const exp10: NumberFunction<number>;
-export declare const int: NumberFunction<number>;
-export declare const log: NumberFunction<number>;
-export declare const log10: NumberFunction<number>;
-export declare const max: NumberFunction<number>;
-export declare const min: NumberFunction<number>;
+export declare const abs: NumberFunction;
+export declare const acos: NumberFunction;
+export declare const asin: NumberFunction;
+export declare const atan: NumberFunction;
+export declare const atan2: NumberFunction;
+export declare const cos: NumberFunction;
+export declare const exp: NumberFunction;
+export declare const exp10: NumberFunction;
+export declare const int: NumberFunction;
+export declare const log: NumberFunction;
+export declare const log10: NumberFunction;
+export declare const max: NumberFunction;
+export declare const min: NumberFunction;
 /**
  * Overrides the standard XPath 1.0 (fn namespaced) `number` in an
  * {@link XFormsXPathEvaluator}. This supports various date/datetime
  * cases where values would otherwise be treated as string literals
  * and fail to numerically compare as expected.
  */
-export declare const number: FunctionImplementation<number>;
-export declare const pi: NumberFunction<number>;
-export declare const pow: NumberFunction<number>;
-export declare const random: NumberFunction<number>;
-export declare const round: NumberFunction<number>;
-export declare const sin: NumberFunction<number>;
-export declare const sqrt: NumberFunction<number>;
-export declare const tan: NumberFunction<number>;
+export declare const number: FunctionImplementation;
+export declare const pi: NumberFunction;
+export declare const pow: NumberFunction;
+export declare const random: NumberFunction;
+export declare const round: NumberFunction;
+export declare const sin: NumberFunction;
+export declare const sqrt: NumberFunction;
+export declare const tan: NumberFunction;

package/dist/functions/xforms/select.d.ts

@@ -1,7 +1,6 @@
 import { BooleanFunction } from '../../evaluator/functions/BooleanFunction.ts';
 import { NumberFunction } from '../../evaluator/functions/NumberFunction.ts';
 import { StringFunction } from '../../evaluator/functions/StringFunction.ts';
-
-export declare const countSelected: NumberFunction<number>;
-export declare const selected: BooleanFunction<number>;
-export declare const selectedAt: StringFunction<number>;
+export declare const countSelected: NumberFunction;
+export declare const selected: BooleanFunction;
+export declare const selectedAt: StringFunction;

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

@@ -1,11 +1,10 @@
 import { BooleanFunction } from '../../evaluator/functions/BooleanFunction.ts';
 import { StringFunction } from '../../evaluator/functions/StringFunction.ts';
-
-export declare const coalesce: StringFunction<number>;
-export declare const concat: StringFunction<number>;
-export declare const digest: StringFunction<number>;
-export declare const endsWith: BooleanFunction<number>;
-export declare const join: StringFunction<number>;
-export declare const regex: BooleanFunction<number>;
-export declare const substr: StringFunction<number>;
-export declare const uuid: StringFunction<number>;
+export declare const coalesce: StringFunction;
+export declare const concat: StringFunction;
+export declare const digest: StringFunction;
+export declare const endsWith: BooleanFunction;
+export declare const join: StringFunction;
+export declare const regex: BooleanFunction;
+export declare const substr: StringFunction;
+export declare const uuid: StringFunction;

package/dist/index.d.ts

@@ -1,3 +1,46 @@
+/**
+ * @module @getodk/xpath
+ *
+ * Currently the main entrypoint for:
+ *
+ * - {@link Evaluator}, associated types
+ * - {@link XPathDOMAdapter}, associated values and types
+ * - {@link DefaultEvaluator}, associated types
+ * - {@link XFormsXPathEvaluator}, associated types
+ *
+ * @todo Break out distinct entrypoints for each.
+ * @todo Seriously consider moving all XForms-specific functionality down the
+ * stack instead of breaking those parts out.
+ */
+/**
+ * - - -
+ * {@link Evaluator}, associated types
+ * - - -
+ */
+export type * from './evaluator/Evaluator.ts';
 export { Evaluator } from './evaluator/Evaluator.ts';
-export type { EvaluatorConvenienceMethodOptions } from './evaluator/Evaluator.ts';
+/**
+ * - - -
+ * {@link XPathDOMAdapter}, associated values and types
+ * - - -
+ */
+export * from './adapter/defaults.ts';
+export * from './adapter/interface/XPathDOMAdapter.ts';
+/**
+ * - - -
+ * {@link DefaultEvaluator}, associated types
+ * - - -
+ */
+export type * from './evaluator/DefaultEvaluator.ts';
+export { DefaultEvaluator } from './evaluator/DefaultEvaluator.ts';
+/**
+ * - - -
+ * {@link XFormsXPathEvaluator}, associated values and types
+ * - - -
+ */
+export type * from './xforms/XFormsElementRepresentation.ts';
+export { XFORMS_KNOWN_ATTRIBUTE, XFORMS_LOCAL_NAME } from './xforms/XFormsElementRepresentation.ts';
+export type { XFormsItextTranslationElement, XFormsItextTranslationLanguage, XFormsItextTranslationMap, } from './xforms/XFormsItextTranslations.ts';
+export type { XFormsSecondaryInstanceElement, XFormsSecondaryInstanceMap, } from './xforms/XFormsSecondaryInstances.ts';
 export { XFormsXPathEvaluator } from './xforms/XFormsXPathEvaluator.ts';
+export type { XFormsXPathEvaluatorOptions, XFormsXPathRootNode, } from './xforms/XFormsXPathEvaluator.ts';