nadesiko3 3.8.1 → 3.8.8

package/README.md

@@ -5,26 +5,31 @@
 
 ## 「なでしこ3」とは
 
-「なでしこ3」とは、日本語のプログラミング言語です。JavaScript/TypeScriptをベースとしているので、PC/スマホ/タブレットなど、幅広い環境で動きます。日本語プログラミング言語は、読みやすく理解しやすいのが特徴で、初めてでも楽しくプログラミングを覚えることができます。また、バッチ処理や定型処理などを手軽に記述できます。
+「なでしこ3」とは、日本語のプログラミング言語です。「誰でも簡単プログラマー」を合い言葉に開発しています。
+日本語プログラミング言語は、読みやすく理解しやすいのが特徴で、初めてでも楽しくプログラミングを覚えることができます。
+日本語話者にとって、母国語で行うプログラミング教育にも最適です！
+また、なでしこは、もともと業務改善のためのツールとして開発されましたので、定型処理やバッチ処理などを手軽に記述するのも得意です。ゲームやツール、さまざまな用途でお使いいただけます。
 
 - [なでしこのWebサイト](https://nadesi.com/)
 - [マニュアル](https://nadesi.com/v3/doc/)
 
 はじめて「なでしこ」に挑戦する方は、次のチュートリアルから始めることをオススメします。日本語プログラミング言語の雰囲気が容易に理解できます。
 
-- [チュートリアル](https://nadesi.com/v3/doc/go.php?997)
-- [生成AIになでしこ3のプログラムを作ってもらう](doc/ai-code-generation.md)
+- [チュートリアル](https://nadesi.com/v3/doc/index.php?%E3%83%81%E3%83%A5%E3%83%BC%E3%83%88%E3%83%AA%E3%82%A2%E3%83%AB)
 
 ## 対応機器/ブラウザ
 
-なでしこ3は、内部的にJavaScriptに変換されて実行されます。そのため、JavaScriptが動作するさまざまな端末で実行できます。
+WEB版なでしこ3は、内部的にJavaScriptに変換されて実行されます。そのため、JavaScriptが動作するさまざまな端末で実行できます。
 
-1. Webブラウザ(wnako) - 主要ブラウザ(Chrome/Safari/Edge/Firefox)に対応し、PC/スマートフォンで動作
-2. コマンドライン(cnako) - JavaScriptの実行エンジン「Node.js」上で動作
-3. 配付パッケージ - Electronを利用してローカルPC上で動作
+- Webブラウザ(wnako3) - 主要ブラウザ(Chrome/Safari/Edge/Firefox)に対応し、PC/スマートフォンで動作
+- コマンドライン(cnako3) - JavaScriptの実行エンジン「Node.js」上で動作
 
 具体的な対応ブラウザについて詳しくは、[対応機器/ブラウザ](doc/browsers.md) をご覧ください。Node.jsの対応バージョンは、v22以上です。
 
+また、本リポジトリとは別に、PC版のなでしこ3(Go言語で実装されたもの)があります。
+
+- [PC版(gonako/gonako-gui)](https://github.com/kujirahand/nadesiko3go/) - デスクトップアプリ(gonako-gui)やコマンドライン(gonako)アプリを開発できます。作成したアプリを実行ファイル1個に梱包でき配布も簡単です。エディタ一体型のツールです。
+
 ## ブラウザで利用する方法
 
 次のWebエディタ上で、なでしこを実行できます。ブラウザがあれば動作します。
@@ -36,12 +41,17 @@
 
 なでしこ3をインストールして動かす方法は下記にまとめています。
 
-- [なでしこマニュアル > FAQ/なでしこ3をインストールして使うには？](https://nadesi.com/v3/doc/go.php?3907)
+- [なでしこマニュアル > FAQ/なでしこ3をインストールして使うには？](https://nadesi.com/v3/doc/index.php?FAQ%2F%E3%81%AA%E3%81%A7%E3%81%97%E3%81%933%E3%82%92%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%97%E3%81%A6%E4%BD%BF%E3%81%86%E3%81%AB%E3%81%AF%EF%BC%9F&show)
+
+## AIと一緒になでしこを使う
+
+AIになでしこの文法を読み込ませることで、なでしこのプログラムをエラーなく動かすことが可能です。
+
+- [生成AIになでしこ3のプログラムを作ってもらう](doc/ai-code-generation.md)
 
 ## Node.jsでなでしこ3コマンドライン版をインストール
 
-先にNode.js/npmをインストールします。
-次いで、コマンドラインから次のコマンドを実行します。
+先にNode.js/npmをインストールします。次いで、コマンドラインから次のコマンドを実行します。
 
 ```sh
 npm install -g nadesiko3
@@ -67,45 +77,6 @@ npm install
 npm run build
 ```
 
-## Ubuntuへの開発環境のセットアップ
-
-まっさらなUbuntu22.04に、なでしこ3の開発環境を整える場合は次のコマンドを実行します。
-
-```sh
-sudo apt update
-# nvm で Node.js をインストール
-curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
-source ~/.bashrc
-nvm install v24
-nvm use v24
-# リポジトリのセットアップ
-git clone https://github.com/kujirahand/nadesiko3.git
-cd nadesiko3
-npm install
-# なでしこ3のビルド
-npm run build
-```
-
-## 追加インストール(macOS/Linux)
-
-必要に応じて次のコマンドをインストールします。
-
-macOS:
-
-```sh
-# 『圧縮』『解凍』命令のために
-brew install p7zip
-```
-
-Ubuntu/Debian:
-
-```sh
-# 『圧縮』『解凍』命令のために
-sudo apt install p7zip-full
-# 『キー送信』命令のために
-sudo apt install xdotool
-```
-
 全てのコマンドが正しく動くかを確認するには、次のコマンドを実行します。
 
 ```sh
@@ -121,7 +92,7 @@ npm test
 ```sh
 # なでしこエディタ(WEB版)のサーバーを起動
 npm start
-# なでしこエディタ(PC版)を起動
+# なでしこエディタ(Node.js版)を起動
 npm run nako3edit
 ```
 
@@ -143,25 +114,15 @@ npm run search:command -- --help
 
 詳しくは、[doc/search_command.md](doc/search_command.md) をご覧ください。
 
-## Colabでなでしこを使って作業をする場合
-
-以下にColabを使ってなでしこを使う場合の作業用テンプレートを用意しました。
-ノートを複製して自分の作業に利用できます。
-
-- [作業用テンプレート](https://colab.research.google.com/drive/1FmOIoJGeFP57C9fgZXCP5pvcVJ6HmvH4?usp=sharing)
-
-## Colabでビルドテスト
-
-Google Colabでなでしこのビルドテストできます。
-
-- [ノートブック](https://colab.research.google.com/drive/1a-Choj3tCBCA1R7x7vPdNQN48vGzBd7E?usp=sharing)
-
 ## なでしこの開発履歴
 
 日本語プログラミング言語「なでしこ」の開発は2004年にはじまりました。その後、何度も作り直しを行って、現在の「なでしこ3」ができています。
 「なでしこ3」の開発は、2017年からコツコツと継続され、現在まで定期的にバージョンアップが続いています。
 2004年に掲げた「誰でも簡単プログラマー」の目標を実現するために開発を続けます。
 
+- (2026-09-07) 現行TS版と互換性のある[なでしこ3(Go版)](https://github.com/kujirahand/nadesiko3go/)を公開
+- (2026-09-01) v3.8.1で古い__getProp/__setPropによるプロパティアクセスを廃止
+- (2026-04-05) v3.7.17より生成AIの活用を大々的に開始
 - (2024-07-22) v.3.6.11でcoreに分割した開発用リポジトリを再び本家に統合
 - (2024-07-04) v3.6.8で、バンドルツールを`webpack`から`esbuild`に変更(#1690)
 - (2024-05-02) v3.6.2で、プラグイン用APIを一新、なでしこの変数管理をObjectからMapに変更(#1638)
@@ -204,8 +165,9 @@ Google Colabでなでしこのビルドテストできます。
 
 ## なでしこ関連リポジトリへのリンク
 
-- [なでしこ3開発リポジトリ(GitHub)](https://github.com/kujirahand/nadesiko3/)
-- [なでしこ3拡張プラグイン](https://nadesi.com/v3/doc/index.php?FAQ%2F%E6%8B%A1%E5%BC%B5%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6&show)
+- [WEB版なでしこ3(Node.js)](https://github.com/kujirahand/nadesiko3/)
+- [PC版なでしこ3(Go)](https://github.com/kujirahand/nadesiko3go)
+- [なでしこ3Node.js版の拡張プラグイン](https://nadesi.com/v3/doc/index.php?FAQ%2F%E6%8B%A1%E5%BC%B5%E3%83%97%E3%83%A9%E3%82%B0%E3%82%A4%E3%83%B3%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6&show)
   - [nadesiko3-server](https://github.com/kujirahand/nadesiko3-server) --- Webサーバ(HTTP)
   - [nadesiko3-websocket](https://github.com/kujirahand/nadesiko3-websocket) --- WebSocket
   - [nadesiko3-office](https://github.com/kujirahand/nadesiko3-office) --- Excelなど
@@ -218,15 +180,12 @@ Google Colabでなでしこのビルドテストできます。
   - [nadesiko3-mysql](https://github.com/kujirahand/nadesiko3-mysql) --- データベースMySQL
   - [nadesiko3-postgresql](https://github.com/kujirahand/nadesiko3-postgresql) --- データベースPostgreSQL
   - [nadesiko3-mssql](https://github.com/kujirahand/nadesiko3-mssql) --- データベースmssql
-- 配布用パッケージ
+- 配布用パッケージ (現在は非推奨)
   - [nadesiko3webkit - なでしこ3軽量配布キット(webkit版)](https://github.com/kujirahand/nadesiko3webkit)
   - [nadesiko3electron - なでしこ3フル配布キット(electron版)](https://github.com/kujirahand/nadesiko3electron)
   - [nadesiko3win32 - なでしこ3(コンソール版)のWindows配布パッケージ](https://github.com/kujirahand/nadesiko3win32/releases)
-- サーバーサイドJavaScriptエンジン用の実装
-  - [nadesiko3(Node.js)](https://github.com/kujirahand/nadesiko3)
-  - [nadesiko3(Deno)](https://github.com/kujirahand/nadesiko3deno)
-- 実験的に別言語で実装したなでしこ3
-  - [nadesiko3php - なでしこ3PHP](https://github.com/kujirahand/nadesiko3php)
-  - [nadesiko3rust - なでしこ3Rust](https://github.com/kujirahand/nadesiko3rust)
-  - [nadesiko3go - なでしこ3Go言語](https://github.com/kujirahand/nadesiko3go)
+- 実験/別言語で実装したなでしこ3
   - [nadesiko3core](https://github.com/kujirahand/nadesiko3core/) --- 言語コアのみ取り出したもの
+  - [nadesiko3rust - なでしこ3Rust](https://github.com/kujirahand/nadesiko3rust)
+  - [nadesiko3php - なでしこ3PHP](https://github.com/kujirahand/nadesiko3php)
+  - [nadesiko3(Deno)](https://github.com/kujirahand/nadesiko3deno)

package/batch/analize-code-line.nako3

@@ -0,0 +1,39 @@
+ROOT_DIR = 母艦パスを「../」で相対パス展開。
+
+FILES = 「{ROOT_DIR}/*.mts」の全ファイル列挙。
+TOTAL_FILES = 0
+TOTAL_LINES = 0
+TOTAL_CHARS = 0
+
+FILESを反復
+    # node_modules を除外
+    対象を『node_modules』で正規表現マッチ。
+    もし、そうならば、続ける。
+
+    F = 対象
+    S = Fを開く。
+    CHARS = Sの文字数。
+
+    # 行末の改行を取り除いてから改行で区切る
+    S_TRIM = Sの「/\r?\n$/」を「」に正規表現置換。
+    もし、S_TRIM == ""ならば
+        LINES = 0
+    違えば
+        LINES = (S_TRIMを改行で区切る)の要素数
+    ここまで。
+
+    TOTAL_FILES = TOTAL_FILES + 1
+    TOTAL_LINES = TOTAL_LINES + LINES
+    TOTAL_CHARS = TOTAL_CHARS + CHARS
+
+    # 相対パス表示
+    REL_PATH = Fの「{ROOT_DIR}」を「」に置換。
+    REL_PATH = REL_PATHの「/^[\\\/]/」を「」に正規表現置換。
+    「{REL_PATH}: {LINES}行, {CHARS}文字」を表示。
+ここまで。
+
+「----------------------------------------」を表示。
+「対象ファイル数: {TOTAL_FILES}」を表示。
+「総行数: {TOTAL_LINES} 行」を表示。
+「総文字数: {TOTAL_CHARS} 文字」を表示。
+「----------------------------------------」を表示。