arkanalyzer 1.0.90 → 1.0.91

package/lib/core/common/EtsConst.js

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ETS_CODE_PATH = exports.PATH_DELIMITER = exports.ETS_PATH = exports.SCOPE_PREFIX = exports.PATH_BE_OMITTED = exports.DEFAULT_SDK_NUMS = exports.MODULE_PREFIX = exports.OH_MODULES = exports.OHPM = exports.OHOS_BASE_FILE = exports.BUSINESS_ERROR = exports.COMPONENT_EXTEND_DECORATOR = exports.COMMON_METHOD = exports.COMPONENT = exports.BUILD_PROFILE_JSON5 = exports.OH_PACKAGE_JSON5 = exports.ON_OFF = exports.CALL_BACK = exports.COMPONENT_ATTRIBUTE = exports.COMPONENT_INSTANCE = exports.COMPONENT_COMMON = exports.SPECIAL_CONTAINER_COMPONENT = exports.COMPONENT_BUILD_FUNCTION = exports.COMPONENT_BRANCH_FUNCTION = exports.COMPONENT_IF_BRANCH = exports.COMPONENT_IF = exports.COMPONENT_REPEAT = exports.COMPONENT_CUSTOMVIEW = exports.COMPONENT_POP_FUNCTION = exports.COMPONENT_CREATE_FUNCTION = exports.isEtsContainerComponent = exports.isEtsSystemComponent = exports.isEtsAtomicComponent = exports.COMPONENT_BEHAVIOR = exports.BUILDER_PARAM_DECORATOR = exports.BUILDER_DECORATOR = exports.ENTRY_DECORATOR = exports.COMPONENT_DECORATOR = exports.BUILDIN_ATOMIC_COMPONENT = exports.BUILDIN_SYSTEM_COMPONENT = exports.COMPONENT_LAZY_FOR_EACH = exports.COMPONENT_FOR_EACH = exports.ETS_COMPILER_OPTIONS = void 0;
+exports.ETS_CODE_PATH = exports.PATH_DELIMITER = exports.ETS_PATH = exports.SCOPE_PREFIX = exports.PATH_BE_OMITTED = exports.DEFAULT_SDK_NUMS = exports.MODULE_PREFIX = exports.OH_MODULES = exports.OHPM = exports.OHOS_BASE_FILE = exports.BUSINESS_ERROR = exports.COMPONENT_EXTEND_DECORATOR = exports.COMMON_METHOD = exports.COMPONENT = exports.BUILD_PROFILE_JSON5 = exports.OH_PACKAGE_JSON5 = exports.ON_OFF = exports.CALL_BACK = exports.COMPONENT_ATTRIBUTE = exports.COMPONENT_INSTANCE = exports.COMPONENT_COMMON = exports.SPECIAL_CONTAINER_COMPONENT = exports.COMPONENT_BUILD_FUNCTION = exports.COMPONENT_BRANCH_FUNCTION = exports.COMPONENT_IF_BRANCH = exports.COMPONENT_IF = exports.COMPONENT_REPEAT = exports.COMPONENT_CUSTOMVIEW = exports.COMPONENT_POP_FUNCTION = exports.COMPONENT_CREATE_FUNCTION = exports.addSystemComponent = exports.isEtsContainerComponent = exports.isEtsSystemComponent = exports.isEtsAtomicComponent = exports.COMPONENT_BEHAVIOR = exports.BUILDER_PARAM_DECORATOR = exports.BUILDER_DECORATOR = exports.ENTRY_DECORATOR = exports.COMPONENT_DECORATOR = exports.DEFAULT_COMPONENTS = exports.BUILDIN_ATOMIC_COMPONENT = exports.BUILDIN_SYSTEM_COMPONENT = exports.COMPONENT_LAZY_FOR_EACH = exports.COMPONENT_FOR_EACH = exports.ETS_COMPILER_OPTIONS = void 0;
 exports.ETS_COMPILER_OPTIONS = {
     ets: {
         emitDecorators: [
@@ -173,129 +173,7 @@ exports.ETS_COMPILER_OPTIONS = {
             method: ['build', 'pageTransition'],
             decorator: ['LocalBuilder', 'Builder'],
         },
-        components: [
-            'AbilityComponent',
-            'AlphabetIndexer',
-            'Animator',
-            'Badge',
-            'Blank',
-            'Button',
-            'Calendar',
-            'CalendarPicker',
-            'Camera',
-            'Canvas',
-            'Checkbox',
-            'CheckboxGroup',
-            'Circle',
-            'ColorPicker',
-            'ColorPickerDialog',
-            'Column',
-            'ColumnSplit',
-            'ContentSlot',
-            'Counter',
-            'DataPanel',
-            'DatePicker',
-            'Divider',
-            'EffectComponent',
-            'Ellipse',
-            'EmbeddedComponent',
-            'Flex',
-            'FolderStack',
-            'FormComponent',
-            'FormLink',
-            'Gauge',
-            'GeometryView',
-            'Grid',
-            'GridItem',
-            'GridContainer',
-            'Hyperlink',
-            'Image',
-            'ImageAnimator',
-            'Line',
-            'List',
-            'ListItem',
-            'ListItemGroup',
-            'LoadingProgress',
-            'Marquee',
-            'MediaCachedImage',
-            'Menu',
-            'MenuItem',
-            'MenuItemGroup',
-            'MovingPhotoView',
-            'NavDestination',
-            'NavRouter',
-            'Navigation',
-            'Navigator',
-            'NodeContainer',
-            'Option',
-            'PageTransitionEnter',
-            'PageTransitionExit',
-            'Panel',
-            'Particle',
-            'Path',
-            'PatternLock',
-            'Piece',
-            'PluginComponent',
-            'Polygon',
-            'Polyline',
-            'Progress',
-            'QRCode',
-            'Radio',
-            'Rating',
-            'Rect',
-            'Refresh',
-            'RelativeContainer',
-            'RemoteWindow',
-            'RootScene',
-            'Row',
-            'RowSplit',
-            'RichText',
-            'Screen',
-            'Scroll',
-            'ScrollBar',
-            'Search',
-            'Section',
-            'Select',
-            'Shape',
-            'Sheet',
-            'SideBarContainer',
-            'Slider',
-            'Span',
-            'Stack',
-            'Stepper',
-            'StepperItem',
-            'Swiper',
-            'SymbolGlyph',
-            'SymbolSpan',
-            'TabContent',
-            'Tabs',
-            'Text',
-            'TextPicker',
-            'TextClock',
-            'TextArea',
-            'TextInput',
-            'TextTimer',
-            'TimePicker',
-            'Toggle',
-            'Video',
-            'Web',
-            'WindowScene',
-            'WithTheme',
-            'XComponent',
-            'GridRow',
-            'GridCol',
-            'WaterFlow',
-            'FlowItem',
-            'ImageSpan',
-            'LocationButton',
-            'PasteButton',
-            'SaveButton',
-            'UIExtensionComponent',
-            'IsolatedComponent',
-            'RichEditor',
-            'Component3D',
-            'ContainerSpan',
-        ],
+        components: [],
         extend: {
             decorator: ['Extend', 'AnimatableExtend'],
             components: [
@@ -923,7 +801,7 @@ exports.ETS_COMPILER_OPTIONS = {
 };
 exports.COMPONENT_FOR_EACH = 'ForEach';
 exports.COMPONENT_LAZY_FOR_EACH = 'LazyForEach';
-exports.BUILDIN_SYSTEM_COMPONENT = new Set([...exports.ETS_COMPILER_OPTIONS.ets.components, exports.COMPONENT_FOR_EACH, exports.COMPONENT_LAZY_FOR_EACH]);
+exports.BUILDIN_SYSTEM_COMPONENT = new Set([exports.COMPONENT_FOR_EACH, exports.COMPONENT_LAZY_FOR_EACH]);
 exports.BUILDIN_ATOMIC_COMPONENT = new Set([
     'AbilityComponent',
     'AlphabetIndexer',
@@ -978,6 +856,129 @@ exports.BUILDIN_ATOMIC_COMPONENT = new Set([
     'Video',
     'Web',
 ]);
+exports.DEFAULT_COMPONENTS = [
+    'AbilityComponent',
+    'AlphabetIndexer',
+    'Animator',
+    'Badge',
+    'Blank',
+    'Button',
+    'Calendar',
+    'CalendarPicker',
+    'Camera',
+    'Canvas',
+    'Checkbox',
+    'CheckboxGroup',
+    'Circle',
+    'ColorPicker',
+    'ColorPickerDialog',
+    'Column',
+    'ColumnSplit',
+    'ContentSlot',
+    'Counter',
+    'DataPanel',
+    'DatePicker',
+    'Divider',
+    'EffectComponent',
+    'Ellipse',
+    'EmbeddedComponent',
+    'Flex',
+    'FolderStack',
+    'FormComponent',
+    'FormLink',
+    'Gauge',
+    'GeometryView',
+    'Grid',
+    'GridItem',
+    'GridContainer',
+    'Hyperlink',
+    'Image',
+    'ImageAnimator',
+    'Line',
+    'List',
+    'ListItem',
+    'ListItemGroup',
+    'LoadingProgress',
+    'Marquee',
+    'MediaCachedImage',
+    'Menu',
+    'MenuItem',
+    'MenuItemGroup',
+    'MovingPhotoView',
+    'NavDestination',
+    'NavRouter',
+    'Navigation',
+    'Navigator',
+    'NodeContainer',
+    'Option',
+    'PageTransitionEnter',
+    'PageTransitionExit',
+    'Panel',
+    'Particle',
+    'Path',
+    'PatternLock',
+    'Piece',
+    'PluginComponent',
+    'Polygon',
+    'Polyline',
+    'Progress',
+    'QRCode',
+    'Radio',
+    'Rating',
+    'Rect',
+    'Refresh',
+    'RelativeContainer',
+    'RemoteWindow',
+    'RootScene',
+    'Row',
+    'RowSplit',
+    'RichText',
+    'Screen',
+    'Scroll',
+    'ScrollBar',
+    'Search',
+    'Section',
+    'Select',
+    'Shape',
+    'Sheet',
+    'SideBarContainer',
+    'Slider',
+    'Span',
+    'Stack',
+    'Stepper',
+    'StepperItem',
+    'Swiper',
+    'SymbolGlyph',
+    'SymbolSpan',
+    'TabContent',
+    'Tabs',
+    'Text',
+    'TextPicker',
+    'TextClock',
+    'TextArea',
+    'TextInput',
+    'TextTimer',
+    'TimePicker',
+    'Toggle',
+    'Video',
+    'Web',
+    'WindowScene',
+    'WithTheme',
+    'XComponent',
+    'GridRow',
+    'GridCol',
+    'WaterFlow',
+    'FlowItem',
+    'ImageSpan',
+    'LocationButton',
+    'PasteButton',
+    'SaveButton',
+    'UIExtensionComponent',
+    'IsolatedComponent',
+    'RichEditor',
+    'Component3D',
+    'ContainerSpan',
+];
 exports.COMPONENT_DECORATOR = new Set(['Reusable', 'Component', 'ComponentV2', 'CustomDialog']);
 exports.ENTRY_DECORATOR = 'Entry';
 exports.BUILDER_DECORATOR = 'Builder';
@@ -995,6 +996,13 @@ function isEtsContainerComponent(name) {
     return isEtsSystemComponent(name) && !isEtsAtomicComponent(name);
 }
 exports.isEtsContainerComponent = isEtsContainerComponent;
+function addSystemComponent(componentNames) {
+    componentNames.forEach(name => {
+        exports.ETS_COMPILER_OPTIONS.ets.components.push(name);
+        exports.BUILDIN_SYSTEM_COMPONENT.add(name);
+    });
+}
+exports.addSystemComponent = addSystemComponent;
 exports.COMPONENT_CREATE_FUNCTION = 'create';
 exports.COMPONENT_POP_FUNCTION = 'pop';
 exports.COMPONENT_CUSTOMVIEW = 'View';

package/lib/core/common/SdkUtils.d.ts

@@ -29,5 +29,6 @@ export declare class SdkUtils {
     static copyMembers(from: ArkClass, to: ArkClass): void;
     static computeGlobalThis(leftOp: AbstractFieldRef, arkMethod: ArkMethod): void;
     static extendArkUI(scene: Scene): void;
+    static loadSystemComponentsFromSdk(sdkPath: string): void;
 }
 //# sourceMappingURL=SdkUtils.d.ts.map

package/lib/core/common/SdkUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SdkUtils.d.ts","sourceRoot":"","sources":["../../../src/core/common/SdkUtils.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAI3D,OAAO,EAAE,QAAQ,EAAiB,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGnC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIpC,qBAAa,QAAQ;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAoB;IAC5C,OAAO,CAAC,MAAM,CAAC,YAAY,CAGxB;IAEH,OAAO,CAAC,MAAM,CAAC,YAAY,CAAoD;IAC/E,OAAc,aAAa,SAAc;IACzC,OAAO,CAAC,MAAM,CAAC,cAAc,CAG3B;WAEY,YAAY,CAAC,YAAY,EAAE,GAAG,GAAG,IAAI;WAQrC,aAAa,IAAI,GAAG;WAoBpB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAW9D,OAAO,CAAC,MAAM,CAAC,QAAQ;WAaT,OAAO,IAAI,IAAI;WAIf,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;WAStC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIjE,OAAO,CAAC,MAAM,CAAC,YAAY;WAUb,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;WAqBrE,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;IAiBpF,OAAO,CAAC,MAAM,CAAC,aAAa;WAWd,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,GAAE,OAAe,GAAG,IAAI;WAY3F,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;IAgBrF,OAAO,CAAC,MAAM,CAAC,SAAS;IAiBxB,OAAO,CAAC,MAAM,CAAC,eAAe;WA0BhB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI;WAqB/C,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;WAWvE,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAWhD"}
+{"version":3,"file":"SdkUtils.d.ts","sourceRoot":"","sources":["../../../src/core/common/SdkUtils.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAc,MAAM,oBAAoB,CAAC;AAU3D,OAAO,EAAE,QAAQ,EAAiB,MAAM,mBAAmB,CAAC;AAG5D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGnC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIpC,qBAAa,QAAQ;IACjB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAoB;IAC5C,OAAO,CAAC,MAAM,CAAC,YAAY,CAGxB;IAEH,OAAO,CAAC,MAAM,CAAC,YAAY,CAAoD;IAC/E,OAAc,aAAa,SAAc;IACzC,OAAO,CAAC,MAAM,CAAC,cAAc,CAG3B;WAEY,YAAY,CAAC,YAAY,EAAE,GAAG,GAAG,IAAI;WAQrC,aAAa,IAAI,GAAG;WAoBpB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAW9D,OAAO,CAAC,MAAM,CAAC,QAAQ;WAaT,OAAO,IAAI,IAAI;WAIf,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;WAStC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIjE,OAAO,CAAC,MAAM,CAAC,YAAY;WAUb,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;WAqBrE,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;IAiBpF,OAAO,CAAC,MAAM,CAAC,aAAa;WAWd,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,QAAQ,GAAE,OAAe,GAAG,IAAI;WAY3F,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI;IAgBrF,OAAO,CAAC,MAAM,CAAC,SAAS;IAiBxB,OAAO,CAAC,MAAM,CAAC,eAAe;WA0BhB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI;WAqB/C,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;WAWvE,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;WAgB/B,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAwBnE"}

package/lib/core/common/SdkUtils.js

@@ -294,6 +294,35 @@ class SdkUtils {
             mtd.setIsGeneratedFlag(true);
             cls.addMethod(mtd);
         }
+        if (EtsConst_1.BUILDIN_SYSTEM_COMPONENT.size < EtsConst_1.DEFAULT_COMPONENTS.length) {
+            (0, EtsConst_1.addSystemComponent)(EtsConst_1.DEFAULT_COMPONENTS);
+            logger.error('System component not found, fall back to default component. Please check sdk setting.');
+        }
+    }
+    static loadSystemComponentsFromSdk(sdkPath) {
+        const componentsDir = path_1.default.join(sdkPath, 'build-tools', 'ets-loader', 'components');
+        if (!fs_1.default.existsSync(componentsDir)) {
+            return;
+        }
+        const componentFiles = fs_1.default.readdirSync(componentsDir)
+            .filter(file => file.endsWith('.json'));
+        const componentNames = [];
+        componentFiles.forEach(file => {
+            const filePath = path_1.default.join(componentsDir, file);
+            try {
+                const content = fs_1.default.readFileSync(filePath, 'utf-8');
+                const componentData = JSON.parse(content);
+                if (componentData && typeof componentData.name === 'string') {
+                    componentNames.push(componentData.name);
+                }
+            }
+            catch (error) {
+                logger.error(`Failed to parse component file: ${filePath}`, error);
+            }
+        });
+        if (componentNames.length > 0) {
+            (0, EtsConst_1.addSystemComponent)(componentNames);
+        }
     }
 }
 exports.SdkUtils = SdkUtils;

package/lib/core/graph/BaseExplicitGraph.d.ts

@@ -50,6 +50,8 @@ export declare abstract class BaseExplicitGraph implements GraphTraits<BaseNode>
     nodesItor(): IterableIterator<BaseNode>;
     addNode(n: BaseNode): void;
     getNode(id: NodeID): BaseNode | undefined;
+    getNodeID(node: BaseNode): NodeID;
+    succ(id: NodeID): NodeID[];
     hasNode(id: NodeID): boolean;
     removeNode(id: NodeID): boolean;
     hasEdge(src: BaseNode, dst: BaseNode): boolean;

package/lib/core/graph/BaseExplicitGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseExplicitGraph.d.ts","sourceRoot":"","sources":["../../../src/core/graph/BaseExplicitGraph.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACxB,8BAAsB,QAAQ;IAC1B,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,GAAG,CAAW;IACtB,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;gBAET,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI;IAMtC,QAAQ,IAAI,MAAM;IAIlB,QAAQ,IAAI,MAAM;IAIlB,UAAU,IAAI,QAAQ;IAItB,UAAU,IAAI,QAAQ;IAItB,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIzB,YAAY,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAO5C,UAAU,IAAI,MAAM;CAG9B;AAED,8BAAsB,QAAQ;IAC1B,OAAO,CAAC,EAAE,CAAS;IACnB,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;IACrB,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAgB;gBAErB,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI;IAKxB,KAAK,IAAI,MAAM;IAIf,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIzB,gBAAgB,IAAI,OAAO;IAI3B,gBAAgB,IAAI,OAAO;IAI3B,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;IAIrC,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;IAIrC,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI;IAOlC,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI;IAOlC,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;IAIxC,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;IAIxC,eAAe,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,SAAS;IAI5C,gBAAgB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,SAAS;IAI7C,UAAU,IAAI,MAAM;aAIX,WAAW,IAAI,MAAM;CACxC;AAED,8BAAsB,iBAAkB,YAAW,WAAW,CAAC,QAAQ,CAAC;IACpE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAK;IAC9B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAK;IAC9B,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;;IAO5B,UAAU,IAAI,MAAM;IAIpB,UAAU,IAAI,MAAM;IAIpB,SAAS,IAAI,gBAAgB,CAAC,QAAQ,CAAC;IAIvC,OAAO,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI;IAK1B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAQzC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI5B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ/B,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO;IAc9C,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAUvC,YAAY,IAAI,gBAAgB,CAAC,QAAQ,CAAC;aAIjC,YAAY,IAAI,MAAM;CACzC"}
+{"version":3,"file":"BaseExplicitGraph.d.ts","sourceRoot":"","sources":["../../../src/core/graph/BaseExplicitGraph.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACxB,8BAAsB,QAAQ;IAC1B,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,GAAG,CAAW;IACtB,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;gBAET,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI;IAMtC,QAAQ,IAAI,MAAM;IAIlB,QAAQ,IAAI,MAAM;IAIlB,UAAU,IAAI,QAAQ;IAItB,UAAU,IAAI,QAAQ;IAItB,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIzB,YAAY,IAAI;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAO5C,UAAU,IAAI,MAAM;CAG9B;AAED,8BAAsB,QAAQ;IAC1B,OAAO,CAAC,EAAE,CAAS;IACnB,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;IACrB,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAgB;gBAErB,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI;IAKxB,KAAK,IAAI,MAAM;IAIf,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIzB,gBAAgB,IAAI,OAAO;IAI3B,gBAAgB,IAAI,OAAO;IAI3B,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;IAIrC,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;IAIrC,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI;IAOlC,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI;IAOlC,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;IAIxC,kBAAkB,CAAC,CAAC,EAAE,QAAQ,GAAG,OAAO;IAIxC,eAAe,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,SAAS;IAI5C,gBAAgB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,SAAS;IAI7C,UAAU,IAAI,MAAM;aAIX,WAAW,IAAI,MAAM;CACxC;AAED,8BAAsB,iBAAkB,YAAW,WAAW,CAAC,QAAQ,CAAC;IACpE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAK;IAC9B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAK;IAC9B,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;;IAO5B,UAAU,IAAI,MAAM;IAIpB,UAAU,IAAI,MAAM;IAIpB,SAAS,IAAI,gBAAgB,CAAC,QAAQ,CAAC;IAIvC,OAAO,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI;IAK1B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAQzC,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;IAIjC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE;IAS1B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI5B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQ/B,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO;IAc9C,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAUvC,YAAY,IAAI,gBAAgB,CAAC,QAAQ,CAAC;aAIjC,YAAY,IAAI,MAAM;CACzC"}

package/lib/core/graph/BaseExplicitGraph.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright (c) 2024-2025 Huawei Device Co., Ltd.
+ * Copyright (c) 2024-2026 Huawei Device Co., Ltd.
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
@@ -131,6 +131,17 @@ class BaseExplicitGraph {
         }
         return this.idToNodeMap.get(id);
     }
+    getNodeID(node) {
+        return node.getID();
+    }
+    succ(id) {
+        const node = this.getNode(id);
+        const outgoingEdges = node === null || node === void 0 ? void 0 : node.getOutgoingEdges();
+        if (!outgoingEdges) {
+            return [];
+        }
+        return Array.from(outgoingEdges).map(e => e.getDstID());
+    }
     hasNode(id) {
         return this.idToNodeMap.has(id);
     }

package/lib/core/graph/BaseImplicitGraph.d.ts

@@ -44,6 +44,22 @@ export declare abstract class BaseImplicitGraph<Node> implements GraphTraits<Nod
      * @throws Throws an error if idToNodeMap is not initialized or if the node is not found.
      */
     getNode(id: NodeID): Node;
+    /**
+     * Safely gets the node object corresponding to a given node ID.
+     * Unlike {@link getNode}, this method does not throw; it returns undefined when the
+     * idToNodeMap is not initialized or the node is not found.
+     * @param id The node ID.
+     * @returns The corresponding node object, or undefined when not found.
+     */
+    tryGetNode(id: NodeID): Node | undefined;
+    /**
+     * Safely gets the node ID corresponding to a given node object.
+     * Unlike {@link getNodeID}, this method does not throw; it returns undefined
+     * when the node is not found in the nodeToIdMap.
+     * @param node The node object.
+     * @returns The corresponding NodeID, or undefined when not found.
+     */
+    tryGetNodeID(node: Node): NodeID | undefined;
     getNodeID(s: Node): NodeID;
     /**
      * Checks whether the graph contains a specific node ID.

package/lib/core/graph/BaseImplicitGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseImplicitGraph.d.ts","sourceRoot":"","sources":["../../../src/core/graph/BaseImplicitGraph.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB;;;;GAIG;AACH,8BAAsB,iBAAiB,CAAC,IAAI,CAAE,YAAW,WAAW,CAAC,IAAI,CAAC;IACtE;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE1C;;;OAGG;IACH,SAAS,CAAC,WAAW,EAAG,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE1C;;;OAGG;IACH,OAAO,EAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEhC;;;OAGG;IACH,OAAO,EAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;;IAIhC;;;OAGG;IACI,UAAU,IAAI,MAAM;IAI3B;;;OAGG;IACI,SAAS,IAAI,gBAAgB,CAAC,IAAI,CAAC;IAI1C;;;;;OAKG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAYzB,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM;IAQjC;;;;;OAKG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQnC;;;;OAIG;IACI,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjC;;;;OAIG;IACI,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjC;;;OAGG;IACI,cAAc,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC;IAI1C;;;;OAIG;aACa,YAAY,IAAI,MAAM;CACzC"}
+{"version":3,"file":"BaseImplicitGraph.d.ts","sourceRoot":"","sources":["../../../src/core/graph/BaseImplicitGraph.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB;;;;GAIG;AACH,8BAAsB,iBAAiB,CAAC,IAAI,CAAE,YAAW,WAAW,CAAC,IAAI,CAAC;IACtE;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE1C;;;OAGG;IACH,SAAS,CAAC,WAAW,EAAG,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE1C;;;OAGG;IACH,OAAO,EAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEhC;;;OAGG;IACH,OAAO,EAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;;IAIhC;;;OAGG;IACI,UAAU,IAAI,MAAM;IAI3B;;;OAGG;IACI,SAAS,IAAI,gBAAgB,CAAC,IAAI,CAAC;IAI1C;;;;;OAKG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAYhC;;;;;;OAMG;IACI,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAI/C;;;;;;OAMG;IACI,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS;IAI5C,SAAS,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM;IAQjC;;;;;OAKG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAQnC;;;;OAIG;IACI,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjC;;;;OAIG;IACI,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE;IAIjC;;;OAGG;IACI,cAAc,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC;IAI1C;;;;OAIG;aACa,YAAY,IAAI,MAAM;CACzC"}

package/lib/core/graph/BaseImplicitGraph.js

@@ -37,6 +37,27 @@ class BaseImplicitGraph {
         }
         return this.idToNodeMap.get(id);
     }
+    /**
+     * Safely gets the node object corresponding to a given node ID.
+     * Unlike {@link getNode}, this method does not throw; it returns undefined when the
+     * idToNodeMap is not initialized or the node is not found.
+     * @param id The node ID.
+     * @returns The corresponding node object, or undefined when not found.
+     */
+    tryGetNode(id) {
+        var _a;
+        return (_a = this.idToNodeMap) === null || _a === void 0 ? void 0 : _a.get(id);
+    }
+    /**
+     * Safely gets the node ID corresponding to a given node object.
+     * Unlike {@link getNodeID}, this method does not throw; it returns undefined
+     * when the node is not found in the nodeToIdMap.
+     * @param node The node object.
+     * @returns The corresponding NodeID, or undefined when not found.
+     */
+    tryGetNodeID(node) {
+        return this.nodeToIdMap.get(node);
+    }
     getNodeID(s) {
         if (!this.nodeToIdMap.has(s)) {
             throw new Error(`Can find Node # ${s}`);

package/lib/core/graph/FileDepGraph.d.ts

@@ -0,0 +1,75 @@
+import { BaseImplicitGraph } from './BaseImplicitGraph';
+import type { NodeID } from './BaseImplicitGraph';
+import type { ArkFile } from '../model/ArkFile';
+import type { Canonicalizer } from '../../utils/Canonicalizer';
+/**
+ * File dependency graph, based on BaseImplicitGraph.
+ * The node type is ArkFile, and edges represent dependency relationships between files.
+ *
+ * Similar to ModuleDepGraph but operates at file granularity:
+ * - The node is the ArkFile itself, identified by its Canonicalizer-assigned ID
+ * - Edge information is implicitly stored via succMap/predMap (Map<NodeID, NodeID[]>)
+ * - Works with Canonicalizer<ArkFile> to provide bidirectional ArkFile <-> NodeID mapping
+ *
+ * SCCDetection is used to compute a topological order of files (depended-on files first).
+ */
+export declare class FileDepGraph extends BaseImplicitGraph<ArkFile> {
+    /**
+     * File Canonicalizer for bidirectional ArkFile <-> NodeID mapping.
+     */
+    private fileCanonicalizer;
+    /**
+     * Topological order of nodes after SCC computation, populated by computeTopoOrder.
+     * Depended-on files appear before their dependents.
+     */
+    private topoOrder;
+    constructor(fileCanonicalizer: Canonicalizer<ArkFile>);
+    getGraphName(): string;
+    /**
+     * Add a file node to the graph.
+     * The node's NodeID directly uses the ID assigned by the Canonicalizer.
+     */
+    addFile(file: ArkFile): void;
+    /**
+     * Add a dependency edge: src depends on dst (src -> dst).
+     * succMap stores successors (dependency targets), predMap stores predecessors (dependents).
+     */
+    addDependencyEdge(srcId: NodeID, dstId: NodeID): void;
+    /**
+     * Remove a dependency edge.
+     */
+    removeDependencyEdge(srcId: NodeID, dstId: NodeID): void;
+    /**
+     * Remove a node ID from an adjacency list entry.
+     */
+    private removeFromAdjacencyList;
+    /**
+     * Get all successor (dependency target) file IDs of the specified file.
+     */
+    getSuccFileIds(fileId: NodeID): NodeID[];
+    /**
+     * Get all predecessor (dependent) file IDs of the specified file.
+     */
+    getPredFileIds(fileId: NodeID): NodeID[];
+    /**
+     * Check whether a dependency edge exists between two files.
+     */
+    hasDependencyEdge(srcId: NodeID, dstId: NodeID): boolean;
+    /**
+     * Get the total number of edges in the graph.
+     */
+    getEdgeCount(): number;
+    /**
+     * Get the topological order produced by the last computeTopoOrder call.
+     * Depended-on files appear before their dependents.
+     */
+    getTopoOrder(): NodeID[];
+    /**
+     * Compute the topological order of all files using SCCDetection.
+     * Each SCC representative in the topological stack is expanded to its members,
+     * so every node appears exactly once. The result is stored in topoOrder and returned.
+     * Depended-on files appear before their dependents.
+     */
+    computeTopoOrder(): NodeID[];
+}
+//# sourceMappingURL=FileDepGraph.d.ts.map

package/lib/core/graph/FileDepGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileDepGraph.d.ts","sourceRoot":"","sources":["../../../src/core/graph/FileDepGraph.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,SAAQ,iBAAiB,CAAC,OAAO,CAAC;IACxD;;OAEG;IACH,OAAO,CAAC,iBAAiB,CAAyB;IAElD;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAgB;gBAErB,iBAAiB,EAAE,aAAa,CAAC,OAAO,CAAC;IAS9C,YAAY,IAAI,MAAM;IAI7B;;;OAGG;IACI,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAcnC;;;OAGG;IACI,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAsB5D;;OAEG;IACI,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAK/D;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;OAEG;IACI,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAI/C;;OAEG;IACI,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAI/C;;OAEG;IACI,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAK/D;;OAEG;IACI,YAAY,IAAI,MAAM;IAQ7B;;;OAGG;IACI,YAAY,IAAI,MAAM,EAAE;IAI/B;;;;;OAKG;IACI,gBAAgB,IAAI,MAAM,EAAE;CAoBtC"}