kokoscript 1.0.0

package/DESIGN.md

@@ -0,0 +1,95 @@
+# KokoScript 設計思想
+
+## コンセプト
+「もし日本人がJavaScriptを作ったら」という世界観を表現する。
+句読点を活用した自然な日本語の文章のようなコード。
+
+## 構文設計
+
+### 句読点の役割
+- **読点（、）**: キーワードの後、節の区切り
+- **句点（。）**: 文の終わり
+- **鉤括弧（「」）**: 文字列リテラル
+
+### 基本原則
+1. キーワードの後には必ず読点（、）を置く
+2. 文の終わりには必ず句点（。）を置く
+3. 識別子とキーワードは句読点で区切られる
+4. スペースは不要（あっても良い）
+
+## 構文例
+
+### 変数
+```kokoscript
+変数、名前は「田中」。
+変数、年齢は25。
+```
+
+### 条件分岐
+```kokoscript
+もし、年齢が20より大きいならば、
+  「成人です」を表示。
+そうでなければ、
+  「未成年です」を表示。
+終わり。
+```
+
+### 繰り返し
+```kokoscript
+3回、繰り返す、
+  「こんにちは」を表示。
+終わり。
+```
+
+### 関数
+```kokoscript
+関数、挨拶は、名前で、
+  「こんにちは」と名前を表示。
+終わり。
+
+挨拶に「太郎」を渡す。
+```
+
+### 演算
+```kokoscript
+変数、合計は0。
+合計は合計に10を足す。
+合計は合計から5を引く。
+合計は合計に2を掛ける。
+合計は合計を2で割る。
+```
+
+## JavaScriptとの対応
+
+| KokoScript | JavaScript |
+|------------|------------|
+| 変数、xは10。 | let x = 10; |
+| もし、x > 5ならば、 | if (x > 5) { |
+| 3回、繰り返す、 | for (let i = 0; i < 3; i++) { |
+| 関数、名前は、引数で、 | function 名前(引数) { |
+| 「文字列」を表示。 | console.log("文字列"); |
+| 値を返す。 | return 値; |
+
+## 予約語リスト
+
+### 制御構造
+- 変数、もし、そうでなければ、終わり
+- 繰り返す、回、抜ける、続ける
+- 関数、返す
+
+### 演算子（自然言語）
+- は（代入）
+- が（比較の主語）
+- と（連結）
+- を（目的語）
+- に（方向）
+- で（手段）
+- より、以上、以下、等しい
+- 大きい、小さい
+
+### アクション
+- 表示、渡す、呼ぶ
+- 足す、引く、掛ける、割る
+
+### リテラル
+- 真、偽、空

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,62 @@
+# 🈁 KokoScript
+日本語で書けるJavaScriptサブセット言語
+
+## 概要
+KokoScriptは、「日本語で自然に書けるJavaScript」を目指した日本語ベースのプログラミング言語です。
+句読点（、と。）を使って文を区切ることで、スペース不要で日本語のように読めるコードを書けます。
+内部的にはJavaScriptにトランスパイルされます。
+
+## 特徴
+- 日本語のキーワードを使用
+- 句読点（、。）で文を区切る
+- スペース不要
+- JavaScriptへ自動変換
+- シンプルで学びやすい構文
+
+## サンプルコード
+```koko
+変数、名前は「太郎」。
+もし、名前が「太郎」ならば、
+  「こんにちは！」を表示。
+終わり。
+```
+
+## ディレクトリ構成
+```
+.
+├── docs/            # ブラウザ向けプレイグラウンド
+├── scripts/         # ユーティリティスクリプト
+├── src/
+│   ├── cli/         # CLI / REPL エントリーポイント
+│   └── compiler/    # レキサー・パーサー・コード生成
+└── tests/
+    ├── basic.test.js
+    └── examples/    # 各種サンプル .koko
+```
+
+## CLI
+KokoScriptにはコンパイラCLI `koko` が付属しています。  
+`npm install --global kokoscript` でインストールすると、システム全体で `koko` コマンドが使えます。
+
+```bash
+# 初回インストール
+npm i -g kokoscript
+
+# .koko -> .js を出力
+koko tests/examples/basic.koko --outDir dist
+
+# REPL モード
+koko --repl
+```
+
+`--outDir` を省略すると、入力ファイルと同じディレクトリに `.js` が生成されます。  
+複数ファイルを指定した場合は順次コンパイルされ、相対パスを維持したまま `outDir` に配置されます。
+
+## 開発
+```bash
+npm install
+npm run cli tests/examples/basic.koko     # 生成されたJSを表示して実行（eval）
+npm run repl                 # 対話モード
+npm test                     # Nodeテスト
+npm run build:browser        # docs/kokoscript-bundle.js を再生成
+```

package/bin/koko.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+
+/**
+ * KokoScript CLI compiler (tsc-style)
+ * - Compiles .koko files to .js files
+ * - Supports --outDir similar to TypeScript CLI
+ * - Provides --help and --version flags
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { compile } = require('../src/compiler');
+const { startRepl } = require('../src/cli/repl');
+const pkg = require('../package.json');
+
+function printHelp() {
+  console.log(`KokoScript v${pkg.version}`);
+  console.log('Usage: koko [options] <files...>');
+  console.log('\nOptions:');
+  console.log('  --outDir <dir>     Specify output directory (like tsc)');
+  console.log('  --repl, -r         Launch interactive REPL mode');
+  console.log('  --help, -h         Show this help');
+  console.log('  --version, -v      Show version number');
+  console.log('');
+  console.log('Example:');
+  console.log('  koko src/example.koko --outDir dist');
+}
+
+function replaceExtension(filePath, newExt) {
+  const parsed = path.parse(filePath);
+  return path.join(parsed.dir, parsed.name + newExt);
+}
+
+function computeOutputPath(filePath, outDir) {
+  const absolute = path.resolve(filePath);
+  if (!outDir) {
+    return replaceExtension(absolute, '.js');
+  }
+
+  const relativeFromCwd = path.relative(process.cwd(), absolute);
+  const normalizedRelative = relativeFromCwd.startsWith('..')
+    ? path.basename(absolute)
+    : relativeFromCwd;
+  const target = path.join(outDir, normalizedRelative);
+  return replaceExtension(target, '.js');
+}
+
+const args = process.argv.slice(2);
+const files = [];
+let outDir = null;
+let replMode = false;
+
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i];
+
+  if (arg === '--help' || arg === '-h') {
+    printHelp();
+    process.exit(0);
+  }
+
+  if (arg === '--version' || arg === '-v') {
+    console.log(pkg.version);
+    process.exit(0);
+  }
+
+  if (arg === '--repl' || arg === '-r' || arg === 'repl') {
+    replMode = true;
+    continue;
+  }
+
+  if (arg.startsWith('--outDir=')) {
+    outDir = path.resolve(arg.split('=')[1]);
+    continue;
+  }
+
+  if (arg === '--outDir') {
+    if (i + 1 >= args.length) {
+      console.error('Error: --outDir requires a directory path.');
+      process.exit(1);
+    }
+    outDir = path.resolve(args[++i]);
+    continue;
+  }
+
+  files.push(arg);
+}
+
+if (replMode) {
+  if (files.length > 0) {
+    console.warn('koko: ファイル指定はREPLモードでは無視されます。');
+  }
+  startRepl();
+} else {
+  if (files.length === 0) {
+    printHelp();
+    process.exit(1);
+  }
+
+  let hasErrors = false;
+
+  for (const file of files) {
+    const resolved = path.resolve(file);
+
+    if (!fs.existsSync(resolved)) {
+      console.error(`koko: Cannot find file '${file}'.`);
+      hasErrors = true;
+      continue;
+    }
+
+    const source = fs.readFileSync(resolved, 'utf8');
+    const result = compile(source);
+
+    if (!result.success) {
+      console.error(`koko: Failed to compile '${file}': ${result.error}`);
+      hasErrors = true;
+      continue;
+    }
+
+    const outputPath = computeOutputPath(resolved, outDir);
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, result.code, 'utf8');
+
+    const inputDisplay = path.relative(process.cwd(), resolved);
+    const outputDisplay = path.relative(process.cwd(), outputPath);
+    console.log(`${inputDisplay} -> ${outputDisplay}`);
+  }
+
+  process.exit(hasErrors ? 1 : 0);
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "kokoscript",
+  "version": "1.0.0",
+  "description": "日本語で書けるJavaScriptサブセット言語",
+  "main": "src/compiler/index.js",
+  "bin": {
+    "koko": "bin/koko.js"
+  },
+  "scripts": {
+    "cli": "node src/cli/koko.js",
+    "koko": "node bin/koko.js",
+    "repl": "node src/cli/repl.js",
+    "test": "node tests/basic.test.js",
+    "build:browser": "node scripts/build-browser.js"
+  },
+  "keywords": [
+    "japanese",
+    "programming",
+    "language",
+    "transpiler",
+    "kokoscript"
+  ],
+  "author": "Daijiro Wachi",
+  "license": "Apache-2.0"
+}

package/scripts/build-browser.js

@@ -0,0 +1,77 @@
+// Browser bundle builder for KokoScript
+
+const fs = require('fs');
+const path = require('path');
+
+const projectRoot = path.join(__dirname, '..');
+const readSource = (relativePath) =>
+  fs.readFileSync(path.join(projectRoot, relativePath), 'utf-8');
+
+// Read source files
+const lexerSource = readSource('src/compiler/lexer.js');
+const parserSource = readSource('src/compiler/parser.js');
+const codegenSource = readSource('src/compiler/codegen.js');
+
+// Extract the class definitions and constants
+const lexerCode = lexerSource
+  .replace(/module\.exports = .*?;/g, '')
+  .trim();
+
+const parserCode = parserSource
+  .replace(/const { TOKEN_TYPES } = require\('\.\/lexer'\);/g, '')
+  .replace(/module\.exports = .*?;/g, '')
+  .trim();
+
+const codegenCode = codegenSource
+  .replace(/module\.exports = .*?;/g, '')
+  .trim();
+
+// Create the browser bundle
+const bundle = `// KokoScript Browser Bundle - 句読点ベース
+(function(global) {
+  'use strict';
+
+  ${lexerCode}
+
+  ${parserCode}
+
+  ${codegenCode}
+
+  // Main compile function
+  function compile(source) {
+    try {
+      const lexer = new Lexer(source);
+      const tokens = lexer.tokenize();
+      const parser = new Parser(tokens);
+      const ast = parser.parse();
+      const generator = new CodeGenerator(ast);
+      const code = generator.generate();
+      
+      return {
+        success: true,
+        code: code,
+        ast: ast
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: error.message
+      };
+    }
+  }
+
+  // Export to global
+  global.KokoScript = {
+    compile: compile,
+    Lexer: Lexer,
+    Parser: Parser,
+    CodeGenerator: CodeGenerator,
+    TOKEN_TYPES: TOKEN_TYPES
+  };
+
+})(typeof window !== 'undefined' ? window : this);
+`;
+
+// Write to docs directory
+fs.writeFileSync(path.join(projectRoot, 'docs/kokoscript-bundle.js'), bundle, 'utf-8');
+console.log('✓ Browser bundle created: docs/kokoscript-bundle.js');

package/src/cli/koko.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+
+// KokoScript インタプリタ
+
+const fs = require('fs');
+const { compile } = require('../compiler');
+
+function run(source) {
+  const result = compile(source);
+  
+  if (result.success) {
+    console.log('=== 生成されたJavaScriptコード ===');
+    console.log(result.code);
+    console.log('\n=== 実行結果 ===');
+    try {
+      eval(result.code);
+    } catch (error) {
+      console.error('実行エラー:', error.message);
+    }
+  } else {
+    console.error('コンパイルエラー:', result.error);
+  }
+}
+
+// コマンドライン引数の処理
+if (require.main === module) {
+  const args = process.argv.slice(2);
+  
+  if (args.length === 0) {
+    console.log('使い方: koko <ファイル名>');
+    console.log('例: koko example.koko');
+    process.exit(1);
+  }
+  
+  const filename = args[0];
+  
+  if (!fs.existsSync(filename)) {
+    console.error(`エラー: ファイル '${filename}' が見つかりません`);
+    process.exit(1);
+  }
+  
+  const source = fs.readFileSync(filename, 'utf-8');
+  run(source);
+}
+
+module.exports = { compile, run };