@mojir/dvala 0.0.10 → 0.0.12

package/dist/modules/common/createFormatter.d.ts

@@ -1,6 +0,0 @@
-import type { FormatterRule } from '../cli/src/cliFormatterRules';
-export type TextFormatter = (text: string) => string;
-export declare function createFormatter(rules: FormatterRule[], options?: {
-    prefix?: string;
-    suffix?: string;
-}): TextFormatter;

package/dist/modules/common/utils.d.ts

@@ -1,2 +0,0 @@
-export declare function stringifyValue(value: unknown, html: boolean): string;
-export declare function findAllOccurrences(input: string, pattern: RegExp): Set<string>;

package/dist/modules/convert.esm.js

@@ -1,2 +0,0 @@
-function e(e){if(!e.position||!e.code)return"";const t=e.position.column-1,n=e.code.length-t-1;return`${" ".repeat(Math.max(t,0))}^${" ".repeat(Math.max(n,0))}`}class t extends Error{sourceCodeInfo;shortMessage;constructor(n,r){const s=n instanceof Error?n.message:`${n}`;super(function(t,n){if(!n)return t;const r=`${n.position.line}:${n.position.column}`;return`${t}${n.filePath?`\n${n.filePath}:${r}`:`\nLocation ${r}`}\n${n.code}\n${e(n)}`}(s,r)),this.shortMessage=s,this.sourceCodeInfo=r,Object.setPrototypeOf(this,t.prototype),this.name="DvalaError"}getCodeMarker(){return this.sourceCodeInfo&&e(this.sourceCodeInfo)}}const n={Number:1,String:2,NormalExpression:3,SpecialExpression:4,UserDefinedSymbol:5,NormalBuiltinSymbol:6,SpecialBuiltinSymbol:7,ReservedSymbol:8,Binding:9,Spread:10},r=new Set(Object.values(n));const s=new Set(["UserDefined","Partial","Comp","Constantly","Juxt","Complement","EveryPred","SomePred","Fnull","EffectMatcher","Builtin","SpecialBuiltin","Module"]);function i(e){return null!==e&&"object"==typeof e&&("^^fn^^"in e&&"functionType"in e&&("string"==typeof(t=e.functionType)&&s.has(t)));var t}function o(e){return!(!Array.isArray(e)||e.length<2)&&("number"==typeof(t=e[0])&&r.has(t));var t}function a(e){return i(e)?`<function ${e.name||"λ"}>`:o(e)?`${t=e[0],Object.keys(n).find(e=>n[e]===t)}-node`:null===e?"null":"object"==typeof e&&e instanceof RegExp?`${e}`:"object"==typeof e&&e instanceof Error?e.toString():JSON.stringify(e);var t}function u(e,n,r={}){if(!function(e,t={}){return!("number"!=typeof e||Number.isNaN(e)||t.integer&&!Number.isInteger(e)||t.finite&&!Number.isFinite(e)||t.zero&&0!==e||t.nonZero&&0===e||t.positive&&e<=0||t.negative&&e>=0||t.nonPositive&&e>0||t.nonNegative&&e<0||"number"==typeof t.gt&&e<=t.gt||"number"==typeof t.gte&&e<t.gte||"number"==typeof t.lt&&e>=t.lt||"number"==typeof t.lte&&e>t.lte)}(e,r))throw new t(`Expected ${function(e){if(e.zero)return"zero";const t=function(e){return e.positive?"positive":e.negative?"negative":e.nonNegative?"non negative":e.nonPositive?"non positive":e.nonZero?"non zero":""}(e),n=e.integer?"integer":"number",r=e.finite?"finite":"",s=function(e){return"number"!=typeof e.gt&&"number"!=typeof e.gte||"number"!=typeof e.lt&&"number"!=typeof e.lte?"number"==typeof e.gt||"number"==typeof e.gte?"number"==typeof e.gt?`n > ${e.gt}`:`n >= ${e.gte}`:"number"==typeof e.lt||"number"==typeof e.lte?"number"==typeof e.lt?`n < ${e.lt}`:`n <= ${e.lte}`:"":`${"number"==typeof e.gt?`${e.gt} < n `:`${e.gte} <= n `}${"number"==typeof e.lt?`< ${e.lt}`:`<= ${e.lte}`}`}(e);return[t,r,n,s].filter(e=>!!e).join(" ")}(r)}, got ${a(e)}.`,function(e,t){return e?.sourceCodeInfo??t}(e,n))}function c(e){return{min:e,max:e}}const m={baseUnit:"rad",description:"angle",units:{deg:Math.PI/180,rad:1,grad:Math.PI/200,turn:2*Math.PI}};function l(e,t){switch(e){case"c":return t;case"f":return 9*t/5+32;case"k":return t+273.15}}function p(e,t){switch(e){case"c":return t;case"f":return 5*(t-32)/9;case"k":return t-273.15}}const f=["c","f","k"],g={angstrom:"ångströms",um:"micrometers",mm:"millimeters",cm:"centimeters",m:"meters",km:"kilometers",in:"inches",ft:"feet",yd:"yards",mi:"miles",nmi:"nautical miles",mg:"milligrams",g:"grams",kg:"kilograms",t:"metric tons",oz:"ounces",lb:"pounds",st:"stones",ml:"milliliters",cl:"centiliters",dl:"deciliters",l:"liters",tsp:"teaspoons",tbsp:"tablespoons","fl-oz":"fluid ounces",cup:"cups",pt:"pints",qt:"quarts",gal:"gallons",ms:"milliseconds",s:"seconds",min:"minutes",h:"hours",day:"days",week:"weeks",mm2:"square millimeters",cm2:"square centimeters",m2:"square meters",km2:"square kilometers",in2:"square inches",ft2:"square feet",yd2:"square yards",acre:"acres",hectare:"hectares","m/s":"meters per second","km/h":"kilometers per hour",mph:"miles per hour",kn:"knots","ft/s":"feet per second",b:"bytes",kb:"kilobytes",mb:"megabytes",gb:"gigabytes",tb:"terabytes",pb:"petabytes",pa:"pascals",kpa:"kilopascals",bar:"bars",atm:"atmospheres",psi:"pounds per square inch",mmhg:"millimeters of mercury",j:"joules",kj:"kilojoules",cal:"calories",kcal:"kilocalories",wh:"watt-hours",kwh:"kilowatt-hours",btu:"British thermal units",w:"watts",kw:"kilowatts",mw:"megawatts",hp:"horsepower",hz:"hertz",khz:"kilohertz",mhz:"megahertz",ghz:"gigahertz",deg:"degrees",rad:"radians",grad:"gradians",turn:"turns",c:"Celsius",f:"Fahrenheit",k:"Kelvin"};function b(e){const t={},n=Object.keys(e.units);for(const r of n)for(const s of n){if(r===s)continue;const i=e.units[r]/e.units[s],o=`${r}->${s}`,a=g[r],m=g[s],l=[`convert.${s}->${r}`,...n.filter(e=>e!==r&&e!==s).map(e=>`convert.${r}->${e}`)];t[o]={evaluate:([e],t)=>(u(e,t),e*i),arity:c(1),docs:{category:"convert",returns:{type:"number"},args:{value:{type:"number",description:`Value in ${a}`}},variants:[{argumentNames:["value"]}],description:`Converts a value from ${a} (\`${r}\`) to ${m} (\`${s}\`).`,seeAlso:l,examples:[`let { ${o} } = import(convert);\n${o}(1)`]}}}return t}const d={...b({baseUnit:"m",description:"length",units:{angstrom:1e-10,um:1e-6,mm:.001,cm:.01,m:1,km:1e3,in:.0254,ft:.3048,yd:.9144,mi:1609.344,nmi:1852}}),...b({baseUnit:"kg",description:"weight",units:{mg:1e-6,g:.001,kg:1,t:1e3,oz:.028349523125,lb:.45359237,st:6.35029318}}),...b({baseUnit:"l",description:"volume",units:{ml:.001,cl:.01,dl:.1,l:1,tsp:.00492892159375,tbsp:.01478676478125,"fl-oz":.0295735295625,cup:.2365882365,pt:.473176473,qt:.946352946,gal:3.785411784}}),...b({baseUnit:"s",description:"time",units:{ms:.001,s:1,min:60,h:3600,day:86400,week:604800}}),...b({baseUnit:"m2",description:"area",units:{mm2:1e-6,cm2:1e-4,m2:1,km2:1e6,in2:64516e-8,ft2:.09290304,yd2:.83612736,acre:4046.8564224,hectare:1e4}}),...b({baseUnit:"m/s",description:"speed",units:{"m/s":1,"km/h":1/3.6,mph:.44704,kn:.514444,"ft/s":.3048}}),...b({baseUnit:"b",description:"data",units:{b:1,kb:1e3,mb:1e6,gb:1e9,tb:1e12,pb:1e15}}),...b({baseUnit:"pa",description:"pressure",units:{pa:1,kpa:1e3,bar:1e5,atm:101325,psi:6894.757293168,mmhg:133.322387415}}),...b({baseUnit:"j",description:"energy",units:{j:1,kj:1e3,cal:4.184,kcal:4184,wh:3600,kwh:36e5,btu:1055.06}}),...b({baseUnit:"w",description:"power",units:{w:1,kw:1e3,mw:1e6,hp:745.7}}),...b({baseUnit:"hz",description:"frequency",units:{hz:1,khz:1e3,mhz:1e6,ghz:1e9}}),...b(m),...function(){const e={};for(const t of f)for(const n of f){if(t===n)continue;const r=`${t}->${n}`,s=g[t],i=g[n],o=[`convert.${n}->${t}`,...f.filter(e=>e!==t&&e!==n).map(e=>`convert.${t}->${e}`)];e[r]={evaluate:([e],r)=>{u(e,r);const s=p(t,e);return l(n,s)},arity:c(1),docs:{category:"convert",returns:{type:"number"},args:{value:{type:"number",description:`Value in ${s}`}},variants:[{argumentNames:["value"]}],description:`Converts a temperature from ${s} (\`${t}\`) to ${i} (\`${n}\`).`,seeAlso:o,examples:[`let { ${r} } = import(convert);\n${r}(100)`]}}}return e}()},h={name:"convert",functions:d,source:"{}",docs:(y=d,Object.fromEntries(Object.entries(y).map(([e,t])=>{if(!t.docs)throw new Error(`Missing docs for function "${e}"`);return[e,t.docs]})))};var y;export{h as convertModule};
-//# sourceMappingURL=convert.esm.js.map

