@ng-doc/builder 21.0.5 → 22.0.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -32,12 +32,27 @@ function buildNgDoc(context) {
32
32
  (0, helpers_1.importUtils)(),
33
33
  (0, helpers_1.importEsm)('@angular/compiler'),
34
34
  ]).pipe((0, rxjs_1.switchMap)(() => (0, rxjs_1.merge)((0, builder_1.entriesEmitter)(context), (0, global_1.globalBuilders)(context))));
35
+ /**
36
+ * The pipeline emits every time the builder stack is empty, but on the initial build
37
+ * an empty stack does not guarantee that every entry page has been collected into the
38
+ * PageStore (entries can register late). Hold back the first emission until all
39
+ * discovered entries have resolved, so the very first build the application/dev-server
40
+ * builders consume is generated from a complete PageStore (see issue #322). Subsequent
41
+ * (watch) rebuilds are not gated.
42
+ */
43
+ let initialBuildComplete = false;
35
44
  return emitter.pipe((0, builder_1.printBuildProgress)(), (0, builder_1.whenStackIsEmpty)(), (0, resolve_async_file_outputs_1.resolveAsyncFileOutputs)(), (0, builder_1.emitFileOutput)(), (0, operators_1.tap)(() => {
36
45
  (0, builder_1.setColdStartFalse)();
37
46
  // console.log(
38
47
  // output.state,
39
48
  // isBuilderDone(output) ? output.result.filePath : output.error,
40
49
  // );
41
- }), (0, builder_1.printErrors)(), (0, operators_1.debounceTime)(100), (0, operators_1.map)(() => void 0), (0, builder_1.emitCache)(), (0, operators_2.progress)());
50
+ }), (0, builder_1.printErrors)(), (0, operators_1.filter)(() => {
51
+ if (initialBuildComplete) {
52
+ return true;
53
+ }
54
+ initialBuildComplete = (0, builder_1.allEntriesResolved)();
55
+ return initialBuildComplete;
56
+ }), (0, operators_1.debounceTime)(100), (0, operators_1.map)(() => void 0), (0, builder_1.emitCache)(), (0, operators_2.progress)());
42
57
  }
43
58
  //# sourceMappingURL=build-ng-doc.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"build-ng-doc.js","sourceRoot":"","sources":["../../../../libs/builder/engine/build-ng-doc.ts"],"names":[],"mappings":";;AA2BA,gCAsCC;;AAjED,6CAWyB;AACzB,oDAAoB;AACpB,+BAA8D;AAC9D,8CAAwD;AAExD,wCAAoD;AAEpD,4CAAwC;AACxC,8CAAmD;AACnD,mCAAkD;AAClD,4FAAsF;AAEtF;;;GAGG;AACH,SAAgB,UAAU,CAAC,OAA4B;IACrD,uBAAuB;IACvB,iBAAO,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;IAEtD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAA,sBAAY,GAAE,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,IAAA,+BAAuB,EAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5E,aAAa;IACf,CAAC;SAAM,CAAC;QACN,YAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,eAAQ,EAAC;QACvB,IAAA,4BAAkB,EAAC,OAAO,CAAC;QAC3B,IAAA,qBAAW,GAAE;QACb,IAAA,mBAAS,EAAC,mBAAmB,CAAC;KAC/B,CAAC,CAAC,IAAI,CAAC,IAAA,gBAAS,EAAC,GAAG,EAAE,CAAC,IAAA,YAAK,EAAC,IAAA,wBAAc,EAAC,OAAO,CAAC,EAAE,IAAA,uBAAc,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAElF,OAAO,OAAO,CAAC,IAAI,CACjB,IAAA,4BAAkB,GAAE,EACpB,IAAA,0BAAgB,GAAE,EAClB,IAAA,oDAAuB,GAAE,EACzB,IAAA,wBAAc,GAAE,EAChB,IAAA,eAAG,EAAC,GAAG,EAAE;QACP,IAAA,2BAAiB,GAAE,CAAC;QACpB,eAAe;QACf,kBAAkB;QAClB,mEAAmE;QACnE,KAAK;IACP,CAAC,CAAC,EACF,IAAA,qBAAW,GAAE,EACb,IAAA,wBAAY,EAAC,GAAG,CAAC,EACjB,IAAA,eAAG,EAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EACjB,IAAA,mBAAS,GAAE,EACX,IAAA,oBAAQ,GAAE,CACS,CAAC;AACxB,CAAC"}
