@sema-agent/settings-schema 14.6.0 → 14.7.0

package/dist/definition-copy.d.ts

@@ -1,23 +0,0 @@
-/**
- * 包内私有(不进主桶、不进 exports 表):**定义语义的复制**。读不可信的串数组、写读出来的副本,都不许走 `[[Set]]` 与继承的成员 ——
- * `Object.prototype` / `Array.prototype` 上被污染的数字键(getter / setter)、`get` / `set` 键、数组实例上被替换的 `Symbol.iterator`,
- * 在下标赋值、`push`、展开、描述符对象字面量上各有一条路能把条目吞掉、替换或抛出去。本模块是这件事的唯一读法,读者只调它:
- *  · {@link captureStringArray}:一份串数组的捕获副本(按下标、`hasOwn`、一次读、非串即坏、`defineProperty` 写入);
- *  · {@link dataDescriptor}:写副本用的描述符,零原型(`{ value, writable, enumerable, configurable }` 字面量继承 `Object.prototype`,
- *    `Object.prototype.get` / `set` 被污染时它会被读成访问器描述符)。
- * 零 import。
- */
-/** 数据属性描述符(可写 / 可枚举 / 可配置),**零原型**:不继承 `Object.prototype` 上被污染的 `get` / `set` 等键,也不靠对象字面量。 */
-export declare function dataDescriptor(value: unknown): PropertyDescriptor;
-/**
- * 一份**串数组的捕获副本**;不是串数组 ⇒ `undefined`(调用方据此读成坏形 —— 名单读成 `[]` 并点名,`args` 丢键并进 `lost`)。
- * **取值 + 检视 + 复制整段在一个 try 里**,`length` 与每个元素都只读一次(检视与后续使用不会读到两个答案):
- *  · 不是数组,或 `length` 不是安全非负整数(读成字符串的 Proxy 等)⇒ 坏形,不按 `length` 物化;
- *  · 逐下标先问 `Object.hasOwn` 再读 —— 洞(不是自有下标)⇒ 坏形,不顺原型链读到 `Object.prototype` / `Array.prototype` 上的数字键(数据属性或访问器);
- *  · 条目不是串 ⇒ 坏形;遇到第一个坏处就退出(`length` 很大的稀疏数组立即判坏形);
- *  · 副本用 `Object.defineProperty` + {@link dataDescriptor} 写(`push` / 下标赋值是 `[[Set]]`,会命中继承的数字键 setter、吞掉条目);
- *  · 不走迭代协议(展开 / `for…of` 会让数组实例上被替换的 `Symbol.iterator` 供出别的条目);
- *  · 读 `length` / 元素时抛(getter、Proxy 陷阱)⇒ 坏形,不抛出去。
- * 交出去的是**副本**(不是调用方数组的原引用):调用方之后改原数组,副本不变。
- */
-export declare function captureStringArray(v: unknown): string[] | undefined;

package/dist/definition-copy.js

@@ -1,52 +0,0 @@
-/**
- * 包内私有(不进主桶、不进 exports 表):**定义语义的复制**。读不可信的串数组、写读出来的副本,都不许走 `[[Set]]` 与继承的成员 ——
- * `Object.prototype` / `Array.prototype` 上被污染的数字键(getter / setter)、`get` / `set` 键、数组实例上被替换的 `Symbol.iterator`,
- * 在下标赋值、`push`、展开、描述符对象字面量上各有一条路能把条目吞掉、替换或抛出去。本模块是这件事的唯一读法,读者只调它:
- *  · {@link captureStringArray}:一份串数组的捕获副本(按下标、`hasOwn`、一次读、非串即坏、`defineProperty` 写入);
- *  · {@link dataDescriptor}:写副本用的描述符,零原型(`{ value, writable, enumerable, configurable }` 字面量继承 `Object.prototype`,
- *    `Object.prototype.get` / `set` 被污染时它会被读成访问器描述符)。
- * 零 import。
- */
-/** 数据属性描述符(可写 / 可枚举 / 可配置),**零原型**:不继承 `Object.prototype` 上被污染的 `get` / `set` 等键,也不靠对象字面量。 */
-export function dataDescriptor(value) {
-    const descriptor = Object.create(null);
-    descriptor.value = value;
-    descriptor.writable = true;
-    descriptor.enumerable = true;
-    descriptor.configurable = true;
-    return descriptor;
-}
-/**
- * 一份**串数组的捕获副本**;不是串数组 ⇒ `undefined`(调用方据此读成坏形 —— 名单读成 `[]` 并点名,`args` 丢键并进 `lost`)。
- * **取值 + 检视 + 复制整段在一个 try 里**,`length` 与每个元素都只读一次(检视与后续使用不会读到两个答案):
- *  · 不是数组,或 `length` 不是安全非负整数(读成字符串的 Proxy 等)⇒ 坏形,不按 `length` 物化;
- *  · 逐下标先问 `Object.hasOwn` 再读 —— 洞(不是自有下标)⇒ 坏形,不顺原型链读到 `Object.prototype` / `Array.prototype` 上的数字键(数据属性或访问器);
- *  · 条目不是串 ⇒ 坏形;遇到第一个坏处就退出(`length` 很大的稀疏数组立即判坏形);
- *  · 副本用 `Object.defineProperty` + {@link dataDescriptor} 写(`push` / 下标赋值是 `[[Set]]`,会命中继承的数字键 setter、吞掉条目);
- *  · 不走迭代协议(展开 / `for…of` 会让数组实例上被替换的 `Symbol.iterator` 供出别的条目);
- *  · 读 `length` / 元素时抛(getter、Proxy 陷阱)⇒ 坏形,不抛出去。
- * 交出去的是**副本**(不是调用方数组的原引用):调用方之后改原数组,副本不变。
- */
-export function captureStringArray(v) {
-    try {
-        if (!Array.isArray(v))
-            return undefined;
-        const source = v;
-        const n = source.length;
-        if (typeof n !== "number" || !Number.isSafeInteger(n) || n < 0)
-            return undefined;
-        const copy = [];
-        for (let i = 0; i < n; i++) {
-            if (!Object.hasOwn(source, i))
-                return undefined;
-            const entry = source[i];
-            if (typeof entry !== "string")
-                return undefined;
-            Object.defineProperty(copy, i, dataDescriptor(entry));
-        }
-        return copy;
-    }
-    catch {
-        return undefined;
-    }
-}