nadesiko3 3.3.49 → 3.3.52

package/batch/pickup_command.nako3

@@ -1,110 +1,113 @@
-# -----------------------------------------------------
-# なでしこのソースコードから命令一覧テキストを作成する
-#-------------------------------------------------
-# 入力: src/plugin_xxx.js
-# 出力: command.txt
-# -----------------------------------------------------
-!「jsplugin2text.nako3」を取り込む。
-
-# 基本パスを取得
-母艦パス取得してパス抽出して基本パスに代入。
-REPOSパス=基本パスを「../」で相対パス展開。
-CORE="core/src"
-
-コアプラグイン一覧は[
-    ["plugin_system.mts", 'wnako,cnako,phpnako'],
-    ["plugin_csv.mts", 'wnako,cnako'],
-    ["plugin_math.mts", 'wnako,cnako'],
-    ["plugin_promise.mts", 'wnako']
-]
-
-基本プラグイン一覧は[
-    ['src/plugin_browser.mjs','wnako'],
-    ['src/plugin_turtle.mjs', 'wnako'],
-    ['src/plugin_node.mts', 'cnako,phpnako'],
-    ['src/plugin_httpserver.mts', 'cnako'],
-    ['src/plugin_markup.mjs', 'wnako,cnako'],
-    ['src/plugin_datetime.mjs', 'wnako,cnako'],
-    ['src/plugin_caniuse.mjs', 'wnako,cnako'],
-    ['src/plugin_kansuji.mjs', 'wnako,cnako'],
-    ['src/plugin_weykturtle3d.mjs', 'wnako'],
-    ['src/plugin_webworker.mjs', 'wnako'],
-]
-拡張プラグイン一覧は[
-    ['nadesiko3-tools/nadesiko3-tools.mjs', 'cnako'],    
-    ['nadesiko3-server/nadesiko3-server.mjs', 'cnako'],
-    ['nadesiko3-sqlite3/nadesiko3-sqlite3.js', 'cnako'],    
-    ['nadesiko3-htmlparser/nadesiko3-htmlparser.js', 'cnako'],
-    ['nadesiko3-websocket/nadesiko3-websocket.js', 'cnako'],
-    ['nadesiko3-ml/nadesiko3-ml.js', 'cnako'],
-    ['nadesiko3-mecab/nadesiko3-mecab.js', 'cnako'],
-    ['nadesiko3-office/nadesiko3-office.js', 'cnako'],
-    ['nadesiko3-odbc/src/plugin_odbc.js', 'cnako'],
-    ['nadesiko3-mssql/src/plugin_mssql.js', 'cnako'],
-    ['nadesiko3-mysql/src/plugin_mysql.js', 'cnako'],
-    ['nadesiko3-postgresql/src/plugin_postgresql.js', 'cnako'],
-    ['nadesiko3php/src/plugin_php.php', 'phpnako'],
-]
-# サポートしない
-# 'nadesiko3-firebase/plugin_firebase.js',
-# 'nadesiko3-googlehome/plugin_googlehome.js',
-# 'nadesiko3-sqlite3sync/nadesiko3-sqlite3sync.js', # 利用は非推奨に
-# 'nadesiko3-drone/nadesiko3-drone.js', 'cnako', # ドローン
-
-#------------------------
-結果データ＝「」
-SRC_URL=""
-FILE_PATH=""
-#------------------------
-コアプラグイン一覧を反復
-　　PNAME=対象@0
-　　カレントプラグイン＝"{CORE}/{PNAME}"
-　　FILE_PATH="{基本パス}/{CORE}/{PNAME}"
-　　# https://github.com/kujirahand/nadesiko3core/blob/main/src/{PNAME}#L119
-　　SRC_URL="https://github.com/kujirahand/nadesiko3core/blob/main/src/{PNAME}"
-　　ナコタイプ＝対象＠1
-　　パスは「{基本パス}/{カレントプラグイン}」
-　　パスを「(基本プラグイン,{ナコタイプ})」でプラグイン要約作成
-　　結果データ＝結果データ＆それ＆改行＆改行。
-ここまで
-#------------------------
-基本プラグイン一覧を反復
-　　PNAME=対象@0
-　　カレントプラグイン＝対象@0
-　　ナコタイプ＝対象＠1
-　　FILE_PATH="{基本パス}/{PNAME}"
-　　SRC_URL="https://github.com/kujirahand/nadesiko3/tree/master/{PNAME}"
-　　パスは「{基本パス}/{カレントプラグイン}」
-　　パスを「(基本プラグイン,{ナコタイプ})」でプラグイン要約作成
-　　結果データ＝結果データ＆それ＆改行＆改行。
-ここまで
-#------------------------
-拡張プラグイン一覧を反復
-　　カレントプラグイン＝それ@0
-　　ナコタイプ＝それ＠1
-　　パスは「{REPOSパス}/{カレントプラグイン}」
-　　FILE_PATH="{REPOSパス}/{カレントプラグイン}"
-　　SRC_URL="https://github.com/kujirahand/{カレントプラグイン}"
-　　パスが存在
-　　もし、そうならば
-　　　　 # パスを表示。
-　　　　EX=「拡張プラグイン」
-　　　　もし、ナコタイプ＝「phpnako」ならば
-　　　　　EX=「基本プラグイン」
-　　　　ここまで
-　　　　パスを「({EX},{ナコタイプ})」でプラグイン要約作成。
-　　　　結果データ＝結果データ＆それ＆改行＆改行。
-　　違えば
-　　　　「REPORT_ERR」の環境変数取得
-　　　　もしそうならば
-　　　　　　OS=OS取得
-　　　　　　もし、OS="darwin"ならば
-　　　　　　　　「[エラー]ファイルが存在しない: {パス}」を表示。
-　　　　　　　　「ファイルが存在しない:{パス}」のエラー発生。
-　　　　　　ここまで。
-　　　　ここまで。
-　　ここまで。
-ここまで。
-#------------------------
-結果データを「{基本パス}/batch/command.txt」に保存。
-
+# -----------------------------------------------------
+# なでしこのソースコードから命令一覧テキストを作成する
+#-------------------------------------------------
+# 入力: src/plugin_xxx.js
+# 出力: command.txt
+# -----------------------------------------------------
+!「jsplugin2text.nako3」を取り込む。
+
+# 基本パスを取得
+母艦パス取得してパス抽出して基本パスに代入。
+REPOSパス=基本パスを「../」で相対パス展開。
+CORE="core/src"
+
+コアプラグイン一覧は[
+    ["plugin_system.mts", 'wnako,cnako,phpnako'],
+    ["plugin_csv.mts", 'wnako,cnako'],
+    ["plugin_math.mts", 'wnako,cnako'],
+    ["plugin_promise.mts", 'wnako']
+]
+
+基本プラグイン一覧は[
+    ['src/plugin_browser.mjs','wnako'],
+    ['src/plugin_turtle.mjs', 'wnako'],
+    ['src/plugin_node.mts', 'cnako,phpnako'],
+    ['src/plugin_httpserver.mts', 'cnako'],
+    ['src/plugin_markup.mjs', 'wnako,cnako'],
+    ['src/plugin_datetime.mjs', 'wnako,cnako'],
+    ['src/plugin_caniuse.mjs', 'wnako,cnako'],
+    ['src/plugin_kansuji.mjs', 'wnako,cnako'],
+    ['src/plugin_weykturtle3d.mjs', 'wnako'],
+    ['src/plugin_webworker.mjs', 'wnako'],
+]
+拡張プラグイン一覧は[
+    ['nadesiko3-tools/nadesiko3-tools.mjs', 'cnako'],    
+    ['nadesiko3-server/nadesiko3-server.mjs', 'cnako'],
+    ['nadesiko3-sqlite3/nadesiko3-sqlite3.js', 'cnako'],    
+    ['nadesiko3-htmlparser/nadesiko3-htmlparser.js', 'cnako'],
+    ['nadesiko3-websocket/nadesiko3-websocket.js', 'cnako'],
+    ['nadesiko3-ml/nadesiko3-ml.js', 'cnako'],
+    ['nadesiko3-mecab/nadesiko3-mecab.js', 'cnako'],
+    ['nadesiko3-office/nadesiko3-office.js', 'cnako'],
+    ['nadesiko3-odbc/src/plugin_odbc.js', 'cnako'],
+    ['nadesiko3-mssql/src/plugin_mssql.js', 'cnako'],
+    ['nadesiko3-mysql/src/plugin_mysql.js', 'cnako'],
+    ['nadesiko3-postgresql/src/plugin_postgresql.js', 'cnako'],
+    ['nadesiko3php/src/plugin_php.php', 'phpnako'],
+]
+# サポートしない
+# 'nadesiko3-firebase/plugin_firebase.js',
+# 'nadesiko3-googlehome/plugin_googlehome.js',
+# 'nadesiko3-sqlite3sync/nadesiko3-sqlite3sync.js', # 利用は非推奨に
+# 'nadesiko3-drone/nadesiko3-drone.js', 'cnako', # ドローン
+
+#------------------------
+結果データ＝「」
+SRC_URL=""
+FILE_PATH=""
+#------------------------
+コアプラグイン一覧を反復
+　　PNAME=対象@0
+　　カレントプラグイン＝"{CORE}/{PNAME}"
+　　FILE_PATH="{基本パス}/{CORE}/{PNAME}"
+　　# https://github.com/kujirahand/nadesiko3core/blob/main/src/{PNAME}#L119
+　　SRC_URL="https://github.com/kujirahand/nadesiko3core/blob/main/src/{PNAME}"
+　　ナコタイプ＝対象＠1
+　　パスは「{基本パス}/{カレントプラグイン}」
+　　パスを「(基本プラグイン,{ナコタイプ})」でプラグイン要約作成
+　　結果データ＝結果データ＆それ＆改行＆改行。
+ここまで
+#------------------------
+基本プラグイン一覧を反復
+　　PNAME=対象@0
+　　カレントプラグイン＝対象@0
+　　ナコタイプ＝対象＠1
+　　FILE_PATH="{基本パス}/{PNAME}"
+　　SRC_URL="https://github.com/kujirahand/nadesiko3/tree/master/{PNAME}"
+　　パスは「{基本パス}/{カレントプラグイン}」
+　　パスを「(基本プラグイン,{ナコタイプ})」でプラグイン要約作成
+　　結果データ＝結果データ＆それ＆改行＆改行。
+ここまで
+#------------------------
+拡張プラグイン一覧を反復
+　　カレントプラグイン＝それ@0
+　　ナコタイプ＝それ＠1
+　　パスは「{REPOSパス}/{カレントプラグイン}」
+　　FILE_PATH="{REPOSパス}/{カレントプラグイン}"
+　　カレントプラグインを「/」で区切ってAに代入。
+　　P0＝Aの0を配列切取。
+　　P1=Aを「/」で配列結合。
+　　SRC_URL="https://github.com/kujirahand/{P0}/blob/master/{P1}"
+　　パスが存在
+　　もし、そうならば
+　　　　 # パスを表示。
+　　　　EX=「拡張プラグイン」
+　　　　もし、ナコタイプ＝「phpnako」ならば
+　　　　　EX=「基本プラグイン」
+　　　　ここまで
+　　　　パスを「({EX},{ナコタイプ})」でプラグイン要約作成。
+　　　　結果データ＝結果データ＆それ＆改行＆改行。
+　　違えば
+　　　　「REPORT_ERR」の環境変数取得
+　　　　もしそうならば
+　　　　　　OS=OS取得
+　　　　　　もし、OS="darwin"ならば
+　　　　　　　　「[エラー]ファイルが存在しない: {パス}」を表示。
+　　　　　　　　「ファイルが存在しない:{パス}」のエラー発生。
+　　　　　　ここまで。
+　　　　ここまで。
+　　ここまで。
+ここまで。
+#------------------------
+結果データを「{基本パス}/batch/command.txt」に保存。
+