1
+ {"version":3,"file":"build-ng-doc.js","sourceRoot":"","sources":["../../../../libs/builder/engine/build-ng-doc.ts"],"names":[],"mappings":";;AA4BA,gCAyDC;;AArFD,6CAYyB;AACzB,oDAAoB;AACpB,+BAA8D;AAC9D,8CAAgE;AAEhE,wCAAoD;AAEpD,4CAAwC;AACxC,8CAAmD;AACnD,mCAAkD;AAClD,4FAAsF;AAEtF;;;GAGG;AACH,SAAgB,UAAU,CAAC,OAA4B;IACrD,uBAAuB;IACvB,iBAAO,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;IAEtD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAA,sBAAY,GAAE,CAAC;IACjB,CAAC;IAED,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,IAAA,+BAAuB,EAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5E,aAAa;IACf,CAAC;SAAM,CAAC;QACN,YAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,OAAO,GAAG,IAAA,eAAQ,EAAC;QACvB,IAAA,4BAAkB,EAAC,OAAO,CAAC;QAC3B,IAAA,qBAAW,GAAE;QACb,IAAA,mBAAS,EAAC,mBAAmB,CAAC;KAC/B,CAAC,CAAC,IAAI,CAAC,IAAA,gBAAS,EAAC,GAAG,EAAE,CAAC,IAAA,YAAK,EAAC,IAAA,wBAAc,EAAC,OAAO,CAAC,EAAE,IAAA,uBAAc,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAElF;;;;;;;OAOG;IACH,IAAI,oBAAoB,GAAG,KAAK,CAAC;IAEjC,OAAO,OAAO,CAAC,IAAI,CACjB,IAAA,4BAAkB,GAAE,EACpB,IAAA,0BAAgB,GAAE,EAClB,IAAA,oDAAuB,GAAE,EACzB,IAAA,wBAAc,GAAE,EAChB,IAAA,eAAG,EAAC,GAAG,EAAE;QACP,IAAA,2BAAiB,GAAE,CAAC;QACpB,eAAe;QACf,kBAAkB;QAClB,mEAAmE;QACnE,KAAK;IACP,CAAC,CAAC,EACF,IAAA,qBAAW,GAAE,EACb,IAAA,kBAAM,EAAC,GAAG,EAAE;QACV,IAAI,oBAAoB,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oBAAoB,GAAG,IAAA,4BAAkB,GAAE,CAAC;QAE5C,OAAO,oBAAoB,CAAC;IAC9B,CAAC,CAAC,EACF,IAAA,wBAAY,EAAC,GAAG,CAAC,EACjB,IAAA,eAAG,EAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EACjB,IAAA,mBAAS,GAAE,EACX,IAAA,oBAAQ,GAAE,CACS,CAAC;AACxB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"create-import-path.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/create-import-path.ts"],"names":[],"mappings":";;AAUA,4CAKC;;AAfD,wDAAwB;AAExB,8CAAyC;AAEzC;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,UAAkB,EAAE,eAAuB;IAC3E,wFAAwF;IACxF,kIAAkI;IAClI,mDAAmD;IACnD,OAAO,IAAA,eAAK,EAAC,cAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC/E,CAAC"}
1
+ {"version":3,"file":"create-import-path.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/create-import-path.ts"],"names":[],"mappings":";;AAUA,4CAKC;;AAfD,wDAAwB;AAExB,8CAAyC;AAEzC;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,UAAkB,EAAE,eAAuB;IAC1E,wFAAwF;IACxF,kIAAkI;IAClI,mDAAmD;IACnD,OAAO,IAAA,eAAK,EAAC,cAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"get-entry-relative-path.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/get-entry-relative-path.ts"],"names":[],"mappings":";;AAKA,oDAQC;AAbD;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,SAAmB,EAAE,SAAiB;IAC1E,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAEtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,eAAe,SAAS,8BAA8B,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC"}
1
+ {"version":3,"file":"get-entry-relative-path.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/helpers/get-entry-relative-path.ts"],"names":[],"mappings":";;AAKA,oDAQC;AAbD;;;;GAIG;AACH,SAAgB,oBAAoB,CAAC,SAAmB,EAAE,SAAiB;IACzE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAEtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,eAAe,SAAS,8BAA8B,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
@@ -29,7 +29,19 @@ function entryBuilder(config) {
29
29
  core_1.PageStore.add([entryPath, metadata]);
30
30
  return metadata;
31
31
  }));