package/dist/modules/convert.esm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"convert.esm.js","sources":["../../src/utils/debug/getCodeMarker.ts","../../src/errors.ts","../../src/constants/constants.ts","../../src/utils/debug/debugTools.ts","../../src/utils/symbols.ts","../../src/typeGuards/number.ts","../../src/utils/debug/getSourceCodeInfo.ts","../../src/utils/arity.ts","../../src/builtin/modules/convert/index.ts","../../src/builtin/modules/convert/convert.dvala","../../src/builtin/modules/interface.ts"],"sourcesContent":["import type { SourceCodeInfo } from '../../tokenizer/token'\n\nexport function getCodeMarker(sourceCodeInfo: SourceCodeInfo): string {\n  if (!sourceCodeInfo.position || !sourceCodeInfo.code)\n    return ''\n\n  const leftPadding = sourceCodeInfo.position.column - 1\n  const rightPadding = sourceCodeInfo.code.length - leftPadding - 1\n  return `${' '.repeat(Math.max(leftPadding, 0))}^${' '.repeat(Math.max(rightPadding, 0))}`\n}\n","import { getCodeMarker } from '../src/utils/debug/getCodeMarker'\nimport type { Arr } from './interface'\nimport type { SourceCodeInfo } from './tokenizer/token'\n\nfunction getDvalaErrorMessage(message: string, sourceCodeInfo?: SourceCodeInfo) {\n  if (!sourceCodeInfo) {\n    return message\n  }\n  const location = `${sourceCodeInfo.position.line}:${sourceCodeInfo.position.column}`\n  const filePathLine = sourceCodeInfo.filePath\n    ? `\\n${sourceCodeInfo.filePath}:${location}`\n    : `\\nLocation ${location}`\n  const codeLine = `\\n${sourceCodeInfo.code}`\n  const codeMarker = `\\n${getCodeMarker(sourceCodeInfo)}`\n  return `${message}${filePathLine}${codeLine}${codeMarker}`\n}\n\nexport class RecurSignal extends Error {\n  public params: Arr\n  constructor(params: Arr) {\n    super(`recur, params: ${params}`)\n    Object.setPrototypeOf(this, RecurSignal.prototype)\n    this.name = 'RecurSignal'\n    this.params = params\n  }\n}\n\nexport class DvalaError extends Error {\n  public readonly sourceCodeInfo?: SourceCodeInfo\n  public readonly shortMessage: string\n  constructor(err: unknown, sourceCodeInfo: SourceCodeInfo | undefined) {\n    const message = err instanceof Error\n      ? err.message\n      : `${err}`\n\n    super(getDvalaErrorMessage(message, sourceCodeInfo))\n    this.shortMessage = message\n    this.sourceCodeInfo = sourceCodeInfo\n    Object.setPrototypeOf(this, DvalaError.prototype)\n    this.name = 'DvalaError'\n  }\n\n  public getCodeMarker(): string | undefined {\n    return this.sourceCodeInfo && getCodeMarker(this.sourceCodeInfo)\n  }\n}\n\nexport class UserDefinedError extends DvalaError {\n  public userMessage: string\n  constructor(message: string, sourceCodeInfo?: SourceCodeInfo) {\n    super(message, sourceCodeInfo)\n    this.userMessage = message\n    Object.setPrototypeOf(this, UserDefinedError.prototype)\n    this.name = 'UserDefinedError'\n  }\n}\n\nexport class AssertionError extends DvalaError {\n  constructor(message: string | Error, sourceCodeInfo?: SourceCodeInfo) {\n    super(message, sourceCodeInfo)\n    Object.setPrototypeOf(this, AssertionError.prototype)\n    this.name = 'AssertionError'\n  }\n}\n\nexport class UndefinedSymbolError extends DvalaError {\n  public symbol: string\n  constructor(symbolName: string, sourceCodeInfo?: SourceCodeInfo) {\n    const message = `Undefined symbol '${symbolName}'.`\n    super(message, sourceCodeInfo)\n    this.symbol = symbolName\n    Object.setPrototypeOf(this, UndefinedSymbolError.prototype)\n    this.name = 'UndefinedSymbolError'\n  }\n}\n\nexport function isDvalaError(error: unknown): error is DvalaError {\n  return error instanceof DvalaError\n}\n","export const NodeTypes = {\n  Number: 1,\n  String: 2,\n  NormalExpression: 3,\n  SpecialExpression: 4,\n  UserDefinedSymbol: 5,\n  NormalBuiltinSymbol: 6,\n  SpecialBuiltinSymbol: 7,\n  ReservedSymbol: 8,\n  Binding: 9,\n  Spread: 10,\n} as const\n\nconst NodeTypesSet = new Set(Object.values(NodeTypes))\n\nexport type NodeType = typeof NodeTypes[keyof typeof NodeTypes]\n\nexport function getNodeTypeName(type: NodeType): keyof typeof NodeTypes {\n  return Object.keys(NodeTypes).find(key => NodeTypes[key as keyof typeof NodeTypes] === type) as keyof typeof NodeTypes\n}\n\n// TODO, is this needed?\nexport function isNodeType(type: unknown): type is NodeType {\n  return typeof type === 'number' && NodeTypesSet.has(type as NodeType)\n}\n\nconst functionTypes = [\n  'UserDefined',\n  'Partial',\n  'Comp',\n  'Constantly',\n  'Juxt',\n  'Complement',\n  'EveryPred',\n  'SomePred',\n  'Fnull',\n  'EffectMatcher',\n  'Builtin',\n  'SpecialBuiltin',\n  'Module',\n] as const\n\nconst functionTypeSet = new Set(functionTypes)\n\nexport type FunctionType = typeof functionTypes[number]\n\nexport function isFunctionType(type: unknown): type is FunctionType {\n  return typeof type === 'string' && functionTypeSet.has(type as FunctionType)\n}\n","import { getNodeTypeName, isFunctionType, isNodeType } from '../../constants/constants'\nimport type { AstNode, DvalaFunction } from '../../parser/types'\nimport { FUNCTION_SYMBOL } from '../symbols'\n\nfunction isDvalaFunction(func: unknown): func is DvalaFunction {\n  if (func === null || typeof func !== 'object')\n    return false\n\n  return FUNCTION_SYMBOL in func && 'functionType' in func && isFunctionType(func.functionType)\n}\n\nfunction isNode(value: unknown): value is AstNode {\n  if (!Array.isArray(value) || value.length < 2)\n    return false\n  return isNodeType(value[0])\n}\n\nexport function valueToString(value: unknown): string {\n  if (isDvalaFunction(value))\n    // eslint-disable-next-line ts/no-unsafe-member-access\n    return `<function ${(value as any).name || '\\u03BB'}>`\n\n  if (isNode(value))\n    return `${getNodeTypeName(value[0])}-node`\n\n  if (value === null)\n    return 'null'\n\n  if (typeof value === 'object' && value instanceof RegExp)\n    return `${value}`\n\n  if (typeof value === 'object' && value instanceof Error)\n    return value.toString()\n\n  return JSON.stringify(value)\n}\n","export const FUNCTION_SYMBOL = '^^fn^^'\nexport const REGEXP_SYMBOL = '^^re^^'\nexport const EFFECT_SYMBOL = '^^ef^^'\n","import { DvalaError } from '../errors'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { valueToString } from '../utils/debug/debugTools'\nimport { getSourceCodeInfo } from '../utils/debug/getSourceCodeInfo'\n\ntype SignOptions =\n  | {\n    positive?: true\n    negative?: never\n    nonPositive?: never\n    nonNegative?: never\n    zero?: never\n    nonZero?: never\n  }\n  | {\n    positive?: never\n    negative?: true\n    nonPositive?: never\n    nonNegative?: never\n    zero?: never\n    nonZero?: never\n  }\n  | {\n    positive?: never\n    negative?: never\n    nonPositive?: true\n    nonNegative?: never\n    zero?: never\n    nonZero?: never\n  }\n  | {\n    positive?: never\n    negative?: never\n    nonPositive?: never\n    nonNegative?: true\n    zero?: never\n    nonZero?: never\n  }\n  | {\n    positive?: never\n    negative?: never\n    nonPositive?: never\n    nonNegative?: never\n    zero?: true\n    nonZero?: never\n  }\n  | {\n    positive?: never\n    negative?: never\n    nonPositive?: never\n    nonNegative?: never\n    zero?: never\n    nonZero?: true\n  }\n\ntype GtOptions =\n  | {\n    gt?: number\n    gte?: never\n  }\n  | {\n    gt?: never\n    gte?: number\n  }\n\ntype LtOptions =\n  | {\n    lt?: number\n    lte?: never\n  }\n  | {\n    lt?: never\n    lte?: number\n  }\n\ntype NumberOptions = {\n  integer?: true\n  finite?: true\n} & SignOptions &\nGtOptions &\nLtOptions\n\nfunction getRangeString(options: NumberOptions): string {\n  const hasUpperAndLowerBound\n    = (typeof options.gt === 'number' || typeof options.gte === 'number')\n      && (typeof options.lt === 'number' || typeof options.lte === 'number')\n  if (hasUpperAndLowerBound) {\n    return `${typeof options.gt === 'number' ? `${options.gt} < n ` : `${options.gte} <= n `}${\n      typeof options.lt === 'number' ? `< ${options.lt}` : `<= ${options.lte}`\n    }`\n  }\n  else if (typeof options.gt === 'number' || typeof options.gte === 'number') {\n    return `${typeof options.gt === 'number' ? `n > ${options.gt}` : `n >= ${options.gte}`}`\n  }\n  else if (typeof options.lt === 'number' || typeof options.lte === 'number') {\n    return `${typeof options.lt === 'number' ? `n < ${options.lt}` : `n <= ${options.lte}`}`\n  }\n  else { return '' }\n}\n\nfunction getSignString(options: NumberOptions): string {\n  return options.positive\n    ? 'positive'\n    : options.negative\n      ? 'negative'\n      : options.nonNegative\n        ? 'non negative'\n        : options.nonPositive\n          ? 'non positive'\n          : options.nonZero\n            ? 'non zero'\n            : ''\n}\n\nfunction getNumberTypeName(options: NumberOptions): string {\n  if (options.zero)\n    return 'zero'\n\n  const sign = getSignString(options)\n  const numberType = options.integer ? 'integer' : 'number'\n  const finite = options.finite ? 'finite' : ''\n  const range = getRangeString(options)\n\n  return [sign, finite, numberType, range].filter(x => !!x).join(' ')\n}\n\nexport function isNumber(value: unknown, options: NumberOptions = {}): value is number {\n  if (typeof value !== 'number')\n    return false\n\n  if (Number.isNaN(value))\n    return false\n\n  if (options.integer && !Number.isInteger(value))\n    return false\n\n  if (options.finite && !Number.isFinite(value))\n    return false\n\n  if (options.zero && value !== 0)\n    return false\n\n  if (options.nonZero && value === 0)\n    return false\n\n  if (options.positive && value <= 0)\n    return false\n\n  if (options.negative && value >= 0)\n    return false\n\n  if (options.nonPositive && value > 0)\n    return false\n\n  if (options.nonNegative && value < 0)\n    return false\n\n  if (typeof options.gt === 'number' && value <= options.gt)\n    return false\n\n  if (typeof options.gte === 'number' && value < options.gte)\n    return false\n\n  if (typeof options.lt === 'number' && value >= options.lt)\n    return false\n\n  if (typeof options.lte === 'number' && value > options.lte)\n    return false\n\n  return true\n}\n\nexport function assertNumber(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n  options: NumberOptions = {},\n): asserts value is number {\n  if (!isNumber(value, options)) {\n    throw new DvalaError(\n      `Expected ${getNumberTypeName(options)}, got ${valueToString(value)}.`,\n      getSourceCodeInfo(value, sourceCodeInfo),\n    )\n  }\n}\n\nexport function asNumber(\n  value: unknown,\n  sourceCodeInfo: SourceCodeInfo | undefined,\n  options: NumberOptions = {},\n): number {\n  assertNumber(value, sourceCodeInfo, options)\n  return value\n}\n","import type { SourceCodeInfo } from '../../tokenizer/token'\n\nexport function getSourceCodeInfo(anyValue: any, sourceCodeInfo: SourceCodeInfo | undefined): SourceCodeInfo | undefined {\n  // eslint-disable-next-line ts/no-unsafe-return, ts/no-unsafe-member-access\n  return anyValue?.sourceCodeInfo ?? sourceCodeInfo\n}\n","import type { Arity } from '../builtin/interface'\nimport { DvalaError } from '../errors'\nimport type { FunctionLike } from '../parser/types'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { isColl } from '../typeGuards/dvala'\nimport { valueToString } from './debug/debugTools'\n\nexport function arityAccepts(arity: Arity, nbrOfParams: number): boolean {\n  const { min, max } = arity\n  if (typeof min === 'number' && nbrOfParams < min) {\n    return false\n  }\n  if (typeof max === 'number' && nbrOfParams > max) {\n    return false\n  }\n  return true\n}\n\nexport function arityAcceptsMin(arity: Arity, nbrOfParams: number): boolean {\n  const { min } = arity\n  if (typeof min === 'number' && nbrOfParams < min) {\n    return false\n  }\n  return true\n}\n\nexport function getCommonArityFromFunctions(params: FunctionLike[]): Arity | null {\n  return params.reduce((acc: Arity | null, param): Arity | null => {\n    if (acc === null) {\n      return null\n    }\n    const arity: Arity = (typeof param === 'number' || isColl(param)) ? toFixedArity(1) : param.arity\n    const { min: aMin, max: aMax } = arity\n    const { min: bMin, max: bMax } = acc\n    const min = typeof aMin === 'number' && typeof bMin === 'number'\n      ? Math.max(aMin, bMin)\n      : typeof aMin === 'number' ? aMin : typeof bMin === 'number' ? bMin : undefined\n    const max = typeof aMax === 'number' && typeof bMax === 'number'\n      ? Math.min(aMax, bMax)\n      : typeof aMax === 'number' ? aMax : typeof bMax === 'number' ? bMax : undefined\n\n    if (typeof min === 'number' && typeof max === 'number' && min > max) {\n      return null\n    }\n\n    return { min, max }\n  }, {})\n}\n\nexport function getArityFromFunction(param: FunctionLike): Arity {\n  return (typeof param === 'number' || isColl(param)) ? toFixedArity(1) : param.arity\n}\n\nexport function assertNumberOfParams(arity: Arity, length: number, sourceCodeInfo: SourceCodeInfo | undefined): void {\n  const { min, max } = arity\n  if (typeof min === 'number' && length < min) {\n    throw new DvalaError(\n      `Wrong number of arguments, expected at least ${min}, got ${valueToString(length)}.`,\n      sourceCodeInfo,\n    )\n  }\n\n  if (typeof max === 'number' && length > max) {\n    throw new DvalaError(\n      `Wrong number of arguments, expected at most ${max}, got ${valueToString(length)}.`,\n      sourceCodeInfo,\n    )\n  }\n}\n\nexport function canBeOperator(count: Arity): boolean {\n  if (typeof count.max === 'number' && count.max < 2) {\n    return false\n  }\n\n  if (typeof count.min === 'number' && count.min > 2) {\n    return false\n  }\n\n  return true\n}\n\nexport function toFixedArity(arity: number): Arity {\n  return { min: arity, max: arity }\n}\n","import { assertNumber } from '../../../typeGuards/number'\nimport { toFixedArity } from '../../../utils/arity'\nimport type { BuiltinNormalExpressions } from '../../interface'\nimport { moduleDocsFromFunctions } from '../interface'\nimport type { DvalaModule } from '../interface'\nimport convertModuleSource from './convert.dvala'\n\n// --- Conversion factor tables ---\n// Each category maps unit abbreviations to a factor relative to a base unit.\n// To convert from unit A to unit B: value * (factorA / factorB)\n// Temperature is special-cased (non-linear).\n\ninterface UnitCategory {\n  baseUnit: string\n  units: Record<string, number>\n  description: string\n}\n\nconst lengthUnits: UnitCategory = {\n  baseUnit: 'm',\n  description: 'length',\n  units: {\n    angstrom: 1e-10,\n    um: 0.000001,\n    mm: 0.001,\n    cm: 0.01,\n    m: 1,\n    km: 1000,\n    in: 0.0254,\n    ft: 0.3048,\n    yd: 0.9144,\n    mi: 1609.344,\n    nmi: 1852,\n  },\n}\n\nconst weightUnits: UnitCategory = {\n  baseUnit: 'kg',\n  description: 'weight',\n  units: {\n    mg: 0.000001,\n    g: 0.001,\n    kg: 1,\n    t: 1000,\n    oz: 0.028349523125,\n    lb: 0.45359237,\n    st: 6.35029318,\n  },\n}\n\nconst volumeUnits: UnitCategory = {\n  baseUnit: 'l',\n  description: 'volume',\n  units: {\n    'ml': 0.001,\n    'cl': 0.01,\n    'dl': 0.1,\n    'l': 1,\n    'tsp': 0.00492892159375,\n    'tbsp': 0.01478676478125,\n    'fl-oz': 0.0295735295625,\n    'cup': 0.2365882365,\n    'pt': 0.473176473,\n    'qt': 0.946352946,\n    'gal': 3.785411784,\n  },\n}\n\nconst timeUnits: UnitCategory = {\n  baseUnit: 's',\n  description: 'time',\n  units: {\n    ms: 0.001,\n    s: 1,\n    min: 60,\n    h: 3600,\n    day: 86400,\n    week: 604800,\n  },\n}\n\nconst areaUnits: UnitCategory = {\n  baseUnit: 'm2',\n  description: 'area',\n  units: {\n    mm2: 0.000001,\n    cm2: 0.0001,\n    m2: 1,\n    km2: 1000000,\n    in2: 0.00064516,\n    ft2: 0.09290304,\n    yd2: 0.83612736,\n    acre: 4046.8564224,\n    hectare: 10000,\n  },\n}\n\nconst speedUnits: UnitCategory = {\n  baseUnit: 'm/s',\n  description: 'speed',\n  units: {\n    'm/s': 1,\n    'km/h': 1 / 3.6,\n    'mph': 0.44704,\n    'kn': 0.514444,\n    'ft/s': 0.3048,\n  },\n}\n\nconst dataUnits: UnitCategory = {\n  baseUnit: 'b',\n  description: 'data',\n  units: {\n    b: 1,\n    kb: 1000,\n    mb: 1000000,\n    gb: 1e9,\n    tb: 1e12,\n    pb: 1e15,\n  },\n}\n\nconst pressureUnits: UnitCategory = {\n  baseUnit: 'pa',\n  description: 'pressure',\n  units: {\n    pa: 1,\n    kpa: 1000,\n    bar: 100000,\n    atm: 101325,\n    psi: 6894.757293168,\n    mmhg: 133.322387415,\n  },\n}\n\nconst energyUnits: UnitCategory = {\n  baseUnit: 'j',\n  description: 'energy',\n  units: {\n    j: 1,\n    kj: 1000,\n    cal: 4.184,\n    kcal: 4184,\n    wh: 3600,\n    kwh: 3600000,\n    btu: 1055.06,\n  },\n}\n\nconst powerUnits: UnitCategory = {\n  baseUnit: 'w',\n  description: 'power',\n  units: {\n    w: 1,\n    kw: 1000,\n    mw: 1000000,\n    hp: 745.7,\n  },\n}\n\nconst frequencyUnits: UnitCategory = {\n  baseUnit: 'hz',\n  description: 'frequency',\n  units: {\n    hz: 1,\n    khz: 1000,\n    mhz: 1000000,\n    ghz: 1000000000,\n  },\n}\n\nconst angleUnits: UnitCategory = {\n  baseUnit: 'rad',\n  description: 'angle',\n  units: {\n    deg: Math.PI / 180,\n    rad: 1,\n    grad: Math.PI / 200,\n    turn: 2 * Math.PI,\n  },\n}\n\n// --- Temperature conversion functions ---\n\nfunction celsiusTo(unit: 'c' | 'f' | 'k', value: number): number {\n  switch (unit) {\n    case 'c': return value\n    case 'f': return value * 9 / 5 + 32\n    case 'k': return value + 273.15\n  }\n}\n\nfunction toCelsius(unit: 'c' | 'f' | 'k', value: number): number {\n  switch (unit) {\n    case 'c': return value\n    case 'f': return (value - 32) * 5 / 9\n    case 'k': return value - 273.15\n  }\n}\n\nconst temperatureUnits = ['c', 'f', 'k'] as const\n\nconst unitDescriptions: Record<string, string> = {\n  // Length\n  'angstrom': 'ångströms',\n  'um': 'micrometers',\n  'mm': 'millimeters',\n  'cm': 'centimeters',\n  'm': 'meters',\n  'km': 'kilometers',\n  'in': 'inches',\n  'ft': 'feet',\n  'yd': 'yards',\n  'mi': 'miles',\n  'nmi': 'nautical miles',\n  // Weight\n  'mg': 'milligrams',\n  'g': 'grams',\n  'kg': 'kilograms',\n  't': 'metric tons',\n  'oz': 'ounces',\n  'lb': 'pounds',\n  'st': 'stones',\n  // Volume\n  'ml': 'milliliters',\n  'cl': 'centiliters',\n  'dl': 'deciliters',\n  'l': 'liters',\n  'tsp': 'teaspoons',\n  'tbsp': 'tablespoons',\n  'fl-oz': 'fluid ounces',\n  'cup': 'cups',\n  'pt': 'pints',\n  'qt': 'quarts',\n  'gal': 'gallons',\n  // Time\n  'ms': 'milliseconds',\n  's': 'seconds',\n  'min': 'minutes',\n  'h': 'hours',\n  'day': 'days',\n  'week': 'weeks',\n  // Area\n  'mm2': 'square millimeters',\n  'cm2': 'square centimeters',\n  'm2': 'square meters',\n  'km2': 'square kilometers',\n  'in2': 'square inches',\n  'ft2': 'square feet',\n  'yd2': 'square yards',\n  'acre': 'acres',\n  'hectare': 'hectares',\n  // Speed\n  'm/s': 'meters per second',\n  'km/h': 'kilometers per hour',\n  'mph': 'miles per hour',\n  'kn': 'knots',\n  'ft/s': 'feet per second',\n  // Data\n  'b': 'bytes',\n  'kb': 'kilobytes',\n  'mb': 'megabytes',\n  'gb': 'gigabytes',\n  'tb': 'terabytes',\n  'pb': 'petabytes',\n  // Pressure\n  'pa': 'pascals',\n  'kpa': 'kilopascals',\n  'bar': 'bars',\n  'atm': 'atmospheres',\n  'psi': 'pounds per square inch',\n  'mmhg': 'millimeters of mercury',\n  // Energy\n  'j': 'joules',\n  'kj': 'kilojoules',\n  'cal': 'calories',\n  'kcal': 'kilocalories',\n  'wh': 'watt-hours',\n  'kwh': 'kilowatt-hours',\n  'btu': 'British thermal units',\n  // Power\n  'w': 'watts',\n  'kw': 'kilowatts',\n  'mw': 'megawatts',\n  'hp': 'horsepower',\n  // Frequency\n  'hz': 'hertz',\n  'khz': 'kilohertz',\n  'mhz': 'megahertz',\n  'ghz': 'gigahertz',\n  // Angle\n  'deg': 'degrees',\n  'rad': 'radians',\n  'grad': 'gradians',\n  'turn': 'turns',\n  // Temperature\n  'c': 'Celsius',\n  'f': 'Fahrenheit',\n  'k': 'Kelvin',\n}\n\n// --- Generate linear conversion functions ---\n\nfunction generateLinearConversions(category: UnitCategory): BuiltinNormalExpressions {\n  const result: BuiltinNormalExpressions = {}\n  const unitNames = Object.keys(category.units)\n\n  for (const from of unitNames) {\n    for (const to of unitNames) {\n      if (from === to)\n        continue\n\n      const fromFactor = category.units[from]!\n      const toFactor = category.units[to]!\n      const conversionFactor = fromFactor / toFactor\n      const fnName = `${from}->${to}`\n      const fromDesc = unitDescriptions[from]!\n      const toDesc = unitDescriptions[to]!\n\n      const seeAlso = [\n        `convert.${to}->${from}`,\n        ...unitNames\n          .filter(u => u !== from && u !== to)\n          .map(u => `convert.${from}->${u}`),\n      ]\n\n      result[fnName] = {\n        evaluate: ([value], sourceCodeInfo): number => {\n          assertNumber(value, sourceCodeInfo)\n          return value * conversionFactor\n        },\n        arity: toFixedArity(1),\n        docs: {\n          category: 'convert',\n          returns: { type: 'number' },\n          args: {\n            value: { type: 'number', description: `Value in ${fromDesc}` },\n          },\n          variants: [{ argumentNames: ['value'] }],\n          description: `Converts a value from ${fromDesc} (\\`${from}\\`) to ${toDesc} (\\`${to}\\`).`,\n          seeAlso,\n          examples: [\n            `let { ${fnName} } = import(convert);\n${fnName}(1)`,\n          ],\n        },\n      }\n    }\n  }\n  return result\n}\n\n// --- Generate temperature conversion functions ---\n\nfunction generateTemperatureConversions(): BuiltinNormalExpressions {\n  const result: BuiltinNormalExpressions = {}\n\n  for (const from of temperatureUnits) {\n    for (const to of temperatureUnits) {\n      if (from === to)\n        continue\n\n      const fnName = `${from}->${to}`\n      const fromDesc = unitDescriptions[from]!\n      const toDesc = unitDescriptions[to]!\n\n      const seeAlso = [\n        `convert.${to}->${from}`,\n        ...temperatureUnits\n          .filter(u => u !== from && u !== to)\n          .map(u => `convert.${from}->${u}`),\n      ]\n\n      result[fnName] = {\n        evaluate: ([value], sourceCodeInfo): number => {\n          assertNumber(value, sourceCodeInfo)\n          const celsius = toCelsius(from, value)\n          return celsiusTo(to, celsius)\n        },\n        arity: toFixedArity(1),\n        docs: {\n          category: 'convert',\n          returns: { type: 'number' },\n          args: {\n            value: { type: 'number', description: `Value in ${fromDesc}` },\n          },\n          variants: [{ argumentNames: ['value'] }],\n          description: `Converts a temperature from ${fromDesc} (\\`${from}\\`) to ${toDesc} (\\`${to}\\`).`,\n          seeAlso,\n          examples: [\n            `let { ${fnName} } = import(convert);\n${fnName}(100)`,\n          ],\n        },\n      }\n    }\n  }\n  return result\n}\n\n// --- Assemble all conversion functions ---\n\nconst convertFunctions: BuiltinNormalExpressions = {\n  ...generateLinearConversions(lengthUnits),\n  ...generateLinearConversions(weightUnits),\n  ...generateLinearConversions(volumeUnits),\n  ...generateLinearConversions(timeUnits),\n  ...generateLinearConversions(areaUnits),\n  ...generateLinearConversions(speedUnits),\n  ...generateLinearConversions(dataUnits),\n  ...generateLinearConversions(pressureUnits),\n  ...generateLinearConversions(energyUnits),\n  ...generateLinearConversions(powerUnits),\n  ...generateLinearConversions(frequencyUnits),\n  ...generateLinearConversions(angleUnits),\n  ...generateTemperatureConversions(),\n}\n\nexport const convertModule: DvalaModule = {\n  name: 'convert',\n  functions: convertFunctions,\n  source: convertModuleSource,\n  docs: moduleDocsFromFunctions(convertFunctions),\n}\n","{}","import type { BuiltinNormalExpressions, FunctionDocs } from '../../builtin/interface'\n\n/**\n * Represents a Dvala module that can be imported dynamically.\n * Modules contain a collection of functions that are not part of the core bundle.\n */\nexport interface DvalaModule {\n  /** The name of the module (e.g., 'grid', 'vec', 'mat') */\n  name: string\n  /** The functions provided by this module, keyed by their short name (e.g., 'transpose') */\n  functions: BuiltinNormalExpressions\n  /**\n   * Optional Dvala source code that is evaluated at import time.\n   * The source must evaluate to an object mapping function names to functions.\n   * These are merged with (and may override) the TypeScript `functions`.\n   */\n  source?: string\n  /**\n   * Docs for all functions in this module, including any defined in `source`.\n   * The reference system uses this record as the sole source of truth for\n   * function names and documentation. Not required for user-defined modules.\n   */\n  docs?: Record<string, FunctionDocs>\n}\n\n/**\n * Derives a docs record from a BuiltinNormalExpressions map.\n * Use this for modules whose docs are co-located inline on each function.\n */\nexport function moduleDocsFromFunctions(functions: BuiltinNormalExpressions): Record<string, FunctionDocs> {\n  return Object.fromEntries(\n    Object.entries(functions).map(([k, v]) => {\n      if (!v.docs)\n        throw new Error(`Missing docs for function \"${k}\"`)\n      return [k, v.docs]\n    }),\n  )\n}\n"],"names":["getCodeMarker","sourceCodeInfo","position","code","leftPadding","column","rightPadding","length","repeat","Math","max","DvalaError","Error","shortMessage","constructor","err","message","super","location","line","filePath","getDvalaErrorMessage","this","Object","setPrototypeOf","prototype","name","NodeTypes","Number","String","NormalExpression","SpecialExpression","UserDefinedSymbol","NormalBuiltinSymbol","SpecialBuiltinSymbol","ReservedSymbol","Binding","Spread","NodeTypesSet","Set","values","functionTypeSet","isDvalaFunction","func","type","functionType","has","isNode","value","Array","isArray","valueToString","keys","find","key","RegExp","toString","JSON","stringify","assertNumber","options","isNaN","integer","isInteger","finite","isFinite","zero","nonZero","positive","negative","nonPositive","nonNegative","gt","gte","lt","lte","isNumber","sign","getSignString","numberType","range","getRangeString","filter","x","join","getNumberTypeName","anyValue","getSourceCodeInfo","toFixedArity","arity","min","angleUnits","baseUnit","description","units","deg","PI","rad","grad","turn","celsiusTo","unit","toCelsius","temperatureUnits","unitDescriptions","angstrom","um","mm","cm","m","km","in","ft","yd","mi","nmi","mg","g","kg","t","oz","lb","st","ml","cl","dl","l","tsp","tbsp","cup","pt","qt","gal","ms","s","h","day","week","mm2","cm2","m2","km2","in2","ft2","yd2","acre","hectare","mph","kn","b","kb","mb","gb","tb","pb","pa","kpa","bar","atm","psi","mmhg","j","kj","cal","kcal","wh","kwh","btu","w","kw","mw","hp","hz","khz","mhz","ghz","c","f","k","generateLinearConversions","category","result","unitNames","from","to","conversionFactor","fnName","fromDesc","toDesc","seeAlso","u","map","evaluate","docs","returns","args","variants","argumentNames","examples","convertFunctions","celsius","generateTemperatureConversions","convertModule","functions","source","fromEntries","entries","v"],"mappings":"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"}

package/dist/modules/convert.js

