funcity 0.2.0 → 0.3.0

package/dist/tokenizer.d.ts

@@ -1,133 +1,14 @@
 /*!
  * name: funcity
- * version: 0.2.0
+ * version: 0.3.0
  * description: A functional language interpreter with text processing
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/funcity.git
- * git.commit.hash: 296ed901d99782ce89723733d765cf0bbf36348a
+ * git.commit.hash: 220b26da1df7f7653a61cde67d006c26df5272da
  */
 
-import { FunCityErrorInfo, FunCityRange } from './scripting';
-/**
- * The string token.
- */
-export interface FunCityStringToken {
-    /**
-     * Token kind.
-     */
-    readonly kind: 'string';
-    /**
-     * String value.
-     */
-    readonly value: string;
-    /**
-     * Token range in source text.
-     */
-    readonly range: FunCityRange;
-}
-/**
- * The number (numeric) token.
- */
-export interface FunCityNumberToken {
-    /**
-     * Token kind.
-     */
-    readonly kind: 'number';
-    /**
-     * Numeric value.
-     */
-    readonly value: number;
-    /**
-     * Token range in source text.
-     */
-    readonly range: FunCityRange;
-}
-/**
- * The identity (variable name) token.
- */
-export interface FunCityIdentityToken {
-    /**
-     * Token kind.
-     */
-    readonly kind: 'identity';
-    /**
-     * Identity.
-     */
-    readonly name: string;
-    /**
-     * Token range in source text.
-     */
-    readonly range: FunCityRange;
-}
-/**
- * Open parenthesis or bracket node.
- */
-export interface FunCityOpenToken {
-    /**
-     * Token kind.
-     */
-    readonly kind: 'open';
-    /**
-     * Open symbol.
-     */
-    readonly symbol: string;
-    /**
-     * Token range in source text.
-     */
-    readonly range: FunCityRange;
-}
-/**
- * Close parenthesis or bracket token.
- */
-export interface FunCityCloseToken {
-    /**
-     * Token kind.
-     */
-    readonly kind: 'close';
-    /**
-     * Close symbol.
-     */
-    readonly symbol: string;
-    /**
-     * Token range in source text.
-     */
-    readonly range: FunCityRange;
-}
-/**
- * End of line token.
- */
-export interface FunCityEndOfLineToken {
-    /**
-     * Token kind.
-     */
-    readonly kind: 'eol';
-    /**
-     * Token range in source text.
-     */
-    readonly range: FunCityRange;
-}
-/**
- * Free form text token.
- */
-export interface FunCityTextToken {
-    /**
-     * Token kind.
-     */
-    readonly kind: 'text';
-    /**
-     * Text value.
-     */
-    readonly text: string;
-    /**
-     * Token range in source text.
-     */
-    readonly range: FunCityRange;
-}
-/**
- * The token.
- */
-export type FunCityToken = FunCityStringToken | FunCityNumberToken | FunCityIdentityToken | FunCityOpenToken | FunCityCloseToken | FunCityEndOfLineToken | FunCityTextToken;
+import { FunCityErrorInfo, FunCityToken } from './types';
 /**
  * Run the tokenizer.
  * @param script - Input script text

package/dist/tokenizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../src/tokenizer.ts"],"names":[],"mappings":";;;;;;;;;AAKA,OAAO,KAAK,EACV,gBAAgB,EAEhB,YAAY,EACb,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,GAChB,iBAAiB,GACjB,qBAAqB,GACrB,gBAAgB,CAAC;AAgerB;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,EACd,QAAQ,gBAAgB,EAAE,KACzB,YAAY,EAiDd,CAAC"}
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../src/tokenizer.ts"],"names":[],"mappings":";;;;;;;;;AAKA,OAAO,KAAK,EACV,gBAAgB,EAKhB,YAAY,EACb,MAAM,SAAS,CAAC;AA+gBjB;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,MAAM,EACd,QAAQ,gBAAgB,EAAE,KACzB,YAAY,EAiDd,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,453 @@
+/*!
+ * name: funcity
+ * version: 0.3.0
+ * description: A functional language interpreter with text processing
+ * author: Kouji Matsui (@kekyo@mi.kekyo.net)
+ * license: MIT
+ * repository.url: https://github.com/kekyo/funcity.git
+ * git.commit.hash: 220b26da1df7f7653a61cde67d006c26df5272da
+ */
+
+/**
+ * Location in source text.
+ */
+export interface FunCityLocation {
+    /**
+     * Line number (1-based).
+     */
+    readonly line: number;
+    /**
+     * Column number (1-based).
+     */
+    readonly column: number;
+}
+/**
+ * Range in source text.
+ */
+export interface FunCityRange {
+    /**
+     * Start location.
+     */
+    readonly start: FunCityLocation;
+    /**
+     * End location.
+     */
+    readonly end: FunCityLocation;
+}
+/**
+ * Error severity type.
+ */
+export type FunCityErrorType = 'warning' | 'error';
+/**
+ * Error information with location.
+ */
+export interface FunCityErrorInfo {
+    /**
+     * Error severity.
+     */
+    readonly type: FunCityErrorType;
+    /**
+     * Error description.
+     */
+    readonly description: string;
+    /**
+     * Error range in source text.
+     */
+    readonly range: FunCityRange;
+}
+export interface FunCityRangedObject {
+    /**
+     * This object range.
+     */
+    readonly range: FunCityRange;
+}
+/**
+ * Variable map used by the reducer.
+ */
+export type FunCityVariables = ReadonlyMap<string, unknown>;
+/**
+ * The string token.
+ */
+export interface FunCityStringToken extends FunCityRangedObject {
+    /**
+     * Token kind.
+     */
+    readonly kind: 'string';
+    /**
+     * String value.
+     */
+    readonly value: string;
+}
+/**
+ * The number (numeric) token.
+ */
+export interface FunCityNumberToken extends FunCityRangedObject {
+    /**
+     * Token kind.
+     */
+    readonly kind: 'number';
+    /**
+     * Numeric value.
+     */
+    readonly value: number;
+}
+/**
+ * The identity (variable name) token.
+ */
+export interface FunCityIdentityToken extends FunCityRangedObject {
+    /**
+     * Token kind.
+     */
+    readonly kind: 'identity';
+    /**
+     * Identity.
+     */
+    readonly name: string;
+}
+/**
+ * Open parenthesis or bracket node.
+ */
+export interface FunCityOpenToken extends FunCityRangedObject {
+    /**
+     * Token kind.
+     */
+    readonly kind: 'open';
+    /**
+     * Open symbol.
+     */
+    readonly symbol: string;
+}
+/**
+ * Close parenthesis or bracket token.
+ */
+export interface FunCityCloseToken extends FunCityRangedObject {
+    /**
+     * Token kind.
+     */
+    readonly kind: 'close';
+    /**
+     * Close symbol.
+     */
+    readonly symbol: string;
+}
+/**
+ * End of line token.
+ */
+export interface FunCityEndOfLineToken extends FunCityRangedObject {
+    /**
+     * Token kind.
+     */
+    readonly kind: 'eol';
+}
+/**
+ * Free form text token.
+ */
+export interface FunCityTextToken extends FunCityRangedObject {
+    /**
+     * Token kind.
+     */
+    readonly kind: 'text';
+    /**
+     * Text value.
+     */
+    readonly text: string;
+}
+/**
+ * The token.
+ */
+export type FunCityToken = FunCityStringToken | FunCityNumberToken | FunCityIdentityToken | FunCityOpenToken | FunCityCloseToken | FunCityEndOfLineToken | FunCityTextToken;
+/**
+ * String expression node.
+ */
+export interface FunCityStringNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'string';
+    /**
+     * String value.
+     */
+    readonly value: string;
+}
+/**
+ * Number (numeric) expression node.
+ */
+export interface FunCityNumberNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'number';
+    /**
+     * Numeric value.
+     */
+    readonly value: number;
+}
+/**
+ * Variable (identity) expression node.
+ */
+export interface FunCityVariableNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'variable';
+    /**
+     * Variable name.
+     */
+    readonly name: string;
+}
+/**
+ * Application expression node.
+ */
+export interface FunCityApplyNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'apply';
+    /**
+     * Application target node.
+     */
+    readonly func: FunCityExpressionNode;
+    /**
+     * Application arguments.
+     */
+    readonly args: readonly FunCityExpressionNode[];
+}
+/**
+ * Lambda expression node.
+ */
+export interface FunCityLambdaNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'lambda';
+    /**
+     * Parameter names.
+     */
+    readonly names: readonly FunCityVariableNode[];
+    /**
+     * Lambda body expression.
+     */
+    readonly body: FunCityExpressionNode;
+}
+/**
+ * Expression list (array) node.
+ */
+export interface FunCityListNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'list';
+    /**
+     * List item nodes.
+     */
+    readonly items: readonly FunCityExpressionNode[];
+}
+/**
+ * Evaluate child scope node.
+ */
+export interface FunCityScopeNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'scope';
+    /**
+     * Scoped node list.
+     * @remarks Reduced each nodes, but takes last one reduced value.
+     */
+    readonly nodes: readonly FunCityExpressionNode[];
+}
+/**
+ * The expression node.
+ */
+export type FunCityExpressionNode = FunCityNumberNode | FunCityStringNode | FunCityVariableNode | FunCityApplyNode | FunCityLambdaNode | FunCityListNode | FunCityScopeNode;
+/**
+ * Text block node.
+ */
+export interface FunCityTextNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'text';
+    /**
+     * Text body.
+     */
+    readonly text: string;
+}
+/**
+ * Conditional branch (`if`) block node contains else block.
+ */
+export interface FunCityIfNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'if';
+    /**
+     * Condition expression node.
+     */
+    readonly condition: FunCityExpressionNode;
+    /**
+     * Then (true) block node.
+     */
+    readonly then: readonly FunCityBlockNode[];
+    /**
+     * Else (false) block node.
+     */
+    readonly else: readonly FunCityBlockNode[];
+}
+/**
+ * Conditional repeats (`while`) block node contains else block.
+ */
+export interface FunCityWhileNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'while';
+    /**
+     * Condition expression node.
+     */
+    readonly condition: FunCityExpressionNode;
+    /**
+     * Repeat block node.
+     */
+    readonly repeat: readonly FunCityBlockNode[];
+}
+/**
+ * Item iteration (`for`) block node contains else block.
+ */
+export interface FunCityForNode extends FunCityRangedObject {
+    /**
+     * Node kind.
+     */
+    readonly kind: 'for';
+    /**
+     * Bind variable node in each iteration.
+     */
+    readonly bind: FunCityVariableNode;
+    /**
+     * Iteration target expression node.
+     */
+    readonly iterable: FunCityExpressionNode;
+    /**
+     * Repeat block node.
+     */
+    readonly repeat: readonly FunCityBlockNode[];
+}
+/**
+ * The block node.
+ */
+export type FunCityBlockNode = FunCityExpressionNode | FunCityTextNode | FunCityIfNode | FunCityWhileNode | FunCityForNode;
+export interface ParserCursor {
+    /**
+     * Peek one token.
+     * @returns A token or undefined when reached end of token.
+     */
+    peekToken: () => FunCityToken | undefined;
+    /**
+     * Get one token and advance.
+     * @returns A token or undefined when reached end of token.
+     */
+    takeToken: () => FunCityToken | undefined;
+    /**
+     * Skip one token.
+     */
+    skipToken: () => void;
+}
+/**
+ * Variable value result.
+ */
+export interface FunCityReducerContextValueResult {
+    /**
+     * Variable value.
+     */
+    readonly value: unknown;
+    /**
+     * Is this found?
+     */
+    readonly isFound: boolean;
+}
+/**
+ * Native function context.
+ */
+export interface FunCityFunctionContext {
+    /**
+     * Current function application node.
+     */
+    readonly thisNode: FunCityExpressionNode;
+    /**
+     * Get current abort signal object.
+     * @returns AbortSignal when available.
+     */
+    readonly abortSignal: AbortSignal | undefined;
+    /**
+     * Get current context (scope) variable value.
+     * @param name - Variable name
+     * @returns Variable value information
+     */
+    readonly getValue: (name: string) => FunCityReducerContextValueResult;
+    /**
+     * Set current context (scope) variable value.
+     * @param name - Variable name
+     * @param value - New value
+     */
+    readonly setValue: (name: string, value: unknown) => void;
+    /**
+     * Append context error.
+     * @param error - Error or warning information.
+     */
+    readonly appendError: (error: FunCityErrorInfo) => void;
+    /**
+     * Indicate error received.
+     * @returns The context is received any errors.
+     */
+    readonly isFailed: () => boolean;
+    /**
+     * Reduce expression node with this context.
+     * @param node - Target node
+     * @returns Reduced value.
+     */
+    readonly reduce: (node: FunCityExpressionNode) => Promise<unknown>;
+}
+/**
+ * The reducer context.
+ */
+export interface FunCityReducerContext {
+    /**
+     * Get current abort signal object.
+     * @returns AbortSignal when available.
+     */
+    readonly abortSignal: AbortSignal | undefined;
+    /**
+     * Get current context (scope) variable value.
+     * @param name - Variable name
+     * @returns Variable value information
+     */
+    readonly getValue: (name: string) => FunCityReducerContextValueResult;
+    /**
+     * Set current context (scope) variable value.
+     * @param name - Variable name
+     * @param value - New value
+     */
+    readonly setValue: (name: string, value: unknown) => void;
+    /**
+     * Append context error.
+     * @param error - Error or warning information.
+     */
+    readonly appendError: (error: FunCityErrorInfo) => void;
+    /**
+     * Indicate error received.
+     * @returns The context is received any errors.
+     */
+    readonly isFailed: () => boolean;
+    /**
+     * Create new scoped context.
+     * @returns New reducer context.
+     */
+    readonly newScope: () => FunCityReducerContext;
+    /**
+     * Create native function context proxy.
+     * @param thisNode Current node (Indicating the current application is expected)
+     * @returns Native function context proxy instance.
+     */
+    readonly createFunctionContext: (thisNode: FunCityExpressionNode) => FunCityFunctionContext;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;;;;;;;AAOA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAID,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;CAC9B;AAID;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC/D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,GAChB,iBAAiB,GACjB,qBAAqB,GACrB,gBAAgB,CAAC;AAIrB;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACxD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,mBAAmB;IACzD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,qBAAqB,GACrB,eAAe,GACf,aAAa,GACb,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,SAAS,EAAE,MAAM,YAAY,GAAG,SAAS,CAAC;IAC1C;;;OAGG;IACH,SAAS,EAAE,MAAM,YAAY,GAAG,SAAS,CAAC;IAC1C;;OAEG;IACH,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAID;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gCAAgC,CAAC;IACtE;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,gCAAgC,CAAC;IACtE;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1D;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACxD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,qBAAqB,CAAC;IAC/C;;;;OAIG;IACH,QAAQ,CAAC,qBAAqB,EAAE,CAC9B,QAAQ,EAAE,qBAAqB,KAC5B,sBAAsB,CAAC;CAC7B"}

package/dist/utils.d.ts

@@ -0,0 +1,75 @@
+/*!
+ * name: funcity
+ * version: 0.3.0
+ * description: A functional language interpreter with text processing
+ * author: Kouji Matsui (@kekyo@mi.kekyo.net)
+ * license: MIT
+ * repository.url: https://github.com/kekyo/funcity.git
+ * git.commit.hash: 220b26da1df7f7653a61cde67d006c26df5272da
+ */
+
+import { FunCityErrorInfo, FunCityLocation, FunCityRange, FunCityVariables } from './types';
+/**
+ * Empty location with zeroed coordinates.
+ */
+export declare const emptyLocation: FunCityLocation;
+/**
+ * Empty range with zeroed coordinates.
+ */
+export declare const emptyRange: FunCityRange;
+/**
+ * Mark a function as a funcity special function.
+ * @param f - Target function.
+ * @returns The same function with a marker.
+ */
+export declare const makeFunCityFunction: (f: Function) => Function;
+/**
+ * Check whether a function is marked as funcity special function.
+ * @param f - Target function.
+ * @returns True when marked.
+ */
+export declare const isFunCityFunction: (f: Function) => boolean;
+/**
+ * Evaluate value with the interpreter's conditional semantics.
+ * @param v - Target value.
+ * @returns True when the value should be treated as truthy.
+ */
+export declare const isConditionalTrue: (v: unknown) => boolean;
+/**
+ * Cast a value to iterable when it has a default iterator.
+ * @param v - Target value.
+ * @returns Iterable instance or undefined when not iterable.
+ */
+export declare const asIterable: (v: unknown) => Iterable<unknown> | undefined;
+/**
+ * Combine variable maps or records into a single variable map.
+ * @param variablesList - Variable sources to merge.
+ * @returns Combined variable map.
+ */
+export declare const combineVariables: (...variablesList: readonly (FunCityVariables | Record<string, unknown>)[]) => FunCityVariables;
+/**
+ * Convert an error object into a human-readable message.
+ * @param error - Error object.
+ * @returns Error message.
+ */
+export declare const fromError: (error: any) => string;
+/**
+ * Build a range that covers all provided ranges.
+ * @param ranges - Ranges to cover.
+ * @returns The widest range.
+ */
+export declare const widerRange: (...ranges: FunCityRange[]) => FunCityRange;
+/**
+ * Output error list and return whether any error-level entry exists.
+ * @param path - Source path.
+ * @param errors - Errors to output.
+ * @returns True when an error-level entry exists.
+ */
+export declare const outputErrors: (path: string, errors: readonly FunCityErrorInfo[]) => boolean;
+/**
+ * Convert to string.
+ * @param v Target instance
+ * @returns String
+ */
+export declare const convertToString: (v: unknown) => 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":";;;;;;;;;AAKA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,eAGlB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,YAGf,CAAC;AAIX;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,GAAG,QAAQ,aAG9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,GAAG,QAAQ,KAAG,OAE/C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,GAAG,OAAO,YAa3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,OAAO,KAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,SAM3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,GAAG,eAAe,SAAS,CAAC,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,KACxE,gBAkBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,GAAG,KAAG,MAQtC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,QAAQ,YAAY,EAAE,KAAG,YA4BtD,CAAC;AA0BF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,EACZ,QAAQ,SAAS,gBAAgB,EAAE,YAQpC,CAAC;AAeF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,GAAG,OAAO,KAAG,MAyC5C,CAAC"}