32
- return (0, core_1.createBuilder)([(0, core_1.createMainTrigger)((0, core_1.watchFile)(entryPath, 'update'), (0, core_1.onDependenciesChange)(dependencies))], () => builder).pipe((0, rxjs_1.finalize)(() => core_1.PageStore.delete(entryPath)), (0, rxjs_1.takeUntil)((0, core_1.watchFile)(entryPath, 'delete')));
32
+ return (0, core_1.createBuilder)([(0, core_1.createMainTrigger)((0, core_1.watchFile)(entryPath, 'update'), (0, core_1.onDependenciesChange)(dependencies))], () => builder).pipe((0, rxjs_1.tap)((state) => {
33
+ // Track whether this entry failed to build so the completion gate doesn't wait
34
+ // forever for a page that will never register (see issue #322).
35
+ if ((0, core_1.isBuilderError)(state)) {
36
+ core_1.FailedEntries.add(entryPath);
37
+ }
38
+ else if ((0, core_1.isBuilderDone)(state)) {
39
+ core_1.FailedEntries.delete(entryPath);
40
+ }
41
+ }), (0, rxjs_1.finalize)(() => {
42
+ core_1.PageStore.delete(entryPath);
43
+ core_1.FailedEntries.delete(entryPath);
44
+ }), (0, rxjs_1.takeUntil)((0, core_1.watchFile)(entryPath, 'delete')));
33
45
  }
