@libs-ui/components-preview-text-data 0.2.357-2 → 0.2.357-21

package/preview-text-data.component.d.ts

@@ -30,6 +30,21 @@ export declare class LibsUiComponentsPreviewTextDataComponent implements OnInit,
     readonly langsChangeLabel: import("@angular/core").InputSignal<ILanguageOptions | undefined>;
     readonly editable: import("@angular/core").InputSignalWithTransform<boolean, boolean | undefined>;
     readonly hiddenAction: import("@angular/core").InputSignalWithTransform<boolean, boolean | undefined>;
+    /** Số dòng tối thiểu: nếu content ít dòng hơn sẽ tự bù dòng trống (xử lý 1 lần khi khởi tạo editor). Bỏ trống = không bù. */
+    readonly minLines: import("@angular/core").InputSignal<number | undefined>;
+    /** Số dòng tối đa: vượt quá editor sẽ giới hạn chiều cao và xuất hiện vùng cuộn (xử lý 1 lần khi khởi tạo editor). Bỏ trống = không giới hạn. */
+    readonly maxLines: import("@angular/core").InputSignal<number | undefined>;
+    /**
+     * Element container bên ngoài để editor tự tính chiều cao theo `min-height`/`max-height` (CSS) của nó.
+     * Khi truyền, editor đọc min/max-height của container, trừ phần header/toolbar phía trên, rồi snap
+     * chiều cao vùng cuộn về đúng bội số dòng (không cắt nửa dòng) + bật scroll khi vượt max.
+     * CẤM cấu hình đồng thời với `minLines`/`maxLines` (sẽ throw lỗi) — container tự quản lý min/max.
+     */
+    readonly containerElement: import("@angular/core").InputSignal<HTMLElement | undefined>;
+    /** z-index cho popover dropdown chọn ngôn ngữ. */
+    readonly zIndexPopover: import("@angular/core").InputSignal<number | undefined>;
+    /** Ẩn ô search trong dropdown chọn ngôn ngữ (danh sách ngôn ngữ ngắn thường không cần tìm kiếm). */
+    readonly hiddenSearchLang: import("@angular/core").InputSignalWithTransform<boolean, boolean | undefined>;
     readonly lintIgnorePatterns: import("@angular/core").InputSignalWithTransform<string[], string[] | undefined>;
     /**
      * Danh sách đối tượng/biến gợi ý khi gõ — giống IntelliSense trong IDE.
@@ -76,47 +91,17 @@ export declare class LibsUiComponentsPreviewTextDataComponent implements OnInit,
     private createLightTheme;
     private createBracketTheme;
     private createUpdateListener;
-    /**
-     * Tạo JavaScript linter với 2-pass detection:
-     * 1. Text-based scan cho trailing dot (parser thường đặt error node sai vị trí với pattern này)
-     * 2. syntaxTree cho các lỗi thực sự khác, bỏ qua vùng bị ảnh hưởng bởi trailing dot
-     */
+    /** JavaScript/TypeScript linter — pipeline trong `linters/js-linter.ts` (babel + trailing-dot + thiếu `;` + biến chưa khai báo). */
     createJsLinter(): Extension;
-    private buildJsErrorMessage;
-    /**
-     * Tạo JSON linter
-     * Sử dụng JSON.parse để validate
-     */
+    /** JSON linter — logic trong `linters/json-linter.ts`. */
     createJsonLinter(): Extension;
-    /**
-     * Tạo SQL linter
-     */
+    /** SQL linter — logic trong `linters/sql-linter.ts`. */
     createSqlLinter(): Extension;
-    private buildSqlErrorMessage;
-    private getTokenBefore;
-    /**
-     * Tạo Python linter dựa trên syntaxTree parse error — cùng approach với SQL linter.
-     * Phát hiện lỗi cú pháp mà CodeMirror Python parser đánh dấu là error node.
-     */
+    /** Python linter — logic trong `linters/python-linter.ts`. */
     createPythonLinter(): Extension;
