purus 0.7.0 → 0.8.1

package/README-ja.md

@@ -25,6 +25,13 @@ Purus — _/ˈpuː.rus/_ _**ラテン語で 純粋✨**_ — は、美しく、
 
 Purusは、 _Shiftキー_ をほとんど押さずにプログラミングできます。
 
+```purus
+let name
+name be ///Purus///
+const message be ///Welcome to [name]!///
+console.log[message] -- Welcome to Purus!
+```
+
 ## インストール
 
 ```sh
@@ -45,6 +52,7 @@ npm install -D purus
 
 ## ツール
 
+- **Core** — [`purus`](https://www.npmjs.com/package/purus): Purusのコアシステム
 - **VS Code 拡張機能** — [Marketplace](https://marketplace.visualstudio.com/items?itemName=otoneko1102.purus): シンタックスハイライト、スニペット、ファイルアイコン
 - **リンター** — [`@puruslang/linter`](https://www.npmjs.com/package/@puruslang/linter): Purus の静的解析
 - **Prettier プラグイン** — [`@puruslang/prettier-plugin-purus`](https://www.npmjs.com/package/@puruslang/prettier-plugin-purus): コードフォーマッター

package/README.md

@@ -25,6 +25,13 @@ Purus - _/ˈpuː.rus/_ _**means pure✨ in Latin**_ - is a beautiful, simple, an
 
 With Purus, you can write code almost without pressing the _Shift key_.
 
+```purus
+let name
+name be ///Purus///
+const message be ///Welcome to [name]!///
+console.log[message] -- Welcome to Purus!
+```
+
 ## Install
 
 ```sh
@@ -45,6 +52,7 @@ npm install -D purus
 
 ## Tooling
 