34
46
  /**
35
47
  *
@@ -1 +1 @@
1
- {"version":3,"file":"entry.builder.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/shared/entry.builder.ts"],"names":[],"mappings":";;AAiCA,oCAoCC;AApED,+BAA+C;AAE/C,8CAAiD;AACjD,8CAAmE;AAEnE,qCAQoB;AACpB,wCAAiD;AASjD;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAC1B,MAAc;IAEd,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,IAAI,uBAAa,EAAU,CAAC;IAEjD,MAAM,OAAO,GAAG,IAAA,SAAE,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAC7B,IAAA,eAAQ,EAAC,GAAG,EAAE,KAAK,IAAI,EAAE;QACvB,YAAY,CAAC,KAAK,EAAE,CAAC;QAErB,MAAM,UAAU,CAAC,qBAAqB,EAAE,CAAC;QAEzC,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAe,EACnC,UAAU,EACV,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,OAAO,CAAC,aAAa,CAC9B,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,MAAM,IAAA,wBAAc,EAAiB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAA,6BAAmB,EAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAEhE,2BAA2B,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAEpD,gBAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAErC,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,IAAA,oBAAa,EAClB,CAAC,IAAA,wBAAiB,EAAC,IAAA,gBAAS,EAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,IAAA,2BAAoB,EAAC,YAAY,CAAC,CAAC,CAAC,EACvF,GAAG,EAAE,CAAC,OAAO,CACd,CAAC,IAAI,CACJ,IAAA,eAAQ,EAAC,GAAG,EAAE,CAAC,gBAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAC3C,IAAA,gBAAS,EAAC,IAAA,gBAAS,EAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAC1C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,2BAA2B,CAClC,QAAkC,EAClC,YAAmC;IAEnC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;QAE3D,2BAA2B,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"entry.builder.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/builders/shared/entry.builder.ts"],"names":[],"mappings":";;AAoCA,oCAgDC;AAnFD,+BAAoD;AAEpD,8CAAiD;AACjD,8CAAmE;AAEnE,qCAWoB;AACpB,wCAAiD;AASjD;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAC1B,MAAc;IAEd,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,IAAI,uBAAa,EAAU,CAAC;IAEjD,MAAM,OAAO,GAAG,IAAA,SAAE,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAC7B,IAAA,eAAQ,EAAC,GAAG,EAAE,KAAK,IAAI,EAAE;QACvB,YAAY,CAAC,KAAK,EAAE,CAAC;QAErB,MAAM,UAAU,CAAC,qBAAqB,EAAE,CAAC;QAEzC,MAAM,OAAO,GAAG,MAAM,IAAA,yBAAe,EACnC,UAAU,EACV,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,OAAO,CAAC,aAAa,CAC9B,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,MAAM,IAAA,wBAAc,EAAiB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACrE,MAAM,QAAQ,GAAG,IAAA,6BAAmB,EAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAEhE,2BAA2B,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAEpD,gBAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAErC,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,IAAA,oBAAa,EAClB,CAAC,IAAA,wBAAiB,EAAC,IAAA,gBAAS,EAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,IAAA,2BAAoB,EAAC,YAAY,CAAC,CAAC,CAAC,EACvF,GAAG,EAAE,CAAC,OAAO,CACd,CAAC,IAAI,CACJ,IAAA,UAAG,EAAC,CAAC,KAAK,EAAE,EAAE;QACZ,+EAA+E;QAC/E,gEAAgE;QAChE,IAAI,IAAA,qBAAc,EAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,oBAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,CAAC;aAAM,IAAI,IAAA,oBAAa,EAAC,KAAK,CAAC,EAAE,CAAC;YAChC,oBAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC,EACF,IAAA,eAAQ,EAAC,GAAG,EAAE;QACZ,gBAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC5B,oBAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC,CAAC,EACF,IAAA,gBAAS,EAAC,IAAA,gBAAS,EAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAC1C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,2BAA2B,CAClC,QAAkC,EAClC,YAAmC;IAEnC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;QAE3D,2BAA2B,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"distinct-pending.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/distinct-pending.ts"],"names":[],"mappings":";;AAOA,0CAGC;AAVD,+BAA8D;AAE9D,oCAA0D;AAE1D;;GAEG;AACH,SAAgB,eAAe;IAC9B,OAAO,CAAC,MAAM,EAAE,EAAE,CACjB,MAAM,CAAC,IAAI,CAAC,IAAA,2BAAoB,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,IAAI,IAAA,wBAAgB,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1F,CAAC"}
1
+ {"version":3,"file":"distinct-pending.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/distinct-pending.ts"],"names":[],"mappings":";;AAOA,0CAGC;AAVD,+BAA8D;AAE9D,oCAA0D;AAE1D;;GAEG;AACH,SAAgB,eAAe;IAC7B,OAAO,CAAC,MAAM,EAAE,EAAE,CAChB,MAAM,CAAC,IAAI,CAAC,IAAA,2BAAoB,EAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,IAAI,IAAA,wBAAgB,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5F,CAAC"}
@@ -12,6 +12,7 @@ const helpers_1 = require("../../../helpers");
12
12
  const builders_1 = require("../../builders");
13
13
  const api_list_1 = require("../../builders/api-list");
14
14
  const variables_1 = require("../../variables");
15
+ const stores_1 = require("../stores");
15
16
  const watcher_1 = require("../watcher");
16
17
  /**
17
18
  *
@@ -24,11 +25,14 @@ function entriesEmitter(context) {
24
25
  ]);
25
26
  return (0, watcher_1.watchFolder)(context.docsPath, 'create').pipe((0, operators_1.map)((events) => events.map((event) => event.path)), (0, operators_1.startWith)(entries), (0, operators_1.map)((events) => events
26
27
  .map((filePath) => {
28
+ const entryPath = path_1.default.resolve(filePath);
27
29
  if ((0, minimatch_1.minimatch)(filePath, variables_1.PAGE_PATTERN, { dot: true })) {
28
- return (0, builders_1.pageBuilder)(context, path_1.default.resolve(filePath));
30
+ stores_1.ExpectedEntries.add(entryPath);
31
+ return (0, builders_1.pageBuilder)(context, entryPath);
29
32
  }
30
33
  if ((0, minimatch_1.minimatch)(filePath, variables_1.API_PATTERN, { dot: true })) {
31
- return (0, api_list_1.apiBuilder)(context, path_1.default.resolve(filePath));
34
+ stores_1.ExpectedEntries.add(entryPath);
35
+ return (0, api_list_1.apiBuilder)(context, entryPath);
32
36
  }
33
37
  return null;
34
38
  })
@@ -1 +1 @@
1
- {"version":3,"file":"entries-emitter.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/entries-emitter.ts"],"names":[],"mappings":";;AAmBA,wCA6BC;;AAhDD,uCAAyC;AACzC,yCAAiC;AACjC,yCAAsC;AACtC,wDAAwB;AACxB,+BAAmD;AACnD,8CAAwD;AAExD,8CAAyC;AAEzC,6CAA6C;AAC7C,sDAAqD;AACrD,+CAA4D;AAE5D,wCAAyC;AAEzC;;;GAGG;AACH,SAAgB,cAAc,CAC5B,OAA4B;IAE5B,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC;QACnB,IAAA,eAAK,EAAC,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAY,CAAC,CAAC;QAChD,IAAA,eAAK,EAAC,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,uBAAW,CAAC,CAAC;KAChD,CAAC,CAAC;IAEH,OAAO,IAAA,qBAAW,EAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,CACjD,IAAA,eAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAClD,IAAA,qBAAS,EAAC,OAAO,CAAC,EAClB,IAAA,eAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CACb,MAAM;SACH,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAChB,IAAI,IAAA,qBAAS,EAAC,QAAQ,EAAE,wBAAY,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACrD,OAAO,IAAA,sBAAW,EAAC,OAAO,EAAE,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,IAAA,qBAAS,EAAC,QAAQ,EAAE,uBAAW,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACpD,OAAO,IAAA,qBAAU,EAAC,OAAO,EAAE,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,MAAM,CAAC,gBAAS,CAAC,CACrB,EACD,IAAA,kBAAM,EAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EACzC,IAAA,eAAQ,EAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAA,YAAK,EAAC,GAAG,QAAQ,CAAC,CAAC,CAC3C,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"entries-emitter.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/entries-emitter.ts"],"names":[],"mappings":";;AAoBA,wCAmCC;;AAvDD,uCAAyC;AACzC,yCAAiC;AACjC,yCAAsC;AACtC,wDAAwB;AACxB,+BAAmD;AACnD,8CAAwD;AAExD,8CAAyC;AAEzC,6CAA6C;AAC7C,sDAAqD;AACrD,+CAA4D;AAC5D,sCAA4C;AAE5C,wCAAyC;AAEzC;;;GAGG;AACH,SAAgB,cAAc,CAC5B,OAA4B;IAE5B,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC;QACnB,IAAA,eAAK,EAAC,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,wBAAY,CAAC,CAAC;QAChD,IAAA,eAAK,EAAC,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,uBAAW,CAAC,CAAC;KAChD,CAAC,CAAC;IAEH,OAAO,IAAA,qBAAW,EAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,CACjD,IAAA,eAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAClD,IAAA,qBAAS,EAAC,OAAO,CAAC,EAClB,IAAA,eAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CACb,MAAM;SACH,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAChB,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAEzC,IAAI,IAAA,qBAAS,EAAC,QAAQ,EAAE,wBAAY,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACrD,wBAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAE/B,OAAO,IAAA,sBAAW,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,IAAA,qBAAS,EAAC,QAAQ,EAAE,uBAAW,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YACpD,wBAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAE/B,OAAO,IAAA,qBAAU,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,MAAM,CAAC,gBAAS,CAAC,CACrB,EACD,IAAA,kBAAM,EAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EACzC,IAAA,eAAQ,EAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAA,YAAK,EAAC,GAAG,QAAQ,CAAC,CAAC,CAC3C,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"when-builders-done.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/when-builders-done.ts"],"names":[],"mappings":";;AAUA,4CASC;AAnBD,+BAAqD;AAErD,oCAAqD;AAErD;;;;;GAKG;AACH,SAAgB,gBAAgB;IAC/B,OAAO,CAAC,MAAM,EAAE,EAAE;QACjB,OAAO,MAAM,CAAC,IAAI;QACjB,uCAAuC;QACvC,IAAA,aAAM,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,mBAAW,CAAC,CAAC;QACzE,wCAAwC;QACxC,IAAA,UAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CAAE,MAAgC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAC/E,CAAC;IACH,CAAC,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"when-builders-done.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/operators/when-builders-done.ts"],"names":[],"mappings":";;AAUA,4CASC;AAnBD,+BAAqD;AAErD,oCAAqD;AAErD;;;;;GAKG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,OAAO,MAAM,CAAC,IAAI;QAChB,uCAAuC;QACvC,IAAA,aAAM,EAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,mBAAW,CAAC,CAAC;QACzE,wCAAwC;QACxC,IAAA,UAAG,EAAC,CAAC,MAAM,EAAE,EAAE,CAAE,MAAgC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAChF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Set of resolved entry file paths (pages and API files) discovered when the build
3
+ * starts. Populated by the entries emitter as it creates a builder for each entry.
4
+ */
5
+ export declare const ExpectedEntries: Set<string>;
6
+ /**
7
+ * Set of entry file paths whose build ended in an error. Such entries never register
8
+ * a page in the {@link PageStore}, so the completion gate must treat them as resolved
9
+ * to avoid waiting forever.
10
+ */
11
+ export declare const FailedEntries: Set<string>;
12
+ /**
13
+ * Returns `true` once every entry discovered at build start has either registered its
14
+ * page in the {@link PageStore} or failed to build.
15
+ *
16
+ * The build pipeline declares itself "done" the first time the global builder stack is
17
+ * empty. However, entry pages can register in the `PageStore` late (e.g. on a cold
18
+ * build the guide pages are processed after a large API), so an empty stack does not
19
+ * guarantee that every page has been collected. Gating completion on this check
20
+ * prevents `routes.ts`/`context.ts` from being generated from a partially-populated
21
+ * `PageStore` (see issue #322).
22
+ */
23
+ export declare function allEntriesResolved(): boolean;
@@ -0,0 +1,36 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.FailedEntries = exports.ExpectedEntries = void 0;
4
+ exports.allEntriesResolved = allEntriesResolved;
5
+ const page_store_1 = require("./page-store");
6
+ /**
7
+ * Set of resolved entry file paths (pages and API files) discovered when the build
8
+ * starts. Populated by the entries emitter as it creates a builder for each entry.
9
+ */
10
+ exports.ExpectedEntries = new Set();
11
+ /**
12
+ * Set of entry file paths whose build ended in an error. Such entries never register
13
+ * a page in the {@link PageStore}, so the completion gate must treat them as resolved
14
+ * to avoid waiting forever.
15
+ */
16
+ exports.FailedEntries = new Set();
17
+ /**
18
+ * Returns `true` once every entry discovered at build start has either registered its
19
+ * page in the {@link PageStore} or failed to build.
20
+ *
21
+ * The build pipeline declares itself "done" the first time the global builder stack is
22
+ * empty. However, entry pages can register in the `PageStore` late (e.g. on a cold
23
+ * build the guide pages are processed after a large API), so an empty stack does not
24
+ * guarantee that every page has been collected. Gating completion on this check
25
+ * prevents `routes.ts`/`context.ts` from being generated from a partially-populated
26
+ * `PageStore` (see issue #322).
27
+ */
28
+ function allEntriesResolved() {
29
+ for (const entryPath of exports.ExpectedEntries) {
30
+ if (page_store_1.PageStore.get(entryPath) === undefined && !exports.FailedEntries.has(entryPath)) {
31
+ return false;
32
+ }
33
+ }
34
+ return true;
35
+ }
36
+ //# sourceMappingURL=entry-status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"entry-status.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/stores/entry-status.ts"],"names":[],"mappings":";;;AA0BA,gDAQC;AAlCD,6CAAyC;AAEzC;;;GAGG;AACU,QAAA,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;AAEjD;;;;GAIG;AACU,QAAA,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,SAAgB,kBAAkB;IAChC,KAAK,MAAM,SAAS,IAAI,uBAAe,EAAE,CAAC;QACxC,IAAI,sBAAS,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,SAAS,IAAI,CAAC,qBAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5E,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -1,4 +1,5 @@
1
1
  export * from './api';
