@jingyi0605/codingns 0.7.4 → 0.8.1

package/vendor/node-pty-fork/README.md

@@ -0,0 +1,91 @@
+# `@codingns/node-pty`
+
+CodingNS 自维护的 `node-pty` fork。
+
+第一版目标很窄，不装大蒜：
+
+- 只支持 `win32 + x64 + Node 22`
+- 只解决 CodingNS 在 Windows 上的免本机编译安装链
+- 不伪装成官方 `node-pty`
+
+## 当前边界
+
+- 上游基线：`node-pty@1.0.0`
+- fork 版本：`1.0.0-cns.1`
+- npm 包名：`@codingns/node-pty`
+- 正式目标：发布时随包带上 `build/Release` 下的 Windows Node 22 运行必需文件
+
+这不是一个“通用跨平台 fork”。
+
+第一版只对下面这个矩阵负责：
+
+- 平台：Windows
+- 架构：x64
+- Node：22.x
+
+不在这个矩阵里，就直接视为不支持。
+
+## 仓库内容
+
+- `vendor/upstream/`：上游 `node-pty@1.0.0` tarball 解包结果
+- `scripts/fetch-upstream.mjs`：下载上游 tarball
+- `scripts/sync-upstream.mjs`：把上游源码同步到 fork 工作目录
+- `scripts/verify-runtime.cjs`：检查 workspace 是否已经具备可运行的 Windows 预编译产物
+- `scripts/verify-tarball.cjs`：检查打包前后的关键文件
+- `scripts/smoke-load.cjs`：最小加载验证
+
+## 同步上游
+
+```bash
+npm run fetch:upstream
+npm run sync:upstream
+```
+
+同步策略是：
+
+- 保留 fork 自己的 `README.md`
+- 保留 fork 自己的 `package.json`
+- 只同步上游源码、类型、`binding.gyp`、许可证和依赖目录
+
+别把 fork 自己的发布边界说明再覆盖回官方 README，那种做法非常蠢。
+
+## 构建与验收
+
+Windows Node 22 Runner 上的最小闭环：
+
+```bash
+npm install --ignore-scripts
+npm run build:native
+npm run verify:runtime
+npm pack
+npm run verify:tarball
+npm run smoke:install
+```
+
+其中：
+
+- `verify:tarball` 会把最新的 `.tgz` 解包到临时目录，直接检查发布包内容
+- `smoke:install` 会在临时目录里安装 tarball，并阻断任何 `node-gyp rebuild`
+
+## 发布阻断条件
+
+只要出现下面任一情况，就不能发包：
+
+- `build/Release` 缺少 `conpty.node`
+- `build/Release` 缺少 `conpty_console_list.node`
+- `build/Release` 缺少 `pty.node`
+- `build/Release` 缺少 `winpty-agent.exe` 或 `winpty.dll`
+- `npm pack` 后 tarball 里没有这些文件
+- 安装后 `require("@codingns/node-pty")` 无法加载
+
+## 当前状态
+
+现在这个目录已经是 fork 骨架，不再是空目录。
+
+但它还不是正式可发布成品，因为：
+
+- 还没有真实的 Windows CI 构建产物提交到 tarball
+- 主仓依赖还没有切到 `@codingns/node-pty`
+- 还没做 Windows Runner 的完整安装 smoke test
+
+所以别急着改主仓依赖。先把包本身做对。

package/vendor/node-pty-fork/binding.gyp