package/batch/pickup_reserved_words.nako3

@@ -1,11 +1,11 @@
-# 予約語の定義
-PATH=母艦パスを「../src/nako_reserved_words.mjs」で相対パス展開。
-A=[]
-PATHを開いて、改行で区切る。
-反復
-　　対象を『/^\s+\'(.+?)\'\s*\:/』で正規表現マッチ。
-　　もし、そうでなければ、続ける。
-　　N=抽出文字列[0]
-　　AにNを配列追加。
-ここまで。
-Aを「, 」で配列結合して表示。
+# 予約語の定義
+PATH=母艦パスを「../src/nako_reserved_words.mjs」で相対パス展開。
+A=[]
+PATHを開いて、改行で区切る。
+反復
+　　対象を『/^\s+\'(.+?)\'\s*\:/』で正規表現マッチ。
+　　もし、そうでなければ、続ける。
+　　N=抽出文字列[0]
+　　AにNを配列追加。
+ここまで。
+Aを「, 」で配列結合して表示。

package/batch/publish_version.nako3

@@ -1,46 +1,46 @@
-# ---------------------------------------------------------
-# なでしこ3のバージョンをkonawiki2/3/nako3storageに反映
-# ---------------------------------------------------------
-前提条件=「Gitリポジトリを以下のように設定してください。
-# /path/to/nadesiko3
-# /path/to/konawiki2
-# /path/to/konawiki3
-# /path/to/nako3storage
-」。
-# ---------------------------------------------------------
-母艦パス取得してパス抽出して基本パスに代入。
-DIR_REPO = (基本パスからパス抽出)
-VER=ナデシコバージョン。
-VER_PHP=「<?php
-define('NAKO_DEFAULT_VERSION', '{VER}');
-
-」
-# ---------------------------------------------------------
-# リポジトリごとに処理
-ファイル一覧=[
-  "/nako3storage/nako_version.inc.php",
-  "/konawiki2/kona-engine/plugins/nako_version.inc.php",
-  "/konawiki3/kona3engine/plugins/nako3/nako_version.inc.php"
-]
-ファイル一覧を反復
-  パス=DIR_REPO&対象
-  確認パス＝（パスからパス抽出）。
-  もし、確認パスが存在しなければ
-  　　「[ERROR] レポジトリ: {対象}」を表示。
-  　　前提条件を表示。終わり。
-  ここまで。
-  # コピー
-  VER_PHPをパスに保存。
-  「=== === === ===」を表示;
-  「[OK] {パス}」を表示。
-  # コミットする
-  MSG="updated nako3 ver."&ナデシコバージョン;
-  CMD=「cd "{確認パス}" && git commit -a -m "{MSG}" && git push」
-  エラー監視
-　　　CMDを起動待機。
-　エラーならば
-　　　「コミットできません: {確認パス}」を表示。
-　ここまで。
-ここまで。
-
-
+# ---------------------------------------------------------
+# なでしこ3のバージョンをkonawiki2/3/nako3storageに反映
+# ---------------------------------------------------------
+前提条件=「Gitリポジトリを以下のように設定してください。
+# /path/to/nadesiko3
+# /path/to/konawiki2
+# /path/to/konawiki3
+# /path/to/nako3storage
+」。
+# ---------------------------------------------------------
+母艦パス取得してパス抽出して基本パスに代入。
+DIR_REPO = (基本パスからパス抽出)
+VER=ナデシコバージョン。
+VER_PHP=「<?php
+define('NAKO_DEFAULT_VERSION', '{VER}');
+
+」
+# ---------------------------------------------------------
+# リポジトリごとに処理
+ファイル一覧=[
+  "/nako3storage/nako_version.inc.php",
+  "/konawiki2/kona-engine/plugins/nako_version.inc.php",
+  "/konawiki3/kona3engine/plugins/nako3/nako_version.inc.php"
+]
+ファイル一覧を反復
+  パス=DIR_REPO&対象
+  確認パス＝（パスからパス抽出）。
+  もし、確認パスが存在しなければ
+  　　「[ERROR] レポジトリ: {対象}」を表示。
+  　　前提条件を表示。終わり。
+  ここまで。
+  # コピー
+  VER_PHPをパスに保存。
+  「=== === === ===」を表示;
+  「[OK] {パス}」を表示。
+  # コミットする
+  MSG="updated nako3 ver."&ナデシコバージョン;
+  CMD=「cd "{確認パス}" && git commit -a -m "{MSG}" && git push」
+  エラー監視
+　　　CMDを起動待機。
+　エラーならば
+　　　「コミットできません: {確認パス}」を表示。
+　ここまで。
+ここまで。
+
+

