@algorandfoundation/puya-ts 1.0.0-alpha.10

package/cli.mjs

@@ -0,0 +1,161 @@
+import { Command, Option } from 'commander';
+import { z } from 'zod';
+import { globSync } from 'glob';
+import * as fs from 'node:fs';
+import upath from 'upath';
+import { n as normalisePath, l as logger, P as PuyaError, L as LogLevel, a as LocalsCoalescingStrategy, d as defaultPuyaOptions, c as compile } from './index-GbFBpbmB.js';
+import 'change-case';
+import 'node:path';
+import 'node:buffer';
+import 'node:util';
+import 'chalk';
+import 'polytype';
+import 'typescript';
+import 'tslib';
+import 'crypto';
+import 'fs';
+import 'os';
+import 'cross-spawn';
+
+const buildCompileOptions = ({ paths, workingDirectory = process.cwd(), outDir, ...rest }) => {
+    const filePaths = [];
+    for (const p of paths) {
+        if (p.endsWith('.algo.ts')) {
+            if (fs.existsSync(p)) {
+                const actualPath = normalisePath(p, workingDirectory);
+                filePaths.push({
+                    matchedInput: p,
+                    sourceFile: actualPath,
+                    outDir: upath.isAbsolute(outDir) ? upath.normalize(outDir) : upath.join(upath.dirname(actualPath), outDir),
+                });
+            }
+            else {
+                logger.warn(undefined, `File ${p} could not be found`);
+            }
+        }
+        else if (p.endsWith('.ts')) {
+            logger.warn(undefined, `Ignoring path ${p} as it does use the .algo.ts extension`);
+        }
+        else {
+            const matches = globSync(upath.join(p, '**/*.algo.ts'));
+            if (matches.length) {
+                for (const match of matches) {
+                    filePaths.push({
+                        matchedInput: p,
+                        sourceFile: normalisePath(match, workingDirectory),
+                        outDir: upath.join(upath.isAbsolute(outDir) ? outDir : upath.join(p, outDir), upath.relative(p, upath.dirname(match))),
+                    });
+                }
+            }
+            else {
+                logger.warn(undefined, `Path '${p}' did not match any .algo.ts files`);
+            }
+        }
+    }
+    if (filePaths.length === 0) {
+        throw new PuyaError('Input paths did not match any .algo.ts files');
+    }
+    return {
+        filePaths,
+        ...rest,
+        getFileFromSource(sourceFile) {
+            return filePaths.find((p) => p.sourceFile === sourceFile);
+        },
+    };
+};
+
+const cliOptionsSchema = z.object({
+    outputAwst: z.boolean(),
+    outputAwstJson: z.boolean(),
+    outDir: z.string(),
+    dryRun: z.boolean(),
+    logLevel: z.nativeEnum(LogLevel),
+    // Puya options
+    outputTeal: z.boolean(),
+    outputArc32: z.boolean(),
+    outputSsaIr: z.boolean(),
+    outputOptimizationIr: z.boolean(),
+    outputDestructuredIr: z.boolean(),
+    outputMemoryIr: z.boolean(),
+    outputBytecode: z.boolean(),
+    matchAlgodBytecode: z.boolean(),
+    debugLevel: z.number().int(),
+    optimizationLevel: z.number().int(),
+    targetAvmVersion: z.number().int(),
+    cliTemplateDefinitions: z.preprocess((x) => x ?? [], z.array(z.string())),
+    templateVarsPrefix: z.string(),
+    localsCoalescingStrategy: z.nativeEnum(LocalsCoalescingStrategy),
+});
+const cliArgumentsSchema = z.array(z.string());
+function cli() {
+    const commander = new Command().name('puya-ts').description('Algo-TS to Algorand smart contract compiler');
+    commander.helpCommand(true);
+    commander
+        .command('build')
+        .argument('<paths...>', 'The path, or paths to search for compatible .algo.ts files')
+        .addOption(new Option('--log-level [level]', 'The minimum log level to output')
+        .choices([LogLevel.Debug, LogLevel.Info, LogLevel.Warn, LogLevel.Error, LogLevel.Critical])
+        .default(LogLevel.Info))
+        .addOption(new Option('--output-awst', 'Output debugging awst file per parsed file').default(false))
+        .addOption(new Option('--output-awst-json', 'Output debugging awst json file per parsed file').default(false))
+        .addOption(new Option('--out-dir [outDir]').default('out'))
+        .addOption(new Option('--dry-run').default(false))
+        .addOption(new Option('--no-output-teal', 'Do not output TEAL code').default(defaultPuyaOptions.outputTeal))
+        .addOption(new Option('--no-output-arc32', 'Do not output {contract}.arc32.json ARC-32 app spec file. Only applicable to ARC4 contracts').default(defaultPuyaOptions.outputArc32))
+        .addOption(new Option('--output-ssa-ir', 'Output IR (in SSA form) before optimisations').default(defaultPuyaOptions.outputSsaIr))
+        .addOption(new Option('--output-optimization-ir', 'Output IR after each optimization').default(defaultPuyaOptions.outputOptimizationIr))
+        .addOption(new Option('--output-destructured-ir', 'Output IR after SSA destructuring and before MIR').default(defaultPuyaOptions.outputDestructuredIr))
+        .addOption(new Option('--output-memory-ir', 'Output MIR before lowering to TealOps').default(defaultPuyaOptions.outputMemoryIr))
+        .addOption(new Option('--output-bytecode', 'Output AVM bytecode').default(defaultPuyaOptions.outputBytecode))
+        .addOption(new Option('--match-algod-bytecode', 'When outputting bytecode, ensure bytecode matches algod output').default(defaultPuyaOptions.matchAlgodBytecode))
+        .addOption(new Option('--debug-level [level]', 'Output debug information level, 0 = none, 1 = debug, 2 = reserved for future use')
+        .choices(['0', '1', '2'])
+        .default(defaultPuyaOptions.debugLevel))
+        .addOption(new Option('--optimization-level [level]', 'Set optimization level of output TEAL / AVM bytecode')
+        .choices(['0', '1', '2'])
+        .default(defaultPuyaOptions.optimizationLevel))
+        .addOption(new Option('--target-avm-version [version]', '').choices(['10']).default(10))
+        .addOption(new Option('--cli-template-definitions <...definitions>', 'Define template vars for use when assembling via --output-bytecode, should be specified without the prefix (see --template-vars-prefix)'))
+        .addOption(new Option('--template-vars-prefix [prefix]', 'Define the prefix to use with --template-var').default(defaultPuyaOptions.templateVarsPrefix))
+        .addOption(new Option('--locals-coalescing-strategy', '')
+        .default(defaultPuyaOptions.localsCoalescingStrategy)
+        .choices([
+        LocalsCoalescingStrategy.root_operand,
+        LocalsCoalescingStrategy.root_operand_excluding_args,
+        LocalsCoalescingStrategy.aggressive,
+    ]))
+        .action((a, o) => {
+        try {
+            const paths = cliArgumentsSchema.parse(a);
+            const cliOptions = cliOptionsSchema.parse(o);
+            logger.configure({
+                minLogLevel: cliOptions.logLevel,
+            });
+            const compileOptions = buildCompileOptions({
+                paths,
+                ...cliOptions,
+            });
+            const passThroughOptions = cliOptions;
+            const result = compile(compileOptions, passThroughOptions);
+            if (result.logs.some((l) => l.level === LogLevel.Error || l.level === LogLevel.Critical)) {
+                process.exit(-1);
+            }
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                logger.error(e);
+            }
+            else {
+                throw e;
+            }
+        }
+    });
+    if (process.argv.length < 3) {
+        commander.help();
+    }
+    else {
+        commander.parse(process.argv);
+    }
+}
+cli();
+//# sourceMappingURL=cli.mjs.map

