arkanalyzer 1.0.42 → 1.0.43

package/lib/pass/{SceneValidator.d.ts → validators/Validator.d.ts}

@@ -1,16 +1,39 @@
-import { Scene } from '../Scene';
-import { Dispatch, Dispatcher, StmtInit, StmtTy, ValueInit, ValueTy } from './Dispatcher';
-import { ClassCtx, ClassPass, FallAction, FileCtx, FilePass, MethodCtx, MethodPass } from './Pass';
-import { ArkFile } from '../core/model/ArkFile';
-import { ArkClass } from '../core/model/ArkClass';
-import { ArkMethod } from '../core/model/ArkMethod';
-import { Value } from '../core/base/Value';
-import { Stmt } from '../core/base/Stmt';
+import { ClassCtx, ClassPass, FallAction, FileCtx, FilePass, MethodCtx, MethodPass } from '../Pass';
+import type { ArkFile } from '../../core/model/ArkFile';
+import type { ArkClass } from '../../core/model/ArkClass';
+import type { ArkMethod } from '../../core/model/ArkMethod';
+import type { Value } from '../../core/base/Value';
+import type { Stmt } from '../../core/base/Stmt';
+import type { StmtInit, StmtTy, ValueInit, ValueTy } from '../Dispatcher';
+import { Dispatch, Dispatcher } from '../Dispatcher';
 export declare const enum SummaryLevel {
     info = 0,
     warn = 1,
     error = 2
 }
+/**
+ * Represents a summary message with an associated level and content.
+ * The SummaryMsg class is used to encapsulate messages that have a specific severity or importance level.
+ * It provides a way to associate a textual message with a defined level, making it suitable for logging, notifications, or summaries.
+ * The constructor initializes the message and its level, ensuring both are explicitly defined at creation.
+ */
+export declare class SummaryMsg {
+    level: SummaryLevel;
+    msg: string;
+    constructor(level: SummaryLevel, msg: string);
+}
+/**
+ * Interface representing a summary reporter for logging messages with different severity levels.
+ * Provides methods to log informational, warning, and error messages.
+ * The `info` method is used to log general informational messages.
+ * The `warn` method is used to log warning messages that indicate potential issues.
+ * The `error` method is used to log error messages that represent critical problems.
+ */
+export interface SummaryReporter {
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+}
 /**
  * Abstract class representing a statement validator.
  * Provides a mechanism to validate statements of a specific type within a given context.
@@ -60,45 +83,27 @@ export declare class ArkValidatorRegistry extends Dispatcher {
     static value(init: ValueInit): void;
 }
 /**
- * Interface representing a summary reporter for logging messages with different severity levels.
- * Provides methods to log informational, warning, and error messages.
- * The `info` method is used to log general informational messages.
- * The `warn` method is used to log warning messages that indicate potential issues.
- * The `error` method is used to log error messages that represent critical problems.
- */
-export interface SummaryReporter {
-    info(msg: string): void;
-    warn(msg: string): void;
-    error(msg: string): void;
-}
-/**
- * An abstract class that extends FilePass and provides a framework for validating files.
- * The FileValidator class is designed to be subclassed with specific validation logic
- * implemented in the `validate` method. It provides a default implementation of the `run`
- * method, which processes a file and submits validation results (info, warning, or error)
- * to a summary object associated with the file context.
+ * Represents a summary of a method, capturing various messages and associations with values and statements.
+ * This class provides methods to submit messages and associate them with specific values or statements.
+ * It also supports retrieving or creating a method summary within a given context.
  */
