@ng-doc/builder 22.0.0 → 22.1.0

package/templates/page.ts.nunj

@@ -64,11 +64,20 @@ export class PageComponent extends NgDocRootPage {
     {%- if demoAssetsPath %}
   readonly demoAssets: NgDocDemoAssets = demoAssets;
     {%- endif %}
+    {#- The demo pages of the guide (Vite engine), and whether its demos are isolated by default. #}
+    {%- if demoRoute %}
+  readonly demoRoute: string = '{{ demoRoute | replace("\\", "\\\\") | replace("'", "\\'") | replace("\n", "\\n") }}';
+      {%- if isolatedDemos %}
+  readonly isolatedDemos: boolean = true;
+      {%- endif %}
+    {%- endif %}
 
   constructor() {
     super();
   }
 }
+{#- The route has no title of its own: it inherits the title of its tab route, so a page's own
+    `route.title` is the only title here and wins over the generated one. #}
 {%- if contentSourceImport %}
 
 // The router shows the page only once its content has loaded, so the previous page stays on
@@ -79,7 +88,6 @@ const routes: Routes = [ɵwithNgDocContent({
     {%- endif %}
   path: '',
   component: PageComponent,
-  title: `{{ metadata.title | toTemplateString }}`,
 }, pageContentSource)]
 {%- else %}
 
@@ -89,7 +97,6 @@ const routes: Routes = [{
     {%- endif %}
   path: '',
   component: PageComponent,
-  title: `{{ metadata.title | toTemplateString }}`,
 }]
 {%- endif %}
 

package/templates/routes.ts.nunj

@@ -20,9 +20,13 @@ export const NG_DOC_ROUTING: Routes = [
 	{
 		path: '{{ entry.item.route | replace("\\", "\\\\") | replace("'", "\\'") | replace("\n", "\\n") }}',
 		title: `{{ entry.item.title | toTemplateString }}`,
-    {%- if entry.item.apiListSegment is defined %}
-    data: {ngDocApiListSegment: '{{ entry.item.apiListSegment | replace("\\", "\\\\") | replace("'", "\\'") | replace("\n", "\\n") }}'},
-    {%- endif %}
+    {#- `ngDocTitle` names what the title belongs to, so a title strategy can compose the titles of
+        the route without repeating one (`provideNgDocTitle`). #}
+    data: {ngDocTitle: '{{ 'category' if entry.item.isCategory else 'page' }}'
+    {%- if entry.item.apiListSegment is defined -%}
+    , ngDocApiListSegment: '{{ entry.item.apiListSegment | replace("\\", "\\\\") | replace("'", "\\'") | replace("\n", "\\n") }}'
+    {%- endif -%}
+    },
     {%- if entry.item.isCategory %}
     providers: [
       ...({{ entry.item.id }}.providers ?? []),

package/templates/symbol/members.html.nunj

@@ -197,12 +197,14 @@
     </tr>
 {%- endmacro %}
 
-{% macro render(declaration) %}
+{#- `hideProtected` (the `api.protectedMembers: false` option) lists public class members only. #}
+{% macro render(declaration, hideProtected=false) %}
+    {%- set memberScopes = ["public"] if hideProtected else ["public", "protected"] -%}
     {%- if Node.isClassDeclaration(declaration) %}
         {%- set constructors = declaration.getConstructors() | filterByScope("public") | excludeByJsDocTags('internal') -%}
-        {%- set allProperties = declaration | getClassProperties | excludeByJsDocTags('internal') | filterByScope(["public", "protected"]) | filterUselessMembers | sortByNodesName -%}
-        {%- set allMethods = declaration | getClassMethods | excludeByJsDocTags('internal') | filterByScope(["public", "protected"]) | filterUselessMembers | sortByNodesName -%}
-        {%- set allAccessors = declaration | getClassAccessors | excludeByJsDocTags('internal') | filterByScope(["public", "protected"]) | filterUselessMembers | sortByNodesName -%}
+        {%- set allProperties = declaration | getClassProperties | excludeByJsDocTags('internal') | filterByScope(memberScopes) | filterUselessMembers | sortByNodesName -%}
+        {%- set allMethods = declaration | getClassMethods | excludeByJsDocTags('internal') | filterByScope(memberScopes) | filterUselessMembers | sortByNodesName -%}
+        {%- set allAccessors = declaration | getClassAccessors | excludeByJsDocTags('internal') | filterByScope(memberScopes) | filterUselessMembers | sortByNodesName -%}
         {%- set staticProperties = allProperties | filterByStatic(true) -%}
         {%- set properties = allProperties | filterByStatic(false) -%}
         {%- set staticAccessors = allAccessors | filterByStatic(true) | groupAccessors -%}

package/templates/symbol/page.html.nunj

@@ -69,7 +69,7 @@
         {{ overloadMacro.render(overloads) }}
     {% endif %}
 {% else %}
-    {{ membersMacro.render(declaration) }}
+    {{ membersMacro.render(declaration, hideProtectedMembers) }}
 {% endif %}
 
 {% include "parts/examples.html.nunj" %}