+- **Core** — [`purus`](https://www.npmjs.com/package/purus): The core-system of Purus
 - **VS Code Extension** — [Marketplace](https://marketplace.visualstudio.com/items?itemName=otoneko1102.purus): Syntax highlighting, snippets, file icons
 - **Linter** — [`@puruslang/linter`](https://www.npmjs.com/package/@puruslang/linter): Static analysis for Purus
 - **Prettier Plugin** — [`@puruslang/prettier-plugin-purus`](https://www.npmjs.com/package/@puruslang/prettier-plugin-purus): Code formatting

package/bin/purus.js

@@ -16,6 +16,7 @@ function printHelp() {
   console.log("    .cpurus -> .cjs (CommonJS)");
   console.log("    .mpurus -> .mjs (ES Module)");
   console.log("  purus build --no-header [file]       Compile without header comment");
+  console.log("  purus build --type <type>            Set module type (module|commonjs)");
   console.log("  purus run [file|dir]                 Run without generating files");
   console.log("  purus run --entry <file|dir>         Run entry file or directory");
   console.log("  purus run                            Run using config.purus");

package/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Options for the Purus compiler.
+ */
+export interface CompileOptions {
+  /**
+   * Include "Generated by Purus" header comment in the output.
+   * @default true
+   */
+  header?: boolean;
+  /**
+   * Enable strict mode (`"use strict";` at the top of the output).
+   * @default true
+   */
+  strict?: boolean;
+  /**
+   * Output module format.
+   * - `"module"` — ES Modules (default)
+   * - `"commonjs"` — CommonJS (`require` / `module.exports`)
+   * @default "module"
+   */
+  type?: "module" | "commonjs";
+}
+
+/**
+ * Compile Purus source code to JavaScript.
+ *
+ * @param source - Purus source code
+ * @param options - Compilation options
+ * @returns Generated JavaScript code
+ *
+ * @example
+ * ```ts
+ * import { compile } from "purus";
+ * const js = compile('const x be 42');
+ * ```
+ */
+export declare function compile(source: string, options?: CompileOptions): string;
+
+/**
+ * Check Purus source code for syntax errors.
+ *
+ * @param source - Purus source code
+ * @returns `true` if the syntax is valid
+ * @throws {Error} If the source contains syntax errors
+ *
+ * @example
+ * ```ts
+ * import { check } from "purus";
+ * check('const x be 42'); // true
+ * ```
+ */
+export declare function check(source: string): true;
+
+/**
+ * The Purus compiler version.
+ */
+export declare const version: string;
+
+declare const purus: {
+  compile: typeof compile;
+  check: typeof check;
+  version: typeof version;
+};
+
+export default purus;

package/lib/build-wrapper.js

@@ -12,6 +12,7 @@ let output = null;
 let noHeader = false;
 let toStdout = false;
 let strict = null; // null = use config or default (true)
+let moduleType = null; // null = resolve from config/package.json/default
 
 for (let i = 0; i < args.length; i++) {
   if (args[i] === "--no-header") {
@@ -24,6 +25,10 @@ for (let i = 0; i < args.length; i++) {
     } else {
       strict = true;
     }
+  } else if (args[i] === "--type" || args[i] === "-t") {
+    if (i + 1 < args.length) {
+      moduleType = args[++i];
+    }
   } else if (args[i] === "--entry" || args[i] === "-e") {
     entry = args[++i];
   } else if (args[i] === "--output" || args[i] === "-o") {
@@ -33,12 +38,46 @@ for (let i = 0; i < args.length; i++) {
   }
 }
 
+/**
+ * Resolve module type for a file.
+ * For .cpurus → always "commonjs", .mpurus → always "module".
+ * For .purus → CLI --type > config.purus type > package.json type > "module" (default).
+ */
+function resolveModuleType(filePath, cliModuleType, configResult) {
+  if (filePath && filePath.endsWith(".cpurus")) return "commonjs";
+  if (filePath && filePath.endsWith(".mpurus")) return "module";
+
+  // CLI option takes highest priority
+  if (cliModuleType) return cliModuleType;
+
+  // config.purus type
+  if (configResult && configResult.config.type) return configResult.config.type;
+
+  // package.json type
+  try {
+    const pkgPath = configResult
+      ? path.join(configResult.configDir, "package.json")
+      : path.resolve("package.json");
+    if (fs.existsSync(pkgPath)) {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+      if (pkg.type) return pkg.type;
+    }
+  } catch {
+    // ignore
+  }
+
+  // default: ESM
+  return "module";
+}
+
 if (entry && fs.existsSync(entry) && fs.statSync(entry).isFile() && /\.(c|m)?purus$/.test(entry)) {
   // Single file - handle directly via compile API
   const source = fs.readFileSync(entry, "utf8");
   const useHeader = !noHeader;
   const useStrict = strict !== null ? strict : true;
-  const js = compile(source, { header: useHeader, strict: useStrict });
+  const configResult = loadConfig();
+  const resolvedModule = resolveModuleType(entry, moduleType, configResult);
+  const js = compile(source, { header: useHeader, strict: useStrict, module: resolvedModule });
 
   if (toStdout) {
     process.stdout.write(js);
@@ -61,6 +100,7 @@ if (entry && fs.existsSync(entry) && fs.statSync(entry).isFile() && /\.(c|m)?pur
   let outputDir;
   let useHeader;
   let useStrict;
+  let configResult = null;
 
   if (entry) {
     entryDir = path.resolve(entry);
@@ -68,22 +108,22 @@ if (entry && fs.existsSync(entry) && fs.statSync(entry).isFile() && /\.(c|m)?pur
     useHeader = !noHeader;
     useStrict = strict !== null ? strict : true;
 
-    const result = loadConfig();
-    if (result) {
+    configResult = loadConfig();
+    if (configResult) {
       if (!output) {
         outputDir = path.resolve(
-          result.configDir,
-          result.config.output || "dist"
+          configResult.configDir,
+          configResult.config.output || "dist"
         );
       }
-      useHeader = result.config.header !== false && !noHeader;
+      useHeader = configResult.config.header !== false && !noHeader;
       if (strict === null) {
-        useStrict = result.config.strict !== false;
+        useStrict = configResult.config.strict !== false;
       }
     }
   } else {
-    const result = loadConfig();
-    if (!result) {
+    configResult = loadConfig();
+    if (!configResult) {
       console.log("Error: no input file specified and no config.purus found");
       console.log("");
       console.log("Usage:");
@@ -95,7 +135,7 @@ if (entry && fs.existsSync(entry) && fs.statSync(entry).isFile() && /\.(c|m)?pur
       process.exit(1);
     }
 
-    const { config, configDir } = result;
+    const { config, configDir } = configResult;
     entryDir = path.resolve(configDir, config.entry || "src");
     outputDir = output
       ? path.resolve(output)
@@ -130,7 +170,8 @@ if (entry && fs.existsSync(entry) && fs.statSync(entry).isFile() && /\.(c|m)?pur
   let count = 0;
   for (const f of files) {
     const source = fs.readFileSync(f, "utf8");
-    const js = compile(source, { header: useHeader, strict: useStrict });
+    const resolvedModule = resolveModuleType(f, moduleType, configResult);
+    const js = compile(source, { header: useHeader, strict: useStrict, module: resolvedModule });
     let outputPath;
 
     if (stat.isFile()) {

package/lib/create.js

@@ -48,6 +48,7 @@ async function run() {
     const configPurus = `-- Purus Configuration
 const entry be ///src///
 const output be ///dist///
+const type be ///module///
 const header be true
 
 -- Linter settings
@@ -135,10 +136,12 @@ node_modules/
       });
     }
 
-    // Add scripts to package.json
+    // Add scripts to package.json and set main/type
     const pkgPath = path.join(projectDir, "package.json");
     if (fs.existsSync(pkgPath)) {
       const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+      pkg.main = "dist/main.js";
+      pkg.type = "module";
       pkg.scripts = {
         ...(pkg.scripts || {}),
         purus: "purus",