package/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","sources":["../src/compile-options.ts","../src/cli.ts"],"sourcesContent":["import { globSync } from 'glob'\nimport * as fs from 'node:fs'\nimport upath from 'upath'\nimport { PuyaError } from './errors'\nimport type { LogLevel } from './logger'\nimport { logger } from './logger'\nimport { normalisePath } from './util'\n\nexport interface AlgoFile {\n  matchedInput: string\n  sourceFile: string\n  outDir: string\n}\n\nexport interface CompileOptions {\n  filePaths: AlgoFile[]\n  logLevel: LogLevel\n  outputAwst: boolean\n  outputAwstJson: boolean\n  /*\n  Don't generate artifacts for puya, or invoke puya\n   */\n  dryRun: boolean\n\n  getFileFromSource(sourceFile: string): AlgoFile | undefined\n}\n\nexport const buildCompileOptions = ({\n  paths,\n  workingDirectory = process.cwd(),\n  outDir,\n  ...rest\n}: {\n  paths: string[]\n  outputAwst: boolean\n  outDir: string\n  outputAwstJson: boolean\n  workingDirectory?: string\n  dryRun: boolean\n  logLevel: LogLevel\n}): CompileOptions => {\n  const filePaths: AlgoFile[] = []\n\n  for (const p of paths) {\n    if (p.endsWith('.algo.ts')) {\n      if (fs.existsSync(p)) {\n        const actualPath = normalisePath(p, workingDirectory)\n        filePaths.push({\n          matchedInput: p,\n          sourceFile: actualPath,\n          outDir: upath.isAbsolute(outDir) ? upath.normalize(outDir) : upath.join(upath.dirname(actualPath), outDir),\n        })\n      } else {\n        logger.warn(undefined, `File ${p} could not be found`)\n      }\n    } else if (p.endsWith('.ts')) {\n      logger.warn(undefined, `Ignoring path ${p} as it does use the .algo.ts extension`)\n    } else {\n      const matches = globSync(upath.join(p, '**/*.algo.ts'))\n      if (matches.length) {\n        for (const match of matches) {\n          filePaths.push({\n            matchedInput: p,\n            sourceFile: normalisePath(match, workingDirectory),\n            outDir: upath.join(upath.isAbsolute(outDir) ? outDir : upath.join(p, outDir), upath.relative(p, upath.dirname(match))),\n          })\n        }\n      } else {\n        logger.warn(undefined, `Path '${p}' did not match any .algo.ts files`)\n      }\n    }\n  }\n  if (filePaths.length === 0) {\n    throw new PuyaError('Input paths did not match any .algo.ts files')\n  }\n\n  return {\n    filePaths,\n    ...rest,\n    getFileFromSource(sourceFile: string): AlgoFile | undefined {\n      return filePaths.find((p) => p.sourceFile === sourceFile)\n    },\n  }\n}\n","import { Command, Option } from 'commander'\nimport { z } from 'zod'\nimport { buildCompileOptions } from './compile-options'\nimport { compile } from './index'\nimport { logger, LogLevel } from './logger'\nimport type { PuyaPassThroughOptions } from './puya/options'\nimport { defaultPuyaOptions, LocalsCoalescingStrategy } from './puya/options'\n\nconst cliOptionsSchema = z.object({\n  outputAwst: z.boolean(),\n  outputAwstJson: z.boolean(),\n  outDir: z.string(),\n  dryRun: z.boolean(),\n  logLevel: z.nativeEnum(LogLevel),\n\n  // Puya options\n  outputTeal: z.boolean(),\n  outputArc32: z.boolean(),\n  outputSsaIr: z.boolean(),\n  outputOptimizationIr: z.boolean(),\n  outputDestructuredIr: z.boolean(),\n  outputMemoryIr: z.boolean(),\n  outputBytecode: z.boolean(),\n  matchAlgodBytecode: z.boolean(),\n  debugLevel: z.number().int(),\n  optimizationLevel: z.number().int(),\n  targetAvmVersion: z.number().int(),\n  cliTemplateDefinitions: z.preprocess((x) => x ?? [], z.array(z.string())),\n  templateVarsPrefix: z.string(),\n  localsCoalescingStrategy: z.nativeEnum(LocalsCoalescingStrategy),\n})\n\nconst cliArgumentsSchema = z.array(z.string())\n\nfunction cli() {\n  const commander = new Command().name('puya-ts').description('Algo-TS to Algorand smart contract compiler')\n\n  commander.helpCommand(true)\n\n  commander\n    .command('build')\n    .argument('<paths...>', 'The path, or paths to search for compatible .algo.ts files')\n    .addOption(\n      new Option('--log-level [level]', 'The minimum log level to output')\n        .choices([LogLevel.Debug, LogLevel.Info, LogLevel.Warn, LogLevel.Error, LogLevel.Critical])\n        .default(LogLevel.Info),\n    )\n    .addOption(new Option('--output-awst', 'Output debugging awst file per parsed file').default(false))\n    .addOption(new Option('--output-awst-json', 'Output debugging awst json file per parsed file').default(false))\n    .addOption(new Option('--out-dir [outDir]').default('out'))\n    .addOption(new Option('--dry-run').default(false))\n\n    .addOption(new Option('--no-output-teal', 'Do not output TEAL code').default(defaultPuyaOptions.outputTeal))\n    .addOption(\n      new Option(\n        '--no-output-arc32',\n        'Do not output {contract}.arc32.json ARC-32 app spec file. Only applicable to ARC4 contracts',\n      ).default(defaultPuyaOptions.outputArc32),\n    )\n    .addOption(new Option('--output-ssa-ir', 'Output IR (in SSA form) before optimisations').default(defaultPuyaOptions.outputSsaIr))\n    .addOption(new Option('--output-optimization-ir', 'Output IR after each optimization').default(defaultPuyaOptions.outputOptimizationIr))\n    .addOption(\n      new Option('--output-destructured-ir', 'Output IR after SSA destructuring and before MIR').default(\n        defaultPuyaOptions.outputDestructuredIr,\n      ),\n    )\n    .addOption(new Option('--output-memory-ir', 'Output MIR before lowering to TealOps').default(defaultPuyaOptions.outputMemoryIr))\n    .addOption(new Option('--output-bytecode', 'Output AVM bytecode').default(defaultPuyaOptions.outputBytecode))\n    .addOption(\n      new Option('--match-algod-bytecode', 'When outputting bytecode, ensure bytecode matches algod output').default(\n        defaultPuyaOptions.matchAlgodBytecode,\n      ),\n    )\n    .addOption(\n      new Option('--debug-level [level]', 'Output debug information level, 0 = none, 1 = debug, 2 = reserved for future use')\n        .choices(['0', '1', '2'])\n        .default(defaultPuyaOptions.debugLevel),\n    )\n    .addOption(\n      new Option('--optimization-level [level]', 'Set optimization level of output TEAL / AVM bytecode')\n        .choices(['0', '1', '2'])\n        .default(defaultPuyaOptions.optimizationLevel),\n    )\n    .addOption(new Option('--target-avm-version [version]', '').choices(['10']).default(10))\n    .addOption(\n      new Option(\n        '--cli-template-definitions <...definitions>',\n        'Define template vars for use when assembling via --output-bytecode, should be specified without the prefix (see --template-vars-prefix)',\n      ),\n    )\n    .addOption(\n      new Option('--template-vars-prefix [prefix]', 'Define the prefix to use with --template-var').default(\n        defaultPuyaOptions.templateVarsPrefix,\n      ),\n    )\n    .addOption(\n      new Option('--locals-coalescing-strategy', '')\n        .default(defaultPuyaOptions.localsCoalescingStrategy)\n        .choices([\n          LocalsCoalescingStrategy.root_operand,\n          LocalsCoalescingStrategy.root_operand_excluding_args,\n          LocalsCoalescingStrategy.aggressive,\n        ]),\n    )\n\n    .action((a, o) => {\n      try {\n        const paths = cliArgumentsSchema.parse(a)\n        const cliOptions = cliOptionsSchema.parse(o)\n        logger.configure({\n          minLogLevel: cliOptions.logLevel,\n        })\n\n        const compileOptions = buildCompileOptions({\n          paths,\n          ...cliOptions,\n        })\n        const passThroughOptions: PuyaPassThroughOptions = cliOptions\n        const result = compile(compileOptions, passThroughOptions)\n        if (result.logs.some((l) => l.level === LogLevel.Error || l.level === LogLevel.Critical)) {\n          process.exit(-1)\n        }\n      } catch (e) {\n        if (e instanceof Error) {\n          logger.error(e)\n        } else {\n          throw e\n        }\n      }\n    })\n\n  if (process.argv.length < 3) {\n    commander.help()\n  } else {\n    commander.parse(process.argv)\n  }\n}\ncli()\n"],"names":[],"mappings":"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"}

package/compile-options.d.ts

@@ -0,0 +1,23 @@
+import type { LogLevel } from './logger';
+export interface AlgoFile {
+    matchedInput: string;
+    sourceFile: string;
+    outDir: string;
+}
+export interface CompileOptions {
+    filePaths: AlgoFile[];
+    logLevel: LogLevel;
+    outputAwst: boolean;
+    outputAwstJson: boolean;
+    dryRun: boolean;
+    getFileFromSource(sourceFile: string): AlgoFile | undefined;
+}
+export declare const buildCompileOptions: ({ paths, workingDirectory, outDir, ...rest }: {
+    paths: string[];
+    outputAwst: boolean;
+    outDir: string;
+    outputAwstJson: boolean;
+    workingDirectory?: string;
+    dryRun: boolean;
+    logLevel: LogLevel;
+}) => CompileOptions;

package/constants.d.ts

@@ -0,0 +1,20 @@
+export declare const Constants: {
+    readonly approvalProgramMethodName: "approvalProgram";
+    readonly clearStateProgramMethodName: "clearStateProgram";
+    readonly algoTsPackage: "@algorandfoundation/algorand-typescript";
+    readonly arc4ModuleName: "@algorandfoundation/algorand-typescript/arc4/index.d.ts";
+    readonly opModuleName: "@algorandfoundation/algorand-typescript/op.d.ts";
+    readonly baseContractModuleName: "@algorandfoundation/algorand-typescript/base-contract.d.ts";
+    readonly utilModuleName: "@algorandfoundation/algorand-typescript/util.d.ts";
+    readonly referenceModuleName: "@algorandfoundation/algorand-typescript/reference.d.ts";
+    readonly stateModuleName: "@algorandfoundation/algorand-typescript/state.d.ts";
+    readonly boxModuleName: "@algorandfoundation/algorand-typescript/box.d.ts";
+    readonly transactionsModuleName: "@algorandfoundation/algorand-typescript/transactions.d.ts";
+    readonly gtxnModuleName: "@algorandfoundation/algorand-typescript/gtxn.d.ts";
+    readonly itxnModuleName: "@algorandfoundation/algorand-typescript/itxn.d.ts";
+    readonly primitivesModuleName: "@algorandfoundation/algorand-typescript/primitives.d.ts";
+    readonly arc4EncodedTypesModuleName: "@algorandfoundation/algorand-typescript/arc4/encoded-types.d.ts";
+    readonly arc4BareDecoratorName: "arc4.baremethod";
+    readonly arc4AbiDecoratorName: "arc4.abimethod";
+    readonly constructorMethodName: "constructor";
+};

package/errors.d.ts

@@ -0,0 +1,46 @@
+import type { SourceLocation } from './awst/source-location';
+import type { PType, PTypeOrClass } from './awst_build/ptypes';
+type PuyaErrorOptions = {
+    cause?: Error;
+    sourceLocation?: SourceLocation;
+};
+/**
+ * Thrown when the awst visitor cannot return a meaningful value
+ */
+export declare class AwstBuildFailureError extends Error {
+    constructor();
+}
+export declare class PuyaError extends Error {
+    readonly sourceLocation: SourceLocation | undefined;
+    constructor(message?: string, options?: PuyaErrorOptions);
+}
+export declare class CodeError extends PuyaError {
+    static unexpectedUnhandledArgs({ sourceLocation }: {
+        sourceLocation: SourceLocation;
+    }): CodeError;
+    static unexpectedTypeArgs({ sourceLocation }: {
+        sourceLocation: SourceLocation;
+    }): CodeError;
+    static expectedCompileTimeConstant({ sourceLocation }: {
+        sourceLocation: SourceLocation;
+    }): CodeError;
+    static invalidAssignmentTarget({ sourceLocation, name }: {
+        sourceLocation: SourceLocation;
+        name: string;
+    }): CodeError;
+    static cannotResolveToType({ sourceType, targetType, sourceLocation, }: {
+        sourceLocation: SourceLocation;
+        sourceType: PType;
+        targetType: PTypeOrClass;
+    }): CodeError;
+}
+export declare class TodoError extends PuyaError {
+}
+export declare class InternalError extends PuyaError {
+}
+export declare class NotSupported extends CodeError {
+    constructor(featureName: string, options?: PuyaErrorOptions);
+}
+export declare const throwError: (error: Error) => never;
+export declare const wrapInCodeError: <T>(func: () => T, sourceLocation: SourceLocation) => T;
+export {};