@@ -1,2 +0,0 @@
-"use strict";function e(e){if(!e.position||!e.code)return"";const t=e.position.column-1,n=e.code.length-t-1;return`${" ".repeat(Math.max(t,0))}^${" ".repeat(Math.max(n,0))}`}class t extends Error{sourceCodeInfo;shortMessage;constructor(n,r){const s=n instanceof Error?n.message:`${n}`;super(function(t,n){if(!n)return t;const r=`${n.position.line}:${n.position.column}`;return`${t}${n.filePath?`\n${n.filePath}:${r}`:`\nLocation ${r}`}\n${n.code}\n${e(n)}`}(s,r)),this.shortMessage=s,this.sourceCodeInfo=r,Object.setPrototypeOf(this,t.prototype),this.name="DvalaError"}getCodeMarker(){return this.sourceCodeInfo&&e(this.sourceCodeInfo)}}const n={Number:1,String:2,NormalExpression:3,SpecialExpression:4,UserDefinedSymbol:5,NormalBuiltinSymbol:6,SpecialBuiltinSymbol:7,ReservedSymbol:8,Binding:9,Spread:10},r=new Set(Object.values(n));const s=new Set(["UserDefined","Partial","Comp","Constantly","Juxt","Complement","EveryPred","SomePred","Fnull","EffectMatcher","Builtin","SpecialBuiltin","Module"]);function o(e){return null!==e&&"object"==typeof e&&("^^fn^^"in e&&"functionType"in e&&("string"==typeof(t=e.functionType)&&s.has(t)));var t}function i(e){return!(!Array.isArray(e)||e.length<2)&&("number"==typeof(t=e[0])&&r.has(t));var t}function a(e){return o(e)?`<function ${e.name||"λ"}>`:i(e)?`${t=e[0],Object.keys(n).find(e=>n[e]===t)}-node`:null===e?"null":"object"==typeof e&&e instanceof RegExp?`${e}`:"object"==typeof e&&e instanceof Error?e.toString():JSON.stringify(e);var t}function u(e,n,r={}){if(!function(e,t={}){return!("number"!=typeof e||Number.isNaN(e)||t.integer&&!Number.isInteger(e)||t.finite&&!Number.isFinite(e)||t.zero&&0!==e||t.nonZero&&0===e||t.positive&&e<=0||t.negative&&e>=0||t.nonPositive&&e>0||t.nonNegative&&e<0||"number"==typeof t.gt&&e<=t.gt||"number"==typeof t.gte&&e<t.gte||"number"==typeof t.lt&&e>=t.lt||"number"==typeof t.lte&&e>t.lte)}(e,r))throw new t(`Expected ${function(e){if(e.zero)return"zero";const t=function(e){return e.positive?"positive":e.negative?"negative":e.nonNegative?"non negative":e.nonPositive?"non positive":e.nonZero?"non zero":""}(e),n=e.integer?"integer":"number",r=e.finite?"finite":"",s=function(e){return"number"!=typeof e.gt&&"number"!=typeof e.gte||"number"!=typeof e.lt&&"number"!=typeof e.lte?"number"==typeof e.gt||"number"==typeof e.gte?"number"==typeof e.gt?`n > ${e.gt}`:`n >= ${e.gte}`:"number"==typeof e.lt||"number"==typeof e.lte?"number"==typeof e.lt?`n < ${e.lt}`:`n <= ${e.lte}`:"":`${"number"==typeof e.gt?`${e.gt} < n `:`${e.gte} <= n `}${"number"==typeof e.lt?`< ${e.lt}`:`<= ${e.lte}`}`}(e);return[t,r,n,s].filter(e=>!!e).join(" ")}(r)}, got ${a(e)}.`,function(e,t){return e?.sourceCodeInfo??t}(e,n))}function c(e){return{min:e,max:e}}const m={baseUnit:"rad",description:"angle",units:{deg:Math.PI/180,rad:1,grad:Math.PI/200,turn:2*Math.PI}};function l(e,t){switch(e){case"c":return t;case"f":return 9*t/5+32;case"k":return t+273.15}}function p(e,t){switch(e){case"c":return t;case"f":return 5*(t-32)/9;case"k":return t-273.15}}const f=["c","f","k"],g={angstrom:"ångströms",um:"micrometers",mm:"millimeters",cm:"centimeters",m:"meters",km:"kilometers",in:"inches",ft:"feet",yd:"yards",mi:"miles",nmi:"nautical miles",mg:"milligrams",g:"grams",kg:"kilograms",t:"metric tons",oz:"ounces",lb:"pounds",st:"stones",ml:"milliliters",cl:"centiliters",dl:"deciliters",l:"liters",tsp:"teaspoons",tbsp:"tablespoons","fl-oz":"fluid ounces",cup:"cups",pt:"pints",qt:"quarts",gal:"gallons",ms:"milliseconds",s:"seconds",min:"minutes",h:"hours",day:"days",week:"weeks",mm2:"square millimeters",cm2:"square centimeters",m2:"square meters",km2:"square kilometers",in2:"square inches",ft2:"square feet",yd2:"square yards",acre:"acres",hectare:"hectares","m/s":"meters per second","km/h":"kilometers per hour",mph:"miles per hour",kn:"knots","ft/s":"feet per second",b:"bytes",kb:"kilobytes",mb:"megabytes",gb:"gigabytes",tb:"terabytes",pb:"petabytes",pa:"pascals",kpa:"kilopascals",bar:"bars",atm:"atmospheres",psi:"pounds per square inch",mmhg:"millimeters of mercury",j:"joules",kj:"kilojoules",cal:"calories",kcal:"kilocalories",wh:"watt-hours",kwh:"kilowatt-hours",btu:"British thermal units",w:"watts",kw:"kilowatts",mw:"megawatts",hp:"horsepower",hz:"hertz",khz:"kilohertz",mhz:"megahertz",ghz:"gigahertz",deg:"degrees",rad:"radians",grad:"gradians",turn:"turns",c:"Celsius",f:"Fahrenheit",k:"Kelvin"};function b(e){const t={},n=Object.keys(e.units);for(const r of n)for(const s of n){if(r===s)continue;const o=e.units[r]/e.units[s],i=`${r}->${s}`,a=g[r],m=g[s],l=[`convert.${s}->${r}`,...n.filter(e=>e!==r&&e!==s).map(e=>`convert.${r}->${e}`)];t[i]={evaluate:([e],t)=>(u(e,t),e*o),arity:c(1),docs:{category:"convert",returns:{type:"number"},args:{value:{type:"number",description:`Value in ${a}`}},variants:[{argumentNames:["value"]}],description:`Converts a value from ${a} (\`${r}\`) to ${m} (\`${s}\`).`,seeAlso:l,examples:[`let { ${i} } = import(convert);\n${i}(1)`]}}}return t}const d={...b({baseUnit:"m",description:"length",units:{angstrom:1e-10,um:1e-6,mm:.001,cm:.01,m:1,km:1e3,in:.0254,ft:.3048,yd:.9144,mi:1609.344,nmi:1852}}),...b({baseUnit:"kg",description:"weight",units:{mg:1e-6,g:.001,kg:1,t:1e3,oz:.028349523125,lb:.45359237,st:6.35029318}}),...b({baseUnit:"l",description:"volume",units:{ml:.001,cl:.01,dl:.1,l:1,tsp:.00492892159375,tbsp:.01478676478125,"fl-oz":.0295735295625,cup:.2365882365,pt:.473176473,qt:.946352946,gal:3.785411784}}),...b({baseUnit:"s",description:"time",units:{ms:.001,s:1,min:60,h:3600,day:86400,week:604800}}),...b({baseUnit:"m2",description:"area",units:{mm2:1e-6,cm2:1e-4,m2:1,km2:1e6,in2:64516e-8,ft2:.09290304,yd2:.83612736,acre:4046.8564224,hectare:1e4}}),...b({baseUnit:"m/s",description:"speed",units:{"m/s":1,"km/h":1/3.6,mph:.44704,kn:.514444,"ft/s":.3048}}),...b({baseUnit:"b",description:"data",units:{b:1,kb:1e3,mb:1e6,gb:1e9,tb:1e12,pb:1e15}}),...b({baseUnit:"pa",description:"pressure",units:{pa:1,kpa:1e3,bar:1e5,atm:101325,psi:6894.757293168,mmhg:133.322387415}}),...b({baseUnit:"j",description:"energy",units:{j:1,kj:1e3,cal:4.184,kcal:4184,wh:3600,kwh:36e5,btu:1055.06}}),...b({baseUnit:"w",description:"power",units:{w:1,kw:1e3,mw:1e6,hp:745.7}}),...b({baseUnit:"hz",description:"frequency",units:{hz:1,khz:1e3,mhz:1e6,ghz:1e9}}),...b(m),...function(){const e={};for(const t of f)for(const n of f){if(t===n)continue;const r=`${t}->${n}`,s=g[t],o=g[n],i=[`convert.${n}->${t}`,...f.filter(e=>e!==t&&e!==n).map(e=>`convert.${t}->${e}`)];e[r]={evaluate:([e],r)=>{u(e,r);const s=p(t,e);return l(n,s)},arity:c(1),docs:{category:"convert",returns:{type:"number"},args:{value:{type:"number",description:`Value in ${s}`}},variants:[{argumentNames:["value"]}],description:`Converts a temperature from ${s} (\`${t}\`) to ${o} (\`${n}\`).`,seeAlso:i,examples:[`let { ${r} } = import(convert);\n${r}(100)`]}}}return e}()},h={name:"convert",functions:d,source:"{}",docs:(y=d,Object.fromEntries(Object.entries(y).map(([e,t])=>{if(!t.docs)throw new Error(`Missing docs for function "${e}"`);return[e,t.docs]})))};var y;exports.convertModule=h;
-//# sourceMappingURL=convert.js.map