@@ -0,0 +1,117 @@
+{
+  'target_defaults': {
+    'conditions': [
+      ['OS=="win"', {
+        'msvs_configuration_attributes': {
+          'SpectreMitigation': 'Spectre'
+        },
+        'msvs_settings': {
+            'VCCLCompilerTool': {
+              'AdditionalOptions': [
+                '/guard:cf',
+                '/ZH:SHA_256'
+              ]
+            },
+            'VCLinkerTool': {
+              'AdditionalOptions': [
+                '/guard:cf'
+              ]
+            }
+          },
+      }],
+    ],
+  },
+  'conditions': [
+    ['OS=="win"', {
+      'targets': [
+        {
+          'target_name': 'conpty',
+          'include_dirs' : [
+            '<!(node -e "require(\'nan\')")'
+          ],
+          'sources' : [
+            'src/win/conpty.cc',
+            'src/win/path_util.cc'
+          ],
+          'libraries': [
+            'shlwapi.lib'
+          ],
+        },
+        {
+          'target_name': 'conpty_console_list',
+          'include_dirs' : [
+            '<!(node -e "require(\'nan\')")'
+          ],
+          'sources' : [
+            'src/win/conpty_console_list.cc'
+          ],
+        },
+        {
+          'target_name': 'pty',
+          'include_dirs' : [
+            '<!(node -e "require(\'nan\')")',
+            'deps/winpty/src/include',
+          ],
+          # Disabled due to winpty
+          'msvs_disabled_warnings': [ 4506, 4530 ],
+          'dependencies' : [
+            'deps/winpty/src/winpty.gyp:winpty-agent',
+            'deps/winpty/src/winpty.gyp:winpty',
+          ],
+          'sources' : [
+            'src/win/winpty.cc',
+            'src/win/path_util.cc'
+          ],
+          'libraries': [
+            'shlwapi.lib'
+          ],
+        }
+      ]
+    }, { # OS!="win"
+      'targets': [
+        {
+          'target_name': 'pty',
+          'include_dirs' : [
+            '<!(node -e "require(\'nan\')")'
+          ],
+          'sources': [
+            'src/unix/pty.cc',
+          ],
+          'libraries': [
+            '-lutil'
+          ],
+          'cflags': ['-Wall'],
+          'conditions': [
+            # http://www.gnu.org/software/gnulib/manual/html_node/forkpty.html
+            #   One some systems (at least including Cygwin, Interix,
+            #   OSF/1 4 and 5, and Mac OS X) linking with -lutil is not required.
+            ['OS=="mac" or OS=="solaris"', {
+              'libraries!': [
+                '-lutil'
+              ]
+            }],
+            ['OS=="mac"', {
+              "xcode_settings": {
+                "MACOSX_DEPLOYMENT_TARGET":"10.7"
+              }
+            }]
+          ]
+        }
+      ]
+    }],
+    ['OS=="mac"', {
+      'targets': [
+        {
+          'target_name': 'spawn-helper',
+          'type': 'executable',
+          'sources': [
+            'src/unix/spawn-helper.cc',
+          ],
+          "xcode_settings": {
+            "MACOSX_DEPLOYMENT_TARGET":"10.7"
+          }
+        },
+      ]
+    }]
+  ]
+}

package/vendor/node-pty-fork/deps/.editorconfig

@@ -0,0 +1,2 @@
+# Have editor config ignore this directory
+root = true

package/vendor/node-pty-fork/deps/winpty/.drone.yml

@@ -0,0 +1,17 @@
+# Build configure for https://www.tea-ci.org (fork of Drone CI with Msys2 support)
+build:
+  image: teaci/msys$$arch
+  pull: true
+  shell: msys$$arch
+  commands:
+    - pacman -S --needed --noconfirm --noprogressbar mingw-w64-cross-gcc mingw-w64-cross-crt-git
+    - ./configure
+    - make
+    - make tests
+    - build/trivial_test.exe
+    - mintty --log - --exec build/winpty.exe cmd /c ver | grep Windows
+
+matrix:
+  arch:
+    - 64
+    - 32

package/vendor/node-pty-fork/deps/winpty/.gitattributes

@@ -0,0 +1,19 @@
+*               text=auto
+*.bat           text eol=crlf
+*.c             text
+*.cc            text
+*.gyp           text
+*.gypi          text
+*.h             text
+*.ps1           text eol=crlf
+*.rst           text
+*.sh            text
+*.txt           text
+.gitignore      text
+.gitattributes  text
+Makefile        text
+configure       text
+
+*.sh            eol=lf
+configure       eol=lf
+VERSION.txt     eol=lf

package/vendor/node-pty-fork/deps/winpty/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2011-2016 Ryan Prichard
+
+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/vendor/node-pty-fork/deps/winpty/Makefile