package/batch/show_agents.js

@@ -1,14 +1,14 @@
-const a = require('caniuse-db/data.json').agents
-const e = {}
-const t = {}
-for (let key in a) {
-  e[key] = a[key]['browser'];
-  let type = a[key]['type'];
-  if (t[type] === undefined) {
-    t[type] = [];
-  }
-  t[type].push(key)
-}
-console.log(JSON.stringify(e))
-// console.log(JSON.stringify(t))
-// console.log(JSON.stringify(a))
+const a = require('caniuse-db/data.json').agents
+const e = {}
+const t = {}
+for (let key in a) {
+  e[key] = a[key]['browser'];
+  let type = a[key]['type'];
+  if (t[type] === undefined) {
+    t[type] = [];
+  }
+  t[type].push(key)
+}
+console.log(JSON.stringify(e))
+// console.log(JSON.stringify(t))
+// console.log(JSON.stringify(a))

package/batch/turtle2js.nako3

@@ -1,21 +1,21 @@
-# src/turtle64.png を src/image_turtle64.mjs に変換する
-
-SRC_DIR = 母艦パスを「../src」で相対パス展開。
-SRC_DIRを表示。
-
-「turtle64.png」をJS変換処理
-「turtle-panda.png」をJS変換処理
-「turtle-elephant.png」をJS変換処理
-
-●(Fを)JS変換処理
-　　BIN =「{SRC_DIR}/{F}」をバイナリ読む。
-　　B64 = BINをBASE64エンコード
-　　FNAME=Fの「.png」を「.mjs」に置換。
-　　FULLNAME=「{SRC_DIR}/image_{FNAME}」
-　　「
-// file:{F}
-export default 'data:image/png;base64,{B64}'
-//
-    」をFULLNAMEへ保存。
-    FULLNAMEを表示。
-ここまで。
+# src/turtle64.png を src/image_turtle64.mjs に変換する
+
+SRC_DIR = 母艦パスを「../src」で相対パス展開。
+SRC_DIRを表示。
+
+「turtle64.png」をJS変換処理
+「turtle-panda.png」をJS変換処理
+「turtle-elephant.png」をJS変換処理
+
+●(Fを)JS変換処理
+　　BIN =「{SRC_DIR}/{F}」をバイナリ読む。
+　　B64 = BINをBASE64エンコード
+　　FNAME=Fの「.png」を「.mjs」に置換。
+　　FULLNAME=「{SRC_DIR}/image_{FNAME}」
+　　「
+// file:{F}
+export default 'data:image/png;base64,{B64}'
+//
+    」をFULLNAMEへ保存。
+    FULLNAMEを表示。
+ここまで。