package/dist/modules/convert.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"convert.js","sources":["../../src/utils/debug/getCodeMarker.ts","../../src/errors.ts","../../src/constants/constants.ts","../../src/utils/debug/debugTools.ts","../../src/utils/symbols.ts","../../src/typeGuards/number.ts","../../src/utils/debug/getSourceCodeInfo.ts","../../src/utils/arity.ts","../../src/builtin/modules/convert/index.ts","../../src/builtin/modules/convert/convert.dvala","../../src/builtin/modules/interface.ts"],"sourcesContent":["import type { SourceCodeInfo } from '../../tokenizer/token'\n\nexport function getCodeMarker(sourceCodeInfo: SourceCodeInfo): string {\n  if (!sourceCodeInfo.position || !sourceCodeInfo.code)\n    return ''\n\n  const leftPadding = sourceCodeInfo.position.column - 1\n  const rightPadding = sourceCodeInfo.code.length - leftPadding - 1\n  return `${' '.repeat(Math.max(leftPadding, 0))}^${' '.repeat(Math.max(rightPadding, 0))}`\n}\n","import { getCodeMarker } from '../src/utils/debug/getCodeMarker'\nimport type { Arr } from './interface'\nimport type { SourceCodeInfo } from './tokenizer/token'\n\nfunction getDvalaErrorMessage(message: string, sourceCodeInfo?: SourceCodeInfo) {\n  if (!sourceCodeInfo) {\n    return message\n  }\n  const location = `${sourceCodeInfo.position.line}:${sourceCodeInfo.position.column}`\n  const filePathLine = sourceCodeInfo.filePath\n    ? `\\n${sourceCodeInfo.filePath}:${location}`\n    : `\\nLocation ${location}`\n  const codeLine = `\\n${sourceCodeInfo.code}`\n  const codeMarker = `\\n${getCodeMarker(sourceCodeInfo)}`\n  return `${message}${filePathLine}${codeLine}${codeMarker}`\n}\n\nexport class RecurSignal extends Error {\n  public params: Arr\n  constructor(params: Arr) {\n    super(`recur, params: ${params}`)\n    Object.setPrototypeOf(this, RecurSignal.prototype)\n    this.name = 'RecurSignal'\n    this.params = params\n  }\n}\n\nexport class DvalaError extends Error {\n  public readonly sourceCodeInfo?: SourceCodeInfo\n  public readonly shortMessage: string\n  constructor(err: unknown, sourceCodeInfo: SourceCodeInfo | undefined) {\n    const message = err instanceof Error\n      ? err.message\n      : `${err}`\n\n    super(getDvalaErrorMessage(message, sourceCodeInfo))\n    this.shortMessage = message\n    this.sourceCodeInfo = sourceCodeInfo\n    Object.setPrototypeOf(this, DvalaError.prototype)\n    this.name = 'DvalaError'\n  }\n\n  public getCodeMarker(): string | undefined {\n    return this.sourceCodeInfo && getCodeMarker(this.sourceCodeInfo)\n  }\n}\n\nexport class UserDefinedError extends DvalaError {\n  public userMessage: string\n  constructor(message: string, sourceCodeInfo?: SourceCodeInfo) {\n    super(message, sourceCodeInfo)\n    this.userMessage = message\n    Object.setPrototypeOf(this, UserDefinedError.prototype)\n    this.name = 'UserDefinedError'\n  }\n}\n\nexport class AssertionError extends DvalaError {\n  constructor(message: string | Error, sourceCodeInfo?: SourceCodeInfo) {\n    super(message, sourceCodeInfo)\n    Object.setPrototypeOf(this, AssertionError.prototype)\n    this.name = 'AssertionError'\n  }\n}\n\nexport class UndefinedSymbolError extends DvalaError {\n  public symbol: string\n  constructor(symbolName: string, sourceCodeInfo?: SourceCodeInfo) {\n    const message = `Undefined symbol '${symbolName}'.`\n    super(message, sourceCodeInfo)\n    this.symbol = symbolName\n    Object.setPrototypeOf(this, UndefinedSymbolError.prototype)\n    this.name = 'UndefinedSymbolError'\n  }\n}\n\nexport function isDvalaError(error: unknown): error is DvalaError {\n  return error instanceof DvalaError\n}\n","export const NodeTypes = {\n  Number: 1,\n  String: 2,\n  NormalExpression: 3,\n  SpecialExpression: 4,\n  UserDefinedSymbol: 5,\n  NormalBuiltinSymbol: 6,\n  SpecialBuiltinSymbol: 7,\n  ReservedSymbol: 8,\n  Binding: 9,\n  Spread: 10,\n} as const\n\nconst NodeTypesSet = new Set(Object.values(NodeTypes))\n\nexport type NodeType = typeof NodeTypes[keyof typeof NodeTypes]\n\nexport function getNodeTypeName(type: NodeType): keyof typeof NodeTypes {\n  return Object.keys(NodeTypes).find(key => NodeTypes[key as keyof typeof NodeTypes] === type) as keyof typeof NodeTypes\n}\n\n// TODO, is this needed?\nexport function isNodeType(type: unknown): type is NodeType {\n  return typeof type === 'number' && NodeTypesSet.has(type as NodeType)\n}\n\nconst functionTypes = [\n  'UserDefined',\n  'Partial',\n  'Comp',\n  'Constantly',\n  'Juxt',\n  'Complement',\n  'EveryPred',\n  'SomePred',\n  'Fnull',\n  'EffectMatcher',\n  'Builtin',\n  'SpecialBuiltin',\n  'Module',\n] as const\n\nconst functionTypeSet = new Set(functionTypes)\n\nexport type FunctionType = typeof functionTypes[number]\n\nexport function isFunctionType(type: unknown): type is FunctionType {\n  return typeof type === 'string' && functionTypeSet.has(type as FunctionType)\n}\n","import { getNodeTypeName, isFunctionType, isNodeType } from '../../constants/constants'\nimport type { AstNode, DvalaFunction } from '../../parser/types'\nimport { FUNCTION_SYMBOL } from '../symbols'\n\nfunction isDvalaFunction(func: unknown): func is DvalaFunction {\n  if (func === null || typeof func !== 'object')\n    return false\n\n  return FUNCTION_SYMBOL in func && 'functionType' in func && isFunctionType(func.functionType)\n}\n\nfunction isNode(value: unknown): value is AstNode {\n  if (!Array.isArray(value) || value.length < 2)\n    return false\n  return isNodeType(value[0])\n}\n\nexport function valueToString(value: unknown): string {\n  if (isDvalaFunction(value))\n    // eslint-disable-next-line ts/no-unsafe-member-access\n    return `<function ${(value as any).name || '\\u03BB'}>`\n\n  if (isNode(value))\n    return `${getNodeTypeName(value[0])}-node`\n\n  if (value === null)\n    return 'null'\n\n  if (typeof value === 'object' && value instanceof RegExp)\n    return `${value}`\n\n  if (typeof value === 'object' && value instanceof Error)\n    return value.toString()\n\n  return JSON.stringify(value)\n}\n","export const FUNCTION_SYMBOL = '^^fn^^'\nexport const REGEXP_SYMBOL = '^^re^^'\nexport const EFFECT_SYMBOL = '^^ef^^'\n","import { DvalaError } from '../errors'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { valueToString } from '../utils/debug/debugTools'\nimport { getSourceCodeInfo } from '../utils/debug/getSourceCodeInfo'\n\ntype SignOptions =\n  | {\n    positive?: true\n    negative?: never\n    nonPositive?: never\n    nonNegative?: never\n    zero?: never\n    nonZero?: never\n  }\n  | {\n    positive?: never\n    negative?: true\n    nonPositive?: never\n    nonNegative?: never\n    zero?: never\n    nonZero?: never\n  }\n  | {\n    positive?: never\n    negative?: never\n    nonPositive?: true\n    nonNegative?: never\n    zero?: never\n    nonZero?: never\n  }\n  | {\n    positive?: never\n    negative?: never\n    nonPositive?: never\n    nonNegative?: true\n    zero?: never\n    nonZero?: never\n  }\n  | {\n    positive?: never\n    negative?: never\n    nonPositive?: never\n    nonNegative?: never\n    zero?: true\n    nonZero?: never\n  }\n  | {\n    positive?: never\n    negative?: never\n    nonPositive?: never\n    nonNegative?: never\n    zero?: never\n    nonZero?: true\n  }\n\ntype GtOptions =\n  | {\n    gt?: number\n    gte?: never\n  }\n  | {\n    gt?: never\n    gte?: number\n  }\n\ntype LtOptions =\n  | {\n    lt?: number\n    lte?: never\n  }\n  | {\n    lt?: never\n    lte?: number\n  }\n\ntype NumberOptions = {\n  integer?: true\n  finite?: true\n} & SignOptions &\nGtOptions &\nLtOptions\n\nfunction getRangeString(options: NumberOptions): string {\n  const hasUpperAndLowerBound\n    = (typeof options.gt === 'number' || typeof options.gte === 'number')\n      && (typeof options.lt === 'number' || typeof options.lte === 'number')\n  if (hasUpperAndLowerBound) {\n    return `${typeof options.gt === 'number' ? `${options.gt} < n ` : `${options.gte} <= n `}${\n      typeof options.lt === 'number' ? `< ${options.lt}` : `<= ${options.lte}`\n    }`\n  }\n  else if (typeof options.gt === 'number' || typeof options.gte === 'number') {\n    return `${typeof options.gt === 'number' ? `n > ${options.gt}` : `n >= ${options.gte}`}`\n  }\n  else if (typeof options.lt === 'number' || typeof options.lte === 'number') {\n    return `${typeof options.lt === 'number' ? `n < ${options.lt}` : `n <= ${options.lte}`}`\n  }\n  else { return '' }\n}\n\nfunction getSignString(options: NumberOptions): string {\n  return options.positive\n    ? 'positive'\n    : options.negative\n      ? 'negative'\n      : options.nonNegative\n        ? 'non negative'\n        : options.nonPositive\n          ? 'non positive'\n          : options.nonZero\n            ? 'non zero'\n            : ''\n}\n\nfunction getNumberTypeName(options: NumberOptions): string {\n  if (options.zero)\n    return 'zero'\n\n  const sign = getSignString(options)\n  const numberType = options.integer ? 'integer' : 'number'\n  const finite = options.finite ? 'finite' : ''\n  const range = getRangeString(options)\n\n  return [sign, finite, numberType, range].filter(x => !!x).join(' ')\n}\n\nexport function isNumber(value: unknown, options: NumberOptions = {}): value is number {\n  if (typeof value !== 'number')\n    return false\n\n  if (Number.isNaN(value))\n    return false\n\n  if (options.integer && !Number.isInteger(value))\n    return false\n\n  if (options.finite && !Number.isFinite(value))\n    return false\n\n  if (options.zero && value !== 0)\n    return false\n\n  if (options.nonZero && value === 0)\n    return false\n\n  if (options.positive && value <= 0)\n    return false\n\n  if (options.negative && value >= 0)\n    return false\n\n  if (options.nonPositive && value > 0)\n    return false\n\n  if (options.nonNegative && value < 0)\n    return false\n\n  if (typeof options.gt === 'number' && value <= options.gt)\n    return false\n\n  if (typeof options.gte === 'number' && value < options.gte)\n    return false\n\n  if (typeof options.lt === 'number' && value >= options.lt)\n    return false\n\n  if (typeof options.lte === 'number' && value > options.lte)\n    return false\n\n  return true\n}\n\nexport function assertNumber(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n  options: NumberOptions = {},\n): asserts value is number {\n  if (!isNumber(value, options)) {\n    throw new DvalaError(\n      `Expected ${getNumberTypeName(options)}, got ${valueToString(value)}.`,\n      getSourceCodeInfo(value, sourceCodeInfo),\n    )\n  }\n}\n\nexport function asNumber(\n  value: unknown,\n  sourceCodeInfo: SourceCodeInfo | undefined,\n  options: NumberOptions = {},\n): number {\n  assertNumber(value, sourceCodeInfo, options)\n  return value\n}\n","import type { SourceCodeInfo } from '../../tokenizer/token'\n\nexport function getSourceCodeInfo(anyValue: any, sourceCodeInfo: SourceCodeInfo | undefined): SourceCodeInfo | undefined {\n  // eslint-disable-next-line ts/no-unsafe-return, ts/no-unsafe-member-access\n  return anyValue?.sourceCodeInfo ?? sourceCodeInfo\n}\n","import type { Arity } from '../builtin/interface'\nimport { DvalaError } from '../errors'\nimport type { FunctionLike } from '../parser/types'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { isColl } from '../typeGuards/dvala'\nimport { valueToString } from './debug/debugTools'\n\nexport function arityAccepts(arity: Arity, nbrOfParams: number): boolean {\n  const { min, max } = arity\n  if (typeof min === 'number' && nbrOfParams < min) {\n    return false\n  }\n  if (typeof max === 'number' && nbrOfParams > max) {\n    return false\n  }\n  return true\n}\n\nexport function arityAcceptsMin(arity: Arity, nbrOfParams: number): boolean {\n  const { min } = arity\n  if (typeof min === 'number' && nbrOfParams < min) {\n    return false\n  }\n  return true\n}\n\nexport function getCommonArityFromFunctions(params: FunctionLike[]): Arity | null {\n  return params.reduce((acc: Arity | null, param): Arity | null => {\n    if (acc === null) {\n      return null\n    }\n    const arity: Arity = (typeof param === 'number' || isColl(param)) ? toFixedArity(1) : param.arity\n    const { min: aMin, max: aMax } = arity\n    const { min: bMin, max: bMax } = acc\n    const min = typeof aMin === 'number' && typeof bMin === 'number'\n      ? Math.max(aMin, bMin)\n      : typeof aMin === 'number' ? aMin : typeof bMin === 'number' ? bMin : undefined\n    const max = typeof aMax === 'number' && typeof bMax === 'number'\n      ? Math.min(aMax, bMax)\n      : typeof aMax === 'number' ? aMax : typeof bMax === 'number' ? bMax : undefined\n\n    if (typeof min === 'number' && typeof max === 'number' && min > max) {\n      return null\n    }\n\n    return { min, max }\n  }, {})\n}\n\nexport function getArityFromFunction(param: FunctionLike): Arity {\n  return (typeof param === 'number' || isColl(param)) ? toFixedArity(1) : param.arity\n}\n\nexport function assertNumberOfParams(arity: Arity, length: number, sourceCodeInfo: SourceCodeInfo | undefined): void {\n  const { min, max } = arity\n  if (typeof min === 'number' && length < min) {\n    throw new DvalaError(\n      `Wrong number of arguments, expected at least ${min}, got ${valueToString(length)}.`,\n      sourceCodeInfo,\n    )\n  }\n\n  if (typeof max === 'number' && length > max) {\n    throw new DvalaError(\n      `Wrong number of arguments, expected at most ${max}, got ${valueToString(length)}.`,\n      sourceCodeInfo,\n    )\n  }\n}\n\nexport function canBeOperator(count: Arity): boolean {\n  if (typeof count.max === 'number' && count.max < 2) {\n    return false\n  }\n\n  if (typeof count.min === 'number' && count.min > 2) {\n    return false\n  }\n\n  return true\n}\n\nexport function toFixedArity(arity: number): Arity {\n  return { min: arity, max: arity }\n}\n","import { assertNumber } from '../../../typeGuards/number'\nimport { toFixedArity } from '../../../utils/arity'\nimport type { BuiltinNormalExpressions } from '../../interface'\nimport { moduleDocsFromFunctions } from '../interface'\nimport type { DvalaModule } from '../interface'\nimport convertModuleSource from './convert.dvala'\n\n// --- Conversion factor tables ---\n// Each category maps unit abbreviations to a factor relative to a base unit.\n// To convert from unit A to unit B: value * (factorA / factorB)\n// Temperature is special-cased (non-linear).\n\ninterface UnitCategory {\n  baseUnit: string\n  units: Record<string, number>\n  description: string\n}\n\nconst lengthUnits: UnitCategory = {\n  baseUnit: 'm',\n  description: 'length',\n  units: {\n    angstrom: 1e-10,\n    um: 0.000001,\n    mm: 0.001,\n    cm: 0.01,\n    m: 1,\n    km: 1000,\n    in: 0.0254,\n    ft: 0.3048,\n    yd: 0.9144,\n    mi: 1609.344,\n    nmi: 1852,\n  },\n}\n\nconst weightUnits: UnitCategory = {\n  baseUnit: 'kg',\n  description: 'weight',\n  units: {\n    mg: 0.000001,\n    g: 0.001,\n    kg: 1,\n    t: 1000,\n    oz: 0.028349523125,\n    lb: 0.45359237,\n    st: 6.35029318,\n  },\n}\n\nconst volumeUnits: UnitCategory = {\n  baseUnit: 'l',\n  description: 'volume',\n  units: {\n    'ml': 0.001,\n    'cl': 0.01,\n    'dl': 0.1,\n    'l': 1,\n    'tsp': 0.00492892159375,\n    'tbsp': 0.01478676478125,\n    'fl-oz': 0.0295735295625,\n    'cup': 0.2365882365,\n    'pt': 0.473176473,\n    'qt': 0.946352946,\n    'gal': 3.785411784,\n  },\n}\n\nconst timeUnits: UnitCategory = {\n  baseUnit: 's',\n  description: 'time',\n  units: {\n    ms: 0.001,\n    s: 1,\n    min: 60,\n    h: 3600,\n    day: 86400,\n    week: 604800,\n  },\n}\n\nconst areaUnits: UnitCategory = {\n  baseUnit: 'm2',\n  description: 'area',\n  units: {\n    mm2: 0.000001,\n    cm2: 0.0001,\n    m2: 1,\n    km2: 1000000,\n    in2: 0.00064516,\n    ft2: 0.09290304,\n    yd2: 0.83612736,\n    acre: 4046.8564224,\n    hectare: 10000,\n  },\n}\n\nconst speedUnits: UnitCategory = {\n  baseUnit: 'm/s',\n  description: 'speed',\n  units: {\n    'm/s': 1,\n    'km/h': 1 / 3.6,\n    'mph': 0.44704,\n    'kn': 0.514444,\n    'ft/s': 0.3048,\n  },\n}\n\nconst dataUnits: UnitCategory = {\n  baseUnit: 'b',\n  description: 'data',\n  units: {\n    b: 1,\n    kb: 1000,\n    mb: 1000000,\n    gb: 1e9,\n    tb: 1e12,\n    pb: 1e15,\n  },\n}\n\nconst pressureUnits: UnitCategory = {\n  baseUnit: 'pa',\n  description: 'pressure',\n  units: {\n    pa: 1,\n    kpa: 1000,\n    bar: 100000,\n    atm: 101325,\n    psi: 6894.757293168,\n    mmhg: 133.322387415,\n  },\n}\n\nconst energyUnits: UnitCategory = {\n  baseUnit: 'j',\n  description: 'energy',\n  units: {\n    j: 1,\n    kj: 1000,\n    cal: 4.184,\n    kcal: 4184,\n    wh: 3600,\n    kwh: 3600000,\n    btu: 1055.06,\n  },\n}\n\nconst powerUnits: UnitCategory = {\n  baseUnit: 'w',\n  description: 'power',\n  units: {\n    w: 1,\n    kw: 1000,\n    mw: 1000000,\n    hp: 745.7,\n  },\n}\n\nconst frequencyUnits: UnitCategory = {\n  baseUnit: 'hz',\n  description: 'frequency',\n  units: {\n    hz: 1,\n    khz: 1000,\n    mhz: 1000000,\n    ghz: 1000000000,\n  },\n}\n\nconst angleUnits: UnitCategory = {\n  baseUnit: 'rad',\n  description: 'angle',\n  units: {\n    deg: Math.PI / 180,\n    rad: 1,\n    grad: Math.PI / 200,\n    turn: 2 * Math.PI,\n  },\n}\n\n// --- Temperature conversion functions ---\n\nfunction celsiusTo(unit: 'c' | 'f' | 'k', value: number): number {\n  switch (unit) {\n    case 'c': return value\n    case 'f': return value * 9 / 5 + 32\n    case 'k': return value + 273.15\n  }\n}\n\nfunction toCelsius(unit: 'c' | 'f' | 'k', value: number): number {\n  switch (unit) {\n    case 'c': return value\n    case 'f': return (value - 32) * 5 / 9\n    case 'k': return value - 273.15\n  }\n}\n\nconst temperatureUnits = ['c', 'f', 'k'] as const\n\nconst unitDescriptions: Record<string, string> = {\n  // Length\n  'angstrom': 'ångströms',\n  'um': 'micrometers',\n  'mm': 'millimeters',\n  'cm': 'centimeters',\n  'm': 'meters',\n  'km': 'kilometers',\n  'in': 'inches',\n  'ft': 'feet',\n  'yd': 'yards',\n  'mi': 'miles',\n  'nmi': 'nautical miles',\n  // Weight\n  'mg': 'milligrams',\n  'g': 'grams',\n  'kg': 'kilograms',\n  't': 'metric tons',\n  'oz': 'ounces',\n  'lb': 'pounds',\n  'st': 'stones',\n  // Volume\n  'ml': 'milliliters',\n  'cl': 'centiliters',\n  'dl': 'deciliters',\n  'l': 'liters',\n  'tsp': 'teaspoons',\n  'tbsp': 'tablespoons',\n  'fl-oz': 'fluid ounces',\n  'cup': 'cups',\n  'pt': 'pints',\n  'qt': 'quarts',\n  'gal': 'gallons',\n  // Time\n  'ms': 'milliseconds',\n  's': 'seconds',\n  'min': 'minutes',\n  'h': 'hours',\n  'day': 'days',\n  'week': 'weeks',\n  // Area\n  'mm2': 'square millimeters',\n  'cm2': 'square centimeters',\n  'm2': 'square meters',\n  'km2': 'square kilometers',\n  'in2': 'square inches',\n  'ft2': 'square feet',\n  'yd2': 'square yards',\n  'acre': 'acres',\n  'hectare': 'hectares',\n  // Speed\n  'm/s': 'meters per second',\n  'km/h': 'kilometers per hour',\n  'mph': 'miles per hour',\n  'kn': 'knots',\n  'ft/s': 'feet per second',\n  // Data\n  'b': 'bytes',\n  'kb': 'kilobytes',\n  'mb': 'megabytes',\n  'gb': 'gigabytes',\n  'tb': 'terabytes',\n  'pb': 'petabytes',\n  // Pressure\n  'pa': 'pascals',\n  'kpa': 'kilopascals',\n  'bar': 'bars',\n  'atm': 'atmospheres',\n  'psi': 'pounds per square inch',\n  'mmhg': 'millimeters of mercury',\n  // Energy\n  'j': 'joules',\n  'kj': 'kilojoules',\n  'cal': 'calories',\n  'kcal': 'kilocalories',\n  'wh': 'watt-hours',\n  'kwh': 'kilowatt-hours',\n  'btu': 'British thermal units',\n  // Power\n  'w': 'watts',\n  'kw': 'kilowatts',\n  'mw': 'megawatts',\n  'hp': 'horsepower',\n  // Frequency\n  'hz': 'hertz',\n  'khz': 'kilohertz',\n  'mhz': 'megahertz',\n  'ghz': 'gigahertz',\n  // Angle\n  'deg': 'degrees',\n  'rad': 'radians',\n  'grad': 'gradians',\n  'turn': 'turns',\n  // Temperature\n  'c': 'Celsius',\n  'f': 'Fahrenheit',\n  'k': 'Kelvin',\n}\n\n// --- Generate linear conversion functions ---\n\nfunction generateLinearConversions(category: UnitCategory): BuiltinNormalExpressions {\n  const result: BuiltinNormalExpressions = {}\n  const unitNames = Object.keys(category.units)\n\n  for (const from of unitNames) {\n    for (const to of unitNames) {\n      if (from === to)\n        continue\n\n      const fromFactor = category.units[from]!\n      const toFactor = category.units[to]!\n      const conversionFactor = fromFactor / toFactor\n      const fnName = `${from}->${to}`\n      const fromDesc = unitDescriptions[from]!\n      const toDesc = unitDescriptions[to]!\n\n      const seeAlso = [\n        `convert.${to}->${from}`,\n        ...unitNames\n          .filter(u => u !== from && u !== to)\n          .map(u => `convert.${from}->${u}`),\n      ]\n\n      result[fnName] = {\n        evaluate: ([value], sourceCodeInfo): number => {\n          assertNumber(value, sourceCodeInfo)\n          return value * conversionFactor\n        },\n        arity: toFixedArity(1),\n        docs: {\n          category: 'convert',\n          returns: { type: 'number' },\n          args: {\n            value: { type: 'number', description: `Value in ${fromDesc}` },\n          },\n          variants: [{ argumentNames: ['value'] }],\n          description: `Converts a value from ${fromDesc} (\\`${from}\\`) to ${toDesc} (\\`${to}\\`).`,\n          seeAlso,\n          examples: [\n            `let { ${fnName} } = import(convert);\n${fnName}(1)`,\n          ],\n        },\n      }\n    }\n  }\n  return result\n}\n\n// --- Generate temperature conversion functions ---\n\nfunction generateTemperatureConversions(): BuiltinNormalExpressions {\n  const result: BuiltinNormalExpressions = {}\n\n  for (const from of temperatureUnits) {\n    for (const to of temperatureUnits) {\n      if (from === to)\n        continue\n\n      const fnName = `${from}->${to}`\n      const fromDesc = unitDescriptions[from]!\n      const toDesc = unitDescriptions[to]!\n\n      const seeAlso = [\n        `convert.${to}->${from}`,\n        ...temperatureUnits\n          .filter(u => u !== from && u !== to)\n          .map(u => `convert.${from}->${u}`),\n      ]\n\n      result[fnName] = {\n        evaluate: ([value], sourceCodeInfo): number => {\n          assertNumber(value, sourceCodeInfo)\n          const celsius = toCelsius(from, value)\n          return celsiusTo(to, celsius)\n        },\n        arity: toFixedArity(1),\n        docs: {\n          category: 'convert',\n          returns: { type: 'number' },\n          args: {\n            value: { type: 'number', description: `Value in ${fromDesc}` },\n          },\n          variants: [{ argumentNames: ['value'] }],\n          description: `Converts a temperature from ${fromDesc} (\\`${from}\\`) to ${toDesc} (\\`${to}\\`).`,\n          seeAlso,\n          examples: [\n            `let { ${fnName} } = import(convert);\n${fnName}(100)`,\n          ],\n        },\n      }\n    }\n  }\n  return result\n}\n\n// --- Assemble all conversion functions ---\n\nconst convertFunctions: BuiltinNormalExpressions = {\n  ...generateLinearConversions(lengthUnits),\n  ...generateLinearConversions(weightUnits),\n  ...generateLinearConversions(volumeUnits),\n  ...generateLinearConversions(timeUnits),\n  ...generateLinearConversions(areaUnits),\n  ...generateLinearConversions(speedUnits),\n  ...generateLinearConversions(dataUnits),\n  ...generateLinearConversions(pressureUnits),\n  ...generateLinearConversions(energyUnits),\n  ...generateLinearConversions(powerUnits),\n  ...generateLinearConversions(frequencyUnits),\n  ...generateLinearConversions(angleUnits),\n  ...generateTemperatureConversions(),\n}\n\nexport const convertModule: DvalaModule = {\n  name: 'convert',\n  functions: convertFunctions,\n  source: convertModuleSource,\n  docs: moduleDocsFromFunctions(convertFunctions),\n}\n","{}","import type { BuiltinNormalExpressions, FunctionDocs } from '../../builtin/interface'\n\n/**\n * Represents a Dvala module that can be imported dynamically.\n * Modules contain a collection of functions that are not part of the core bundle.\n */\nexport interface DvalaModule {\n  /** The name of the module (e.g., 'grid', 'vec', 'mat') */\n  name: string\n  /** The functions provided by this module, keyed by their short name (e.g., 'transpose') */\n  functions: BuiltinNormalExpressions\n  /**\n   * Optional Dvala source code that is evaluated at import time.\n   * The source must evaluate to an object mapping function names to functions.\n   * These are merged with (and may override) the TypeScript `functions`.\n   */\n  source?: string\n  /**\n   * Docs for all functions in this module, including any defined in `source`.\n   * The reference system uses this record as the sole source of truth for\n   * function names and documentation. Not required for user-defined modules.\n   */\n  docs?: Record<string, FunctionDocs>\n}\n\n/**\n * Derives a docs record from a BuiltinNormalExpressions map.\n * Use this for modules whose docs are co-located inline on each function.\n */\nexport function moduleDocsFromFunctions(functions: BuiltinNormalExpressions): Record<string, FunctionDocs> {\n  return Object.fromEntries(\n    Object.entries(functions).map(([k, v]) => {\n      if (!v.docs)\n        throw new Error(`Missing docs for function \"${k}\"`)\n      return [k, v.docs]\n    }),\n  )\n}\n"],"names":["getCodeMarker","sourceCodeInfo","position","code","leftPadding","column","rightPadding","length","repeat","Math","max","DvalaError","Error","shortMessage","constructor","err","message","super","location","line","filePath","getDvalaErrorMessage","this","Object","setPrototypeOf","prototype","name","NodeTypes","Number","String","NormalExpression","SpecialExpression","UserDefinedSymbol","NormalBuiltinSymbol","SpecialBuiltinSymbol","ReservedSymbol","Binding","Spread","NodeTypesSet","Set","values","functionTypeSet","isDvalaFunction","func","type","functionType","has","isNode","value","Array","isArray","valueToString","keys","find","key","RegExp","toString","JSON","stringify","assertNumber","options","isNaN","integer","isInteger","finite","isFinite","zero","nonZero","positive","negative","nonPositive","nonNegative","gt","gte","lt","lte","isNumber","sign","getSignString","numberType","range","getRangeString","filter","x","join","getNumberTypeName","anyValue","getSourceCodeInfo","toFixedArity","arity","min","angleUnits","baseUnit","description","units","deg","PI","rad","grad","turn","celsiusTo","unit","toCelsius","temperatureUnits","unitDescriptions","angstrom","um","mm","cm","m","km","in","ft","yd","mi","nmi","mg","g","kg","t","oz","lb","st","ml","cl","dl","l","tsp","tbsp","cup","pt","qt","gal","ms","s","h","day","week","mm2","cm2","m2","km2","in2","ft2","yd2","acre","hectare","mph","kn","b","kb","mb","gb","tb","pb","pa","kpa","bar","atm","psi","mmhg","j","kj","cal","kcal","wh","kwh","btu","w","kw","mw","hp","hz","khz","mhz","ghz","c","f","k","generateLinearConversions","category","result","unitNames","from","to","conversionFactor","fnName","fromDesc","toDesc","seeAlso","u","map","evaluate","docs","returns","args","variants","argumentNames","examples","convertFunctions","celsius","generateTemperatureConversions","convertModule","functions","source","fromEntries","entries","v"],"mappings":"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"}

package/dist/modules/functional.esm.js

