dsh-composer-ease 0.0.0-stage → 0.9.66

package/THIRD-PARTY.md

@@ -0,0 +1,259 @@
+# 第三方数据来源与许可证
+
+`lib/words.js` 里的补全词表（HTML 标签、JS/Python/Java 关键字、CSS 属性名）是从下列开源项目里
+**抽取的数据**，没有复制它们的源代码；交互形态参照 VSCode（同样未复制源码）。
+各项目的许可证要求保留版权与许可声明，原文照录如下。
+
+| 用途 | 项目 | 许可证 | 取的 commit | 具体文件 |
+|---|---|---|---|---|
+| JS / Python / Java 关键字 | [microsoft/monaco-editor](https://github.com/microsoft/monaco-editor) | MIT | `f54d769` | `src/languages/definitions/<lang>/<lang>.ts` 的 `keywords` |
+| HTML 标签、全局属性 | [codemirror/lang-html](https://github.com/codemirror/lang-html) | MIT | `06eec80` | `src/complete.ts` 的 `Tags` / `GlobalAttrs` |
+| CSS 伪类、at 规则 | [codemirror/lang-css](https://github.com/codemirror/lang-css) | MIT | `7b7835b` | `src/complete.ts` 的 `pseudoClasses` / `atRules` |
+| CSS 属性名 | [mdn/browser-compat-data](https://github.com/mdn/browser-compat-data) | CC0-1.0 | `0416078` | `css/properties/*.json` 的文件名（去掉 `-moz-`/`-webkit-` 前缀项） |
+| 中文常用词表 | [fxsjy/jieba](https://github.com/fxsjy/jieba) | MIT | `extra_dict/dict.txt.big` | 抽「纯汉字、2~4 字、按频次靠前」的常用词（`lib/cjk-lexicon.js`），用于区分完整词与碎片 |
+| 英文词表（T2，30k 子集） | [words/an-array-of-english-words](https://github.com/words/an-array-of-english-words) | MIT | v2.0.0 `index.json`（274,937 词） | 只留 3-12 字符纯字母，再用**本机语料频次**排序取前 30000，落在 `lib/en-lexicon.js`；生成脚本 `tools/gen-lexicon.mjs`，可复跑 |
+| 模糊打分引擎与字符判据 | [microsoft/vscode](https://github.com/microsoft/vscode) | MIT | `0b4e063` | `src/vs/base/common/filters.ts`（`fuzzyScore`/`_doScore`/`fuzzyScoreGraceful*` 等）＋同目录 `charCode.ts`（只取用到的条目）与 `strings.ts`（只取 `isEmojiImprecise`） |
+
+抽取是静态的（正则取数组与对象键），没有执行任何第三方代码；复跑脚本与中间产物不随包分发。
+若某个项目的许可条款与本文件描述不一致，以各项目仓库里的 LICENSE 原文件为准。
+
+---
+
+## 1. microsoft/monaco-editor（MIT）
+
+```
+The MIT License (MIT)
+
+Copyright (c) 2016 - present Microsoft Corporation
+
+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.
+```
+
+## 2. codemirror/lang-html 与 codemirror/lang-css（MIT）
+
+两个包用同一份许可证原文（取用时逐字节比对相同）：
+
+```
+MIT License
+
+Copyright (C) 2018-2021 by Marijn Haverbeke <marijn@haverbeke.berlin> and others
+
+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.
+```
+
+## 3. mdn/browser-compat-data（CC0-1.0）
+
+```
+CC0 1.0 Universal
+
+Statement of Purpose
+
+The laws of most jurisdictions throughout the world automatically confer
+exclusive Copyright and Related Rights (defined below) upon the creator and
+subsequent owner(s) (each and all, an "owner") of an original work of
+authorship and/or a database (each, a "Work").
+
+Certain owners wish to permanently relinquish those rights to a Work for the
+purpose of contributing to a commons of creative, cultural and scientific
+works ("Commons") that the public can reliably and without fear of later
+claims of infringement build upon, modify, incorporate in other works, reuse
+and redistribute as freely as possible in any form whatsoever and for any
+purposes, including without limitation commercial purposes. These owners may
+contribute to the Commons to promote the ideal of a free culture and the
+further production of creative, cultural and scientific works, or to gain
+reputation or greater distribution for their Work in part through the use and
+efforts of others.
+
+For these and/or other purposes and motivations, and without any expectation
+of additional consideration or compensation, the person associating CC0 with a
+Work (the "Affirmer"), to the extent that he or she is an owner of Copyright
+and Related Rights in the Work, voluntarily elects to apply CC0 to the Work
+and publicly distribute the Work under its terms, with knowledge of his or her
+Copyright and Related Rights in the Work and the meaning and intended legal
+effect of CC0 on those rights.
+
+1. Copyright and Related Rights. A Work made available under CC0 may be
+protected by copyright and related or neighboring rights ("Copyright and
+Related Rights"). Copyright and Related Rights include, but are not limited
+to, the following:
+
+  i. the right to reproduce, adapt, distribute, perform, display, communicate,
+  and translate a Work;
+
+  ii. moral rights retained by the original author(s) and/or performer(s);
+
+  iii. publicity and privacy rights pertaining to a person's image or likeness
+  depicted in a Work;
+
+  iv. rights protecting against unfair competition in regards to a Work,
+  subject to the limitations in paragraph 4(a), below;
+
+  v. rights protecting the extraction, dissemination, use and reuse of data in
+  a Work;
+
+  vi. database rights (such as those arising under Directive 96/9/EC of the
+  European Parliament and of the Council of 11 March 1996 on the legal
+  protection of databases, and under any national implementation thereof,
+  including any amended or successor version of such directive); and
+
+  vii. other similar, equivalent or corresponding rights throughout the world
+  based on applicable law or treaty, and any national implementations thereof.
+
+2. Waiver. To the greatest extent permitted by, but not in contravention of,
+applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and
+unconditionally waives, abandons, and surrenders all of Affirmer's Copyright
+and Related Rights and associated claims and causes of action, whether now
+known or unknown (including existing as well as future claims and causes of
+action), in the Work (i) in all territories worldwide, (ii) for the maximum
+duration provided by applicable law or treaty (including future time
+extensions), (iii) in any current or future medium and for any number of
+copies, and (iv) for any purpose whatsoever, including without limitation
+commercial, advertising or promotional purposes (the "Waiver"). Affirmer makes
+the Waiver for the benefit of each member of the public at large and to the
+detriment of Affirmer's heirs and successors, fully intending that such Waiver
+shall not be subject to revocation, rescission, cancellation, termination, or
+any other legal or equitable action to disrupt the quiet enjoyment of the Work
+by the public as contemplated by Affirmer's express Statement of Purpose.
+
+3. Public License Fallback. Should any part of the Waiver for any reason be
+judged legally invalid or ineffective under applicable law, then the Waiver
+shall be preserved to the maximum extent permitted taking into account
+Affirmer's express Statement of Purpose. In addition, to the extent the Waiver
+is so judged Affirmer hereby grants to each affected person a royalty-free,
+non transferable, non sublicensable, non exclusive, irrevocable and
+unconditional license to exercise Affirmer's Copyright and Related Rights in
+the Work (i) in all territories worldwide, (ii) for the maximum duration
+provided by applicable law or treaty (including future time extensions), (iii)
+in any current or future medium and for any number of copies, and (iv) for any
+purpose whatsoever, including without limitation commercial, advertising or
+promotional purposes (the "License"). The License shall be deemed effective as
+of the date CC0 was applied by Affirmer to the Work. Should any part of the
+License for any reason be judged legally invalid or ineffective under
+applicable law, such partial invalidity or ineffectiveness shall not
+invalidate the remainder of the License, and in such case Affirmer hereby
+affirms that he or she will not (i) exercise any of his or her remaining
+Copyright and Related Rights in the Work or (ii) assert any associated claims
+and causes of action with respect to the Work, in either case contrary to
+Affirmer's express Statement of Purpose.
+
+4. Limitations and Disclaimers.
+
+  a. No trademark or patent rights held by Affirmer are waived, abandoned,
+  surrendered, licensed or otherwise affected by this document.
+
+  b. Affirmer offers the Work as-is and makes no representations or warranties
+  of any kind concerning the Work, express, implied, statutory or otherwise,
+  including without limitation warranties of title, merchantability, fitness
+  for a particular purpose, non infringement, or the absence of latent or
+  other defects, accuracy, or the present or absence of errors, whether or not
+  discoverable, all to the greatest extent permissible under applicable law.
+
+  c. Affirmer disclaims responsibility for clearing rights of other persons
+  that may apply to the Work or any use thereof, including without limitation
+  any person's Copyright and Related Rights in the Work. Further, Affirmer
+  disclaims responsibility for obtaining any necessary consents, permissions
+  or other rights required for any use of the Work.
+
+  d. Affirmer understands and acknowledges that Creative Commons is not a
+  party to this document and has no duty or obligation with respect to this
+  CC0 or use of the Work.
+
+For more information, please see
+<http://creativecommons.org/publicdomain/zero/1.0/>
+```
+
+## 4. microsoft/vscode（MIT）
+
+`lib/fuzzy.js` 是**逐字取自**该项目的模糊打分实现（文件顶部**原样保留**上游逐字的版权与许可头
+`Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT License.`；只去掉了 TypeScript 类型注解、并把调试打印函数换成空实现；
+`enum Arrow` 与 `const enum CharCode` 换成等价值对象），用于补全候选的排序口径与命中位置标注：
+
+```
+MIT License
+
+Copyright (c) 2015 - present Microsoft Corporation
+
+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.
+```
+
+## 5. fxsjy/jieba（MIT）
+
+`lib/cjk-lexicon.js` 取自该项目的 `extra_dict/dict.txt.big`，只保留常用纯汉字词（2~4 字），用于中文前缀补全的「完整词义」判定：
+
+```
+The MIT License (MIT)
+
+Copyright (c) 2013 Sun Junyi
+
+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.
+```
+
+## 6. words/an-array-of-english-words（MIT）
+
+- 用途：英文补全的词表来源（`lib/en-lexicon.js` 的 T2 部分）。
+- 取用：v2.0.0 的 `index.json`（274,937 词）→ 过滤 3-12 字符纯字母 → 按**本机语料频次**排序（T3）→ 取前 30000。
+- 该词表**不含词频**，所以顺序那一半来自本机语料统计（`lib/domain-words.js` 同源生成）；换机器重跑会得到不同顺序，这是设计如此。
+- 重新生成：`node tools/gen-lexicon.mjs --words <index.json> --corpus lib --corpus docs --corpus ~/.dsh/本地配置 --cap 30000 --domain-cap 1000`

package/cordis.patch.yml

@@ -0,0 +1,11 @@
+# dsh-composer-ease —— DSH bundle patch
+# 插入 web profile 配置树：服务端注册 /dsh-composer-ease/* 路由，浏览器侧半（exports["./client"]）
+# 进 boot 图提供键位与补全弹层。
+# 安装：dsh plugin --profile web add "<本插件目录或 git URL>"
+#   例：dsh plugin --profile web add "https://github.com/mengge237/dsh-composer-ease"
+# 卸载：dsh plugin --profile web remove dsh-composer-ease
+# 客户端半边要重启 dsh web 才进 boot 图（服务端半边新加条目可热挂）。
+
+- insert:
+    - id: dsh-composer-ease
+      name: dsh-composer-ease

package/lib/cjk-domain.js

@@ -0,0 +1,24 @@
+// dsh-composer-ease —— 领域词表（本仓自建，不是 jieba 的数据）。
+// 为什么需要它：本仓文档里出现频次最高的一批中文词（引号 108 次、宿主 57、弹层 44、闭符 41…）
+// 恰恰不在通用词典里 —— 通用词典覆盖「日常生活」，不覆盖「插件开发」这套行话。
+// 只收会被前缀匹配用到的词：大多是 3~6 字，保证 2 字前缀能接出更长的词。
+export const CJK_DOMAIN = [
+  '补全弹层', '补全候选', '自动补全', '补全触发',
+  '波浪线', '引号配对', '引号未闭合', '中文引号', '英文引号',
+  '触发源', '触发字符', '触发键',
+  '会话压缩', '会话历史', '会话列表', '压缩上下文',
+  '插件目录', '插件市场', '插件开发', '插件管理',
+  '渲染层', '重渲染', '渲染顺序',
+  '候选词', '候选列表', '候选类型', '候选排序',
+  '弹层位置', '弹层宽度', '弹层高度',
+  '宿主版本', '宿主目录', '宿主重启',
+  '闭符跳过', '开符家族', '成对符号',
+  '全角字符', '全角符号', '半角字符', '半角符号',
+  '标红提示', '行内灰字', '代码围栏', '代码片段', '片段占位符',
+  '前缀匹配', '命令菜单', '斜杠菜单', '快捷键冲突',
+  '设置项', '配置文件', '工作区文件', '令牌校验', '额度查询',
+  '上下文窗口', '摘要算法', '中文分词', '语言词表', '词表命中',
+  '围栏标记', '菜单项', '输入法候选', '波浪线样式', '光标位置', '选区替换', '弹窗提示',
+]
+
+export const CJK_DOMAIN_SOURCE = { origin: 'dsh-composer-ease（本仓自建）', why: '通用词典缺插件开发这套行话' }