-    private buildPythonErrorMessage;
-    /**
-     * Tạo CodeMirror extension cho custom completions từ danh sách input.
-     * Hỗ trợ 2 chế độ:
-     * 1. Gõ tên biến → gợi ý top-level items
-     * 2. Gõ `obj.` → gợi ý properties của obj
-     */
-    private buildCompletionExtension;
-    /**
-     * Tạo extension bảo mật gồm 2 layer:
-     * 1. Linter: highlight đỏ tại đúng vị trí match + emit outViolations
-     * 2. Transaction filter: chặn paste nếu nội dung paste chứa pattern cấm
-     */
-    private buildForbiddenExtension;
-    private escapeRegex;
     protected handlerCopy(): void;
     protected handlerLineWrap(): void;
     protected handlerSelectKey(data?: IEmitSelectKey): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<LibsUiComponentsPreviewTextDataComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<LibsUiComponentsPreviewTextDataComponent, "libs_ui-components-preview_text_data", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "langSelected": { "alias": "langSelected"; "required": true; "isSignal": true; }; "langsAccept": { "alias": "langsAccept"; "required": false; "isSignal": true; }; "langsChangeLabel": { "alias": "langsChangeLabel"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "hiddenAction": { "alias": "hiddenAction"; "required": false; "isSignal": true; }; "lintIgnorePatterns": { "alias": "lintIgnorePatterns"; "required": false; "isSignal": true; }; "completions": { "alias": "completions"; "required": false; "isSignal": true; }; "forbiddenPatterns": { "alias": "forbiddenPatterns"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; }, { "langSelected": "langSelectedChange"; "outChange": "outChange"; "syntaxErrors": "syntaxErrors"; "outViolations": "outViolations"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LibsUiComponentsPreviewTextDataComponent, "libs_ui-components-preview_text_data", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "langSelected": { "alias": "langSelected"; "required": true; "isSignal": true; }; "langsAccept": { "alias": "langsAccept"; "required": false; "isSignal": true; }; "langsChangeLabel": { "alias": "langsChangeLabel"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "hiddenAction": { "alias": "hiddenAction"; "required": false; "isSignal": true; }; "minLines": { "alias": "minLines"; "required": false; "isSignal": true; }; "maxLines": { "alias": "maxLines"; "required": false; "isSignal": true; }; "containerElement": { "alias": "containerElement"; "required": false; "isSignal": true; }; "zIndexPopover": { "alias": "zIndexPopover"; "required": false; "isSignal": true; }; "hiddenSearchLang": { "alias": "hiddenSearchLang"; "required": false; "isSignal": true; }; "lintIgnorePatterns": { "alias": "lintIgnorePatterns"; "required": false; "isSignal": true; }; "completions": { "alias": "completions"; "required": false; "isSignal": true; }; "forbiddenPatterns": { "alias": "forbiddenPatterns"; "required": false; "isSignal": true; }; "background": { "alias": "background"; "required": false; "isSignal": true; }; }, { "langSelected": "langSelectedChange"; "outChange": "outChange"; "syntaxErrors": "syntaxErrors"; "outViolations": "outViolations"; }, never, never, true, never>;
 }

package/preview-text-data.define.d.ts

@@ -20,6 +20,18 @@ export declare const languageRegistry: Record<string, I_LanguageRegistryItem>;
  * Chặn các API nguy hiểm: eval, network calls, storage, DOM injection...
  */
 export declare const DEFAULT_SECURITY_PATTERNS: T_ForbiddenPattern[];
+/**
+ * Các key của AST node KHÔNG phải node con (metadata vị trí, comment...) — bỏ qua khi duyệt.
+ */
+export declare const astSkipKeys: Set<string>;
+/**
+ * Các key chứa annotation kiểu TypeScript → con của nó nằm trong "type context" (không phải biến giá trị).
+ */
+export declare const astTypeKeys: Set<string>;
+/**
+ * Các node `TS*` mang GIÁ TRỊ (không phải type thuần) → con của chúng vẫn là biến giá trị bình thường.
+ */
+export declare const tsValueNodes: Set<string>;
 /**
  * Tạo default language extension cho plain text
  * Sử dụng khi ngôn ngữ không được hỗ trợ

package/preview-text-data.type.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Type structural tối thiểu cho AST node của `@babel/parser` (plain object, browser-safe).
+ *
+ * KHÔNG dùng `@babel/traverse` để resolve scope vì nó phụ thuộc `process` của Node → crash trên
+ * browser (`ReferenceError: process is not defined`). Thay vào đó tự duyệt AST (chỉ là object
+ * thuần). Type này chỉ khai báo các thuộc tính được dùng trong bộ duyệt semantic linter; phần
+ * còn lại truy cập qua index signature.
+ */
+export type T_AstNode = {
+    type: string;
+    end?: number;
+    name?: string;
+    computed?: boolean;
+    id?: T_AstNode | null;
+    param?: T_AstNode | null;
+    parameter?: T_AstNode;
+    argument?: T_AstNode;
+    left?: T_AstNode;
+    value?: T_AstNode;
+    local?: {
+        name?: string;
+    };
+    params?: T_AstNode[];
+    properties?: T_AstNode[];
+    elements?: Array<T_AstNode | null>;
+    loc?: {
+        start: {
+            line: number;
+            column: number;
+        };
+    } | null;
+    [key: string]: unknown;
+};