@@ -1,2 +0,0 @@
-function n(n){if(!n.position||!n.code)return"";const e=n.position.column-1,t=n.code.length-e-1;return`${" ".repeat(Math.max(e,0))}^${" ".repeat(Math.max(t,0))}`}class e extends Error{sourceCodeInfo;shortMessage;constructor(t,r){const o=t instanceof Error?t.message:`${t}`;super(function(e,t){if(!t)return e;const r=`${t.position.line}:${t.position.column}`;return`${e}${t.filePath?`\n${t.filePath}:${r}`:`\nLocation ${r}`}\n${t.code}\n${n(t)}`}(o,r)),this.shortMessage=o,this.sourceCodeInfo=r,Object.setPrototypeOf(this,e.prototype),this.name="DvalaError"}getCodeMarker(){return this.sourceCodeInfo&&n(this.sourceCodeInfo)}}const t={Number:1,String:2,NormalExpression:3,SpecialExpression:4,UserDefinedSymbol:5,NormalBuiltinSymbol:6,SpecialBuiltinSymbol:7,ReservedSymbol:8,Binding:9,Spread:10},r=new Set(Object.values(t));const o=new Set(["UserDefined","Partial","Comp","Constantly","Juxt","Complement","EveryPred","SomePred","Fnull","EffectMatcher","Builtin","SpecialBuiltin","Module"]);const u="^^fn^^",a="^^re^^",i="^^ef^^";function s(n){return null!==n&&"object"==typeof n&&(u in n&&"functionType"in n&&("string"==typeof(e=n.functionType)&&o.has(e)));var e}function l(n){return!(!Array.isArray(n)||n.length<2)&&("number"==typeof(e=n[0])&&r.has(e));var e}function c(n){return s(n)?`<function ${n.name||"λ"}>`:l(n)?`${e=n[0],Object.keys(t).find(n=>t[n]===e)}-node`:null===n?"null":"object"==typeof n&&n instanceof RegExp?`${n}`:"object"==typeof n&&n instanceof Error?n.toString():JSON.stringify(n);var e}function f(n){return null!==n&&"object"==typeof n&&!!n[u]}function m(n){return!(null===n||"object"!=typeof n||Array.isArray(n)||n instanceof RegExp||f(n)||(e=n,null!==e&&"object"==typeof e&&e[a])||function(n){return null!==n&&"object"==typeof n&&!!n[i]}(n));var e}function p(n){return function(n){return Array.isArray(n)||"string"==typeof n}(n)||m(n)}function y(n,e){return d(n,e),n}function d(n,t){if(!function(n){return"number"==typeof n||!!p(n)||!!f(n)}(n))throw function(n,t,r){return new e(`Expected ${n}, got ${c(t)}.`,function(n,e){return n?.sourceCodeInfo??e}(t,r))}("FunctionLike",n,t)}function g(n){return"number"==typeof n||p(n)?h(1):n.arity}function h(n){return{min:n,max:n}}const b={juxt:{evaluate:(n,t)=>{n.forEach(n=>d(n,t));const r=function(n){return n.reduce((n,e)=>{if(null===n)return null;const t="number"==typeof e||p(e)?h(1):e.arity,{min:r,max:o}=t,{min:u,max:a}=n,i="number"==typeof r&&"number"==typeof u?Math.max(r,u):"number"==typeof r?r:"number"==typeof u?u:void 0,s="number"==typeof o&&"number"==typeof a?Math.min(o,a):"number"==typeof o?o:"number"==typeof a?a:void 0;return"number"==typeof i&&"number"==typeof s&&i>s?null:{min:i,max:s}},{})}(n);if(null===r)throw new e("All functions must accept the same number of arguments",t);return{[u]:!0,sourceCodeInfo:t,functionType:"Juxt",params:n,arity:r}},arity:{min:1},docs:{category:"functional",returns:{type:"function"},args:{a:{type:"function"},b:{type:"function"},fun:{type:"function"},fns:{type:"function",rest:!0}},variants:[{argumentNames:["fun"]},{argumentNames:["fun","fns"]}],description:"Takes one or many function and returns a function that is the juxtaposition of those functions.\nThe returned function takes a variable number of args,\nand returns a vector containing the result of applying each function to the args (left-to-right).",seeAlso:["comp"],examples:["let { juxt } = import(functional);\njuxt(+, *, min, max)(\n  3,\n  4,\n  6,\n)",'let { juxt } = import(functional);\njuxt("a", "b")(\n  {\n    a: 1,\n    b: 2,\n    c: 3,\n    d: 4\n  }\n)',"let { juxt } = import(functional);\njuxt(+, *, min, max) apply range(1, 11)"]}},complement:{evaluate:([n],e)=>{const t=y(n,e);return{[u]:!0,sourceCodeInfo:e,functionType:"Complement",function:t,arity:g(t)}},arity:h(1),docs:{category:"functional",returns:{type:"function"},args:{fun:{type:"function"}},variants:[{argumentNames:["fun"]}],description:"Takes a function $fun and returns a new function that takes the same arguments as f, has the same effects, if any, and returns the opposite truth value.",seeAlso:["comp","functional.every-pred","functional.some-pred"],examples:["let { complement } = import(functional);\ncomplement(>)(1, 3)","let { complement } = import(functional);\ncomplement(<)(1, 3)","let { complement } = import(functional);\ncomplement(+)(1, 3)","let { complement } = import(functional);\ncomplement(+)(0, 0)"]}},"every-pred":{evaluate:(n,e)=>({[u]:!0,sourceCodeInfo:e,functionType:"EveryPred",params:n,arity:{min:1,max:1}}),arity:{min:1},docs:{category:"functional",returns:{type:"function"},args:{fun:{type:"function"},fns:{type:"function",rest:!0}},variants:[{argumentNames:["fun"]},{argumentNames:["fun","fns"]}],description:"\nTakes a number of predicates and returns a function that returns `true` if all predicates\nreturn a truthy value against all of its arguments, else it returns `false`.",seeAlso:["functional.some-pred","functional.complement","collection.every?"],examples:['let { every-pred } = import(functional);\nevery-pred(string?, -> count($) > 3)(\n  "Albert",\n  "Mojir"\n)','let { every-pred } = import(functional);\n(string? every-pred -> count($) > 3)(\n  "Albert",\n  "M"\n)'],hideOperatorForm:!0}},"some-pred":{evaluate:(n,e)=>({[u]:!0,sourceCodeInfo:e,functionType:"SomePred",params:n,arity:{min:1,max:1}}),arity:{min:1},docs:{category:"functional",returns:{type:"function"},args:{fun:{type:"function"},fns:{type:"function",rest:!0}},variants:[{argumentNames:["fun"]},{argumentNames:["fun","fns"]}],description:"Takes a number of `predicates` and returns a function that returns `true` if at least one of the `predicates` return a truthy `true` value against at least one of its arguments, else it returns `false`.",seeAlso:["functional.every-pred","functional.complement","collection.any?"],examples:['let { some-pred } = import(functional);\nsome-pred(string?, -> count($) > 3)("Albert", "Mojir")','let { some-pred } = import(functional);\nsome-pred(string?, -> count($) > 3)("a", "M")','let { some-pred } = import(functional);\nsome-pred(string?, -> count($) > 3)("a", [1, 2, 3])',"let { some-pred } = import(functional);\nsome-pred(string?, -> count($) > 3)([1, 2, 3], [2])"],hideOperatorForm:!0}},fnull:{evaluate:([n,...e],t)=>{const r=y(n,t);return{[u]:!0,sourceCodeInfo:t,functionType:"Fnull",function:r,params:e,arity:g(r)}},arity:{min:2},docs:{category:"functional",returns:{type:"function"},args:{a:{type:"function"},b:{type:"any"},fun:{type:"function"},arg:{type:"any"},args:{type:"any",rest:!0}},variants:[{argumentNames:["fun","arg"]},{argumentNames:["fun","arg","args"]}],description:"Takes a function $fun, and returns a function that calls $fun, replacing a null argument to the corresponding argument.",seeAlso:["identity","constantly"],examples:["let { fnull } = import(functional);\nfnull(inc, 0)(1)","let { fnull } = import(functional);\nfnull(inc, 0)(null)","let { fnull } = import(functional);\n(inc fnull 0)(null)","let { fnull } = import(functional);\nfnull(+, 1, 2)(null, 0)","let { fnull } = import(functional);\nfnull(+, 1, 2)(0, null)","let { fnull } = import(functional);\nfnull(+, 1, 2)(null, null)","let { fnull } = import(functional);\nfnull(+, 1, 2)(null, null, 3, 4)"]}}},v={name:"functional",functions:b,source:"{}",docs:(x=b,Object.fromEntries(Object.entries(x).map(([n,e])=>{if(!e.docs)throw new Error(`Missing docs for function "${n}"`);return[n,e.docs]})))};var x;export{v as functionalUtilsModule};
-//# sourceMappingURL=functional.esm.js.map

package/dist/modules/functional.esm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"functional.esm.js","sources":["../../src/utils/debug/getCodeMarker.ts","../../src/errors.ts","../../src/constants/constants.ts","../../src/utils/symbols.ts","../../src/utils/debug/debugTools.ts","../../src/typeGuards/dvalaFunction.ts","../../src/typeGuards/dvala.ts","../../src/utils/getAssertionError.ts","../../src/utils/debug/getSourceCodeInfo.ts","../../src/utils/arity.ts","../../src/builtin/modules/functional/index.ts","../../src/builtin/modules/functional/functional.dvala","../../src/builtin/modules/interface.ts"],"sourcesContent":["import type { SourceCodeInfo } from '../../tokenizer/token'\n\nexport function getCodeMarker(sourceCodeInfo: SourceCodeInfo): string {\n  if (!sourceCodeInfo.position || !sourceCodeInfo.code)\n    return ''\n\n  const leftPadding = sourceCodeInfo.position.column - 1\n  const rightPadding = sourceCodeInfo.code.length - leftPadding - 1\n  return `${' '.repeat(Math.max(leftPadding, 0))}^${' '.repeat(Math.max(rightPadding, 0))}`\n}\n","import { getCodeMarker } from '../src/utils/debug/getCodeMarker'\nimport type { Arr } from './interface'\nimport type { SourceCodeInfo } from './tokenizer/token'\n\nfunction getDvalaErrorMessage(message: string, sourceCodeInfo?: SourceCodeInfo) {\n  if (!sourceCodeInfo) {\n    return message\n  }\n  const location = `${sourceCodeInfo.position.line}:${sourceCodeInfo.position.column}`\n  const filePathLine = sourceCodeInfo.filePath\n    ? `\\n${sourceCodeInfo.filePath}:${location}`\n    : `\\nLocation ${location}`\n  const codeLine = `\\n${sourceCodeInfo.code}`\n  const codeMarker = `\\n${getCodeMarker(sourceCodeInfo)}`\n  return `${message}${filePathLine}${codeLine}${codeMarker}`\n}\n\nexport class RecurSignal extends Error {\n  public params: Arr\n  constructor(params: Arr) {\n    super(`recur, params: ${params}`)\n    Object.setPrototypeOf(this, RecurSignal.prototype)\n    this.name = 'RecurSignal'\n    this.params = params\n  }\n}\n\nexport class DvalaError extends Error {\n  public readonly sourceCodeInfo?: SourceCodeInfo\n  public readonly shortMessage: string\n  constructor(err: unknown, sourceCodeInfo: SourceCodeInfo | undefined) {\n    const message = err instanceof Error\n      ? err.message\n      : `${err}`\n\n    super(getDvalaErrorMessage(message, sourceCodeInfo))\n    this.shortMessage = message\n    this.sourceCodeInfo = sourceCodeInfo\n    Object.setPrototypeOf(this, DvalaError.prototype)\n    this.name = 'DvalaError'\n  }\n\n  public getCodeMarker(): string | undefined {\n    return this.sourceCodeInfo && getCodeMarker(this.sourceCodeInfo)\n  }\n}\n\nexport class UserDefinedError extends DvalaError {\n  public userMessage: string\n  constructor(message: string, sourceCodeInfo?: SourceCodeInfo) {\n    super(message, sourceCodeInfo)\n    this.userMessage = message\n    Object.setPrototypeOf(this, UserDefinedError.prototype)\n    this.name = 'UserDefinedError'\n  }\n}\n\nexport class AssertionError extends DvalaError {\n  constructor(message: string | Error, sourceCodeInfo?: SourceCodeInfo) {\n    super(message, sourceCodeInfo)\n    Object.setPrototypeOf(this, AssertionError.prototype)\n    this.name = 'AssertionError'\n  }\n}\n\nexport class UndefinedSymbolError extends DvalaError {\n  public symbol: string\n  constructor(symbolName: string, sourceCodeInfo?: SourceCodeInfo) {\n    const message = `Undefined symbol '${symbolName}'.`\n    super(message, sourceCodeInfo)\n    this.symbol = symbolName\n    Object.setPrototypeOf(this, UndefinedSymbolError.prototype)\n    this.name = 'UndefinedSymbolError'\n  }\n}\n\nexport function isDvalaError(error: unknown): error is DvalaError {\n  return error instanceof DvalaError\n}\n","export const NodeTypes = {\n  Number: 1,\n  String: 2,\n  NormalExpression: 3,\n  SpecialExpression: 4,\n  UserDefinedSymbol: 5,\n  NormalBuiltinSymbol: 6,\n  SpecialBuiltinSymbol: 7,\n  ReservedSymbol: 8,\n  Binding: 9,\n  Spread: 10,\n} as const\n\nconst NodeTypesSet = new Set(Object.values(NodeTypes))\n\nexport type NodeType = typeof NodeTypes[keyof typeof NodeTypes]\n\nexport function getNodeTypeName(type: NodeType): keyof typeof NodeTypes {\n  return Object.keys(NodeTypes).find(key => NodeTypes[key as keyof typeof NodeTypes] === type) as keyof typeof NodeTypes\n}\n\n// TODO, is this needed?\nexport function isNodeType(type: unknown): type is NodeType {\n  return typeof type === 'number' && NodeTypesSet.has(type as NodeType)\n}\n\nconst functionTypes = [\n  'UserDefined',\n  'Partial',\n  'Comp',\n  'Constantly',\n  'Juxt',\n  'Complement',\n  'EveryPred',\n  'SomePred',\n  'Fnull',\n  'EffectMatcher',\n  'Builtin',\n  'SpecialBuiltin',\n  'Module',\n] as const\n\nconst functionTypeSet = new Set(functionTypes)\n\nexport type FunctionType = typeof functionTypes[number]\n\nexport function isFunctionType(type: unknown): type is FunctionType {\n  return typeof type === 'string' && functionTypeSet.has(type as FunctionType)\n}\n","export const FUNCTION_SYMBOL = '^^fn^^'\nexport const REGEXP_SYMBOL = '^^re^^'\nexport const EFFECT_SYMBOL = '^^ef^^'\n","import { getNodeTypeName, isFunctionType, isNodeType } from '../../constants/constants'\nimport type { AstNode, DvalaFunction } from '../../parser/types'\nimport { FUNCTION_SYMBOL } from '../symbols'\n\nfunction isDvalaFunction(func: unknown): func is DvalaFunction {\n  if (func === null || typeof func !== 'object')\n    return false\n\n  return FUNCTION_SYMBOL in func && 'functionType' in func && isFunctionType(func.functionType)\n}\n\nfunction isNode(value: unknown): value is AstNode {\n  if (!Array.isArray(value) || value.length < 2)\n    return false\n  return isNodeType(value[0])\n}\n\nexport function valueToString(value: unknown): string {\n  if (isDvalaFunction(value))\n    // eslint-disable-next-line ts/no-unsafe-member-access\n    return `<function ${(value as any).name || '\\u03BB'}>`\n\n  if (isNode(value))\n    return `${getNodeTypeName(value[0])}-node`\n\n  if (value === null)\n    return 'null'\n\n  if (typeof value === 'object' && value instanceof RegExp)\n    return `${value}`\n\n  if (typeof value === 'object' && value instanceof Error)\n    return value.toString()\n\n  return JSON.stringify(value)\n}\n","import type { DvalaFunction, NormalBuiltinFunction, UserDefinedFunction } from '../parser/types'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { getAssertionError } from '../utils/getAssertionError'\nimport { FUNCTION_SYMBOL } from '../utils/symbols'\nimport { isUnknownRecord } from '.'\n\nexport function isDvalaFunction(value: unknown): value is DvalaFunction {\n  if (value === null || typeof value !== 'object')\n    return false\n\n  return !!(value as DvalaFunction)[FUNCTION_SYMBOL]\n}\nexport function asDvalaFunction(value: unknown, sourceCodeInfo?: SourceCodeInfo): DvalaFunction {\n  assertDvalaFunction(value, sourceCodeInfo)\n  return value\n}\nexport function assertDvalaFunction(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is DvalaFunction {\n  if (!isDvalaFunction(value))\n    throw getAssertionError('DvalaFunction', value, sourceCodeInfo)\n}\n\nexport function isUserDefinedFunction(value: unknown): value is UserDefinedFunction {\n  return isDvalaFunction(value) && value.functionType === 'UserDefined'\n}\nexport function asUserDefinedFunction(value: unknown, sourceCodeInfo?: SourceCodeInfo): UserDefinedFunction {\n  assertUserDefinedFunction(value, sourceCodeInfo)\n  return value\n}\nexport function assertUserDefinedFunction(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n): asserts value is UserDefinedFunction {\n  if (!isUserDefinedFunction(value))\n    throw getAssertionError('UserDefinedFunction', value, sourceCodeInfo)\n}\n\nexport function isBuiltinFunction(value: unknown): value is NormalBuiltinFunction {\n  return isUnknownRecord(value) && value.functionType === 'Builtin'\n}\n","import type { Any, Coll, Obj, Seq } from '../interface'\nimport type { EffectRef, FunctionLike, RegularExpression } from '../parser/types'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { getAssertionError } from '../utils/getAssertionError'\nimport { EFFECT_SYMBOL, REGEXP_SYMBOL } from '../utils/symbols'\nimport { isDvalaFunction } from './dvalaFunction'\n\nexport function isAny(value: unknown): value is Any {\n  // TODO weak test\n  return value !== undefined\n}\nexport function asAny(value: unknown, sourceCodeInfo?: SourceCodeInfo): Any {\n  assertAny(value, sourceCodeInfo)\n  return value\n}\nexport function assertAny(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is Any {\n  if (!isAny(value))\n    throw getAssertionError('not undefined', value, sourceCodeInfo)\n}\n\nexport function isSeq(value: unknown): value is Seq {\n  return Array.isArray(value) || typeof value === 'string'\n}\nexport function asSeq(value: unknown, sourceCodeInfo?: SourceCodeInfo): Seq {\n  assertSeq(value, sourceCodeInfo)\n  return value\n}\nexport function assertSeq(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is Seq {\n  if (!isSeq(value))\n    throw getAssertionError('string or array', value, sourceCodeInfo)\n}\n\nexport function isObj(value: unknown): value is Obj {\n  return !(\n    value === null\n    || typeof value !== 'object'\n    || Array.isArray(value)\n    || value instanceof RegExp\n    || isDvalaFunction(value)\n    || isRegularExpression(value)\n    || isEffect(value)\n  )\n}\nexport function asObj(value: unknown, sourceCodeInfo?: SourceCodeInfo): Obj {\n  assertObj(value, sourceCodeInfo)\n  return value\n}\nexport function assertObj(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is Obj {\n  if (!isObj(value))\n    throw getAssertionError('object', value, sourceCodeInfo)\n}\n\nexport function isColl(value: unknown): value is Coll {\n  return isSeq(value) || isObj(value)\n}\nexport function asColl(value: unknown, sourceCodeInfo?: SourceCodeInfo): Coll {\n  assertColl(value, sourceCodeInfo)\n  return value\n}\nexport function assertColl(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is Coll {\n  if (!isColl(value))\n    throw getAssertionError('string, array or object', value, sourceCodeInfo)\n}\n\nexport function isRegularExpression(regexp: unknown): regexp is RegularExpression {\n  if (regexp === null || typeof regexp !== 'object')\n    return false\n\n  return !!(regexp as RegularExpression)[REGEXP_SYMBOL]\n}\nexport function asRegularExpression(value: unknown, sourceCodeInfo?: SourceCodeInfo): RegularExpression {\n  assertRegularExpression(value, sourceCodeInfo)\n  return value\n}\nexport function assertRegularExpression(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n): asserts value is RegularExpression {\n  if (!isRegularExpression(value))\n    throw getAssertionError('RegularExpression', value, sourceCodeInfo)\n}\n\nexport function isStringOrRegularExpression(value: unknown): value is string | RegularExpression {\n  return isRegularExpression(value) || typeof value === 'string'\n}\nexport function asStringOrRegularExpression(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n): string | RegularExpression {\n  assertStringOrRegularExpression(value, sourceCodeInfo)\n  return value\n}\nexport function assertStringOrRegularExpression(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n): asserts value is string | RegularExpression {\n  if (!isStringOrRegularExpression(value))\n    throw getAssertionError('string or RegularExpression', value, sourceCodeInfo)\n}\n\nexport function isEffect(value: unknown): value is EffectRef {\n  if (value === null || typeof value !== 'object')\n    return false\n\n  return !!(value as EffectRef)[EFFECT_SYMBOL]\n}\nexport function asEffect(value: unknown, sourceCodeInfo?: SourceCodeInfo): EffectRef {\n  assertEffect(value, sourceCodeInfo)\n  return value\n}\nexport function assertEffect(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n): asserts value is EffectRef {\n  if (!isEffect(value))\n    throw getAssertionError('Effect', value, sourceCodeInfo)\n}\n\nfunction isFunctionLike(value: unknown): value is FunctionLike {\n  if (typeof value === 'number')\n    return true\n  if (isColl(value))\n    return true\n  if (isDvalaFunction(value))\n    return true\n\n  return false\n}\nexport function asFunctionLike(value: unknown, sourceCodeInfo?: SourceCodeInfo): FunctionLike {\n  assertFunctionLike(value, sourceCodeInfo)\n  return value\n}\nexport function assertFunctionLike(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is FunctionLike {\n  if (!isFunctionLike(value))\n    throw getAssertionError('FunctionLike', value, sourceCodeInfo)\n}\n","import { DvalaError } from '../errors'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { valueToString } from './debug/debugTools'\nimport { getSourceCodeInfo } from './debug/getSourceCodeInfo'\n\nexport function getAssertionError(typeName: string, value: unknown, sourceCodeInfo?: SourceCodeInfo): DvalaError {\n  return new DvalaError(`Expected ${typeName}, got ${valueToString(value)}.`, getSourceCodeInfo(value, sourceCodeInfo))\n}\n","import type { SourceCodeInfo } from '../../tokenizer/token'\n\nexport function getSourceCodeInfo(anyValue: any, sourceCodeInfo: SourceCodeInfo | undefined): SourceCodeInfo | undefined {\n  // eslint-disable-next-line ts/no-unsafe-return, ts/no-unsafe-member-access\n  return anyValue?.sourceCodeInfo ?? sourceCodeInfo\n}\n","import type { Arity } from '../builtin/interface'\nimport { DvalaError } from '../errors'\nimport type { FunctionLike } from '../parser/types'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { isColl } from '../typeGuards/dvala'\nimport { valueToString } from './debug/debugTools'\n\nexport function arityAccepts(arity: Arity, nbrOfParams: number): boolean {\n  const { min, max } = arity\n  if (typeof min === 'number' && nbrOfParams < min) {\n    return false\n  }\n  if (typeof max === 'number' && nbrOfParams > max) {\n    return false\n  }\n  return true\n}\n\nexport function arityAcceptsMin(arity: Arity, nbrOfParams: number): boolean {\n  const { min } = arity\n  if (typeof min === 'number' && nbrOfParams < min) {\n    return false\n  }\n  return true\n}\n\nexport function getCommonArityFromFunctions(params: FunctionLike[]): Arity | null {\n  return params.reduce((acc: Arity | null, param): Arity | null => {\n    if (acc === null) {\n      return null\n    }\n    const arity: Arity = (typeof param === 'number' || isColl(param)) ? toFixedArity(1) : param.arity\n    const { min: aMin, max: aMax } = arity\n    const { min: bMin, max: bMax } = acc\n    const min = typeof aMin === 'number' && typeof bMin === 'number'\n      ? Math.max(aMin, bMin)\n      : typeof aMin === 'number' ? aMin : typeof bMin === 'number' ? bMin : undefined\n    const max = typeof aMax === 'number' && typeof bMax === 'number'\n      ? Math.min(aMax, bMax)\n      : typeof aMax === 'number' ? aMax : typeof bMax === 'number' ? bMax : undefined\n\n    if (typeof min === 'number' && typeof max === 'number' && min > max) {\n      return null\n    }\n\n    return { min, max }\n  }, {})\n}\n\nexport function getArityFromFunction(param: FunctionLike): Arity {\n  return (typeof param === 'number' || isColl(param)) ? toFixedArity(1) : param.arity\n}\n\nexport function assertNumberOfParams(arity: Arity, length: number, sourceCodeInfo: SourceCodeInfo | undefined): void {\n  const { min, max } = arity\n  if (typeof min === 'number' && length < min) {\n    throw new DvalaError(\n      `Wrong number of arguments, expected at least ${min}, got ${valueToString(length)}.`,\n      sourceCodeInfo,\n    )\n  }\n\n  if (typeof max === 'number' && length > max) {\n    throw new DvalaError(\n      `Wrong number of arguments, expected at most ${max}, got ${valueToString(length)}.`,\n      sourceCodeInfo,\n    )\n  }\n}\n\nexport function canBeOperator(count: Arity): boolean {\n  if (typeof count.max === 'number' && count.max < 2) {\n    return false\n  }\n\n  if (typeof count.min === 'number' && count.min > 2) {\n    return false\n  }\n\n  return true\n}\n\nexport function toFixedArity(arity: number): Arity {\n  return { min: arity, max: arity }\n}\n","import type { Arr } from '../../../interface'\nimport type {\n  ComplementFunction,\n  EveryPredFunction,\n  FNullFunction,\n  FunctionLike,\n  JuxtFunction,\n  SomePredFunction,\n} from '../../../parser/types'\nimport { getArityFromFunction, getCommonArityFromFunctions, toFixedArity } from '../../../utils/arity'\nimport { FUNCTION_SYMBOL } from '../../../utils/symbols'\nimport type { BuiltinNormalExpressions } from '../../interface'\nimport { asFunctionLike, assertFunctionLike } from '../../../typeGuards/dvala'\nimport { DvalaError } from '../../../errors'\nimport { moduleDocsFromFunctions } from '../interface'\nimport type { DvalaModule } from '../interface'\nimport functionalModuleSource from './functional.dvala'\n\nconst functionalUtilsNormalExpression: BuiltinNormalExpressions = {\n  'juxt': {\n    evaluate: (params, sourceCodeInfo): JuxtFunction => {\n      params.forEach(param => assertFunctionLike(param, sourceCodeInfo))\n      const arity = getCommonArityFromFunctions(params as FunctionLike[])\n      if (arity === null) {\n        throw new DvalaError('All functions must accept the same number of arguments', sourceCodeInfo)\n      }\n      return {\n        [FUNCTION_SYMBOL]: true,\n        sourceCodeInfo,\n        functionType: 'Juxt',\n        params,\n        arity,\n      }\n    },\n    arity: { min: 1 },\n    docs: {\n      category: 'functional',\n      returns: { type: 'function' },\n      args: {\n        a: { type: 'function' },\n        b: { type: 'function' },\n        fun: { type: 'function' },\n        fns: { type: 'function', rest: true },\n      },\n      variants: [\n        { argumentNames: ['fun'] },\n        { argumentNames: ['fun', 'fns'] },\n      ],\n      description: `Takes one or many function and returns a function that is the juxtaposition of those functions.\nThe returned function takes a variable number of args,\nand returns a vector containing the result of applying each function to the args (left-to-right).`,\n      seeAlso: ['comp'],\n      examples: [\n        `let { juxt } = import(functional);\njuxt(+, *, min, max)(\n  3,\n  4,\n  6,\n)`,\n        `let { juxt } = import(functional);\njuxt(\"a\", \"b\")(\n  {\n    a: 1,\n    b: 2,\n    c: 3,\n    d: 4\n  }\n)`,\n        `let { juxt } = import(functional);\njuxt(+, *, min, max) apply range(1, 11)`,\n      ],\n    },\n  },\n\n  'complement': {\n    evaluate: ([fn], sourceCodeInfo): ComplementFunction => {\n      const fun = asFunctionLike(fn, sourceCodeInfo)\n      return {\n        [FUNCTION_SYMBOL]: true,\n        sourceCodeInfo,\n        functionType: 'Complement',\n        function: fun,\n        arity: getArityFromFunction(fun),\n      }\n    },\n    arity: toFixedArity(1),\n    docs: {\n      category: 'functional',\n      returns: { type: 'function' },\n      args: { fun: { type: 'function' } },\n      variants: [{ argumentNames: ['fun'] }],\n      description: 'Takes a function $fun and returns a new function that takes the same arguments as f, has the same effects, if any, and returns the opposite truth value.',\n      seeAlso: ['comp', 'functional.every-pred', 'functional.some-pred'],\n      examples: [\n        'let { complement } = import(functional);\\ncomplement(>)(1, 3)',\n        'let { complement } = import(functional);\\ncomplement(<)(1, 3)',\n        'let { complement } = import(functional);\\ncomplement(+)(1, 3)',\n        'let { complement } = import(functional);\\ncomplement(+)(0, 0)',\n      ],\n    },\n  },\n\n  'every-pred': {\n    evaluate: (params, sourceCodeInfo): EveryPredFunction => {\n      return {\n        [FUNCTION_SYMBOL]: true,\n        sourceCodeInfo,\n        functionType: 'EveryPred',\n        params,\n        arity: { min: 1, max: 1 },\n      }\n    },\n    arity: { min: 1 },\n    docs: {\n      category: 'functional',\n      returns: { type: 'function' },\n      args: {\n        fun: { type: 'function' },\n        fns: { type: 'function', rest: true },\n      },\n      variants: [\n        { argumentNames: ['fun'] },\n        { argumentNames: ['fun', 'fns'] },\n      ],\n      description: `\nTakes a number of predicates and returns a function that returns \\`true\\` if all predicates\nreturn a truthy value against all of its arguments, else it returns \\`false\\`.`,\n      seeAlso: ['functional.some-pred', 'functional.complement', 'collection.every?'],\n      examples: [\n        `let { every-pred } = import(functional);\nevery-pred(string?, -> count($) > 3)(\n  \"Albert\",\n  \"Mojir\"\n)`,\n        `let { every-pred } = import(functional);\n(string? every-pred -> count($) > 3)(\n  \"Albert\",\n  \"M\"\n)`,\n      ],\n      hideOperatorForm: true,\n    },\n  },\n\n  'some-pred': {\n    evaluate: (params, sourceCodeInfo): SomePredFunction => {\n      return {\n        [FUNCTION_SYMBOL]: true,\n        sourceCodeInfo,\n        functionType: 'SomePred',\n        params,\n        arity: { min: 1, max: 1 },\n      }\n    },\n    arity: { min: 1 },\n    docs: {\n      category: 'functional',\n      returns: { type: 'function' },\n      args: {\n        fun: { type: 'function' },\n        fns: { type: 'function', rest: true },\n      },\n      variants: [\n        { argumentNames: ['fun'] },\n        { argumentNames: ['fun', 'fns'] },\n      ],\n      description: 'Takes a number of `predicates` and returns a function that returns `true` if at least one of the `predicates` return a truthy `true` value against at least one of its arguments, else it returns `false`.',\n      seeAlso: ['functional.every-pred', 'functional.complement', 'collection.any?'],\n      examples: [\n        'let { some-pred } = import(functional);\\nsome-pred(string?, -> count($) > 3)(\"Albert\", \"Mojir\")',\n        'let { some-pred } = import(functional);\\nsome-pred(string?, -> count($) > 3)(\"a\", \"M\")',\n        'let { some-pred } = import(functional);\\nsome-pred(string?, -> count($) > 3)(\"a\", [1, 2, 3])',\n        'let { some-pred } = import(functional);\\nsome-pred(string?, -> count($) > 3)([1, 2, 3], [2])',\n      ],\n      hideOperatorForm: true,\n    },\n  },\n\n  'fnull': {\n    evaluate: ([fn, ...params]: Arr, sourceCodeInfo): FNullFunction => {\n      const fun = asFunctionLike(fn, sourceCodeInfo)\n      return {\n        [FUNCTION_SYMBOL]: true,\n        sourceCodeInfo,\n        functionType: 'Fnull',\n        function: fun,\n        params,\n        arity: getArityFromFunction(fun),\n      }\n    },\n    arity: { min: 2 },\n    docs: {\n      category: 'functional',\n      returns: { type: 'function' },\n      args: {\n        a: { type: 'function' },\n        b: { type: 'any' },\n        fun: { type: 'function' },\n        arg: { type: 'any' },\n        args: { type: 'any', rest: true },\n      },\n      variants: [\n        { argumentNames: ['fun', 'arg'] },\n        { argumentNames: ['fun', 'arg', 'args'] },\n      ],\n      description: 'Takes a function $fun, and returns a function that calls $fun, replacing a null argument to the corresponding argument.',\n      seeAlso: ['identity', 'constantly'],\n      examples: [\n        'let { fnull } = import(functional);\\nfnull(inc, 0)(1)',\n        'let { fnull } = import(functional);\\nfnull(inc, 0)(null)',\n        'let { fnull } = import(functional);\\n(inc fnull 0)(null)',\n        'let { fnull } = import(functional);\\nfnull(+, 1, 2)(null, 0)',\n        'let { fnull } = import(functional);\\nfnull(+, 1, 2)(0, null)',\n        'let { fnull } = import(functional);\\nfnull(+, 1, 2)(null, null)',\n        'let { fnull } = import(functional);\\nfnull(+, 1, 2)(null, null, 3, 4)',\n      ],\n    },\n  },\n}\n\nexport const functionalUtilsModule: DvalaModule = {\n  name: 'functional',\n  functions: functionalUtilsNormalExpression,\n  source: functionalModuleSource,\n  docs: moduleDocsFromFunctions(functionalUtilsNormalExpression),\n}\n","{}","import type { BuiltinNormalExpressions, FunctionDocs } from '../../builtin/interface'\n\n/**\n * Represents a Dvala module that can be imported dynamically.\n * Modules contain a collection of functions that are not part of the core bundle.\n */\nexport interface DvalaModule {\n  /** The name of the module (e.g., 'grid', 'vec', 'mat') */\n  name: string\n  /** The functions provided by this module, keyed by their short name (e.g., 'transpose') */\n  functions: BuiltinNormalExpressions\n  /**\n   * Optional Dvala source code that is evaluated at import time.\n   * The source must evaluate to an object mapping function names to functions.\n   * These are merged with (and may override) the TypeScript `functions`.\n   */\n  source?: string\n  /**\n   * Docs for all functions in this module, including any defined in `source`.\n   * The reference system uses this record as the sole source of truth for\n   * function names and documentation. Not required for user-defined modules.\n   */\n  docs?: Record<string, FunctionDocs>\n}\n\n/**\n * Derives a docs record from a BuiltinNormalExpressions map.\n * Use this for modules whose docs are co-located inline on each function.\n */\nexport function moduleDocsFromFunctions(functions: BuiltinNormalExpressions): Record<string, FunctionDocs> {\n  return Object.fromEntries(\n    Object.entries(functions).map(([k, v]) => {\n      if (!v.docs)\n        throw new Error(`Missing docs for function \"${k}\"`)\n      return [k, v.docs]\n    }),\n  )\n}\n"],"names":["getCodeMarker","sourceCodeInfo","position","code","leftPadding","column","rightPadding","length","repeat","Math","max","DvalaError","Error","shortMessage","constructor","err","message","super","location","line","filePath","getDvalaErrorMessage","this","Object","setPrototypeOf","prototype","name","NodeTypes","Number","String","NormalExpression","SpecialExpression","UserDefinedSymbol","NormalBuiltinSymbol","SpecialBuiltinSymbol","ReservedSymbol","Binding","Spread","NodeTypesSet","Set","values","functionTypeSet","FUNCTION_SYMBOL","REGEXP_SYMBOL","EFFECT_SYMBOL","isDvalaFunction","func","type","functionType","has","isNode","value","Array","isArray","valueToString","keys","find","key","RegExp","toString","JSON","stringify","isObj","regexp","isEffect","isColl","isSeq","asFunctionLike","assertFunctionLike","isFunctionLike","typeName","anyValue","getSourceCodeInfo","getAssertionError","getArityFromFunction","param","toFixedArity","arity","min","functionalUtilsNormalExpression","juxt","evaluate","params","forEach","reduce","acc","aMin","aMax","bMin","bMax","undefined","getCommonArityFromFunctions","docs","category","returns","args","a","b","fun","fns","rest","variants","argumentNames","description","seeAlso","examples","complement","fn","function","hideOperatorForm","fnull","arg","functionalUtilsModule","functions","source","fromEntries","entries","map","k","v"],"mappings":"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"}

