@ng-doc/builder 17.6.16 → 18.0.0-beta.2

package/engine/core/triggers/on-keywords-touch.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onKeywordsTouch = onKeywordsTouch;
+exports.touchKeywords = touchKeywords;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const variables_1 = require("../variables");
+const KEYWORDS_CHANGE = new rxjs_1.Subject();
+/**
+ *
+ * @param {...any} keywords
+ * @param include
+ * @param exclude
+ */
+function onKeywordsTouch(include, exclude = () => false) {
+    return KEYWORDS_CHANGE.pipe((0, operators_1.filter)((changedKeywords) => {
+        return !(0, variables_1.isColdStart)() && changedKeywords.some((c) => !exclude(c) && include(c));
+    }), (0, operators_1.map)(() => void 0));
+}
+/**
+ *
+ * @param {...any} keywords
+ */
+function touchKeywords(...keywords) {
+    KEYWORDS_CHANGE.next(keywords);
+}
+//# sourceMappingURL=on-keywords-touch.js.map

package/engine/core/triggers/on-keywords-touch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-keywords-touch.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/triggers/on-keywords-touch.ts"],"names":[],"mappings":";;AAaA,0CAUC;AAMD,sCAEC;AA/BD,+BAA2C;AAC3C,8CAA6C;AAE7C,4CAA2C;AAE3C,MAAM,eAAe,GAAG,IAAI,cAAO,EAAY,CAAC;AAEhD;;;;;GAKG;AACH,SAAgB,eAAe,CAC7B,OAAiC,EACjC,UAAoC,GAAG,EAAE,CAAC,KAAK;IAE/C,OAAO,eAAe,CAAC,IAAI,CACzB,IAAA,kBAAM,EAAC,CAAC,eAAe,EAAE,EAAE;QACzB,OAAO,CAAC,IAAA,uBAAW,GAAE,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC,EACF,IAAA,eAAG,EAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAClB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,GAAG,QAAkB;IACjD,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC"}

package/engine/core/triggers/on-remove-from-store.d.ts

@@ -0,0 +1,11 @@
+import { Observable } from 'rxjs';
+/**
+ *
+ * @param store
+ * @param store.changes
+ * @param store.size
+ */
+export declare function onRemoveFromStore(store: {
+    changes: () => Observable<unknown>;
+    size: number;
+}): Observable<void>;

package/engine/core/triggers/on-remove-from-store.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onRemoveFromStore = onRemoveFromStore;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+/**
+ *
+ * @param store
+ * @param store.changes
+ * @param store.size
+ */
+function onRemoveFromStore(store) {
+    return store.changes().pipe((0, operators_1.map)(() => store.size), (0, rxjs_1.pairwise)(), (0, operators_1.map)(([prev, next]) => prev > next), (0, operators_1.filter)(Boolean), (0, operators_1.map)(() => void 0), (0, rxjs_1.subscribeOn)(rxjs_1.asyncScheduler));
+}
+//# sourceMappingURL=on-remove-from-store.js.map

package/engine/core/triggers/on-remove-from-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-remove-from-store.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/triggers/on-remove-from-store.ts"],"names":[],"mappings":";;AASA,8CAYC;AArBD,+BAAyE;AACzE,8CAA6C;AAE7C;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,KAGjC;IACC,OAAO,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,CACzB,IAAA,eAAG,EAAC,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EACrB,IAAA,eAAQ,GAAE,EACV,IAAA,eAAG,EAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,EAClC,IAAA,kBAAM,EAAC,OAAO,CAAC,EACf,IAAA,eAAG,EAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EACjB,IAAA,kBAAW,EAAC,qBAAc,CAAC,CAC5B,CAAC;AACJ,CAAC"}

package/engine/core/types/builder.d.ts

@@ -0,0 +1,3 @@
+import { Observable } from 'rxjs';
+import { BuilderState } from './state';
+export type Builder<T> = Observable<BuilderState<T>>;