2
+ export * from './entry-status';
2
3
  export * from './index-store';
3
4
  export * from './keywords';
4
5
  export * from './page-store';
@@ -2,6 +2,7 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  const tslib_1 = require("tslib");
4
4
  tslib_1.__exportStar(require("./api"), exports);
5
+ tslib_1.__exportStar(require("./entry-status"), exports);
5
6
  tslib_1.__exportStar(require("./index-store"), exports);
6
7
  tslib_1.__exportStar(require("./keywords"), exports);
7
8
  tslib_1.__exportStar(require("./page-store"), exports);
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/stores/index.ts"],"names":[],"mappings":";;;AAAA,gDAAsB;AACtB,wDAA8B;AAC9B,qDAA2B;AAC3B,uDAA6B"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/builder/engine/core/stores/index.ts"],"names":[],"mappings":";;;AAAA,gDAAsB;AACtB,yDAA+B;AAC/B,wDAA8B;AAC9B,qDAA2B;AAC3B,uDAA6B"}
@@ -1 +1 @@
1
- {"version":3,"file":"import-fresh-esm.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/import-fresh-esm.ts"],"names":[],"mappings":";;AAaA,wCAcC;;AA3BD,+CAAyB;AACzB,mDAA6B;AAE7B,6CAAyC;AACzC,mCAAgC;AAEhC;;;;;;GAMG;AACI,KAAK,UAAU,cAAc,CAAI,UAAkB;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAE3E,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAS,EAAI,IAAA,aAAK,EAAC,WAAW,CAAC,CAAC,CAAC;IAEtD,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC;AACf,CAAC"}
1
+ {"version":3,"file":"import-fresh-esm.js","sourceRoot":"","sources":["../../../../libs/builder/helpers/import-fresh-esm.ts"],"names":[],"mappings":";;AAaA,wCAcC;;AA3BD,+CAAyB;AACzB,mDAA6B;AAE7B,6CAAyC;AACzC,mCAAgC;AAEhC;;;;;;GAMG;AACI,KAAK,UAAU,cAAc,CAAI,UAAkB;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IACzC,MAAM,WAAW,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IAE3E,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEtD,MAAM,MAAM,GAAG,MAAM,IAAA,sBAAS,EAAI,IAAA,aAAK,EAAC,WAAW,CAAC,CAAC,CAAC;IAEtD,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"get-property-assignment.js","sourceRoot":"","sources":["../../../../../../libs/builder/helpers/typescript/property/get-property-assignment.ts"],"names":[],"mappings":";;AAOA,sDAIC;AAXD,uCAA0D;AAE1D;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,wBAAmD;IACxF,OAAO,eAAI,CAAC,oBAAoB,CAAC,wBAAwB,CAAC;QACzD,CAAC,CAAC,wBAAwB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC7D,CAAC,CAAC,EAAE,CAAC;AACP,CAAC"}
1
+ {"version":3,"file":"get-property-assignment.js","sourceRoot":"","sources":["../../../../../../libs/builder/helpers/typescript/property/get-property-assignment.ts"],"names":[],"mappings":";;AAOA,sDAIC;AAXD,uCAA0D;AAE1D;;;;GAIG;AACH,SAAgB,qBAAqB,CAAC,wBAAmD;IACvF,OAAO,eAAI,CAAC,oBAAoB,CAAC,wBAAwB,CAAC;QACxD,CAAC,CAAC,wBAAwB,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;QAC7D,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ng-doc/builder",
3
- "version": "21.0.5",
3
+ "version": "22.0.0-beta.1",
4
4
  "type": "commonjs",
5
5
  "builders": "./builders.json",
6
6
  "schematics": "./schematics/collection.json",
@@ -11,8 +11,8 @@
11
11
  ]
12
12
  },
13
13
  "dependencies": {
14
- "@ng-doc/core": "21.0.5",
15
- "@ng-doc/utils": "21.0.5",
14
+ "@ng-doc/core": "22.0.0-beta.1",
15
+ "@ng-doc/utils": "22.0.0-beta.1",
16
16
  "@angular-devkit/architect": ">=0.2100.0 < 0.2200.0",
17
17
  "@angular-devkit/build-angular": ">=21.0.0 < 22.0.0",
18
18
  "minimatch": "9.0.1",