package/dist/modules/functional.js

@@ -1,2 +0,0 @@
-"use strict";function n(n){if(!n.position||!n.code)return"";const t=n.position.column-1,e=n.code.length-t-1;return`${" ".repeat(Math.max(t,0))}^${" ".repeat(Math.max(e,0))}`}class t extends Error{sourceCodeInfo;shortMessage;constructor(e,r){const o=e instanceof Error?e.message:`${e}`;super(function(t,e){if(!e)return t;const r=`${e.position.line}:${e.position.column}`;return`${t}${e.filePath?`\n${e.filePath}:${r}`:`\nLocation ${r}`}\n${e.code}\n${n(e)}`}(o,r)),this.shortMessage=o,this.sourceCodeInfo=r,Object.setPrototypeOf(this,t.prototype),this.name="DvalaError"}getCodeMarker(){return this.sourceCodeInfo&&n(this.sourceCodeInfo)}}const e={Number:1,String:2,NormalExpression:3,SpecialExpression:4,UserDefinedSymbol:5,NormalBuiltinSymbol:6,SpecialBuiltinSymbol:7,ReservedSymbol:8,Binding:9,Spread:10},r=new Set(Object.values(e));const o=new Set(["UserDefined","Partial","Comp","Constantly","Juxt","Complement","EveryPred","SomePred","Fnull","EffectMatcher","Builtin","SpecialBuiltin","Module"]);const u="^^fn^^",a="^^re^^",i="^^ef^^";function s(n){return null!==n&&"object"==typeof n&&(u in n&&"functionType"in n&&("string"==typeof(t=n.functionType)&&o.has(t)));var t}function l(n){return!(!Array.isArray(n)||n.length<2)&&("number"==typeof(t=n[0])&&r.has(t));var t}function c(n){return s(n)?`<function ${n.name||"λ"}>`:l(n)?`${t=n[0],Object.keys(e).find(n=>e[n]===t)}-node`:null===n?"null":"object"==typeof n&&n instanceof RegExp?`${n}`:"object"==typeof n&&n instanceof Error?n.toString():JSON.stringify(n);var t}function f(n){return null!==n&&"object"==typeof n&&!!n[u]}function m(n){return!(null===n||"object"!=typeof n||Array.isArray(n)||n instanceof RegExp||f(n)||(t=n,null!==t&&"object"==typeof t&&t[a])||function(n){return null!==n&&"object"==typeof n&&!!n[i]}(n));var t}function p(n){return function(n){return Array.isArray(n)||"string"==typeof n}(n)||m(n)}function y(n,t){return d(n,t),n}function d(n,e){if(!function(n){return"number"==typeof n||!!p(n)||!!f(n)}(n))throw function(n,e,r){return new t(`Expected ${n}, got ${c(e)}.`,function(n,t){return n?.sourceCodeInfo??t}(e,r))}("FunctionLike",n,e)}function g(n){return"number"==typeof n||p(n)?h(1):n.arity}function h(n){return{min:n,max:n}}const b={juxt:{evaluate:(n,e)=>{n.forEach(n=>d(n,e));const r=function(n){return n.reduce((n,t)=>{if(null===n)return null;const e="number"==typeof t||p(t)?h(1):t.arity,{min:r,max:o}=e,{min:u,max:a}=n,i="number"==typeof r&&"number"==typeof u?Math.max(r,u):"number"==typeof r?r:"number"==typeof u?u:void 0,s="number"==typeof o&&"number"==typeof a?Math.min(o,a):"number"==typeof o?o:"number"==typeof a?a:void 0;return"number"==typeof i&&"number"==typeof s&&i>s?null:{min:i,max:s}},{})}(n);if(null===r)throw new t("All functions must accept the same number of arguments",e);return{[u]:!0,sourceCodeInfo:e,functionType:"Juxt",params:n,arity:r}},arity:{min:1},docs:{category:"functional",returns:{type:"function"},args:{a:{type:"function"},b:{type:"function"},fun:{type:"function"},fns:{type:"function",rest:!0}},variants:[{argumentNames:["fun"]},{argumentNames:["fun","fns"]}],description:"Takes one or many function and returns a function that is the juxtaposition of those functions.\nThe returned function takes a variable number of args,\nand returns a vector containing the result of applying each function to the args (left-to-right).",seeAlso:["comp"],examples:["let { juxt } = import(functional);\njuxt(+, *, min, max)(\n  3,\n  4,\n  6,\n)",'let { juxt } = import(functional);\njuxt("a", "b")(\n  {\n    a: 1,\n    b: 2,\n    c: 3,\n    d: 4\n  }\n)',"let { juxt } = import(functional);\njuxt(+, *, min, max) apply range(1, 11)"]}},complement:{evaluate:([n],t)=>{const e=y(n,t);return{[u]:!0,sourceCodeInfo:t,functionType:"Complement",function:e,arity:g(e)}},arity:h(1),docs:{category:"functional",returns:{type:"function"},args:{fun:{type:"function"}},variants:[{argumentNames:["fun"]}],description:"Takes a function $fun and returns a new function that takes the same arguments as f, has the same effects, if any, and returns the opposite truth value.",seeAlso:["comp","functional.every-pred","functional.some-pred"],examples:["let { complement } = import(functional);\ncomplement(>)(1, 3)","let { complement } = import(functional);\ncomplement(<)(1, 3)","let { complement } = import(functional);\ncomplement(+)(1, 3)","let { complement } = import(functional);\ncomplement(+)(0, 0)"]}},"every-pred":{evaluate:(n,t)=>({[u]:!0,sourceCodeInfo:t,functionType:"EveryPred",params:n,arity:{min:1,max:1}}),arity:{min:1},docs:{category:"functional",returns:{type:"function"},args:{fun:{type:"function"},fns:{type:"function",rest:!0}},variants:[{argumentNames:["fun"]},{argumentNames:["fun","fns"]}],description:"\nTakes a number of predicates and returns a function that returns `true` if all predicates\nreturn a truthy value against all of its arguments, else it returns `false`.",seeAlso:["functional.some-pred","functional.complement","collection.every?"],examples:['let { every-pred } = import(functional);\nevery-pred(string?, -> count($) > 3)(\n  "Albert",\n  "Mojir"\n)','let { every-pred } = import(functional);\n(string? every-pred -> count($) > 3)(\n  "Albert",\n  "M"\n)'],hideOperatorForm:!0}},"some-pred":{evaluate:(n,t)=>({[u]:!0,sourceCodeInfo:t,functionType:"SomePred",params:n,arity:{min:1,max:1}}),arity:{min:1},docs:{category:"functional",returns:{type:"function"},args:{fun:{type:"function"},fns:{type:"function",rest:!0}},variants:[{argumentNames:["fun"]},{argumentNames:["fun","fns"]}],description:"Takes a number of `predicates` and returns a function that returns `true` if at least one of the `predicates` return a truthy `true` value against at least one of its arguments, else it returns `false`.",seeAlso:["functional.every-pred","functional.complement","collection.any?"],examples:['let { some-pred } = import(functional);\nsome-pred(string?, -> count($) > 3)("Albert", "Mojir")','let { some-pred } = import(functional);\nsome-pred(string?, -> count($) > 3)("a", "M")','let { some-pred } = import(functional);\nsome-pred(string?, -> count($) > 3)("a", [1, 2, 3])',"let { some-pred } = import(functional);\nsome-pred(string?, -> count($) > 3)([1, 2, 3], [2])"],hideOperatorForm:!0}},fnull:{evaluate:([n,...t],e)=>{const r=y(n,e);return{[u]:!0,sourceCodeInfo:e,functionType:"Fnull",function:r,params:t,arity:g(r)}},arity:{min:2},docs:{category:"functional",returns:{type:"function"},args:{a:{type:"function"},b:{type:"any"},fun:{type:"function"},arg:{type:"any"},args:{type:"any",rest:!0}},variants:[{argumentNames:["fun","arg"]},{argumentNames:["fun","arg","args"]}],description:"Takes a function $fun, and returns a function that calls $fun, replacing a null argument to the corresponding argument.",seeAlso:["identity","constantly"],examples:["let { fnull } = import(functional);\nfnull(inc, 0)(1)","let { fnull } = import(functional);\nfnull(inc, 0)(null)","let { fnull } = import(functional);\n(inc fnull 0)(null)","let { fnull } = import(functional);\nfnull(+, 1, 2)(null, 0)","let { fnull } = import(functional);\nfnull(+, 1, 2)(0, null)","let { fnull } = import(functional);\nfnull(+, 1, 2)(null, null)","let { fnull } = import(functional);\nfnull(+, 1, 2)(null, null, 3, 4)"]}}},v={name:"functional",functions:b,source:"{}",docs:(x=b,Object.fromEntries(Object.entries(x).map(([n,t])=>{if(!t.docs)throw new Error(`Missing docs for function "${n}"`);return[n,t.docs]})))};var x;exports.functionalUtilsModule=v;
-//# sourceMappingURL=functional.js.map