package/{interfaces/build-result.js → engine/core/types/builder.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=build-result.js.map
+//# sourceMappingURL=builder.js.map

package/engine/core/types/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/types/builder.ts"],"names":[],"mappings":""}

package/engine/core/types/cache-strategy.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cache strategy
+ * `skip` strategy will skip the builder if cache is valid
+ * `restore` strategy will restore the data from cache and return the result
+ */
+export type CacheStrategy<TData = unknown, TCache = unknown> = {
+    /**
+     * Unique id for cache
+     */
+    id: string;
+    /**
+     * Should return file paths that should be checked for changes
+     */
+    files?: () => string[];
+    /**
+     * Function to save custom data to cache
+     */
+    getData?: () => TData;
+    /**
+     * Callback that will be called when cache is loaded and valid
+     */
+    onCacheLoad?: (data: TData) => void;
+} & ({
+    action: 'skip';
+} | {
+    action: 'restore';
+    toCache: (result: TCache) => string;
+    fromCache: (result: string) => TCache;
+});

package/engine/core/types/cache-strategy.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cache-strategy.js.map

package/engine/core/types/cache-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-strategy.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/types/cache-strategy.ts"],"names":[],"mappings":""}

package/engine/core/types/file-output.d.ts

@@ -0,0 +1,10 @@
+export interface FileOutput {
+    filePath: string;
+    content: string;
+}
+export type AsyncFileOutput = () => Promise<FileOutput>;
+/**
+ *
+ * @param obj
+ */
+export declare function isFileOutput(obj: any): obj is FileOutput;

package/engine/core/types/file-output.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isFileOutput = isFileOutput;
+/**
+ *
+ * @param obj
+ */
+function isFileOutput(obj) {
+    return obj && typeof obj.filePath === 'string' && typeof obj.content === 'string';
+}
+//# sourceMappingURL=file-output.js.map

package/engine/core/types/file-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-output.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/types/file-output.ts"],"names":[],"mappings":";;AAWA,oCAEC;AAND;;;GAGG;AACH,SAAgB,YAAY,CAAC,GAAQ;IACnC,OAAO,GAAG,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC;AACpF,CAAC"}

package/engine/core/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from './builder';
+export * from './cache-strategy';
+export * from './file-output';
+export * from './state';
+export * from './trigger';

package/engine/core/types/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./builder"), exports);
+tslib_1.__exportStar(require("./cache-strategy"), exports);
+tslib_1.__exportStar(require("./file-output"), exports);
+tslib_1.__exportStar(require("./state"), exports);
+tslib_1.__exportStar(require("./trigger"), exports);
+//# sourceMappingURL=index.js.map

package/engine/core/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/types/index.ts"],"names":[],"mappings":";;;AAAA,oDAA0B;AAC1B,2DAAiC;AACjC,wDAA8B;AAC9B,kDAAwB;AACxB,oDAA0B"}

package/engine/core/types/state.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Represents a pending state in the builder process.
+ * This class is used when the builder is still in progress and the result is not yet available.
+ */
+export declare class BuilderPending {
+    readonly tag: string;
+    readonly state: 'pending';
+    constructor(tag: string);
+}
+/**
+ * Represents a done state in the builder process.
+ * This class is used when the builder has finished and the result is available.
+ * @template T The type of the result.
+ */
+export declare class BuilderDone<TResult> {
+    readonly tag: string;
+    readonly result: TResult;
+    readonly fromCache: boolean;
+    readonly afterEmit?: (() => void) | undefined;
+    readonly state: 'done';
+    /**
+     * Creates a new instance of the BuilderDone class.
+     * @param tag
+     * @param {T} result The result of the builder process.
+     * @param fromCache Whether the result was restored from the cache.
+     * @param afterEmit A function to execute after the result has been emitted.
+     */
+    constructor(tag: string, result: TResult, fromCache?: boolean, afterEmit?: (() => void) | undefined);
+}
+/**
+ * Represents an error state in the builder process.
+ * This class is used when the builder has encountered an error.
+ */
+export declare class BuilderError {
+    readonly tag: string;
+    readonly error: Error[];
+    readonly state: 'error';
+    /**
+     * Creates a new instance of the BuilderError class.
+     * @param tag
+     * @param {Error[]} error The errors encountered during the builder process.
+     */
+    constructor(tag: string, error: Error[]);
+}
+/**
+ * Represents the state of a builder. It can be one of the following:
+ * - BuilderPending: The builder is still in progress and the result is not yet available.
+ * - BuilderDone: The builder has finished and the result is available.
+ * - BuilderError: The builder has encountered an error.
+ * @template T The type of the result when the builder is done.
+ */
+export type BuilderState<T = never> = BuilderPending | BuilderDone<T> | BuilderError;
+export type EndStates<T = never> = BuilderDone<T> | BuilderError;
+export type BuilderStateTuple<T> = {
+    [K in keyof T]: T[K] extends BuilderState<infer R> ? R : never;
+};
+/**
+ * Type guard function to check if a given state is a BuilderPending state.
+ * @param {BuilderState<T>} state - The state to check.
+ * @returns {boolean} - Returns true if the state is a BuilderPending state, false otherwise.
+ */
+export declare function isBuilderPending<T>(state: BuilderState<T>): state is BuilderPending;
+/**
+ * Type guard function to check if a given state is a BuilderDone state.
+ * @param {BuilderState<T>} state - The state to check.
+ * @returns {boolean} - Returns true if the state is a BuilderDone state, false otherwise.
+ */
+export declare function isBuilderDone<T>(state: BuilderState<T>): state is BuilderDone<T>;
+/**
+ * Type guard function to check if a given state is a BuilderError state.
+ * @param {BuilderState<T>} state - The state to check.
+ * @returns {boolean} - Returns true if the state is a BuilderError state, false otherwise.
+ */
+export declare function isBuilderError<T>(state: BuilderState<T>): state is BuilderError;

package/engine/core/types/state.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BuilderError = exports.BuilderDone = exports.BuilderPending = void 0;
+exports.isBuilderPending = isBuilderPending;
+exports.isBuilderDone = isBuilderDone;
+exports.isBuilderError = isBuilderError;
+/**
+ * Represents a pending state in the builder process.
+ * This class is used when the builder is still in progress and the result is not yet available.
+ */
+class BuilderPending {
+    constructor(tag) {
+        this.tag = tag;
+        this.state = 'pending';
+    }
+}
+exports.BuilderPending = BuilderPending;
+/**
+ * Represents a done state in the builder process.
+ * This class is used when the builder has finished and the result is available.
+ * @template T The type of the result.
+ */
+class BuilderDone {
+    /**
+     * Creates a new instance of the BuilderDone class.
+     * @param tag
+     * @param {T} result The result of the builder process.
+     * @param fromCache Whether the result was restored from the cache.
+     * @param afterEmit A function to execute after the result has been emitted.
+     */
+    constructor(tag, result, fromCache = false, afterEmit) {
+        this.tag = tag;
+        this.result = result;
+        this.fromCache = fromCache;
+        this.afterEmit = afterEmit;
+        this.state = 'done';
+    }
+}
+exports.BuilderDone = BuilderDone;
+/**
+ * Represents an error state in the builder process.
+ * This class is used when the builder has encountered an error.
+ */
+class BuilderError {
+    /**
+     * Creates a new instance of the BuilderError class.
+     * @param tag
+     * @param {Error[]} error The errors encountered during the builder process.
+     */
+    constructor(tag, error) {
+        this.tag = tag;
+        this.error = error;
+        this.state = 'error';
+    }
+}
+exports.BuilderError = BuilderError;
+/**
+ * Type guard function to check if a given state is a BuilderPending state.
+ * @param {BuilderState<T>} state - The state to check.
+ * @returns {boolean} - Returns true if the state is a BuilderPending state, false otherwise.
+ */
+function isBuilderPending(state) {
+    return state instanceof BuilderPending;
+}
+/**
+ * Type guard function to check if a given state is a BuilderDone state.
+ * @param {BuilderState<T>} state - The state to check.
+ * @returns {boolean} - Returns true if the state is a BuilderDone state, false otherwise.
+ */
+function isBuilderDone(state) {
+    return state instanceof BuilderDone;
+}
+/**
+ * Type guard function to check if a given state is a BuilderError state.
+ * @param {BuilderState<T>} state - The state to check.
+ * @returns {boolean} - Returns true if the state is a BuilderError state, false otherwise.
+ */
+function isBuilderError(state) {
+    return state instanceof BuilderError;
+}
+//# sourceMappingURL=state.js.map

package/engine/core/types/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/types/state.ts"],"names":[],"mappings":";;;AAsEA,4CAEC;AAOD,sCAEC;AAOD,wCAEC;AA1FD;;;GAGG;AACH,MAAa,cAAc;IAGzB,YAAqB,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;QAFvB,UAAK,GAAc,SAAkB,CAAC;IAEZ,CAAC;CACrC;AAJD,wCAIC;AAED;;;;GAIG;AACH,MAAa,WAAW;IAGtB;;;;;;OAMG;IACH,YACW,GAAW,EACX,MAAe,EACf,YAAqB,KAAK,EAC1B,SAAsB;QAHtB,QAAG,GAAH,GAAG,CAAQ;QACX,WAAM,GAAN,MAAM,CAAS;QACf,cAAS,GAAT,SAAS,CAAiB;QAC1B,cAAS,GAAT,SAAS,CAAa;QAbxB,UAAK,GAAW,MAAe,CAAC;IActC,CAAC;CACL;AAhBD,kCAgBC;AAED;;;GAGG;AACH,MAAa,YAAY;IAGvB;;;;OAIG;IACH,YACW,GAAW,EACX,KAAc;QADd,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAS;QAThB,UAAK,GAAY,OAAgB,CAAC;IAUxC,CAAC;CACL;AAZD,oCAYC;AAgBD;;;;GAIG;AACH,SAAgB,gBAAgB,CAAI,KAAsB;IACxD,OAAO,KAAK,YAAY,cAAc,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAI,KAAsB;IACrD,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAI,KAAsB;IACtD,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC"}

package/engine/core/types/trigger.d.ts

@@ -0,0 +1,30 @@
+import { Observable } from 'rxjs';
+export interface MainTrigger {
+    type: 'main';
+    trigger: Observable<unknown>;
+}
+export interface SecondaryTrigger {
+    type: 'secondary';
+    trigger: Observable<unknown>;
+}
+export type Trigger = MainTrigger | SecondaryTrigger;
+/**
+ *
+ * @param trigger
+ */
+export declare function isMainTrigger(trigger: Trigger): trigger is MainTrigger;
+/**
+ *
+ * @param trigger
+ */
+export declare function isSecondaryTrigger(trigger: Trigger): trigger is SecondaryTrigger;
+/**
+ *
+ * @param {...any} triggers
+ */
+export declare function createMainTrigger(...triggers: Array<Observable<unknown>>): MainTrigger;
+/**
+ *
+ * @param {...any} triggers
+ */
+export declare function createSecondaryTrigger(...triggers: Array<Observable<unknown>>): SecondaryTrigger;

package/engine/core/types/trigger.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMainTrigger = isMainTrigger;
+exports.isSecondaryTrigger = isSecondaryTrigger;
+exports.createMainTrigger = createMainTrigger;
+exports.createSecondaryTrigger = createSecondaryTrigger;
+const rxjs_1 = require("rxjs");
+/**
+ *
+ * @param trigger
+ */
+function isMainTrigger(trigger) {
+    return trigger.type === 'main';
+}
+/**
+ *
+ * @param trigger
+ */
+function isSecondaryTrigger(trigger) {
+    return trigger.type === 'secondary';
+}
+/**
+ *
+ * @param {...any} triggers
+ */
+function createMainTrigger(...triggers) {
+    return { type: 'main', trigger: (0, rxjs_1.merge)(...triggers) };
+}
+/**
+ *
+ * @param {...any} triggers
+ */
+function createSecondaryTrigger(...triggers) {
+    return { type: 'secondary', trigger: (0, rxjs_1.merge)(...triggers) };
+}
+//# sourceMappingURL=trigger.js.map

package/engine/core/types/trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/types/trigger.ts"],"names":[],"mappings":";;AAkBA,sCAEC;AAMD,gDAEC;AAMD,8CAEC;AAMD,wDAEC;AA5CD,+BAAyC;AAczC;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAgB;IAC5C,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,OAAgB;IACjD,OAAO,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,GAAG,QAAoC;IACvE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAA,YAAK,EAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,GAAG,QAAoC;IAC5E,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAA,YAAK,EAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/engine/core/variables/cold-start.d.ts

@@ -0,0 +1,8 @@
+/**
+ *
+ */
+export declare function setColdStartFalse(): void;
+/**
+ *
+ */
+export declare function isColdStart(): boolean;

package/engine/core/variables/cold-start.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setColdStartFalse = setColdStartFalse;
+exports.isColdStart = isColdStart;
+let IS_COLD_START = true;
+/**
+ *
+ */
+function setColdStartFalse() {
+    IS_COLD_START = false;
+}
+/**
+ *
+ */
+function isColdStart() {
+    return IS_COLD_START;
+}
+//# sourceMappingURL=cold-start.js.map

package/engine/core/variables/cold-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cold-start.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/variables/cold-start.ts"],"names":[],"mappings":";;AAKA,8CAEC;AAKD,kCAEC;AAdD,IAAI,aAAa,GAAG,IAAI,CAAC;AAEzB;;GAEG;AACH,SAAgB,iBAAiB;IAC/B,aAAa,GAAG,KAAK,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW;IACzB,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/engine/core/variables/index.d.ts

@@ -0,0 +1 @@
+export * from './cold-start';

package/engine/{entities/plugins/types → core/variables}/index.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./entity-plugin"), exports);
+tslib_1.__exportStar(require("./cold-start"), exports);
 //# sourceMappingURL=index.js.map

package/engine/core/variables/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/variables/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B"}

package/engine/core/watcher/index.d.ts

@@ -0,0 +1,2 @@
+export * from './watch-file';
+export * from './watch-folder';

package/engine/core/watcher/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./watch-file"), exports);
+tslib_1.__exportStar(require("./watch-folder"), exports);
+//# sourceMappingURL=index.js.map

package/engine/core/watcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/watcher/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,yDAA+B"}

package/engine/core/watcher/watch-file.d.ts

@@ -0,0 +1,9 @@
+import watcher from '@parcel/watcher';
+import { Observable } from 'rxjs';
+/**
+ * Function to watch a specific file for changes.
+ * @param {string} filePath - The path of the file to watch.
+ * @param type - The type of event to watch for.
+ * @returns {Observable<watcher.Event>} - An Observable that emits an event whenever the file changes.
+ */
+export declare function watchFile(filePath: string, type?: watcher.EventType | watcher.EventType[]): Observable<watcher.Event>;

package/engine/core/watcher/watch-file.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watchFile = watchFile;
+const tslib_1 = require("tslib");
+const core_1 = require("@ng-doc/core");
+const path_1 = tslib_1.__importDefault(require("path"));
+const operators_1 = require("rxjs/operators");
+const watch_1 = require("./watch");
+/**
+ * Function to watch a specific file for changes.
+ * @param {string} filePath - The path of the file to watch.
+ * @param type - The type of event to watch for.
+ * @returns {Observable<watcher.Event>} - An Observable that emits an event whenever the file changes.
+ */
+function watchFile(filePath, type) {
+    return (0, watch_1.watch)(filePath).pipe((0, operators_1.map)((events) => {
+        return events.find((event) => {
+            const isFolder = path_1.default.extname(event.path) === '';
+            if (event.type === type &&
+                isFolder &&
+                event.type === 'delete' &&
+                filePath.startsWith(event.path)) {
+                return true;
+            }
+            return event.path === filePath && (!type || (0, core_1.asArray)(type).includes(event.type));
+        });
+    }), (0, operators_1.filter)(core_1.isPresent));
+}
+//# sourceMappingURL=watch-file.js.map

package/engine/core/watcher/watch-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-file.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/watcher/watch-file.ts"],"names":[],"mappings":";;AAcA,8BAuBC;;AArCD,uCAAkD;AAElD,wDAAwB;AAExB,8CAA6C;AAE7C,mCAAgC;AAEhC;;;;;GAKG;AACH,SAAgB,SAAS,CACvB,QAAgB,EAChB,IAA8C;IAE9C,OAAO,IAAA,aAAK,EAAC,QAAQ,CAAC,CAAC,IAAI,CACzB,IAAA,eAAG,EAAC,CAAC,MAAM,EAAE,EAAE;QACb,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,cAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAEjD,IACE,KAAK,CAAC,IAAI,KAAK,IAAI;gBACnB,QAAQ;gBACR,KAAK,CAAC,IAAI,KAAK,QAAQ;gBACvB,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAC/B,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,EACF,IAAA,kBAAM,EAAC,gBAAS,CAAC,CAClB,CAAC;AACJ,CAAC"}

package/engine/core/watcher/watch-folder.d.ts

@@ -0,0 +1,8 @@
+import watcher from '@parcel/watcher';
+import { Observable } from 'rxjs';
+/**
+ *
+ * @param folderPath
+ * @param type
+ */
+export declare function watchFolder(folderPath: string, type?: watcher.EventType | watcher.EventType[]): Observable<watcher.Event[]>;

package/engine/core/watcher/watch-folder.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watchFolder = watchFolder;
+const core_1 = require("@ng-doc/core");
+const operators_1 = require("rxjs/operators");
+const watch_1 = require("./watch");
+/**
+ *
+ * @param folderPath
+ * @param type
+ */
+function watchFolder(folderPath, type) {
+    return (0, watch_1.watch)(folderPath, true).pipe((0, operators_1.map)((events) => {
+        /*
+         * Subscribe to changes in the directory containing the file.
+         * Filter out events for other files in the directory.
+         * It's necessary because @parcel/watcher doesn't support watching a single file.
+         */
+        if (type) {
+            const fileEvents = events.filter((event) => (0, core_1.asArray)(type).includes(event.type));
+            if (fileEvents.length) {
+                return fileEvents;
+            }
+        }
+        else {
+            return events;
+        }
+        return [];
+    }), (0, operators_1.filter)((events) => events.length > 0));
+}
+//# sourceMappingURL=watch-folder.js.map

package/engine/core/watcher/watch-folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-folder.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/watcher/watch-folder.ts"],"names":[],"mappings":";;AAYA,kCAyBC;AArCD,uCAAuC;AAGvC,8CAA6C;AAE7C,mCAAgC;AAEhC;;;;GAIG;AACH,SAAgB,WAAW,CACzB,UAAkB,EAClB,IAA8C;IAE9C,OAAO,IAAA,aAAK,EAAC,UAAU,EAAE,IAAI,CAAC,CAAC,IAAI,CACjC,IAAA,eAAG,EAAC,CAAC,MAAM,EAAE,EAAE;QACb;;;;WAIG;QACH,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAEhF,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;gBACtB,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,EACF,IAAA,kBAAM,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CACtC,CAAC;AACJ,CAAC"}

package/engine/core/watcher/watch.d.ts

@@ -0,0 +1,8 @@
+import * as watcher from '@parcel/watcher';
+import { Observable } from 'rxjs';
+/**
+ *
+ * @param path
+ * @param dir
+ */
+export declare function watch(path: string, dir?: boolean): Observable<watcher.Event[]>;

package/engine/core/watcher/watch.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.watch = watch;
+const tslib_1 = require("tslib");
+const builder_1 = require("@ng-doc/builder");
+const watcher = tslib_1.__importStar(require("@parcel/watcher"));
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+let WATCHER = null;
+/**
+ *
+ * @param path
+ * @param dir
+ */
+function watch(path, dir) {
+    if (!WATCHER) {
+        let unsubscribe = () => { };
+        WATCHER = new rxjs_1.Observable((subscriber) => {
+            watcher
+                .subscribe(builder_1.GLOBALS.workspaceRoot, (err, events) => {
+                if (err) {
+                    console.error(err);
+                    subscriber.error(err);
+                    return;
+                }
+                subscriber.next(events);
+            }, { ignore: ['node_modules'] })
+                .then((unsub) => (unsubscribe = unsub.unsubscribe));
+            return () => {
+                unsubscribe();
+                WATCHER = null;
+            };
+        }).pipe((0, operators_1.share)());
+    }
+    return WATCHER.pipe((0, operators_1.map)((events) => events.filter((event) => {
+        return dir ? event.path.startsWith(path) : event.path.endsWith(path);
+    })), (0, operators_1.filter)((events) => events.length > 0));
+}
+//# sourceMappingURL=watch.js.map

package/engine/core/watcher/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/watcher/watch.ts"],"names":[],"mappings":";;AAYA,sBAqCC;;AAjDD,6CAA0C;AAC1C,iEAA2C;AAC3C,+BAAkC;AAClC,8CAAoD;AAEpD,IAAI,OAAO,GAAuC,IAAI,CAAC;AAEvD;;;;GAIG;AACH,SAAgB,KAAK,CAAC,IAAY,EAAE,GAAa;IAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,WAAW,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QAE3B,OAAO,GAAG,IAAI,iBAAU,CAAkB,CAAC,UAAU,EAAE,EAAE;YACvD,OAAO;iBACJ,SAAS,CACR,iBAAO,CAAC,aAAa,EACrB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;gBACd,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACnB,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAEtB,OAAO;gBACT,CAAC;gBAED,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC,EACD,EAAE,MAAM,EAAE,CAAC,cAAc,CAAC,EAAE,CAC7B;iBACA,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;YAEtD,OAAO,GAAG,EAAE;gBACV,WAAW,EAAE,CAAC;gBACd,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAA,iBAAK,GAAE,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CACjB,IAAA,eAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CACb,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QACtB,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC,CAAC,CACH,EACD,IAAA,kBAAM,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CACtC,CAAC;AACJ,CAAC"}

package/engine/index.d.ts

@@ -1,9 +1,5 @@
-export * from './actions';
-export * from './build-ng-doc';
-export * from './builder-operators';
-export * from './entities';
-export * from './functions';
+export * from './builders';
+export * from './core';
 export * from './nunjucks';
-export * from './ts-doc-formatter';
 export * from './variables';
 export * from './watcher';

package/engine/index.js

@@ -1,13 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./actions"), exports);
-tslib_1.__exportStar(require("./build-ng-doc"), exports);
-tslib_1.__exportStar(require("./builder-operators"), exports);
-tslib_1.__exportStar(require("./entities"), exports);
-tslib_1.__exportStar(require("./functions"), exports);
+tslib_1.__exportStar(require("./builders"), exports);
+tslib_1.__exportStar(require("./core"), exports);
 tslib_1.__exportStar(require("./nunjucks"), exports);
-tslib_1.__exportStar(require("./ts-doc-formatter"), exports);
 tslib_1.__exportStar(require("./variables"), exports);
 tslib_1.__exportStar(require("./watcher"), exports);
 //# sourceMappingURL=index.js.map