-export declare abstract class FileValidator extends FilePass {
-    /**
-     * Validates the given file and reports the results through the provided context.
-     *
-     * @param file The file to be validated, represented as an ArkFile object.
-     * @param ctx The context used for reporting validation results, implemented as a SummaryReporter.
-     * @return The result of the validation process.
-     */
-    abstract validate(file: ArkFile, ctx: SummaryReporter): void;
-    run(file: ArkFile, ctx: FileCtx): void;
-}
-export declare abstract class ClassValidator extends ClassPass {
+export declare class MethodSummary {
+    name: string;
+    values: Map<Value, SummaryMsg[]>;
+    stmts: Map<Stmt, SummaryMsg[]>;
+    msgList: SummaryMsg[];
+    constructor();
+    submit(msg: SummaryMsg): void;
+    submitValue(value: Value, msg: SummaryMsg): void;
+    submitStmt(stmt: Stmt, msg: SummaryMsg): void;
     /**
-     * Validates the given class and reports any issues found during validation.
+     * Retrieves an existing MethodSummary from the context or creates a new one if it does not exist.
      *
-     * @param cls The class to be validated. This should be an instance of ArkClass.
-     * @param ctx The context used for reporting validation results or issues. This should be an instance of SummaryReporter.
-     * @return This method does not return any value.
+     * @param ctx The method context in which the MethodSummary is stored or will be created.
+     * @param mtd The ArkMethod for which the MethodSummary is being retrieved or created.
+     * @return The existing or newly created MethodSummary associated with the provided context and method.
      */
-    abstract validate(cls: ArkClass, ctx: SummaryReporter): void;
-    run(cls: ArkClass, ctx: ClassCtx): FallAction | void;
+    static getOrNew(ctx: MethodCtx, mtd: ArkMethod): MethodSummary;
 }
 export declare abstract class MethodValidator extends MethodPass {
     /**
@@ -111,37 +116,6 @@ export declare abstract class MethodValidator extends MethodPass {
     abstract validate(mtd: ArkMethod, ctx: SummaryReporter): void;
     run(mtd: ArkMethod, ctx: MethodCtx): FallAction | void;
 }
-/**
- * Represents a summary of a scene, containing metadata and associated file summaries.
- * The name property provides a default identifier for the scene summary.
- * The files property maintains a mapping of ArkFile instances to their corresponding FileSummary objects.
- * This class is used to encapsulate and manage information about a scene and its related files.
- */
-export declare class SceneSummary {
-    name: string;
-    files: Map<ArkFile, FileSummary>;
-}
-/**
- * Represents a summary of a file containing information about classes and messages.
- * Provides methods to manage and retrieve file summaries within a given context.
- * The class maintains a collection of messages and a mapping of classes to their summaries.
- * It supports operations to submit new messages and retrieve or create summaries for files.
- */
-export declare class FileSummary {
-    name: string;
-    classes: Map<ArkClass, ClassSummary>;
-    msgList: SummaryMsg[];
-    constructor();
-    submit(msg: SummaryMsg): void;
-    /**
-     * Retrieves an existing FileSummary instance from the given context or creates a new one if it does not exist.
-     *
-     * @param ctx The context object that holds the FileSummary instance. It is used to check if a FileSummary already exists.
-     * @param file The ArkFile object for which the FileSummary is being retrieved or created.
-     * @return The existing or newly created FileSummary instance associated with the provided file.
-     */
-    static getOrNew(ctx: FileCtx, file: ArkFile): FileSummary;
-}
 /**
  * Represents a summary of a class, containing its name, associated methods, and messages.
  * Provides functionality to submit messages and retrieve or create a ClassSummary instance.
@@ -165,51 +139,69 @@ export declare class ClassSummary {
      */
     static getOrNew(ctx: ClassCtx, cls: ArkClass): ClassSummary;
 }
-/**
- * Represents a summary message with an associated level and content.
- * The SummaryMsg class is used to encapsulate messages that have a specific severity or importance level.
- * It provides a way to associate a textual message with a defined level, making it suitable for logging, notifications, or summaries.
- * The constructor initializes the message and its level, ensuring both are explicitly defined at creation.
- */
-export declare class SummaryMsg {
-    level: SummaryLevel;
-    msg: string;
-    constructor(level: SummaryLevel, msg: string);
+export declare abstract class ClassValidator extends ClassPass {
+    /**
+     * Validates the given class and reports any issues found during validation.
+     *
+     * @param cls The class to be validated. This should be an instance of ArkClass.
+     * @param ctx The context used for reporting validation results or issues. This should be an instance of SummaryReporter.
+     * @return This method does not return any value.
+     */
+    abstract validate(cls: ArkClass, ctx: SummaryReporter): void;
+    run(cls: ArkClass, ctx: ClassCtx): FallAction | void;
 }
 /**
- * Represents a summary of a method, capturing various messages and associations with values and statements.
- * This class provides methods to submit messages and associate them with specific values or statements.
- * It also supports retrieving or creating a method summary within a given context.
+ * Represents a summary of a file containing information about classes and messages.
+ * Provides methods to manage and retrieve file summaries within a given context.
+ * The class maintains a collection of messages and a mapping of classes to their summaries.
+ * It supports operations to submit new messages and retrieve or create summaries for files.
  */
-export declare class MethodSummary {
+export declare class FileSummary {
     name: string;
-    values: Map<Value, SummaryMsg[]>;
-    stmts: Map<Stmt, SummaryMsg[]>;
+    classes: Map<ArkClass, ClassSummary>;
     msgList: SummaryMsg[];
     constructor();
     submit(msg: SummaryMsg): void;
-    submitValue(value: Value, msg: SummaryMsg): void;
-    submitStmt(stmt: Stmt, msg: SummaryMsg): void;
     /**
-     * Retrieves an existing MethodSummary from the context or creates a new one if it does not exist.
+     * Retrieves an existing FileSummary instance from the given context or creates a new one if it does not exist.
      *
-     * @param ctx The method context in which the MethodSummary is stored or will be created.
-     * @param mtd The ArkMethod for which the MethodSummary is being retrieved or created.
-     * @return The existing or newly created MethodSummary associated with the provided context and method.
+     * @param ctx The context object that holds the FileSummary instance. It is used to check if a FileSummary already exists.
+     * @param file The ArkFile object for which the FileSummary is being retrieved or created.
+     * @return The existing or newly created FileSummary instance associated with the provided file.
      */
-    static getOrNew(ctx: MethodCtx, mtd: ArkMethod): MethodSummary;
+    static getOrNew(ctx: FileCtx, file: ArkFile): FileSummary;
+}
+export declare abstract class FileValidator extends FilePass {
+    /**
+     * Validates the given file and reports the results through the provided context.
+     *
+     * @param file The file to be validated, represented as an ArkFile object.
+     * @param ctx The context used for reporting validation results, implemented as a SummaryReporter.
+     * @return The result of the validation process.
+     */
+    abstract validate(file: ArkFile, ctx: SummaryReporter): void;
+    run(file: ArkFile, ctx: FileCtx): void;
 }
 /**
- * The SceneValidator class is responsible for validating a given scene by leveraging the ScenePassMgr.
- * It sets up a context for validation, executes the validation process, and retrieves the summary of the validation.
- *
- * The validate method initializes a new SceneSummary instance, associates it with the current scene context,
- * runs the validation process using the configured manager, and finally returns the generated summary.
- *
- * This class ensures that the validation logic is encapsulated and provides a clean interface for processing scenes.
+ * Represents a summary of a scene, containing metadata and associated file summaries.
+ * The name property provides a default identifier for the scene summary.
+ * The files property maintains a mapping of ArkFile instances to their corresponding FileSummary objects.
+ * This class is used to encapsulate and manage information about a scene and its related files.
  */
-export declare class SceneValidator {
-    private mgr;
-    validate(scene: Scene): SceneSummary;
+export declare class SceneSummary {
+    name: string;
+    files: Map<ArkFile, FileSummary>;
+    /**
+     * Checks if the current instance is in an acceptable state.
+     * @return {boolean} - Returns true if the files collection is empty, indicating an acceptable state; otherwise, false.
+     */
+    isOk(): boolean;
+    /**
+     * Dumps the scene summary and details to the log based on the specified level.
+     * @param {SummaryLevel} [level=SummaryLevel.info] - The minimum level of messages to include in the log. Defaults to SummaryLevel.info.
+     * @return {void}
+     */
+    dump2log(level?: SummaryLevel): void;
+    private classDump;
 }
-//# sourceMappingURL=SceneValidator.d.ts.map
+//# sourceMappingURL=Validator.d.ts.map

package/lib/pass/validators/Validator.d.ts.map

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

package/lib/pass/{SceneValidator.js → validators/Validator.js}

@@ -37,12 +37,24 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SceneValidator = exports.MethodSummary = exports.SummaryMsg = exports.ClassSummary = exports.FileSummary = exports.SceneSummary = exports.MethodValidator = exports.ClassValidator = exports.FileValidator = exports.ArkValidatorRegistry = exports.ValueValidator = exports.StmtValidator = void 0;
-const ScenePassMgr_1 = require("./ScenePassMgr");
-const Dispatcher_1 = require("./Dispatcher");
-const Pass_1 = require("./Pass");
-const logger_1 = __importStar(require("../utils/logger"));
+exports.SceneSummary = exports.FileValidator = exports.FileSummary = exports.ClassValidator = exports.ClassSummary = exports.MethodValidator = exports.MethodSummary = exports.ArkValidatorRegistry = exports.ValueValidator = exports.StmtValidator = exports.SummaryMsg = void 0;
+const Pass_1 = require("../Pass");
+const Dispatcher_1 = require("../Dispatcher");
+const logger_1 = __importStar(require("../../utils/logger"));
 const logger = logger_1.default.getLogger(logger_1.LOG_MODULE_TYPE.ARKANALYZER, 'Validator');
+/**
+ * Represents a summary message with an associated level and content.
+ * The SummaryMsg class is used to encapsulate messages that have a specific severity or importance level.
+ * It provides a way to associate a textual message with a defined level, making it suitable for logging, notifications, or summaries.
+ * The constructor initializes the message and its level, ensuring both are explicitly defined at creation.
+ */
+class SummaryMsg {
+    constructor(level, msg) {
+        this.level = level;
+        this.msg = msg;
+    }
+}
+exports.SummaryMsg = SummaryMsg;
 /**
  * Abstract class representing a statement validator.
  * Provides a mechanism to validate statements of a specific type within a given context.
@@ -119,40 +131,54 @@ exports.ArkValidatorRegistry = ArkValidatorRegistry;
 ArkValidatorRegistry.stmtsHolder = [];
 ArkValidatorRegistry.valuesHolder = [];
 /**
- * An abstract class that extends FilePass and provides a framework for validating files.
- * The FileValidator class is designed to be subclassed with specific validation logic
- * implemented in the `validate` method. It provides a default implementation of the `run`
- * method, which processes a file and submits validation results (info, warning, or error)
- * to a summary object associated with the file context.
+ * Represents a summary of a method, capturing various messages and associations with values and statements.
+ * This class provides methods to submit messages and associate them with specific values or statements.
+ * It also supports retrieving or creating a method summary within a given context.
  */
-class FileValidator extends Pass_1.FilePass {
-    run(file, ctx) {
-        let submit = (msg) => {
-            let summary = FileSummary.getOrNew(ctx, file);
-            summary.submit(msg);
-        };
-        this.validate(file, {
-            info: (msg) => submit(new SummaryMsg(0 /* SummaryLevel.info */, msg)),
-            warn: (msg) => submit(new SummaryMsg(1 /* SummaryLevel.warn */, msg)),
-            error: (msg) => submit(new SummaryMsg(2 /* SummaryLevel.error */, msg)),
-        });
+class MethodSummary {
+    constructor() {
+        this.name = 'method summary';
+        this.values = new Map();
+        this.stmts = new Map();
+        this.msgList = [];
     }
-}
-exports.FileValidator = FileValidator;
-class ClassValidator extends Pass_1.ClassPass {
-    run(cls, ctx) {
-        let submit = (msg) => {
-            let summary = ClassSummary.getOrNew(ctx, cls);
-            summary.submit(msg);
-        };
-        this.validate(cls, {
-            info: (msg) => submit(new SummaryMsg(0 /* SummaryLevel.info */, msg)),
-            warn: (msg) => submit(new SummaryMsg(1 /* SummaryLevel.warn */, msg)),
-            error: (msg) => submit(new SummaryMsg(2 /* SummaryLevel.error */, msg)),
-        });
+    submit(msg) {
+        this.msgList.push(msg);
+    }
+    submitValue(value, msg) {
+        if (!this.values.get(value)) {
+            this.values.set(value, []);
+        }
+        this.values.get(value).push(msg);
+    }
+    submitStmt(stmt, msg) {
+        if (this.stmts.get(stmt) === undefined) {
+            this.stmts.set(stmt, []);
+        }
+        logger.info(`submit ${JSON.stringify(msg)}`);
+        this.stmts.get(stmt).push(msg);
+    }
+    /**
+     * Retrieves an existing MethodSummary from the context or creates a new one if it does not exist.
+     *
+     * @param ctx The method context in which the MethodSummary is stored or will be created.
+     * @param mtd The ArkMethod for which the MethodSummary is being retrieved or created.
+     * @return The existing or newly created MethodSummary associated with the provided context and method.
+     */
+    static getOrNew(ctx, mtd) {
+        if (ctx.get(MethodSummary)) {
+            return ctx.get(MethodSummary);
+        }
+        let cls = ClassSummary.getOrNew(ctx.upper, mtd.getDeclaringArkClass());
+        if (!cls.methods.get(mtd)) {
+            cls.methods.set(mtd, new MethodSummary());
+        }
+        let summary = cls.methods.get(mtd);
+        ctx.set(MethodSummary, summary);
+        return summary;
     }
 }
-exports.ClassValidator = ClassValidator;
+exports.MethodSummary = MethodSummary;
 class MethodValidator extends Pass_1.MethodPass {
     run(mtd, ctx) {
         let submit = (msg) => {
@@ -167,55 +193,6 @@ class MethodValidator extends Pass_1.MethodPass {
     }
 }
 exports.MethodValidator = MethodValidator;
-/**
- * Represents a summary of a scene, containing metadata and associated file summaries.
- * The name property provides a default identifier for the scene summary.
- * The files property maintains a mapping of ArkFile instances to their corresponding FileSummary objects.
- * This class is used to encapsulate and manage information about a scene and its related files.
- */
-class SceneSummary {
-    constructor() {
-        this.name = 'validate summary';
-        this.files = new Map();
-    }
-}
-exports.SceneSummary = SceneSummary;
-/**
- * Represents a summary of a file containing information about classes and messages.
- * Provides methods to manage and retrieve file summaries within a given context.
- * The class maintains a collection of messages and a mapping of classes to their summaries.
- * It supports operations to submit new messages and retrieve or create summaries for files.
- */
-class FileSummary {
-    constructor() {
-        this.name = 'file summary';
-        this.classes = new Map();
-        this.msgList = [];
-    }
-    submit(msg) {
-        this.msgList.push(msg);
-    }
-    /**
-     * Retrieves an existing FileSummary instance from the given context or creates a new one if it does not exist.
-     *
-     * @param ctx The context object that holds the FileSummary instance. It is used to check if a FileSummary already exists.
-     * @param file The ArkFile object for which the FileSummary is being retrieved or created.
-     * @return The existing or newly created FileSummary instance associated with the provided file.
-     */
-    static getOrNew(ctx, file) {
-        if (ctx.get(FileSummary)) {
-            return ctx.get(FileSummary);
-        }
-        let validate = ctx.upper.get(SceneSummary);
-        if (!validate.files.get(file)) {
-            validate.files.set(file, new FileSummary());
-        }
-        let summary = validate.files.get(file);
-        ctx.set(FileSummary, summary);
-        return summary;
-    }
-}
-exports.FileSummary = FileSummary;
 /**
  * Represents a summary of a class, containing its name, associated methods, and messages.
  * Provides functionality to submit messages and retrieve or create a ClassSummary instance.
@@ -254,86 +231,113 @@ class ClassSummary {
     }
 }
 exports.ClassSummary = ClassSummary;
-/**
- * Represents a summary message with an associated level and content.
- * The SummaryMsg class is used to encapsulate messages that have a specific severity or importance level.
- * It provides a way to associate a textual message with a defined level, making it suitable for logging, notifications, or summaries.
- * The constructor initializes the message and its level, ensuring both are explicitly defined at creation.
- */
-class SummaryMsg {
-    constructor(level, msg) {
-        this.level = level;
-        this.msg = msg;
+class ClassValidator extends Pass_1.ClassPass {
+    run(cls, ctx) {
+        let submit = (msg) => {
+            let summary = ClassSummary.getOrNew(ctx, cls);
+            summary.submit(msg);
+        };
+        this.validate(cls, {
+            info: (msg) => submit(new SummaryMsg(0 /* SummaryLevel.info */, msg)),
+            warn: (msg) => submit(new SummaryMsg(1 /* SummaryLevel.warn */, msg)),
+            error: (msg) => submit(new SummaryMsg(2 /* SummaryLevel.error */, msg)),
+        });
     }
 }
-exports.SummaryMsg = SummaryMsg;
+exports.ClassValidator = ClassValidator;
 /**
- * Represents a summary of a method, capturing various messages and associations with values and statements.
- * This class provides methods to submit messages and associate them with specific values or statements.
- * It also supports retrieving or creating a method summary within a given context.
+ * Represents a summary of a file containing information about classes and messages.
+ * Provides methods to manage and retrieve file summaries within a given context.
+ * The class maintains a collection of messages and a mapping of classes to their summaries.
+ * It supports operations to submit new messages and retrieve or create summaries for files.
  */
-class MethodSummary {
+class FileSummary {
     constructor() {
-        this.name = 'method summary';
-        this.values = new Map();
-        this.stmts = new Map();
+        this.name = 'file summary';
+        this.classes = new Map();
         this.msgList = [];
     }
     submit(msg) {
         this.msgList.push(msg);
     }
-    submitValue(value, msg) {
-        if (!this.values.get(value)) {
-            this.values.set(value, []);
-        }
-        this.values.get(value).push(msg);
-    }
-    submitStmt(stmt, msg) {
-        if (this.stmts.get(stmt) === undefined) {
-            this.stmts.set(stmt, []);
-        }
-        logger.info(`submit ${JSON.stringify(msg)}`);
-        this.stmts.get(stmt).push(msg);
-    }
     /**
-     * Retrieves an existing MethodSummary from the context or creates a new one if it does not exist.
+     * Retrieves an existing FileSummary instance from the given context or creates a new one if it does not exist.
      *
-     * @param ctx The method context in which the MethodSummary is stored or will be created.
-     * @param mtd The ArkMethod for which the MethodSummary is being retrieved or created.
-     * @return The existing or newly created MethodSummary associated with the provided context and method.
+     * @param ctx The context object that holds the FileSummary instance. It is used to check if a FileSummary already exists.
+     * @param file The ArkFile object for which the FileSummary is being retrieved or created.
+     * @return The existing or newly created FileSummary instance associated with the provided file.
      */
-    static getOrNew(ctx, mtd) {
-        if (ctx.get(MethodSummary)) {
-            return ctx.get(MethodSummary);
+    static getOrNew(ctx, file) {
+        if (ctx.get(FileSummary)) {
+            return ctx.get(FileSummary);
         }
-        let cls = ClassSummary.getOrNew(ctx.upper, mtd.getDeclaringArkClass());
-        if (!cls.methods.get(mtd)) {
-            cls.methods.set(mtd, new MethodSummary());
+        let validate = ctx.upper.get(SceneSummary);
+        if (!validate.files.get(file)) {
+            validate.files.set(file, new FileSummary());
         }
-        let summary = cls.methods.get(mtd);
-        ctx.set(MethodSummary, summary);
+        let summary = validate.files.get(file);
+        ctx.set(FileSummary, summary);
         return summary;
     }
 }
-exports.MethodSummary = MethodSummary;
+exports.FileSummary = FileSummary;
+class FileValidator extends Pass_1.FilePass {
+    run(file, ctx) {
+        let submit = (msg) => {
+            let summary = FileSummary.getOrNew(ctx, file);
+            summary.submit(msg);
+        };
+        this.validate(file, {
+            info: (msg) => submit(new SummaryMsg(0 /* SummaryLevel.info */, msg)),
+            warn: (msg) => submit(new SummaryMsg(1 /* SummaryLevel.warn */, msg)),
+            error: (msg) => submit(new SummaryMsg(2 /* SummaryLevel.error */, msg)),
+        });
+    }
+}
+exports.FileValidator = FileValidator;
 /**
- * The SceneValidator class is responsible for validating a given scene by leveraging the ScenePassMgr.
- * It sets up a context for validation, executes the validation process, and retrieves the summary of the validation.
- *
- * The validate method initializes a new SceneSummary instance, associates it with the current scene context,
- * runs the validation process using the configured manager, and finally returns the generated summary.
- *
- * This class ensures that the validation logic is encapsulated and provides a clean interface for processing scenes.
+ * Represents a summary of a scene, containing metadata and associated file summaries.
+ * The name property provides a default identifier for the scene summary.
+ * The files property maintains a mapping of ArkFile instances to their corresponding FileSummary objects.
+ * This class is used to encapsulate and manage information about a scene and its related files.
  */
-class SceneValidator {
+class SceneSummary {
     constructor() {
-        this.mgr = new ScenePassMgr_1.ScenePassMgr({ dispatcher: ArkValidatorRegistry });
+        this.name = 'validate summary';
+        this.files = new Map();
+    }
+    /**
+     * Checks if the current instance is in an acceptable state.
+     * @return {boolean} - Returns true if the files collection is empty, indicating an acceptable state; otherwise, false.
+     */
+    isOk() {
+        return this.files.size === 0;
     }
-    validate(scene) {
-        let summary = new SceneSummary();
-        this.mgr.sceneContext().set(SceneSummary, summary);
-        this.mgr.run(scene);
-        return this.mgr.sceneContext().remove(SceneSummary);
+    /**
+     * Dumps the scene summary and details to the log based on the specified level.
+     * @param {SummaryLevel} [level=SummaryLevel.info] - The minimum level of messages to include in the log. Defaults to SummaryLevel.info.
+     * @return {void}
+     */
+    dump2log(level = 0 /* SummaryLevel.info */) {
+        logger.info(`scene summary`);
+        for (const [file, fs] of this.files) {
+            logger.info(`file ${file.getName()} msg ${JSON.stringify(fs.msgList.filter((v) => v.level >= level))}`);
+            for (const [cls, cs] of fs.classes) {
+                this.classDump(cls, cs, level);
+            }
+        }
+    }
+    classDump(cls, cs, level = 0 /* SummaryLevel.info */) {
+        logger.info(`class ${cls.getName()} msg ${JSON.stringify(cs.msgList.filter((v) => v.level >= level))}`);
+        for (const [mtd, ms] of cs.methods) {
+            logger.info(`method ${mtd.getName()} msg ${JSON.stringify(ms.msgList.filter((v) => v.level >= level))}`);
+            for (let [s, ss] of ms.stmts) {
+                logger.info(`stmt ${s} ${JSON.stringify(ss.filter((v) => v.level >= level))}`);
+            }
+            for (let [v, vs] of ms.values) {
+                logger.info(`value ${v} ${JSON.stringify(vs.filter((v) => v.level >= level))}`);
+            }
+        }
     }
 }
-exports.SceneValidator = SceneValidator;
+exports.SceneSummary = SceneSummary;

package/lib/pass/validators/Values.d.ts

@@ -0,0 +1,7 @@
+import { SummaryReporter, ValueValidator } from './Validator';
+import { Local } from '../../core/base/Local';
+export declare class LocalValidator extends ValueValidator<Local> {
+    private static readonly INSTANCE;
+    validate(value: Local, ctx: SummaryReporter): void;
+}
+//# sourceMappingURL=Values.d.ts.map

package/lib/pass/validators/Values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Values.d.ts","sourceRoot":"","sources":["../../../src/pass/validators/Values.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAK9C,qBAAa,cAAe,SAAQ,cAAc,CAAC,KAAK,CAAC;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IAExD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,eAAe,GAAG,IAAI;CAWrD"}