package/dist/modules/functional.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"functional.js","sources":["../../src/utils/debug/getCodeMarker.ts","../../src/errors.ts","../../src/constants/constants.ts","../../src/utils/symbols.ts","../../src/utils/debug/debugTools.ts","../../src/typeGuards/dvalaFunction.ts","../../src/typeGuards/dvala.ts","../../src/utils/getAssertionError.ts","../../src/utils/debug/getSourceCodeInfo.ts","../../src/utils/arity.ts","../../src/builtin/modules/functional/index.ts","../../src/builtin/modules/functional/functional.dvala","../../src/builtin/modules/interface.ts"],"sourcesContent":["import type { SourceCodeInfo } from '../../tokenizer/token'\n\nexport function getCodeMarker(sourceCodeInfo: SourceCodeInfo): string {\n  if (!sourceCodeInfo.position || !sourceCodeInfo.code)\n    return ''\n\n  const leftPadding = sourceCodeInfo.position.column - 1\n  const rightPadding = sourceCodeInfo.code.length - leftPadding - 1\n  return `${' '.repeat(Math.max(leftPadding, 0))}^${' '.repeat(Math.max(rightPadding, 0))}`\n}\n","import { getCodeMarker } from '../src/utils/debug/getCodeMarker'\nimport type { Arr } from './interface'\nimport type { SourceCodeInfo } from './tokenizer/token'\n\nfunction getDvalaErrorMessage(message: string, sourceCodeInfo?: SourceCodeInfo) {\n  if (!sourceCodeInfo) {\n    return message\n  }\n  const location = `${sourceCodeInfo.position.line}:${sourceCodeInfo.position.column}`\n  const filePathLine = sourceCodeInfo.filePath\n    ? `\\n${sourceCodeInfo.filePath}:${location}`\n    : `\\nLocation ${location}`\n  const codeLine = `\\n${sourceCodeInfo.code}`\n  const codeMarker = `\\n${getCodeMarker(sourceCodeInfo)}`\n  return `${message}${filePathLine}${codeLine}${codeMarker}`\n}\n\nexport class RecurSignal extends Error {\n  public params: Arr\n  constructor(params: Arr) {\n    super(`recur, params: ${params}`)\n    Object.setPrototypeOf(this, RecurSignal.prototype)\n    this.name = 'RecurSignal'\n    this.params = params\n  }\n}\n\nexport class DvalaError extends Error {\n  public readonly sourceCodeInfo?: SourceCodeInfo\n  public readonly shortMessage: string\n  constructor(err: unknown, sourceCodeInfo: SourceCodeInfo | undefined) {\n    const message = err instanceof Error\n      ? err.message\n      : `${err}`\n\n    super(getDvalaErrorMessage(message, sourceCodeInfo))\n    this.shortMessage = message\n    this.sourceCodeInfo = sourceCodeInfo\n    Object.setPrototypeOf(this, DvalaError.prototype)\n    this.name = 'DvalaError'\n  }\n\n  public getCodeMarker(): string | undefined {\n    return this.sourceCodeInfo && getCodeMarker(this.sourceCodeInfo)\n  }\n}\n\nexport class UserDefinedError extends DvalaError {\n  public userMessage: string\n  constructor(message: string, sourceCodeInfo?: SourceCodeInfo) {\n    super(message, sourceCodeInfo)\n    this.userMessage = message\n    Object.setPrototypeOf(this, UserDefinedError.prototype)\n    this.name = 'UserDefinedError'\n  }\n}\n\nexport class AssertionError extends DvalaError {\n  constructor(message: string | Error, sourceCodeInfo?: SourceCodeInfo) {\n    super(message, sourceCodeInfo)\n    Object.setPrototypeOf(this, AssertionError.prototype)\n    this.name = 'AssertionError'\n  }\n}\n\nexport class UndefinedSymbolError extends DvalaError {\n  public symbol: string\n  constructor(symbolName: string, sourceCodeInfo?: SourceCodeInfo) {\n    const message = `Undefined symbol '${symbolName}'.`\n    super(message, sourceCodeInfo)\n    this.symbol = symbolName\n    Object.setPrototypeOf(this, UndefinedSymbolError.prototype)\n    this.name = 'UndefinedSymbolError'\n  }\n}\n\nexport function isDvalaError(error: unknown): error is DvalaError {\n  return error instanceof DvalaError\n}\n","export const NodeTypes = {\n  Number: 1,\n  String: 2,\n  NormalExpression: 3,\n  SpecialExpression: 4,\n  UserDefinedSymbol: 5,\n  NormalBuiltinSymbol: 6,\n  SpecialBuiltinSymbol: 7,\n  ReservedSymbol: 8,\n  Binding: 9,\n  Spread: 10,\n} as const\n\nconst NodeTypesSet = new Set(Object.values(NodeTypes))\n\nexport type NodeType = typeof NodeTypes[keyof typeof NodeTypes]\n\nexport function getNodeTypeName(type: NodeType): keyof typeof NodeTypes {\n  return Object.keys(NodeTypes).find(key => NodeTypes[key as keyof typeof NodeTypes] === type) as keyof typeof NodeTypes\n}\n\n// TODO, is this needed?\nexport function isNodeType(type: unknown): type is NodeType {\n  return typeof type === 'number' && NodeTypesSet.has(type as NodeType)\n}\n\nconst functionTypes = [\n  'UserDefined',\n  'Partial',\n  'Comp',\n  'Constantly',\n  'Juxt',\n  'Complement',\n  'EveryPred',\n  'SomePred',\n  'Fnull',\n  'EffectMatcher',\n  'Builtin',\n  'SpecialBuiltin',\n  'Module',\n] as const\n\nconst functionTypeSet = new Set(functionTypes)\n\nexport type FunctionType = typeof functionTypes[number]\n\nexport function isFunctionType(type: unknown): type is FunctionType {\n  return typeof type === 'string' && functionTypeSet.has(type as FunctionType)\n}\n","export const FUNCTION_SYMBOL = '^^fn^^'\nexport const REGEXP_SYMBOL = '^^re^^'\nexport const EFFECT_SYMBOL = '^^ef^^'\n","import { getNodeTypeName, isFunctionType, isNodeType } from '../../constants/constants'\nimport type { AstNode, DvalaFunction } from '../../parser/types'\nimport { FUNCTION_SYMBOL } from '../symbols'\n\nfunction isDvalaFunction(func: unknown): func is DvalaFunction {\n  if (func === null || typeof func !== 'object')\n    return false\n\n  return FUNCTION_SYMBOL in func && 'functionType' in func && isFunctionType(func.functionType)\n}\n\nfunction isNode(value: unknown): value is AstNode {\n  if (!Array.isArray(value) || value.length < 2)\n    return false\n  return isNodeType(value[0])\n}\n\nexport function valueToString(value: unknown): string {\n  if (isDvalaFunction(value))\n    // eslint-disable-next-line ts/no-unsafe-member-access\n    return `<function ${(value as any).name || '\\u03BB'}>`\n\n  if (isNode(value))\n    return `${getNodeTypeName(value[0])}-node`\n\n  if (value === null)\n    return 'null'\n\n  if (typeof value === 'object' && value instanceof RegExp)\n    return `${value}`\n\n  if (typeof value === 'object' && value instanceof Error)\n    return value.toString()\n\n  return JSON.stringify(value)\n}\n","import type { DvalaFunction, NormalBuiltinFunction, UserDefinedFunction } from '../parser/types'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { getAssertionError } from '../utils/getAssertionError'\nimport { FUNCTION_SYMBOL } from '../utils/symbols'\nimport { isUnknownRecord } from '.'\n\nexport function isDvalaFunction(value: unknown): value is DvalaFunction {\n  if (value === null || typeof value !== 'object')\n    return false\n\n  return !!(value as DvalaFunction)[FUNCTION_SYMBOL]\n}\nexport function asDvalaFunction(value: unknown, sourceCodeInfo?: SourceCodeInfo): DvalaFunction {\n  assertDvalaFunction(value, sourceCodeInfo)\n  return value\n}\nexport function assertDvalaFunction(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is DvalaFunction {\n  if (!isDvalaFunction(value))\n    throw getAssertionError('DvalaFunction', value, sourceCodeInfo)\n}\n\nexport function isUserDefinedFunction(value: unknown): value is UserDefinedFunction {\n  return isDvalaFunction(value) && value.functionType === 'UserDefined'\n}\nexport function asUserDefinedFunction(value: unknown, sourceCodeInfo?: SourceCodeInfo): UserDefinedFunction {\n  assertUserDefinedFunction(value, sourceCodeInfo)\n  return value\n}\nexport function assertUserDefinedFunction(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n): asserts value is UserDefinedFunction {\n  if (!isUserDefinedFunction(value))\n    throw getAssertionError('UserDefinedFunction', value, sourceCodeInfo)\n}\n\nexport function isBuiltinFunction(value: unknown): value is NormalBuiltinFunction {\n  return isUnknownRecord(value) && value.functionType === 'Builtin'\n}\n","import type { Any, Coll, Obj, Seq } from '../interface'\nimport type { EffectRef, FunctionLike, RegularExpression } from '../parser/types'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { getAssertionError } from '../utils/getAssertionError'\nimport { EFFECT_SYMBOL, REGEXP_SYMBOL } from '../utils/symbols'\nimport { isDvalaFunction } from './dvalaFunction'\n\nexport function isAny(value: unknown): value is Any {\n  // TODO weak test\n  return value !== undefined\n}\nexport function asAny(value: unknown, sourceCodeInfo?: SourceCodeInfo): Any {\n  assertAny(value, sourceCodeInfo)\n  return value\n}\nexport function assertAny(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is Any {\n  if (!isAny(value))\n    throw getAssertionError('not undefined', value, sourceCodeInfo)\n}\n\nexport function isSeq(value: unknown): value is Seq {\n  return Array.isArray(value) || typeof value === 'string'\n}\nexport function asSeq(value: unknown, sourceCodeInfo?: SourceCodeInfo): Seq {\n  assertSeq(value, sourceCodeInfo)\n  return value\n}\nexport function assertSeq(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is Seq {\n  if (!isSeq(value))\n    throw getAssertionError('string or array', value, sourceCodeInfo)\n}\n\nexport function isObj(value: unknown): value is Obj {\n  return !(\n    value === null\n    || typeof value !== 'object'\n    || Array.isArray(value)\n    || value instanceof RegExp\n    || isDvalaFunction(value)\n    || isRegularExpression(value)\n    || isEffect(value)\n  )\n}\nexport function asObj(value: unknown, sourceCodeInfo?: SourceCodeInfo): Obj {\n  assertObj(value, sourceCodeInfo)\n  return value\n}\nexport function assertObj(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is Obj {\n  if (!isObj(value))\n    throw getAssertionError('object', value, sourceCodeInfo)\n}\n\nexport function isColl(value: unknown): value is Coll {\n  return isSeq(value) || isObj(value)\n}\nexport function asColl(value: unknown, sourceCodeInfo?: SourceCodeInfo): Coll {\n  assertColl(value, sourceCodeInfo)\n  return value\n}\nexport function assertColl(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is Coll {\n  if (!isColl(value))\n    throw getAssertionError('string, array or object', value, sourceCodeInfo)\n}\n\nexport function isRegularExpression(regexp: unknown): regexp is RegularExpression {\n  if (regexp === null || typeof regexp !== 'object')\n    return false\n\n  return !!(regexp as RegularExpression)[REGEXP_SYMBOL]\n}\nexport function asRegularExpression(value: unknown, sourceCodeInfo?: SourceCodeInfo): RegularExpression {\n  assertRegularExpression(value, sourceCodeInfo)\n  return value\n}\nexport function assertRegularExpression(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n): asserts value is RegularExpression {\n  if (!isRegularExpression(value))\n    throw getAssertionError('RegularExpression', value, sourceCodeInfo)\n}\n\nexport function isStringOrRegularExpression(value: unknown): value is string | RegularExpression {\n  return isRegularExpression(value) || typeof value === 'string'\n}\nexport function asStringOrRegularExpression(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n): string | RegularExpression {\n  assertStringOrRegularExpression(value, sourceCodeInfo)\n  return value\n}\nexport function assertStringOrRegularExpression(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n): asserts value is string | RegularExpression {\n  if (!isStringOrRegularExpression(value))\n    throw getAssertionError('string or RegularExpression', value, sourceCodeInfo)\n}\n\nexport function isEffect(value: unknown): value is EffectRef {\n  if (value === null || typeof value !== 'object')\n    return false\n\n  return !!(value as EffectRef)[EFFECT_SYMBOL]\n}\nexport function asEffect(value: unknown, sourceCodeInfo?: SourceCodeInfo): EffectRef {\n  assertEffect(value, sourceCodeInfo)\n  return value\n}\nexport function assertEffect(\n  value: unknown,\n  sourceCodeInfo?: SourceCodeInfo,\n): asserts value is EffectRef {\n  if (!isEffect(value))\n    throw getAssertionError('Effect', value, sourceCodeInfo)\n}\n\nfunction isFunctionLike(value: unknown): value is FunctionLike {\n  if (typeof value === 'number')\n    return true\n  if (isColl(value))\n    return true\n  if (isDvalaFunction(value))\n    return true\n\n  return false\n}\nexport function asFunctionLike(value: unknown, sourceCodeInfo?: SourceCodeInfo): FunctionLike {\n  assertFunctionLike(value, sourceCodeInfo)\n  return value\n}\nexport function assertFunctionLike(value: unknown, sourceCodeInfo?: SourceCodeInfo): asserts value is FunctionLike {\n  if (!isFunctionLike(value))\n    throw getAssertionError('FunctionLike', value, sourceCodeInfo)\n}\n","import { DvalaError } from '../errors'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { valueToString } from './debug/debugTools'\nimport { getSourceCodeInfo } from './debug/getSourceCodeInfo'\n\nexport function getAssertionError(typeName: string, value: unknown, sourceCodeInfo?: SourceCodeInfo): DvalaError {\n  return new DvalaError(`Expected ${typeName}, got ${valueToString(value)}.`, getSourceCodeInfo(value, sourceCodeInfo))\n}\n","import type { SourceCodeInfo } from '../../tokenizer/token'\n\nexport function getSourceCodeInfo(anyValue: any, sourceCodeInfo: SourceCodeInfo | undefined): SourceCodeInfo | undefined {\n  // eslint-disable-next-line ts/no-unsafe-return, ts/no-unsafe-member-access\n  return anyValue?.sourceCodeInfo ?? sourceCodeInfo\n}\n","import type { Arity } from '../builtin/interface'\nimport { DvalaError } from '../errors'\nimport type { FunctionLike } from '../parser/types'\nimport type { SourceCodeInfo } from '../tokenizer/token'\nimport { isColl } from '../typeGuards/dvala'\nimport { valueToString } from './debug/debugTools'\n\nexport function arityAccepts(arity: Arity, nbrOfParams: number): boolean {\n  const { min, max } = arity\n  if (typeof min === 'number' && nbrOfParams < min) {\n    return false\n  }\n  if (typeof max === 'number' && nbrOfParams > max) {\n    return false\n  }\n  return true\n}\n\nexport function arityAcceptsMin(arity: Arity, nbrOfParams: number): boolean {\n  const { min } = arity\n  if (typeof min === 'number' && nbrOfParams < min) {\n    return false\n  }\n  return true\n}\n\nexport function getCommonArityFromFunctions(params: FunctionLike[]): Arity | null {\n  return params.reduce((acc: Arity | null, param): Arity | null => {\n    if (acc === null) {\n      return null\n    }\n    const arity: Arity = (typeof param === 'number' || isColl(param)) ? toFixedArity(1) : param.arity\n    const { min: aMin, max: aMax } = arity\n    const { min: bMin, max: bMax } = acc\n    const min = typeof aMin === 'number' && typeof bMin === 'number'\n      ? Math.max(aMin, bMin)\n      : typeof aMin === 'number' ? aMin : typeof bMin === 'number' ? bMin : undefined\n    const max = typeof aMax === 'number' && typeof bMax === 'number'\n      ? Math.min(aMax, bMax)\n      : typeof aMax === 'number' ? aMax : typeof bMax === 'number' ? bMax : undefined\n\n    if (typeof min === 'number' && typeof max === 'number' && min > max) {\n      return null\n    }\n\n    return { min, max }\n  }, {})\n}\n\nexport function getArityFromFunction(param: FunctionLike): Arity {\n  return (typeof param === 'number' || isColl(param)) ? toFixedArity(1) : param.arity\n}\n\nexport function assertNumberOfParams(arity: Arity, length: number, sourceCodeInfo: SourceCodeInfo | undefined): void {\n  const { min, max } = arity\n  if (typeof min === 'number' && length < min) {\n    throw new DvalaError(\n      `Wrong number of arguments, expected at least ${min}, got ${valueToString(length)}.`,\n      sourceCodeInfo,\n    )\n  }\n\n  if (typeof max === 'number' && length > max) {\n    throw new DvalaError(\n      `Wrong number of arguments, expected at most ${max}, got ${valueToString(length)}.`,\n      sourceCodeInfo,\n    )\n  }\n}\n\nexport function canBeOperator(count: Arity): boolean {\n  if (typeof count.max === 'number' && count.max < 2) {\n    return false\n  }\n\n  if (typeof count.min === 'number' && count.min > 2) {\n    return false\n  }\n\n  return true\n}\n\nexport function toFixedArity(arity: number): Arity {\n  return { min: arity, max: arity }\n}\n","import type { Arr } from '../../../interface'\nimport type {\n  ComplementFunction,\n  EveryPredFunction,\n  FNullFunction,\n  FunctionLike,\n  JuxtFunction,\n  SomePredFunction,\n} from '../../../parser/types'\nimport { getArityFromFunction, getCommonArityFromFunctions, toFixedArity } from '../../../utils/arity'\nimport { FUNCTION_SYMBOL } from '../../../utils/symbols'\nimport type { BuiltinNormalExpressions } from '../../interface'\nimport { asFunctionLike, assertFunctionLike } from '../../../typeGuards/dvala'\nimport { DvalaError } from '../../../errors'\nimport { moduleDocsFromFunctions } from '../interface'\nimport type { DvalaModule } from '../interface'\nimport functionalModuleSource from './functional.dvala'\n\nconst functionalUtilsNormalExpression: BuiltinNormalExpressions = {\n  'juxt': {\n    evaluate: (params, sourceCodeInfo): JuxtFunction => {\n      params.forEach(param => assertFunctionLike(param, sourceCodeInfo))\n      const arity = getCommonArityFromFunctions(params as FunctionLike[])\n      if (arity === null) {\n        throw new DvalaError('All functions must accept the same number of arguments', sourceCodeInfo)\n      }\n      return {\n        [FUNCTION_SYMBOL]: true,\n        sourceCodeInfo,\n        functionType: 'Juxt',\n        params,\n        arity,\n      }\n    },\n    arity: { min: 1 },\n    docs: {\n      category: 'functional',\n      returns: { type: 'function' },\n      args: {\n        a: { type: 'function' },\n        b: { type: 'function' },\n        fun: { type: 'function' },\n        fns: { type: 'function', rest: true },\n      },\n      variants: [\n        { argumentNames: ['fun'] },\n        { argumentNames: ['fun', 'fns'] },\n      ],\n      description: `Takes one or many function and returns a function that is the juxtaposition of those functions.\nThe returned function takes a variable number of args,\nand returns a vector containing the result of applying each function to the args (left-to-right).`,\n      seeAlso: ['comp'],\n      examples: [\n        `let { juxt } = import(functional);\njuxt(+, *, min, max)(\n  3,\n  4,\n  6,\n)`,\n        `let { juxt } = import(functional);\njuxt(\"a\", \"b\")(\n  {\n    a: 1,\n    b: 2,\n    c: 3,\n    d: 4\n  }\n)`,\n        `let { juxt } = import(functional);\njuxt(+, *, min, max) apply range(1, 11)`,\n      ],\n    },\n  },\n\n  'complement': {\n    evaluate: ([fn], sourceCodeInfo): ComplementFunction => {\n      const fun = asFunctionLike(fn, sourceCodeInfo)\n      return {\n        [FUNCTION_SYMBOL]: true,\n        sourceCodeInfo,\n        functionType: 'Complement',\n        function: fun,\n        arity: getArityFromFunction(fun),\n      }\n    },\n    arity: toFixedArity(1),\n    docs: {\n      category: 'functional',\n      returns: { type: 'function' },\n      args: { fun: { type: 'function' } },\n      variants: [{ argumentNames: ['fun'] }],\n      description: 'Takes a function $fun and returns a new function that takes the same arguments as f, has the same effects, if any, and returns the opposite truth value.',\n      seeAlso: ['comp', 'functional.every-pred', 'functional.some-pred'],\n      examples: [\n        'let { complement } = import(functional);\\ncomplement(>)(1, 3)',\n        'let { complement } = import(functional);\\ncomplement(<)(1, 3)',\n        'let { complement } = import(functional);\\ncomplement(+)(1, 3)',\n        'let { complement } = import(functional);\\ncomplement(+)(0, 0)',\n      ],\n    },\n  },\n\n  'every-pred': {\n    evaluate: (params, sourceCodeInfo): EveryPredFunction => {\n      return {\n        [FUNCTION_SYMBOL]: true,\n        sourceCodeInfo,\n        functionType: 'EveryPred',\n        params,\n        arity: { min: 1, max: 1 },\n      }\n    },\n    arity: { min: 1 },\n    docs: {\n      category: 'functional',\n      returns: { type: 'function' },\n      args: {\n        fun: { type: 'function' },\n        fns: { type: 'function', rest: true },\n      },\n      variants: [\n        { argumentNames: ['fun'] },\n        { argumentNames: ['fun', 'fns'] },\n      ],\n      description: `\nTakes a number of predicates and returns a function that returns \\`true\\` if all predicates\nreturn a truthy value against all of its arguments, else it returns \\`false\\`.`,\n      seeAlso: ['functional.some-pred', 'functional.complement', 'collection.every?'],\n      examples: [\n        `let { every-pred } = import(functional);\nevery-pred(string?, -> count($) > 3)(\n  \"Albert\",\n  \"Mojir\"\n)`,\n        `let { every-pred } = import(functional);\n(string? every-pred -> count($) > 3)(\n  \"Albert\",\n  \"M\"\n)`,\n      ],\n      hideOperatorForm: true,\n    },\n  },\n\n  'some-pred': {\n    evaluate: (params, sourceCodeInfo): SomePredFunction => {\n      return {\n        [FUNCTION_SYMBOL]: true,\n        sourceCodeInfo,\n        functionType: 'SomePred',\n        params,\n        arity: { min: 1, max: 1 },\n      }\n    },\n    arity: { min: 1 },\n    docs: {\n      category: 'functional',\n      returns: { type: 'function' },\n      args: {\n        fun: { type: 'function' },\n        fns: { type: 'function', rest: true },\n      },\n      variants: [\n        { argumentNames: ['fun'] },\n        { argumentNames: ['fun', 'fns'] },\n      ],\n      description: 'Takes a number of `predicates` and returns a function that returns `true` if at least one of the `predicates` return a truthy `true` value against at least one of its arguments, else it returns `false`.',\n      seeAlso: ['functional.every-pred', 'functional.complement', 'collection.any?'],\n      examples: [\n        'let { some-pred } = import(functional);\\nsome-pred(string?, -> count($) > 3)(\"Albert\", \"Mojir\")',\n        'let { some-pred } = import(functional);\\nsome-pred(string?, -> count($) > 3)(\"a\", \"M\")',\n        'let { some-pred } = import(functional);\\nsome-pred(string?, -> count($) > 3)(\"a\", [1, 2, 3])',\n        'let { some-pred } = import(functional);\\nsome-pred(string?, -> count($) > 3)([1, 2, 3], [2])',\n      ],\n      hideOperatorForm: true,\n    },\n  },\n\n  'fnull': {\n    evaluate: ([fn, ...params]: Arr, sourceCodeInfo): FNullFunction => {\n      const fun = asFunctionLike(fn, sourceCodeInfo)\n      return {\n        [FUNCTION_SYMBOL]: true,\n        sourceCodeInfo,\n        functionType: 'Fnull',\n        function: fun,\n        params,\n        arity: getArityFromFunction(fun),\n      }\n    },\n    arity: { min: 2 },\n    docs: {\n      category: 'functional',\n      returns: { type: 'function' },\n      args: {\n        a: { type: 'function' },\n        b: { type: 'any' },\n        fun: { type: 'function' },\n        arg: { type: 'any' },\n        args: { type: 'any', rest: true },\n      },\n      variants: [\n        { argumentNames: ['fun', 'arg'] },\n        { argumentNames: ['fun', 'arg', 'args'] },\n      ],\n      description: 'Takes a function $fun, and returns a function that calls $fun, replacing a null argument to the corresponding argument.',\n      seeAlso: ['identity', 'constantly'],\n      examples: [\n        'let { fnull } = import(functional);\\nfnull(inc, 0)(1)',\n        'let { fnull } = import(functional);\\nfnull(inc, 0)(null)',\n        'let { fnull } = import(functional);\\n(inc fnull 0)(null)',\n        'let { fnull } = import(functional);\\nfnull(+, 1, 2)(null, 0)',\n        'let { fnull } = import(functional);\\nfnull(+, 1, 2)(0, null)',\n        'let { fnull } = import(functional);\\nfnull(+, 1, 2)(null, null)',\n        'let { fnull } = import(functional);\\nfnull(+, 1, 2)(null, null, 3, 4)',\n      ],\n    },\n  },\n}\n\nexport const functionalUtilsModule: DvalaModule = {\n  name: 'functional',\n  functions: functionalUtilsNormalExpression,\n  source: functionalModuleSource,\n  docs: moduleDocsFromFunctions(functionalUtilsNormalExpression),\n}\n","{}","import type { BuiltinNormalExpressions, FunctionDocs } from '../../builtin/interface'\n\n/**\n * Represents a Dvala module that can be imported dynamically.\n * Modules contain a collection of functions that are not part of the core bundle.\n */\nexport interface DvalaModule {\n  /** The name of the module (e.g., 'grid', 'vec', 'mat') */\n  name: string\n  /** The functions provided by this module, keyed by their short name (e.g., 'transpose') */\n  functions: BuiltinNormalExpressions\n  /**\n   * Optional Dvala source code that is evaluated at import time.\n   * The source must evaluate to an object mapping function names to functions.\n   * These are merged with (and may override) the TypeScript `functions`.\n   */\n  source?: string\n  /**\n   * Docs for all functions in this module, including any defined in `source`.\n   * The reference system uses this record as the sole source of truth for\n   * function names and documentation. Not required for user-defined modules.\n   */\n  docs?: Record<string, FunctionDocs>\n}\n\n/**\n * Derives a docs record from a BuiltinNormalExpressions map.\n * Use this for modules whose docs are co-located inline on each function.\n */\nexport function moduleDocsFromFunctions(functions: BuiltinNormalExpressions): Record<string, FunctionDocs> {\n  return Object.fromEntries(\n    Object.entries(functions).map(([k, v]) => {\n      if (!v.docs)\n        throw new Error(`Missing docs for function \"${k}\"`)\n      return [k, v.docs]\n    }),\n  )\n}\n"],"names":["getCodeMarker","sourceCodeInfo","position","code","leftPadding","column","rightPadding","length","repeat","Math","max","DvalaError","Error","shortMessage","constructor","err","message","super","location","line","filePath","getDvalaErrorMessage","this","Object","setPrototypeOf","prototype","name","NodeTypes","Number","String","NormalExpression","SpecialExpression","UserDefinedSymbol","NormalBuiltinSymbol","SpecialBuiltinSymbol","ReservedSymbol","Binding","Spread","NodeTypesSet","Set","values","functionTypeSet","FUNCTION_SYMBOL","REGEXP_SYMBOL","EFFECT_SYMBOL","isDvalaFunction","func","type","functionType","has","isNode","value","Array","isArray","valueToString","keys","find","key","RegExp","toString","JSON","stringify","isObj","regexp","isEffect","isColl","isSeq","asFunctionLike","assertFunctionLike","isFunctionLike","typeName","anyValue","getSourceCodeInfo","getAssertionError","getArityFromFunction","param","toFixedArity","arity","min","functionalUtilsNormalExpression","juxt","evaluate","params","forEach","reduce","acc","aMin","aMax","bMin","bMax","undefined","getCommonArityFromFunctions","docs","category","returns","args","a","b","fun","fns","rest","variants","argumentNames","description","seeAlso","examples","complement","fn","function","hideOperatorForm","fnull","arg","functionalUtilsModule","functions","source","fromEntries","entries","map","k","v"],"mappings":"aAEM,SAAUA,EAAcC,GAC5B,IAAKA,EAAeC,WAAaD,EAAeE,KAC9C,MAAO,GAET,MAAMC,EAAcH,EAAeC,SAASG,OAAS,EAC/CC,EAAeL,EAAeE,KAAKI,OAASH,EAAc,EAChE,MAAO,GAAG,IAAII,OAAOC,KAAKC,IAAIN,EAAa,OAAO,IAAII,OAAOC,KAAKC,IAAIJ,EAAc,KACtF,CCkBM,MAAOK,UAAmBC,MACdX,eACAY,aAChB,WAAAC,CAAYC,EAAcd,GACxB,MAAMe,EAAUD,aAAeH,MAC3BG,EAAIC,QACJ,GAAGD,IAEPE,MA/BJ,SAA8BD,EAAiBf,GAC7C,IAAKA,EACH,OAAOe,EAET,MAAME,EAAW,GAAGjB,EAAeC,SAASiB,QAAQlB,EAAeC,SAASG,SAM5E,MAAO,GAAGW,IALWf,EAAemB,SAChC,KAAKnB,EAAemB,YAAYF,IAChC,cAAcA,QACIjB,EAAeE,SACbH,EAAcC,IAExC,CAoBUoB,CAAqBL,EAASf,IACpCqB,KAAKT,aAAeG,EACpBM,KAAKrB,eAAiBA,EACtBsB,OAAOC,eAAeF,KAAMX,EAAWc,WACvCH,KAAKI,KAAO,YACb,CAEM,aAAA1B,GACL,OAAOsB,KAAKrB,gBAAkBD,EAAcsB,KAAKrB,eAClD,EC5CI,MAAM0B,EAAY,CACvBC,OAAQ,EACRC,OAAQ,EACRC,iBAAkB,EAClBC,kBAAmB,EACnBC,kBAAmB,EACnBC,oBAAqB,EACrBC,qBAAsB,EACtBC,eAAgB,EAChBC,QAAS,EACTC,OAAQ,IAGJC,EAAe,IAAIC,IAAIhB,OAAOiB,OAAOb,IAa3C,MAgBMc,EAAkB,IAAIF,IAhBN,CACpB,cACA,UACA,OACA,aACA,OACA,aACA,YACA,WACA,QACA,gBACA,UACA,iBACA,WCvCK,MAAMG,EAAkB,SAClBC,EAAgB,SAChBC,EAAgB,SCE7B,SAASC,EAAgBC,GACvB,OAAa,OAATA,GAAiC,iBAATA,IAGrBJ,KAAmBI,GAAQ,iBAAkBA,IFuC7B,iBADMC,EEtC8CD,EAAKE,eFuC7CP,EAAgBQ,IAAIF,KADnD,IAAyBA,CErC/B,CAEA,SAASG,EAAOC,GACd,SAAKC,MAAMC,QAAQF,IAAUA,EAAM5C,OAAS,KFWrB,iBADEwC,EERPI,EAAM,KFSWb,EAAaW,IAAIF,IADhD,IAAqBA,CEP3B,CAEM,SAAUO,EAAcH,GAC5B,OAAIN,EAAgBM,GAEX,aAAcA,EAAczB,MAAQ,OAEzCwB,EAAOC,GACF,GFNqBJ,EEMFI,EAAM,GFL3B5B,OAAOgC,KAAK5B,GAAW6B,KAAKC,GAAO9B,EAAU8B,KAAmCV,UEOzE,OAAVI,EACK,OAEY,iBAAVA,GAAsBA,aAAiBO,OACzC,GAAGP,IAES,iBAAVA,GAAsBA,aAAiBvC,MACzCuC,EAAMQ,WAERC,KAAKC,UAAUV,GFjBlB,IAA0BJ,CEkBhC,CC7BM,SAAUF,EAAgBM,GAC9B,OAAc,OAAVA,GAAmC,iBAAVA,KAGnBA,EAAwBT,EACpC,CCqBM,SAAUoB,EAAMX,GACpB,QACY,OAAVA,GACoB,iBAAVA,GACPC,MAAMC,QAAQF,IACdA,aAAiBO,QACjBb,EAAgBM,KA0BaY,EAzBTZ,EA0BV,OAAXY,GAAqC,iBAAXA,GAGpBA,EAA6BpB,KAgCnC,SAAmBQ,GACvB,OAAc,OAAVA,GAAmC,iBAAVA,KAGnBA,EAAoBP,EAChC,CAjEOoB,CAASb,IAwBV,IAA8BY,CAtBpC,CAUM,SAAUE,EAAOd,GACrB,OAjCI,SAAgBA,GACpB,OAAOC,MAAMC,QAAQF,IAA2B,iBAAVA,CACxC,CA+BSe,CAAMf,IAAUW,EAAMX,EAC/B,CA0EgB,SAAAgB,EAAehB,EAAgBlD,GAE7C,OADAmE,EAAmBjB,EAAOlD,GACnBkD,CACT,CACgB,SAAAiB,EAAmBjB,EAAgBlD,GACjD,IAfF,SAAwBkD,GACtB,MAAqB,iBAAVA,KAEPc,EAAOd,MAEPN,EAAgBM,EAItB,CAMOkB,CAAelB,GAClB,eCjI8BmB,EAAkBnB,EAAgBlD,GAClE,OAAO,IAAIU,EAAW,YAAY2D,UAAiBhB,EAAcH,MCJnD,SAAkBoB,EAAetE,GAE/C,OAAOsE,GAAUtE,gBAAkBA,CACrC,CDC8EuE,CAAkBrB,EAAOlD,GACvG,CD+HUwE,CAAkB,eAAgBtB,EAAOlD,EACnD,CGtFM,SAAUyE,EAAqBC,GACnC,MAAyB,iBAAVA,GAAsBV,EAAOU,GAAUC,EAAa,GAAKD,EAAME,KAChF,CA+BM,SAAUD,EAAaC,GAC3B,MAAO,CAAEC,IAAKD,EAAOnE,IAAKmE,EAC5B,CClEA,MAAME,EAA4D,CAChEC,KAAQ,CACNC,SAAU,CAACC,EAAQjF,KACjBiF,EAAOC,QAAQR,GAASP,EAAmBO,EAAO1E,IAClD,MAAM4E,EDIN,SAAsCK,GAC1C,OAAOA,EAAOE,OAAO,CAACC,EAAmBV,KACvC,GAAY,OAARU,EACF,OAAO,KAET,MAAMR,EAAiC,iBAAVF,GAAsBV,EAAOU,GAAUC,EAAa,GAAKD,EAAME,OACpFC,IAAKQ,EAAM5E,IAAK6E,GAASV,GACzBC,IAAKU,EAAM9E,IAAK+E,GAASJ,EAC3BP,EAAsB,iBAATQ,GAAqC,iBAATE,EAC3C/E,KAAKC,IAAI4E,EAAME,GACC,iBAATF,EAAoBA,EAAuB,iBAATE,EAAoBA,OAAOE,EAClEhF,EAAsB,iBAAT6E,GAAqC,iBAATE,EAC3ChF,KAAKqE,IAAIS,EAAME,GACC,iBAATF,EAAoBA,EAAuB,iBAATE,EAAoBA,OAAOC,EAExE,MAAmB,iBAARZ,GAAmC,iBAARpE,GAAoBoE,EAAMpE,EACvD,KAGF,CAAEoE,MAAKpE,QACb,CAAE,EACP,CCzBoBiF,CAA4BT,GAC1C,GAAc,OAAVL,EACF,MAAM,IAAIlE,EAAW,yDAA0DV,GAEjF,MAAO,CACLyC,CAACA,IAAkB,EACnBzC,iBACA+C,aAAc,OACdkC,SACAL,UAGJA,MAAO,CAAEC,IAAK,GACdc,KAAM,CACJC,SAAU,aACVC,QAAS,CAAE/C,KAAM,YACjBgD,KAAM,CACJC,EAAG,CAAEjD,KAAM,YACXkD,EAAG,CAAElD,KAAM,YACXmD,IAAK,CAAEnD,KAAM,YACboD,IAAK,CAAEpD,KAAM,WAAYqD,MAAM,IAEjCC,SAAU,CACR,CAAEC,cAAe,CAAC,QAClB,CAAEA,cAAe,CAAC,MAAO,SAE3BC,YAAa,6PAGbC,QAAS,CAAC,QACVC,SAAU,CACR,iFAMA,8GASA,iFAMNC,WAAc,CACZzB,SAAU,EAAE0B,GAAK1G,KACf,MAAMiG,EAAM/B,EAAewC,EAAI1G,GAC/B,MAAO,CACLyC,CAACA,IAAkB,EACnBzC,iBACA+C,aAAc,aACd4D,SAAUV,EACVrB,MAAOH,EAAqBwB,KAGhCrB,MAAOD,EAAa,GACpBgB,KAAM,CACJC,SAAU,aACVC,QAAS,CAAE/C,KAAM,YACjBgD,KAAM,CAAEG,IAAK,CAAEnD,KAAM,aACrBsD,SAAU,CAAC,CAAEC,cAAe,CAAC,SAC7BC,YAAa,2JACbC,QAAS,CAAC,OAAQ,wBAAyB,wBAC3CC,SAAU,CACR,gEACA,gEACA,gEACA,mEAKN,aAAc,CACZxB,SAAU,CAACC,EAAQjF,KACV,CACLyC,CAACA,IAAkB,EACnBzC,iBACA+C,aAAc,YACdkC,SACAL,MAAO,CAAEC,IAAK,EAAGpE,IAAK,KAG1BmE,MAAO,CAAEC,IAAK,GACdc,KAAM,CACJC,SAAU,aACVC,QAAS,CAAE/C,KAAM,YACjBgD,KAAM,CACJG,IAAK,CAAEnD,KAAM,YACboD,IAAK,CAAEpD,KAAM,WAAYqD,MAAM,IAEjCC,SAAU,CACR,CAAEC,cAAe,CAAC,QAClB,CAAEA,cAAe,CAAC,MAAO,SAE3BC,YAAa,4KAGbC,QAAS,CAAC,uBAAwB,wBAAyB,qBAC3DC,SAAU,CACR,6GAKA,0GAMFI,kBAAkB,IAItB,YAAa,CACX5B,SAAU,CAACC,EAAQjF,KACV,CACLyC,CAACA,IAAkB,EACnBzC,iBACA+C,aAAc,WACdkC,SACAL,MAAO,CAAEC,IAAK,EAAGpE,IAAK,KAG1BmE,MAAO,CAAEC,IAAK,GACdc,KAAM,CACJC,SAAU,aACVC,QAAS,CAAE/C,KAAM,YACjBgD,KAAM,CACJG,IAAK,CAAEnD,KAAM,YACboD,IAAK,CAAEpD,KAAM,WAAYqD,MAAM,IAEjCC,SAAU,CACR,CAAEC,cAAe,CAAC,QAClB,CAAEA,cAAe,CAAC,MAAO,SAE3BC,YAAa,6MACbC,QAAS,CAAC,wBAAyB,wBAAyB,mBAC5DC,SAAU,CACR,kGACA,yFACA,+FACA,gGAEFI,kBAAkB,IAItBC,MAAS,CACP7B,SAAU,EAAE0B,KAAOzB,GAAcjF,KAC/B,MAAMiG,EAAM/B,EAAewC,EAAI1G,GAC/B,MAAO,CACLyC,CAACA,IAAkB,EACnBzC,iBACA+C,aAAc,QACd4D,SAAUV,EACVhB,SACAL,MAAOH,EAAqBwB,KAGhCrB,MAAO,CAAEC,IAAK,GACdc,KAAM,CACJC,SAAU,aACVC,QAAS,CAAE/C,KAAM,YACjBgD,KAAM,CACJC,EAAG,CAAEjD,KAAM,YACXkD,EAAG,CAAElD,KAAM,OACXmD,IAAK,CAAEnD,KAAM,YACbgE,IAAK,CAAEhE,KAAM,OACbgD,KAAM,CAAEhD,KAAM,MAAOqD,MAAM,IAE7BC,SAAU,CACR,CAAEC,cAAe,CAAC,MAAO,QACzB,CAAEA,cAAe,CAAC,MAAO,MAAO,UAElCC,YAAa,0HACbC,QAAS,CAAC,WAAY,cACtBC,SAAU,CACR,wDACA,2DACA,2DACA,+DACA,+DACA,kEACA,4EAMKO,EAAqC,CAChDtF,KAAM,aACNuF,UAAWlC,EACXmC,OC/Na,KDgObtB,MEnMsCqB,EFmMRlC,EElMvBxD,OAAO4F,YACZ5F,OAAO6F,QAAQH,GAAWI,IAAI,EAAEC,EAAGC,MACjC,IAAKA,EAAE3B,KACL,MAAM,IAAIhF,MAAM,8BAA8B0G,MAChD,MAAO,CAACA,EAAGC,EAAE3B,WALb,IAAkCqB"}