nadesiko3 3.3.51 → 3.3.54

package/README.md

@@ -36,7 +36,7 @@
 「なでしこ3」とは、日本語のプログラミング言語です。HTML5/JavaScript(TypeScript)をベースとしているので、PC/スマホ/タブレットなど、さまざまな環境で動作させることができます。日本語プログラミング言語は、読みやすく理解しやすいのが特徴で、初めてでも楽しくプログラミングを覚えることができます。また、バッチ処理や定型処理などを手軽に記述できます。
 
 - [なでしこのWebサイト](https://nadesi.com/)
-- [なでしこ3のGitHub Pages)](https://kujirahand.github.io/nadesiko3/)
+- [なでしこ3のGitHub Pages](https://kujirahand.github.io/nadesiko3/)
 - [マニュアル](https://nadesi.com/v3/doc/)
 
 ## 対応機器/ブラウザ

package/batch/command.txt

@@ -1033,6 +1033,7 @@
 ■plugin_php(基本プラグイン,phpnako)
 ●PHP定数
 | 定数 | PHPバージョン | |  phpversion() | PHPばーじょん | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90
+| 定数 | PLUGIN_PHPバージョン | |  '0.0.1' | PLUGIN_PHPばーじょん | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90
 ●PHPシステム
 | 関数 | PHP取込 | FILEを/FILEの/FILEから | PHPファイルを取り込む。 | PHPとりこむ | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90
 | 関数 | セッション開始 |  | PHPセッションを開始する。 | せっしょんかいし | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90
@@ -1042,6 +1043,7 @@
 | 関数 | クッキーオプション設定 | Vを/Vへ/Vに | cookieのオプションを辞書型で設定する | くっきーおぷしょんせってい | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90
 | 定数 | GET | | [] | GET | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90
 | 定数 | POST | | [] | POST | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90
+| 定数 | SERVER | | [] | SERVER | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90
 | 定数 | FILES | | [] | FILES | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90
 | 定数 | SESSION | | [] | SESSION | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90
 | 関数 | GET取得 | KEYをDEFで/DEFにて | GETパラメータのKEYを、省略値DEFで取得する | GETしゅとく | https://github.com/kujirahand/nadesiko3php/blob/master/src/plugin_php.php#L90

package/batch/command_nakopad.txt

@@ -981,6 +981,7 @@
 + plugin_php(��{�v���O�C��,phpnako)
 - PHP�萔
 |PHP�o�[�W����,"","phpversion()",0,,�ϐ�,PHP�΁[�����
+|PLUGIN_PHP�o�[�W����,"","'0.0.1'",0,,�ϐ�,PLUGIN_PHP�΁[�����
 - PHP�V�X�e��
 |PHP�捞,"FILE��|FILE��|FILE����","PHP�t�@�C������荞�ށB",0,,����,PHP�Ƃ肱��
 |�Z�b�V�����J�n,"","PHP�Z�b�V�������J�n����B",0,,����,��������񂩂���
@@ -990,6 +991,7 @@
 |�N�b�L�[�I�v�V�����ݒ�,"V��|V��|V��","cookie�̃I�v�V�����������^�Őݒ肷��",0,,����,�������[���Ղ���񂹂��Ă�
 |GET,"","[]",0,,�ϐ�,GET
 |POST,"","[]",0,,�ϐ�,POST
+|SERVER,"","[]",0,,�ϐ�,SERVER
 |FILES,"","[]",0,,�ϐ�,FILES
 |SESSION,"","[]",0,,�ϐ�,SESSION
 |GET�擾,"KEY��DEF��|DEF�ɂ�","GET�p�����[�^��KEY���A�ȗ��lDEF�Ŏ擾����",0,,����,GET����Ƃ�

package/core/.editorconfig

@@ -0,0 +1,6 @@
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2

package/core/.eslintrc.cjs

@@ -0,0 +1,33 @@
+module.exports = {
+    "env": {
+        "browser": true,
+        "commonjs": false,
+        "es2021": true
+    },
+    "extends": [
+        "standard",
+        "standard-with-typescript",
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended"
+    ],
+    "parserOptions": {
+        "ecmaVersion": "latest",
+        "sourceType": "module",
+        "project": "./tsconfig.json",
+        "extraFileExtensions": [".mts", ".mjs"]
+    },
+    "rules": {
+        "quote-props": "off", // 重要
+        "@typescript-eslint/no-explicit-any": "off", // any型を認めないをオフ
+        "@typescript-eslint/explicit-module-boundary-types": "off", // 型の指定に関する警告をオフ
+        "@typescript-eslint/ban-ts-comment": "off", // @ts-nocheck を許さないをオフ
+        //"@typescript-eslint/no-unused-vars":  0,
+        //"@typescript-eslint/no-empty-function": 0,
+        // "no-unused-vars":0,
+        // "no-undef": 0
+    },
+    "plugins": [
+        "@typescript-eslint"
+    ],
+    "root": true
+}

package/core/.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+updates:
+- package-ecosystem: npm
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 10

package/core/.github/workflows/nodejs.yml

@@ -0,0 +1,37 @@
+# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
+# For more information see: https://help.github.com/actions/language-and-framework-guides/using-nodejs-with-github-actions
+
+# (memo)
+# GitHubで頻繁にブラウザテストが失敗するので
+# コミット時のテストを簡易化しています。
+# ただし、リリース前には必ず全テスト実行するように
+# publish用のスクリプトを追加してミスを防ぎます。 
+# [詳細] https://github.com/kujirahand/nadesiko3/issues/1037
+
+name: Node.js CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [16.x, 14.x, 12.x]
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v1
+      with:
+        node-version: ${{ matrix.node-version }}
+    - run: npm install
+    - run: npm run build
+    - run: npm run test
+

package/core/.github/workflows/super-linter.yml

@@ -0,0 +1,61 @@
+###########################
+###########################
+## Linter GitHub Actions ##
+###########################
+###########################
+name: Lint Code Base
+
+#
+# Documentation:
+# https://help.github.com/en/articles/workflow-syntax-for-github-actions
+#
+
+#############################
+# Start the job on all push #
+#############################
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+
+###############
+# Set the Job #
+###############
+jobs:
+  build:
+    # Name the Job
+    name: Lint Code Base
+    # Set the agent to run on
+    runs-on: ubuntu-latest
+
+    ##################
+    # Load all steps #
+    ##################
+    steps:
+      ##########################
+      # Checkout the code base #
+      ##########################
+      - name: Checkout Code
+        uses: actions/checkout@v2
+        with:
+          # Full git history is needed to get a proper list of changed files within `super-linter`
+          fetch-depth: 0
+
+      ################################
+      # Run Linter against code base #
+      ################################
+      - name: Lint Code Base
+        uses: github/super-linter@v4.5.1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          # 本質でないバリデータを排除(余力があればtrueにして直す)
+          VALIDATE_EDITORCONFIG: true
+          VALIDATE_JAVASCRIPT_STANDARD: true
+          VALIDATE_MARKDOWN: true
+          VALIDATE_CSS: false
+          VALIDATE_BASH: false
+          VALIDATE_HTML: false
+          VALIDATE_JSCPD: false
+          VALIDATE_JSON: false
+

package/core/.github/workflows/textlint.yml

@@ -0,0 +1,199 @@
+name: textlint CI
+
+# pull_requestで何かあった時に起動する
+on:
+  pull_request:
+
+jobs:
+  # textlintをかけ、結果をPRにコメントとして表示する。
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [ 16.x ]
+
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v1.4.4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - name: Install dependencies
+        run: |
+          yarn install -D
+      # lintする
+      - name: Lint files
+        id: lint
+        run: |
+          result="$(yarn run textlint 2>&1)" || true
+          echo "$result"
+          result="${result//'%'/'%25'}"
+          result="${result//$'\n'/'%0A'}"
+          result="${result//$'\r'/'%0D'}"
+          echo "::set-output name=result::$result"
+          true
+        continue-on-error: true
+      # lint結果をコメントに残す
+      - name: Lint Comment
+        if: github.event.pull_request.head.repo.full_name == github.repository && steps.lint.outputs.result != ''
+        uses: actions/github-script@v3
+        with:
+          github-token: ${{secrets.GITHUB_TOKEN}}
+          script: |
+            const issues_listComments_params = {
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+             repo: context.repo.repo
+            }
+            console.log("call issues.listComments:", issues_listComments_params)
+            const issue_comments = (await github.paginate(github.issues.listComments, issues_listComments_params)).filter(
+              issue_comment => issue_comment.user.id==41898282 && issue_comment.body.startsWith('日本語の')
+            )
+
+            for (const issue_comment of issue_comments) {
+              const issues_deleteComment_params = {
+                comment_id: issue_comment.id,
+                owner: context.repo.owner,
+                repo: context.repo.repo
+              }
+              console.log("call issues.deleteComment:", issues_deleteComment_params)
+              await github.issues.deleteComment(issues_deleteComment_params)
+            }
+
+            const result = `${{steps.lint.outputs.result}}`
+            const issues_createComment_params = {
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: "日本語のLint結果\n```\n"+result+"\n```"
+            }
+            console.log("call issues.createComment:", issues_createComment_params)
+            await github.issues.createComment(issues_createComment_params)
+      - name: Exit
+        if: github.event.pull_request.head.repo.full_name != github.repository && steps.lint.outcome == 'failure'
+        run: exit 1
+
+  # PRが来たらtextlintをかけてみて、差分があればPRを作って、エラーで落ちるjob
+  format:
+    runs-on: ubuntu-latest
+    if: github.event.pull_request.head.repo.full_name == github.repository
+    strategy:
+      matrix:
+        node-version: [ 16.x ]
+
+    steps:
+      - uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v1.4.4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - name: Install dependencies
+        run: |
+          yarn install -D
+      # textlintでformatする
+      - name: Format files
+        id: format
+        run: |
+          yarn run textlint:fix
+        continue-on-error: true
+      # 差分があったときは差分を出力する
+      - name: Show diff
+        id: show_diff
+        run: |
+          echo "::set-output name=diff::$(git diff)"
+      # 差分があったときは、コミットを作りpushする
+      - name: Push
+        if: steps.show_diff.outputs.diff != ''
+        run: |
+          git config user.name "textlint CI"
+          git config user.email "textlint_ci@example.com"
+          git add -u
+          git commit -m "日本語修正"
+          git push -f https://${{github.actor}}:${{secrets.GITHUB_TOKEN}}@github.com/${{github.repository}}.git HEAD:refs/heads/fix-text-${{github.event.pull_request.head.ref}}
+      - name: Get PullRequests
+        uses: actions/github-script@v3
+        if: steps.show_diff.outputs.diff != ''
+        id: get_pull_requests
+        with:
+          github-token: ${{secrets.GITHUB_TOKEN}}
+          script: |
+            const pulls_list_params = {
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              head: "kujirahand:fix-text-${{github.event.pull_request.head.ref}}",
+              base: "${{github.event.pull_request.head.ref}}",
+              state: "open"
+            }
+            console.log("call pulls.list:", pulls_list_params)
+            const pulls = await github.paginate(github.pulls.list, pulls_list_params)
+            return pulls.length
+      # pushしたブランチでPRを作る
+      - name: Create PullRequest
+        uses: actions/github-script@v3
+        if: steps.show_diff.outputs.diff != '' && steps.get_pull_requests.outputs.result == 0
+        with:
+          github-token: ${{secrets.GITHUB_TOKEN}}
+          script: |
+            const common_params = {
+              owner: context.repo.owner,
+              repo: context.repo.repo
+            }
+            const pulls_create_params = {
+              head: "kujirahand:fix-text-${{github.event.pull_request.head.ref}}",
+              base: "${{github.event.pull_request.head.ref}}",
+              title: "日本語修正 (修正する場合はPRをマージしてください) #${{github.event.pull_request.number}}",
+              body: "日本語を修正しました。本PRをマージすると #${{github.event.pull_request.number}} に修正が適用されます。",
+              ...common_params
+            }
+            console.log("call pulls.create:", pulls_create_params)
+            const create_pull_res = (await github.pulls.create(pulls_create_params)).data
+            const issues_add_assignees_params = {
+              issue_number: create_pull_res.number,
+              assignees: ["${{github.event.pull_request.user.login}}"],
+              ...common_params
+            }
+            console.log("call issues.addAssignees:", issues_add_assignees_params)
+            await github.issues.addAssignees(issues_add_assignees_params)
+      # 既にformat修正のPRがある状態で、手動でformatを修正した場合、format修正のPRを閉じる
+      - name: Close PullRequest
+        uses: actions/github-script@v3
+        if: steps.show_diff.outputs.diff == ''
+        with:
+          github-token: ${{secrets.GITHUB_TOKEN}}
+          script: |
+            const head_name = "fix-text-${{github.event.pull_request.head.ref}}"
+            const common_params = {
+              owner: context.repo.owner,
+              repo: context.repo.repo
+            }
+            const pulls_list_params = {
+              head: "kujirahand:" + head_name,
+              base: "${{github.event.pull_request.head.ref}}",
+              state: "open",
+              ...common_params
+            }
+            console.log("call pulls.list:", pulls_list_params)
+            const pulls = await github.paginate(github.pulls.list,pulls_list_params)
+
+            for (const pull of pulls) {
+              const pulls_update_params = {
+                pull_number: pull.number,
+                state: "closed",
+                ...common_params
+              }
+              console.log("call pulls.update:", pulls_update_params)
+              await github.pulls.update(pulls_update_params)
+              const git_deleteRef_params = {
+                ref: "heads/" + head_name,
+                ...common_params
+              }
+              console.log("call git.deleteRef:", git_deleteRef_params)
+              await github.git.deleteRef(git_deleteRef_params)
+            }
+      - name: Exit
+        if: steps.show_diff.outputs.diff != ''
+        run: exit 1

package/core/README.md

@@ -63,4 +63,8 @@ $ snako -e "1+2を表示"
 $ snako nadesiko3core/sample/hello.nako3
 ```
 
+## なでしこの内部構造について
+
+なでしこの内部構造の仕組みについては、[こちら](/doc/README.md)に詳しく書かれています。
+
 

package/core/doc/README.md

@@ -0,0 +1,67 @@
+# 日本語プログラミング言語「なでしこ3」 内部構造について
+
+なでしこ3は、altJSと呼ばれる仕組みを採用しており、なでしこのプログラムが最終的にJavaScriptに変換されて実行されます。
+
+大きく言って次の仕組みで実行されます。
+
+- 1.[字句解析](/src/nako_lexer.mts)
+- 2.[構文解析](/src/nako_parser3.mts)
+- 3.[コード生成](/src/nako_gen.mts)
+- 4.[実行](/src/nako3.mts)
+ 
+## 字句解析
+
+[字句解析](/src/nako_lexer.mts)では、なでしこのソースコードをトークンと呼ばれる、最小の字句要素に分割します。以下のtokenizeメソッドで分割します。
+
+- [tokenizeメソッド](https://github.com/kujirahand/nadesiko3core/blob/7db54415b74815739fdb64aa05df7da9e5ab1bdf/src/nako_lexer.mts#L404)
+
+なお、トークンを分割するのに複数のルールを利用します。ルールは、配列形式で記述されており、上から順にソースコードにマッチするかを順に確認していきます。
+
+- [rules配列](https://github.com/kujirahand/nadesiko3core/blob/7db54415b74815739fdb64aa05df7da9e5ab1bdf/src/nako_lex_rules.mts#L32)
+
+### 字句解析前の細かな処理
+
+ただし、実際には、字句解析を行う前に、全角半角を揃えたり、特殊な記法を一般的な記法に置き換えたりと前置処理が行われます。
+
+- [前置処理](/src/nako_prepare.mts)
+
+また、なでしこ3では、インデント構文やDNCLモードなどをサポートしており、これは、なでしこの文法を劇的に置換する特殊モードで、字句解析の前に置換処理がおこなれます。
+
+- [インデント構文](/src/nako_indent.mts)
+- [DNCLモード](/src/nako_from_dncl.mjs)
+
+## 構文解析
+
+[構文解析](/src/nako_parser3.mts)では、なでしこの文法に沿った記述があるかどうかを一つずつ確認して、ソースコードを構文木に変換します。
+なでしこの構文木は、複数のノードを木構造でつなげたものです。
+
+- [構文木のノード(Ast)](https://github.com/kujirahand/nadesiko3core/blob/7db54415b74815739fdb64aa05df7da9e5ab1bdf/src/nako_types.mts#L72)
+
+この構文木は、[本家(nadesiko3)](https://github.com/kujirahand/nadesiko3)のcnako3コマンドで、--ast オプションを付けると確認できます。
+例えば、「2+3を表示」というプログラムは、次のような構文木に変換されます。
+
+- block:
+  - func (表示):
+    - args:
+      - op(+)
+        - left:
+          - number (2)
+        - right:
+          - number (3)
+
+## コード生成
+
+[コード生成](/src/nako_gen.mts)の処理では、構文解析で作成した構文木のコードを、JavaScriptのコードに変換します。
+構文木の各要素を一つずつJavaScriptに変換します。
+
+コード変換を実際に行うのが、[_codeGenメソッド](https://github.com/kujirahand/nadesiko3core/blob/7db54415b74815739fdb64aa05df7da9e5ab1bdf/src/nako_gen.mts#L418)です。このメソッドでは、Astのtypeプロパティを調べて、各要素を一つずつ変換していきます。
+
+- 例えば、構文木の種類が[number](https://github.com/kujirahand/nadesiko3core/blob/7db54415b74815739fdb64aa05df7da9e5ab1bdf/src/nako_gen.mts#L460)であれば、数値なのでそのまま数値を返します。
+- [演算子(op)](https://github.com/kujirahand/nadesiko3core/blob/7db54415b74815739fdb64aa05df7da9e5ab1bdf/src/nako_gen.mts#L1388)の時は計算を行うJavaScriptのコードを生成します。
+- [繰り返す文(for)](https://github.com/kujirahand/nadesiko3core/blob/7db54415b74815739fdb64aa05df7da9e5ab1bdf/src/nako_gen.mts#L909)であれば、必要なパラメータを取得しつつJavaScriptのfor文を生成します。
+
+## 実行
+
+[実行](/src/nako3.mts)は、JavaScriptのコードを評価する[evalJS](https://github.com/kujirahand/nadesiko3core/blob/7db54415b74815739fdb64aa05df7da9e5ab1bdf/src/nako3.mts#L749)メソッドで行います。
+JavaScriptの`new Function(code)`を使ってJavaScriptのコードを実行します。
+

package/core/index.mjs

@@ -1,4 +1,4 @@
-import version from './src/nako_core_version.mjs';
+import coreVersion from './src/nako_core_version.mjs';
 import { NakoCompiler } from './src/nako3.mjs';
 import { NakoLogger } from './src/nako_logger.mjs';
 import { NakoError, NakoRuntimeError, NakoImportError } from './src/nako_errors.mjs';
@@ -6,7 +6,7 @@ import { NakoParser } from './src/nako_parser3.mjs';
 import { NakoPrepare } from './src/nako_prepare.mjs';
 export default {
     // version
-    version,
+    version: coreVersion,
     // compiler
     NakoCompiler,
     // loggger

package/core/index.mts

@@ -0,0 +1,21 @@
+import coreVersion from './src/nako_core_version.mjs'
+import { NakoCompiler } from './src/nako3.mjs'
+import { NakoLogger } from './src/nako_logger.mjs'
+import { NakoError, NakoRuntimeError, NakoImportError } from './src/nako_errors.mjs'
+import { NakoParser } from './src/nako_parser3.mjs'
+import { NakoPrepare } from './src/nako_prepare.mjs'
+export default {
+  // version
+  version: coreVersion,
+  // compiler
+  NakoCompiler,
+  // loggger
+  NakoLogger,
+  // error
+  NakoError,
+  NakoRuntimeError,
+  NakoImportError,
+  // tools etc..
+  NakoParser,
+  NakoPrepare
+}

package/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nadesiko3core",
-  "version": "3.3.50",
+  "version": "3.3.54",
   "description": "Japanese Programming Language Nadesiko v3 core",
   "main": "index.mjs",
   "type": "module",