package/bin/cnako3

@@ -1,10 +1,10 @@
-#!/bin/bash
-ROOT_DIR=$(
-  cd $(dirname "$0")
-  cd ..
-  pwd
-)
-SRC_DIR=$ROOT_DIR/src
-NAKO_JS=$SRC_DIR/cnako3.mjs
-
-/usr/bin/env node "$NAKO_JS" $*
+#!/bin/bash
+ROOT_DIR=$(
+  cd $(dirname "$0")
+  cd ..
+  pwd
+)
+SRC_DIR=$ROOT_DIR/src
+NAKO_JS=$SRC_DIR/cnako3.mjs
+
+/usr/bin/env node "$NAKO_JS" $*

package/core/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2022 kujirahand
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2022 kujirahand
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/core/README.md

@@ -1,66 +1,66 @@
-# 日本語プログラミング言語「なでしこ3」言語エンジン
-
-[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE)
-[![npm version](https://badge.fury.io/js/nadesiko3core.svg)](https://www.npmjs.com/package/nadesiko3core)
-
-## 「なでしこ3」とは
-
-「なでしこ3」とは、日本語のプログラミング言語です。HTML5/JavaScript(TypeScript)をベースとしているので、PC/スマホ/タブレットなど、さまざまな環境で動作させることができます。日本語プログラミング言語は、読みやすく理解しやすいのが特徴で、初めてでも楽しくプログラミングを覚えることができます。
-
-- [なでしこ3開発リポジトリ - nadesiko3](https://github.com/kujirahand/nadesiko3)
-- [なでしこのWebサイト](https://nadesi.com/top/)
-
-## 本リポジトリについて
-
-本リポジトリは、なでしこ3の言語エンジンのみを取り出したものです。最小限の構成となっています。
-言語機能と最小限のプラグインのみを備えています。
-
-- [なでしこの基本文法(外部サイト)](https://nadesi.com/v3/doc/index.php?%E6%96%87%E6%B3%95)
-
-最小限のプラグイン構成
-
-- [plugin_system](./src/plugin_system.mts) --- 言語機能の補助など基本的な関数群
-- [plugin_math](./src/plugin_math.mts) --- 数学関数群
-- [plugin_csv](./src/plugin_csv.mts)--- CSV処理のための関数群
-- [plugin_promise](./src/plugin_promise.mts) --- プロミス機能を実現するための関数群
-- [plugin_test](./src/plugin_test.mts) --- テストを記述するための関数群
-
-# 本ライブラリの使い方
-
-例えば、`npm install nadesiko3core`でなでしこ3言語エンジンをインストールしたら、以下のプログラムを記述します。
-`hoge.mjs`という名前で保存します。そして、以下のようなプログラムを記述します。
-
-```js
-import core from 'nadesiko3core'
-const com = new core.NakoCompiler()
-const g = com.run('1 + 2 * 3を表示') // ← ここになでしこのプログラム
-console.log(g.log) // ← 「表示」した内容がlogに入っている
-```
-
-プログラムを実行するには、`node hoge.mjs`と記述すれば実行できます。
-
-## コマンドラインから実行したい場合
-
-コマンドラインからなでしこのプログラムを実行したい場合には、[nadesiko3](https://github.com/kujirahand/nadesiko3)リポジトリを利用してください。nadesiko3リポジトリには、コマンドライン版のなでしこ(cnako3)が含まれています。
-
-なお、本リポジトリにも、[簡易版のコマンドラインツール(snako)](/command/snako.mts)を収録しています。以下は簡単な使い方です。
-
-```
-# ファイル sample/hello.nako3 を実行
-$ node command/snako.mjs sample/hello.nako3
-
-# その場でコードを実行
-$ node command/snako.mjs -e "1+2を表示"
-```
-
-### 簡易コマンドラインをグローバルインストールして使う場合
-
-簡易コマンドライン(snako)を手軽に利用したい場合は、次のように実行します。
-
-```
-$ npm install -g nadesiko3core
-$ snako -e "1+2を表示"
-$ snako nadesiko3core/sample/hello.nako3
-```
-
-
+# 日本語プログラミング言語「なでしこ3」言語エンジン
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE)
+[![npm version](https://badge.fury.io/js/nadesiko3core.svg)](https://www.npmjs.com/package/nadesiko3core)
+
+## 「なでしこ3」とは
+
+「なでしこ3」とは、日本語のプログラミング言語です。HTML5/JavaScript(TypeScript)をベースとしているので、PC/スマホ/タブレットなど、さまざまな環境で動作させることができます。日本語プログラミング言語は、読みやすく理解しやすいのが特徴で、初めてでも楽しくプログラミングを覚えることができます。
+
+- [なでしこ3開発リポジトリ - nadesiko3](https://github.com/kujirahand/nadesiko3)
+- [なでしこのWebサイト](https://nadesi.com/top/)
+
+## 本リポジトリについて
+
+本リポジトリは、なでしこ3の言語エンジンのみを取り出したものです。最小限の構成となっています。
+言語機能と最小限のプラグインのみを備えています。
+
+- [なでしこの基本文法(外部サイト)](https://nadesi.com/v3/doc/index.php?%E6%96%87%E6%B3%95)
+
+最小限のプラグイン構成
+
+- [plugin_system](./src/plugin_system.mts) --- 言語機能の補助など基本的な関数群
+- [plugin_math](./src/plugin_math.mts) --- 数学関数群
+- [plugin_csv](./src/plugin_csv.mts)--- CSV処理のための関数群
+- [plugin_promise](./src/plugin_promise.mts) --- プロミス機能を実現するための関数群
+- [plugin_test](./src/plugin_test.mts) --- テストを記述するための関数群
+
+# 本ライブラリの使い方
+
+例えば、`npm install nadesiko3core`でなでしこ3言語エンジンをインストールしたら、以下のプログラムを記述します。
+`hoge.mjs`という名前で保存します。そして、以下のようなプログラムを記述します。
+
+```js
+import core from 'nadesiko3core'
+const com = new core.NakoCompiler()
+const g = com.run('1 + 2 * 3を表示') // ← ここになでしこのプログラム
+console.log(g.log) // ← 「表示」した内容がlogに入っている
+```
+
+プログラムを実行するには、`node hoge.mjs`と記述すれば実行できます。
+
+## コマンドラインから実行したい場合
+
+コマンドラインからなでしこのプログラムを実行したい場合には、[nadesiko3](https://github.com/kujirahand/nadesiko3)リポジトリを利用してください。nadesiko3リポジトリには、コマンドライン版のなでしこ(cnako3)が含まれています。
+
+なお、本リポジトリにも、[簡易版のコマンドラインツール(snako)](/command/snako.mts)を収録しています。以下は簡単な使い方です。
+
+```
+# ファイル sample/hello.nako3 を実行
+$ node command/snako.mjs sample/hello.nako3
+
+# その場でコードを実行
+$ node command/snako.mjs -e "1+2を表示"
+```
+
+### 簡易コマンドラインをグローバルインストールして使う場合
+
+簡易コマンドライン(snako)を手軽に利用したい場合は、次のように実行します。
+
+```
+$ npm install -g nadesiko3core
+$ snako -e "1+2を表示"
+$ snako nadesiko3core/sample/hello.nako3
+```
+
+