@@ -0,0 +1,166 @@
+# Copyright (c) 2011-2015 Ryan Prichard
+#
+# 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.
+
+# Use make -n to see the actual command-lines make would run.
+
+# The default "make install" prefix is /usr/local.  Pass PREFIX=<path> on the
+# command-line to override the default.
+
+.SECONDEXPANSION :
+
+.PHONY : default
+default : all
+
+PREFIX := /usr/local
+UNIX_ADAPTER_EXE := winpty.exe
+MINGW_ENABLE_CXX11_FLAG := -std=c++11
+USE_PCH := 1
+
+COMMON_CXXFLAGS :=
+UNIX_CXXFLAGS :=
+MINGW_CXXFLAGS :=
+MINGW_LDFLAGS :=
+UNIX_LDFLAGS :=
+
+# Include config.mk but complain if it hasn't been created yet.
+ifeq "$(wildcard config.mk)" ""
+    $(error config.mk does not exist.  Please run ./configure)
+endif
+include config.mk
+
+COMMON_CXXFLAGS += \
+	-MMD -Wall \
+	-DUNICODE \
+	-D_UNICODE \
+	-D_WIN32_WINNT=0x0501 \
+	-Ibuild/gen
+
+UNIX_CXXFLAGS += \
+	$(COMMON_CXXFLAGS)
+
+MINGW_CXXFLAGS += \
+	$(COMMON_CXXFLAGS) \
+	-O2 \
+	$(MINGW_ENABLE_CXX11_FLAG)
+
+MINGW_LDFLAGS += -static -static-libgcc -static-libstdc++
+UNIX_LDFLAGS += $(UNIX_LDFLAGS_STATIC)
+
+ifeq "$(USE_PCH)" "1"
+MINGW_CXXFLAGS += -include build/mingw/PrecompiledHeader.h
+PCH_DEP := build/mingw/PrecompiledHeader.h.gch
+else
+PCH_DEP :=
+endif
+
+build/gen/GenVersion.h : VERSION.txt $(COMMIT_HASH_DEP) | $$(@D)/.mkdir
+	$(info Updating build/gen/GenVersion.h)
+	@echo "const char GenVersion_Version[] = \"$(shell cat VERSION.txt | tr -d '\r\n')\";" > build/gen/GenVersion.h
+	@echo "const char GenVersion_Commit[] = \"$(COMMIT_HASH)\";" >> build/gen/GenVersion.h
+
+build/mingw/PrecompiledHeader.h : src/shared/PrecompiledHeader.h | $$(@D)/.mkdir
+	$(info Copying $< to $@)
+	@cp $< $@
+
+build/mingw/PrecompiledHeader.h.gch : build/mingw/PrecompiledHeader.h | $$(@D)/.mkdir
+	$(info Compiling $<)
+	@$(MINGW_CXX) $(MINGW_CXXFLAGS) -c -o $@ $<
+
+-include build/mingw/PrecompiledHeader.h.d
+
+define def_unix_target
+build/$1/%.o : src/%.cc | $$$$(@D)/.mkdir
+	$$(info Compiling $$<)
+	@$$(UNIX_CXX) $$(UNIX_CXXFLAGS) $2 -I src/include -c -o $$@ $$<
+endef
+
+define def_mingw_target
+build/$1/%.o : src/%.cc $$(PCH_DEP) | $$$$(@D)/.mkdir
+	$$(info Compiling $$<)
+	@$$(MINGW_CXX) $$(MINGW_CXXFLAGS) $2 -I src/include -c -o $$@ $$<
+endef
+
+include src/subdir.mk
+
+.PHONY : all
+all : $(ALL_TARGETS)
+
+.PHONY : tests
+tests : $(TEST_PROGRAMS)
+
+.PHONY : install-bin
+install-bin : all
+	mkdir -p $(PREFIX)/bin
+	install -m 755 -p -s build/$(UNIX_ADAPTER_EXE) $(PREFIX)/bin
+	install -m 755 -p -s build/winpty.dll $(PREFIX)/bin
+	install -m 755 -p -s build/winpty-agent.exe $(PREFIX)/bin
+
+.PHONY : install-debugserver
+install-debugserver : all
+	mkdir -p $(PREFIX)/bin
+	install -m 755 -p -s build/winpty-debugserver.exe $(PREFIX)/bin
+
+.PHONY : install-lib
+install-lib : all
+	mkdir -p $(PREFIX)/lib
+	install -m 644 -p build/winpty.lib $(PREFIX)/lib
+
+.PHONY : install-doc
+install-doc :
+	mkdir -p $(PREFIX)/share/doc/winpty
+	install -m 644 -p LICENSE $(PREFIX)/share/doc/winpty
+	install -m 644 -p README.md $(PREFIX)/share/doc/winpty
+	install -m 644 -p RELEASES.md $(PREFIX)/share/doc/winpty
+
+.PHONY : install-include
+install-include :
+	mkdir -p $(PREFIX)/include/winpty
+	install -m 644 -p src/include/winpty.h $(PREFIX)/include/winpty
+	install -m 644 -p src/include/winpty_constants.h $(PREFIX)/include/winpty
+
+.PHONY : install
+install : \
+	install-bin \
+	install-debugserver \
+	install-lib \
+	install-doc \
+	install-include
+
+.PHONY : clean
+clean :
+	rm -fr build
+
+.PHONY : clean-msvc
+clean-msvc :
+	rm -fr src/Default src/Release src/.vs src/gen
+	rm -f src/*.vcxproj src/*.vcxproj.filters src/*.sln src/*.sdf
+
+.PHONY : distclean
+distclean : clean
+	rm -f config.mk
+
+.PRECIOUS : %.mkdir
+%.mkdir :
+	$(info Creating directory $(dir $@))
+	@mkdir -p $(dir $@)
+	@touch $@
+
+src/%.h :
+	@echo "Missing header file $@ (stale dependency file?)"

package/vendor/node-pty-fork/deps/winpty/README.md

@@ -0,0 +1,151 @@
+# winpty
+
+[![Build Status](https://tea-ci.org/api/badges/rprichard/winpty/status.svg)](https://tea-ci.org/rprichard/winpty)
+
+winpty is a Windows software package providing an interface similar to a Unix
+pty-master for communicating with Windows console programs.  The package
+consists of a library (libwinpty) and a tool for Cygwin and MSYS for running
+Windows console programs in a Cygwin/MSYS pty.
+
+The software works by starting the `winpty-agent.exe` process with a new,
+hidden console window, which bridges between the console API and terminal
+input/output escape codes.  It polls the hidden console's screen buffer for
+changes and generates a corresponding stream of output.
+
+The Unix adapter allows running Windows console programs (e.g. CMD, PowerShell,
+IronPython, etc.) under `mintty` or Cygwin's `sshd` with
+properly-functioning input (e.g. arrow and function keys) and output (e.g. line
+buffering).  The library could be also useful for writing a non-Cygwin SSH
+server.
+
+## Supported Windows versions
+
+winpty runs on Windows XP through Windows 10, including server versions.  It
+can be compiled into either 32-bit or 64-bit binaries.
+
+## Cygwin/MSYS adapter (`winpty.exe`)
+
+### Prerequisites
+
+You need the following to build winpty:
+
+* A Cygwin or MSYS installation
+* GNU make
+* A MinGW g++ toolchain capable of compiling C++11 code to build `winpty.dll`
+  and `winpty-agent.exe`
+* A g++ toolchain targeting Cygwin or MSYS to build `winpty.exe`
+
+Winpty requires two g++ toolchains as it is split into two parts. The
+`winpty.dll` and `winpty-agent.exe` binaries interface with the native
+Windows command prompt window so they are compiled with the native MinGW
+toolchain.  The `winpty.exe` binary interfaces with the MSYS/Cygwin terminal so
+it is compiled with the MSYS/Cygwin toolchain.
+
+MinGW appears to be split into two distributions -- MinGW (creates 32-bit
+binaries) and MinGW-w64 (creates both 32-bit and 64-bit binaries).  Either
+one is generally acceptable.
+
+#### Cygwin packages
+
+The default g++ compiler for Cygwin targets Cygwin itself, but Cygwin also
+packages MinGW-w64 compilers.  As of this writing, the necessary packages are:
+
+* Either `mingw64-i686-gcc-g++` or `mingw64-x86_64-gcc-g++`.  Select the
+  appropriate compiler for your CPU architecture.
+* `gcc-g++`
+* `make`
+
+As of this writing (2016-01-23), only the MinGW-w64 compiler is acceptable.
+The MinGW compiler (e.g. from the `mingw-gcc-g++` package) is no longer
+maintained and is too buggy.
+
+#### MSYS packages
+
+For the original MSYS, use the `mingw-get` tool (MinGW Installation Manager),
+and select at least these components:
+
+* `mingw-developer-toolkit`
+* `mingw32-base`
+* `mingw32-gcc-g++`
+* `msys-base`
+* `msys-system-builder`
+
+When running `./configure`, make sure that `mingw32-g++` is in your
+`PATH`.  It will be in the `C:\MinGW\bin` directory.
+
+#### MSYS2 packages
+
+For MSYS2, use `pacman` and install at least these packages:
+
+* `msys/gcc`
+* `mingw32/mingw-w64-i686-gcc` or `mingw64/mingw-w64-x86_64-gcc`.  Select
+  the appropriate compiler for your CPU architecture.
+* `make`
+
+MSYS2 provides three start menu shortcuts for starting MSYS2:
+
+* MinGW-w64 Win32 Shell
+* MinGW-w64 Win64 Shell
+* MSYS2 Shell
+
+To build winpty, use the MinGW-w64 {Win32,Win64} shortcut of the architecture
+matching MSYS2.  These shortcuts will put the g++ compiler from the
+`{mingw32,mingw64}/mingw-w64-{i686,x86_64}-gcc` packages into the `PATH`.
+
+Alternatively, instead of installing `mingw32/mingw-w64-i686-gcc` or
+`mingw64/mingw-w64-x86_64-gcc`, install the `mingw-w64-cross-gcc` and
+`mingw-w64-cross-crt-git` packages.  These packages install cross-compilers
+into `/opt/bin`, and then any of the three shortcuts will work.
+
+### Building the Unix adapter
+
+In the project directory, run `./configure`, then `make`, then `make install`.
+By default, winpty is installed into `/usr/local`.  Pass `PREFIX=<path>` to
+`make install` to override this default.
+
+### Using the Unix adapter
+
+To run a Windows console program in `mintty` or Cygwin `sshd`, prepend
+`winpty` to the command-line:
+
+    $ winpty powershell
+    Windows PowerShell
+    Copyright (C) 2009 Microsoft Corporation. All rights reserved.
+
+    PS C:\rprichard\proj\winpty> 10 + 20
+    30
+    PS C:\rprichard\proj\winpty> exit
+
+## Embedding winpty / MSVC compilation
+
+See `src/include/winpty.h` for the prototypes of functions exported by
+`winpty.dll`.
+
+Only the `winpty.exe` binary uses Cygwin; all the other binaries work without
+it and can be compiled with either MinGW or MSVC.  To compile using MSVC,
+download gyp and run `gyp -I configurations.gypi` in the `src` subdirectory.
+This will generate a `winpty.sln` and associated project files.  See the
+`src/winpty.gyp` and `src/configurations.gypi` files for notes on dealing with
+MSVC versions and different architectures.
+
+Compiling winpty with MSVC currently requires MSVC 2013 or newer.
+
+## Debugging winpty
+
+winpty comes with a tool for collecting timestamped debugging output.  To use
+it:
+
+1. Run `winpty-debugserver.exe` on the same computer as winpty.
+2. Set the `WINPTY_DEBUG` environment variable to `trace` for the
+   `winpty.exe` process and/or the process using `libwinpty.dll`.
+
+winpty also recognizes a `WINPTY_SHOW_CONSOLE` environment variable.  Set it
+to 1 to prevent winpty from hiding the console window.
+
+## Copyright
+
+This project is distributed under the MIT license (see the `LICENSE` file in
+the project root).
+
+By submitting a pull request for this project, you agree to license your
+contribution under the MIT license to this project.