haori 0.13.0 → 0.13.2

package/dist/src/expression.d.ts

@@ -1,260 +0,0 @@
-/**
- * @fileoverview 式評価エンジン
- *
- * 式評価システムです。
- * XSS攻撃やコードインジェクションを防ぐためのセキュリティ機能と、
- * パフォーマンス向上のためのキャッシュ機能を提供します。
- */
-/**
- * 式評価結果の詳細です。
- */
-export interface ExpressionEvaluationDetail {
-    /** 評価結果 */
-    value: unknown;
-    /** 未解決参照が含まれていたかどうか */
-    unresolvedReference: boolean;
-}
-export default class Expression {
-    /** 未宣言識別子の自動補完を試みる最大回数 */
-    private static readonly MAX_IDENTIFIER_RECOVERY_COUNT;
-    /** 組み込みヘルパーを公開する予約名前空間 */
-    private static readonly BUILTIN_NAMESPACE;
-    /**
-     * 式スコープへ注入する組み込みヘルパー。公開 API の凍結オブジェクトをそのまま
-     * 注入すると、評価時の Proxy ラップが「read-only プロパティに別値を返せない」と
-     * いう Proxy 不変条件に違反するため、非凍結の浅いコピーを用いる。
-     */
-    private static readonly BUILTIN_HELPERS;
-    /**
-     * 式が予約名前空間 `haori` を独立した識別子として参照しているか判定する正規表現。
-     * `foo.haori` のようなプロパティアクセスは対象外とする。
-     */
-    private static readonly BUILTIN_REFERENCE_PATTERN;
-    /** 危険値チェック結果の短命キャッシュ */
-    private static forbiddenBindingValueCache;
-    /** 危険値チェックキャッシュのクリア予約済みフラグ */
-    private static forbiddenBindingValueCacheResetScheduled;
-    /** Haoriで禁止すべき識別子一覧（eval と arguments は strict モードで無効化） */
-    private static readonly FORBIDDEN_NAMES;
-    /** strict モードで禁止される識別子 */
-    private static readonly STRICT_FORBIDDEN_NAMES;
-    /** 明示バインド時のみ利用を許可する衝突名 */
-    private static readonly REBINDABLE_FORBIDDEN_NAMES;
-    /** バインド識別子としては拒否する名前 */
-    private static readonly FORBIDDEN_BINDING_NAMES;
-    /**
-     * 明示バインド内に持ち込まれてはならない危険値を返します。
-     *
-     * @returns 危険値の配列
-     */
-    private static getForbiddenBindingValues;
-    /**
-     * 現在の評価サイクルで利用する危険値集合を返します。
-     *
-     * @returns 危険値の集合
-     */
-    private static getForbiddenBindingValueSet;
-    /**
-     * 危険値チェック用の短命キャッシュを次の microtask で破棄します。
-     */
-    private static scheduleForbiddenBindingValueCacheReset;
-    /** プロパティアクセスで拒否する名前 */
-    private static readonly FORBIDDEN_PROPERTY_NAMES;
-    /** object literal のプロパティ定義で前置修飾子として扱う識別子 */
-    private static readonly OBJECT_PROPERTY_MODIFIERS;
-    /** 式構文として許可しない予約語 */
-    private static readonly DISALLOWED_KEYWORDS;
-    /** 式 → 評価関数のグローバルキャッシュ */
-    private static readonly EXPRESSION_CACHE;
-    /**
-     * 現在のバインド識別子に含まれない禁止グローバルを遮断するコードを生成します。
-     *
-     * @param bindKeys 現在の式で利用するバインド識別子一覧
-     * @returns 評価前に挿入する初期化コード
-     */
-    private static buildAssignments;
-    /**
-     * 式の中で「使用できない（ブロックされた）グローバル識別子」を参照しているものを
-     * 検出します。`Object` などは評価時に `undefined` へ遮断されるため、`Object.assign`
-     * のように使うと原因の分かりにくい `TypeError` になります。エラー時のヒント表示に
-     * 用います。プロパティアクセス（`foo.Object`）は対象外です。
-     *
-     * @param expression 評価対象の式
-     * @returns 式が参照しているブロック済み識別子の一覧
-     */
-    private static detectForbiddenIdentifiers;
-    /**
-     * 式を評価します。
-     *
-     * @param expression 評価する式文字列
-     * @param bindedValue バインドされた値のオブジェクト
-     */
-    static evaluate(expression: string, bindedValues?: Record<string, unknown>): unknown;
-    /**
-     * 式を評価し、未解決参照の有無を含む詳細結果を返します。
-     *
-     * @param expression 評価する式文字列
-     * @param bindedValues バインドされた値のオブジェクト
-     * @returns 評価結果と未解決参照の有無
-     */
-    static evaluateDetailed(expression: string, bindedValues?: Record<string, unknown>): ExpressionEvaluationDetail;
-    /**
-     * 現在のバインド集合で evaluator を取得または生成します。
-     *
-     * @param expression 評価する式
-     * @param bindedValues バインドされた値のオブジェクト
-     * @returns evaluator 準備結果
-     */
-    private static prepareEvaluator;
-    /**
-     * ReferenceError から未宣言識別子名を抽出します。
-     *
-     * @param error 発生した ReferenceError
-     * @returns 識別子名。抽出できない場合は null
-     */
-    private static extractMissingIdentifier;
-    /**
-     * 未宣言識別子を undefined バインドとして補完可能かを返します。
-     *
-     * @param identifier 識別子名
-     * @param bindedValues 現在のバインド値
-     * @returns 補完可能なら true
-     */
-    private static canRecoverMissingIdentifier;
-    /**
-     * 未宣言識別子の補完を試みてよい式かを返します。
-     *
-     * @param expression 評価する式
-     * @returns 補完を試みてよい場合は true
-     */
-    private static canAttemptMissingIdentifierRecovery;
-    /**
-     * 式にevalや危険な構文が含まれているかチェックします。
-     *
-     * @param expression チェック対象の式文字列
-     * @return 危険なパターンが含まれている場合はtrue
-     */
-    protected static containsDangerousPatterns(expression: string): boolean;
-    /**
-     * 式の中で使用されている「使用できないキーワード」を検出します。
-     * 文字列リテラルやプロパティ名は対象外とするため、トークナイザを用いて
-     * 識別子トークンのみを判定します。エラー時のヒント表示に使用します。
-     *
-     * @param expression 検査対象の式
-     * @returns 式に現れた使用できないキーワードの一覧（重複なし、出現順）
-     */
-    private static detectDisallowedKeywords;
-    /**
-     * 許可する式構文かどうかを検証します。
-     *
-     * @param expression 検証対象の式
-     * @returns 許可する構文であればtrue
-     */
-    private static hasAllowedSyntax;
-    /**
-     * 式をトークン列に分解します。
-     *
-     * @param expression 評価前に検証する式
-     * @returns 分解結果。未対応構文を含む場合はnull
-     */
-    private static tokenizeExpression;
-    /**
-     * 文字列リテラルを読み取ります。
-     *
-     * @param expression 式全体
-     * @param start 開始位置
-     * @returns トークンと次の位置
-     */
-    private static readStringToken;
-    /**
-     * 数値リテラルを読み取ります。
-     *
-     * @param expression 式全体
-     * @param start 開始位置
-     * @returns トークンと次の位置
-     */
-    private static readNumberToken;
-    /**
-     * 識別子を読み取ります。
-     *
-     * @param expression 式全体
-     * @param start 開始位置
-     * @returns トークンと次の位置
-     */
-    private static readIdentifierToken;
-    /**
-     * 角括弧がメンバーアクセスかどうかを判定します。
-     *
-     * @param previous 直前のトークン
-     * @returns メンバーアクセスであればtrue
-     */
-    private static startsMemberAccess;
-    /**
-     * object literal 内で次のトークンがキー位置かどうかを判定します。
-     *
-     * @param activeGroup 現在のグループ種別
-     * @param previous 直前のトークン
-     * @returns object literal のキー位置であれば true
-     */
-    private static startsObjectKey;
-    /**
-     * 文字列リテラルをプレーン文字列へ変換します。
-     *
-     * @param literal 文字列リテラル
-     * @returns デコード後の文字列
-     */
-    private static decodeStringLiteral;
-    /**
-     * バインド値を安全なProxyでラップします。
-     *
-     * @param bindedValues バインド値
-     * @returns ラップ済みのバインド値
-     */
-    private static wrapBoundValues;
-    /**
-     * 危険なプロパティアクセスを防ぐために値を再帰的にラップします。
-     *
-     * @param value ラップ対象の値
-     * @param cache 既存Proxyのキャッシュ
-     * @returns ラップ済みの値
-     */
-    private static wrapBoundValue;
-    /**
-     * Proxy ラップ対象の値かどうかを判定します。
-     *
-     * @param value 判定対象
-     * @returns ラップ対象であればtrue
-     */
-    private static shouldWrapValue;
-    /**
-     * 評価中のみ prototype 系プロパティへの生アクセスを抑止します。
-     *
-     * @param callback 実行する処理
-     * @returns 処理結果
-     */
-    private static withBlockedPropertyAccess;
-    /**
-     * イテレータ互換オブジェクトかどうかを判定します。
-     *
-     * @param value 判定対象
-     * @returns イテレータ互換であればtrue
-     */
-    private static isIteratorLike;
-    /**
-     * トップレベルのバインド識別子に拒否対象名が含まれていないかを判定します。
-     * ネストしたオブジェクトのプロパティ名は識別子として評価されないため、ここでは拒否しません。
-     *
-     * @param obj チェック対象のオブジェクト
-     * @return 禁止識別子が含まれていればtrue
-     */
-    protected static containsForbiddenKeys(obj: unknown): boolean;
-    /**
-     * バインド値に危険なホストオブジェクトやグローバル関数が含まれていないかを再帰的に判定します。
-     *
-     * @param obj チェック対象の値
-     * @param seen 循環参照検出用の訪問済み集合
-     * @return 危険値が含まれていればtrue
-     */
-    protected static containsForbiddenBindingValues(obj: unknown, seen?: WeakSet<object>, forbiddenBindingValues?: ReadonlySet<unknown>): boolean;
-}
-//# sourceMappingURL=expression.d.ts.map

package/dist/src/expression.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../src/expression.ts"],"names":[],"mappings":"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"}