@ng-doc/builder 22.0.0-beta.2 → 22.1.0

package/generator/templates/playgrounds.ts.nunj

@@ -0,0 +1,63 @@
+// @ts-nocheck
+import {ChangeDetectionStrategy, Component, viewChild, ViewContainerRef} from '@angular/core';
+import {NgDocBasePlayground, providePlaygroundDemo} from '@ng-doc/app';
+// noinspection ES6UnusedImports
+import pageEntity from '{{ entryImportPath }}';
+import {CommonModule} from '@angular/common';
+
+{%- set components = [] %}
+{%- set index = 1 %}
+{%- set playgrounds = playgroundMetadata %}
+
+
+{%- for id, metadata in playgrounds -%}
+
+{%- for selector, template in metadata.templateForComponents %}
+{%- set comp = {id: id, name: 'PlaygroundComponent' + index, selector: selector } %}
+{%- set components = (components.push(comp), components) %}
+
+@Component({
+    selector: 'ng-doc-playground-{{ index }}',
+    {#- Two pages with the same playground would otherwise compile to identical components, which
+        Angular gives the same component ID (NG0912). The page route keeps them apart. #}
+    host: {'data-ng-doc-playground-page': '{{ pageRoute }}'},
+    template: `
+		{{ template }}
+	`,
+    imports: [
+        CommonModule,
+        {%- if hasImports %}
+        ...pageEntity.imports,
+        {%- endif %}
+        {%- if metadata.standalone %}
+        pageEntity.playgrounds['{{ id }}'].target,
+        {%- endif %}
+    ],
+    changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class {{ comp.name }} extends NgDocBasePlayground {
+    static readonly selector: string = '{{ comp.selector }}';
+
+    readonly target = pageEntity.playgrounds['{{ id }}'].target;
+
+    readonly playground = viewChild(pageEntity.playgrounds['{{ id }}'].target);
+
+    readonly viewContainerRef = viewChild(pageEntity.playgrounds['{{ id }}'].target, {read: ViewContainerRef});
+
+    readonly configData: any = pageEntity.playgrounds['{{ id }}'].data;
+}
+{%- set index = index + 1 -%}
+{%- endfor %}
+{%- endfor %}
+
+export const PLAYGROUND_COMPONENTS = [
+    {%- for comp in components %}
+    {{ comp.name }},
+    {%- endfor %}
+];
+
+export const PLAYGROUND_PROVIDERS = [
+    {%- for comp in components %}
+    providePlaygroundDemo('{{ comp.id }}', {{ comp.name }}),
+    {%- endfor %}
+];

package/generator/templates/routes.ts.nunj

@@ -0,0 +1,53 @@
+// @ts-nocheck
+import {Routes} from '@angular/router';
+{#- Route strings are single-quoted string literals: backslashes, quotes and line breaks are
+    escaped, so a route or segment with one cannot end the literal. -#}
+{%- macro categoryImport(entry) -%}
+{%- if entry.item.isCategory %}
+import {{ entry.item.id }} from '{{ curDir | createImportPath(entry.item.path) }}';
+{%- endif -%}
+{%- for child in entry.children -%}
+{{ categoryImport(child) }}
+{%- endfor -%}
+{%- endmacro -%}
+
+{%- for entry in entries -%}
+{{ categoryImport(entry) }}
+{%- endfor %}
+
+export const NG_DOC_ROUTING: Routes = [
+	{%- macro route(entry) %}
+	{
+		path: '{{ entry.item.route | replace("\\", "\\\\") | replace("'", "\\'") | replace("\n", "\\n") }}',
+		title: `{{ entry.item.title | toTemplateString }}`,
+    {#- `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 ?? []),
+    ],
+    {%- endif %}
+		{%- if entry.children.length %}
+		children: [{
+			path: '',
+			redirectTo: '{{ entry.children[0].item.route }}',
+			pathMatch: 'full'
+		},
+			{%- for child in entry.children -%}
+			{{ route(child) }}
+			{%- endfor -%}
+		],
+		{%- else %}
+		loadChildren: () => import('./{{ curDir | createImportPath(entry.item.outDir + "/page.ts") }}'),
+		{%- endif %}
+	},
+	{%- endmacro %}
+	{%- for entry in entries %}
+	{{ route(entry) }}
+	{%- endfor %}
+];

package/generator/templates/symbol/decorators.html.nunj

@@ -0,0 +1,12 @@
+{#-
+    Decorator chips with the per-decorator colour hook: `data-ng-doc-decorator` names the
+    decorator, so a site colours `@Component`, `@Injectable` or `@Input` chips from their
+    `--ng-doc-*-decorator-background` variables.
+-#}
+{% macro chip(name) -%}
+    <code data-ng-doc-decorator="{{ name | escape }}">{{ '@' + name | escape }}</code>
+{%- endmacro %}
+
+{% macro render(decorators) -%}
+    <span class="ng-doc-decorators-group">{% for decorator in decorators %}{{ chip(decorator.getName()) }}{% endfor %}</span>
+{%- endmacro %}

package/generator/templates/symbol/details.html.nunj

@@ -0,0 +1,62 @@
+{#-
+    The details of a declaration as a definition list: decorators, selectors, type parameters and
+    heritage, the same data as `api/details`. The `rail` variant also names the kind, its modifiers
+    and the scope; the page moves it into the right rail.
+-#}
+{% import "helpers/type.html.nunj" as typeMacro %}
+{% import "helpers/tag.html.nunj" as tagMacro %}
+{% import "helpers/declaration-modifiers.html.nunj" as modifiersMacro %}
+{% import "symbol/decorators.html.nunj" as decoratorsMacro %}
+
+{% macro render(declaration, scope, variant) %}
+    {%- set isClass = Node.isClassDeclaration(declaration) %}
+    {%- set decorators = declaration.getDecorators() if isClass else [] %}
+    {%- set selectors = declaration | extractSelectors %}
+    {%- set typeParameters = declaration.getTypeParameters() if declaration.getTypeParameters else [] %}
+    {%- if isClass %}
+        {%- set extends = [declaration.getExtends()] if declaration.getExtends() else [] %}
+        {%- set implements = declaration.getImplements() %}
+    {%- elseif Node.isInterfaceDeclaration(declaration) %}
+        {%- set extends = declaration.getExtends() %}
+        {%- set implements = [] %}
+    {%- else %}
+        {%- set extends = [] %}
+        {%- set implements = [] %}
+    {%- endif %}
+    {%- set declarationType = declaration | getDeclarationType %}
+    {%- set rail = variant == 'rail' %}
+    {%- if rail or decorators.length or selectors.length or typeParameters.length or extends.length or implements.length %}
+        {#- The content copy indexes what the per-section layout did (the selectors); the rail copy is
+            not indexed. #}
+        <dl class="ng-doc-api-details"{% if rail %} data-ng-doc-variant="rail" data-ng-doc-rail-details hidden indexable="false"{% endif %}>
+            {%- if rail and declarationType %}
+                <dt indexable="false">Kind</dt>
+                <dd>{{ tagMacro.render("Type alias" if declarationType == "TypeAlias" else declarationType, declarationType) }}{{ modifiersMacro.render(declaration) }}</dd>
+            {%- endif %}
+            {%- if decorators.length %}
+                <dt indexable="false">Decorators</dt>
+                <dd indexable="false">{{ decoratorsMacro.render(decorators) }}</dd>
+            {%- endif %}
+            {%- if selectors.length %}
+                <dt indexable="false">Selectors</dt>
+                <dd>{% for selector in selectors %}<code>{{ selector }}</code>{% endfor %}</dd>
+            {%- endif %}
+            {%- if typeParameters.length %}
+                <dt indexable="false">Generic types</dt>
+                <dd>{% for typeParameter in typeParameters %}{{ typeMacro.type(typeParameter) }}{% endfor %}</dd>
+            {%- endif %}
+            {%- if extends.length %}
+                <dt indexable="false">Extends</dt>
+                <dd>{% for item in extends %}{{ typeMacro.type(item) }}{% endfor %}</dd>
+            {%- endif %}
+            {%- if implements.length %}
+                <dt indexable="false">Implements</dt>
+                <dd>{% for item in implements %}{{ typeMacro.type(item) }}{% endfor %}</dd>
+            {%- endif %}
+            {%- if rail %}
+                <dt indexable="false">Scope</dt>
+                <dd>{{ scope.name }}</dd>
+            {%- endif %}
+        </dl>
+    {%- endif %}
+{% endmacro %}

package/generator/templates/symbol/extended-by.html.nunj

@@ -0,0 +1,17 @@
+{#-
+    The classes that extend a class, as identifier chips (they no longer sit in See Also). When the
+    page has no `@see` tags, the list keeps
+    the `see-also` anchor that the per-section layout gave the derived classes, so links and
+    keywords to it still resolve.
+-#}
+{% set derived = declaration.getDerivedClasses() if declaration.getDerivedClasses else [] %}
+{% set seeDocs = docNode | getJsDocTags('see') %}
+
+{% if derived.length %}
+    <dl class="ng-doc-api-extended" indexable="false"{% if not seeDocs.length %} dataSlug="See Also" dataSlugType="heading"{% endif %}>
+        <dt>Extended by <span class="ng-doc-members-count">{{ derived.length }}</span></dt>
+        <dd>
+            {%- for cls in derived %}<code>{{ cls.getName() }}</code>{% endfor -%}
+        </dd>
+    </dl>
+{% endif %}

package/generator/templates/symbol/header.html.nunj

@@ -0,0 +1,22 @@
+{#-
+    The header of an API page in the symbol view: the scope, the kind chip and the modifiers, the
+    name and the status callouts. The details follow the description in the page.
+-#}
+{% import "helpers/status.html.nunj" as statusMacro %}
+{% import "helpers/tag.html.nunj" as tagMacro %}
+{% import "helpers/declaration-modifiers.html.nunj" as modifiersMacro %}
+
+<div class="ng-doc-page-tags">
+    {% set declarationType = declaration | getDeclarationType %}
+
+    {{ tagMacro.render(scope.name, "ng-doc-scope") }}
+    <span class="ng-doc-inline-delimiter" indexable="false">/</span>
+    {{ tagMacro.render("Type alias" if declarationType == "TypeAlias" else declarationType, declarationType) if declarationType }}
+    {{ modifiersMacro.render(declaration) }}
+</div>
+
+<h1 class="{{ statusMacro.class(docNode) }}">
+    {{ declaration.getName() }}
+</h1>
+
+{{ statusMacro.render(docNode) }}

package/generator/templates/symbol/members.html.nunj

@@ -0,0 +1,303 @@
+{#-
+    The members of a class or an interface as one table, which the `ng-doc-members` host filters by
+    group and name at runtime. Every group row holds the heading and every member row the anchor
+    that the per-section layout rendered (same ids, titles and anchor types), so page keywords and
+    links do not change. Only the chevron and the name of an expandable row form its button.
+-#}
+{% import "helpers/type.html.nunj" as typeMacro %}
+{% import "helpers/badge.html.nunj" as badgeMacro %}
+{% import "helpers/status.html.nunj" as statusMacro %}
+{% import "helpers/code.html.nunj" as codeMacro %}
+{% import "helpers/parameters.html.nunj" as parametersMacro %}
+{% import "helpers/overload.html.nunj" as overloadMacro %}
+{% import "symbol/decorators.html.nunj" as decoratorsMacro %}
+
+{% macro chevron() -%}
+    <svg class="ng-doc-member-chevron" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m9 18 6-6-6-6"></path></svg>
+{%- endmacro %}
+
+{% macro description(node, docNode) -%}
+    <div class="ng-doc-api-status">{{ statusMacro.render(node) }}</div>
+    {%- set text = docNode | getJsDocDescription %}
+    {%- if text %}
+        {{ text }}
+    {%- else %}
+        <span class="ng-doc-members-none" indexable="false" aria-label="No documentation">—</span>
+    {%- endif %}
+    {%- set remarks = docNode | getJsDocTags('remarks') %}
+    {%- if remarks.length %}
+        <div class="ng-doc-member-label" indexable="false">Notes</div>
+        {%- for remark in remarks %}
+            {{ remark | markdownToHtml }}
+        {%- endfor %}
+    {%- endif %}
+{%- endmacro %}
+
+{% macro examples(docNode) -%}
+    {%- set items = docNode | getJsDocTags('example') %}
+    {%- if items.length %}
+        <div indexable="false">
+            <div class="ng-doc-member-label">Example usage</div>
+            {%- for example in items %}
+                {{ example }}
+            {%- endfor %}
+        </div>
+    {%- endif %}
+{%- endmacro %}
+
+{% macro tags(node, inheritedFrom, definedIn) -%}
+    {%- set isAbstract = node.isAbstract and node.isAbstract() %}
+    {%- set isStatic = node.isStatic and node.isStatic() %}
+    {%- set isAsync = node.isAsync and node.isAsync() %}
+    {%- set isReadonly = node.isReadonly and node.isReadonly() %}
+    {%- set isProtected = node.getScope and node.getScope() == 'protected' %}
+    {%- set overriddenMember = (node | getOverriddenMember) if node.getName %}
+    {%- set implementedMember = (node | getImplementedMember) if node.getName %}
+    {%- set signal = node | signalMember %}
+    {%- set decorators = node.getDecorators() if node.getDecorators else [] %}
+    <div class="ng-doc-member-tags" indexable="false">
+        {{- badgeMacro.render("protected") if isProtected }}
+        {{- badgeMacro.render("abstract") if isAbstract }}
+        {{- badgeMacro.render("static") if isStatic }}
+        {{- badgeMacro.render("async") if isAsync }}
+        {{- badgeMacro.render("readonly") if isReadonly }}
+        {%- if decorators.length or signal %}
+            <span class="ng-doc-decorators-group">
+                {%- for decorator in decorators %}{{ decoratorsMacro.chip(decorator.getName()) }}{% endfor -%}
+                {%- if signal %}<code data-ng-doc-decorator="{{ 'Output' if signal.kind == 'output' else 'Input' }}" data-ng-doc-signal="{{ signal.kind }}">{{ signal.kind }}()</code>{% endif -%}
+            </span>
+            {%- if signal and signal.required %}{{ badgeMacro.render("required") }}{% endif %}
+        {%- endif %}
+        {%- if definedIn %}
+            <span class="ng-doc-member-from">defined in <code>{{ definedIn.getName() }}</code></span>
+        {%- elseif inheritedFrom %}
+            <span class="ng-doc-member-from">inherited from <code>{{ inheritedFrom.getName() }}</code></span>
+        {%- elseif overriddenMember %}
+            <span class="ng-doc-member-from">overrides <code>{{ (overriddenMember | getMemberParent).getName() }}</code></span>
+        {%- elseif implementedMember %}
+            <span class="ng-doc-member-from">implements <code>{{ (implementedMember | getMemberParent).getName() }}</code></span>
+        {%- endif %}
+    </div>
+{%- endmacro %}
+
+{#- `definedIn` mode (type aliases) names the named type that declares a property, as the
+    per-section layout does; classes and interfaces name the parent it is inherited from. #}
+{% macro propertyRow(property, group, origin, mode) -%}
+    {%- set inheritedFrom = none %}
+    {%- set definedIn = none %}
+    {%- if mode == 'definedIn' %}
+        {%- set parent = property | getDefinedInParent(origin) %}
+        {%- set definedIn = parent if (parent and (parent | isNamed)) else none %}
+    {%- else %}
+        {%- set inheritedFrom = property | getInheritedParent(origin) %}
+    {%- endif %}
+    {%- set docNode = property | getPropertyChain | firstNodeWithComment %}
+    <tr class="ng-doc-member {{ statusMacro.class(property) }}" data-group="{{ group }}" data-name="{{ property.getName() }}"{{ ' data-inherited' if inheritedFrom }} dataSlug="{{ property.getName() }}" dataSlugType="member">
+        <td class="ng-doc-member-declaration" indexable="false">
+            <div class="ng-doc-member-signature"><span class="ng-doc-member-name">{{ property.getName() }}</span>{{ '?' if property.hasQuestionToken and property.hasQuestionToken() }}: {{ typeMacro.type(property) }}</div>
+            {{ tags(property, inheritedFrom, definedIn) }}
+        </td>
+        <td class="ng-doc-member-description">
+            {{ description(property, docNode) }}
+            {{ examples(docNode) }}
+        </td>
+    </tr>
+{%- endmacro %}
+
+{% macro enumRow(member, group) -%}
+    <tr class="ng-doc-member {{ statusMacro.class(member) }}" data-group="{{ group }}" data-name="{{ member.getName() }}" dataSlug="{{ member.getName() }}" dataSlugType="member">
+        <td class="ng-doc-member-declaration" indexable="false">
+            <div class="ng-doc-member-signature"><span class="ng-doc-member-name">{{ member.getName() }}</span> = <code>{{ member.getValue() | dump | escape }}</code></div>
+        </td>
+        <td class="ng-doc-member-description">
+            {{ description(member, member) }}
+        </td>
+    </tr>
+{%- endmacro %}
+
+{% macro accessorRow(accessor, type, group, origin) -%}
+    {%- set inheritedFrom = accessor | getInheritedParent(origin) %}
+    {%- set docNode = accessor | getAccessorChain | firstNodeWithComment %}
+    <tr class="ng-doc-member {{ statusMacro.class(accessor) }}" data-group="{{ group }}" data-name="{{ accessor.getName() }}"{{ ' data-inherited' if inheritedFrom }} dataSlug="{{ type + '-' + accessor.getName() }}" dataSlugType="member" dataSlugTitle="{{ accessor.getName() }}">
+        <td class="ng-doc-member-declaration" indexable="false">
+            <div class="ng-doc-member-signature">{{ type }} <span class="ng-doc-member-name">{{ accessor.getName() }}</span>: {{ typeMacro.type(accessor) }}</div>
+            {{ tags(accessor, inheritedFrom) }}
+        </td>
+        <td class="ng-doc-member-description">
+            {{ description(accessor, docNode) }}
+        </td>
+    </tr>
+{%- endmacro %}
+
+{#- A row with a detail row: a method, the constructor or a call signature (`kind`). #}
+{% macro callableRow(node, kind, name, slug, group, origin, presentation, detailId) -%}
+    {%- if kind == 'method' %}
+        {%- set docNode = node | getMethodChain | firstNodeWithComment %}
+    {%- elseif kind == 'call' %}
+        {%- set docNode = node | getCallSignatureChain | firstNodeWithComment %}
+    {%- else %}
+        {%- set docNode = node %}
+    {%- endif %}
+    {%- set inheritedFrom = none %}
+    {%- if kind != 'constructor' %}
+        {%- set inheritedFrom = node | getInheritedParent(origin) %}
+    {%- endif %}
+    {%- set parameters = node.getParameters() %}
+    {%- set overloads = node.getOverloads() if node.getOverloads else [] %}
+    {%- set returnsTag = docNode | getJsDocTag('returns') %}
+    <tr class="ng-doc-member {{ statusMacro.class(node) }}" data-group="{{ group }}" data-name="{{ name }}"{{ ' data-inherited' if inheritedFrom }}{% if kind != 'constructor' %} dataSlug="{{ slug }}" dataSlugType="method"{% endif %}>
+        <td class="ng-doc-member-declaration" indexable="false">
+            <div class="ng-doc-member-signature"><button type="button" class="ng-doc-member-expand" aria-expanded="false" aria-controls="{{ detailId }}" aria-label="{{ name }}: show the signature">{{ chevron() }}<span class="ng-doc-member-name">{{ name }}</span></button>({{ '…' if parameters.length }}){% if kind != 'constructor' %}: {{ typeMacro.returnType(node) }}{% endif %}</div>
+            {{ tags(node, inheritedFrom) }}
+        </td>
+        <td class="ng-doc-member-description">
+            {{ description(node, docNode) }}
+        </td>
+    </tr>
+    <tr class="ng-doc-member-detail" id="{{ detailId }}" data-group="{{ group }}" hidden>
+        <td colspan="2">
+            <div class="ng-doc-member-label" indexable="false">Signature</div>
+            {{ codeMacro.render(presentation, "typescript", false) }}
+            {%- if parameters.length %}
+                <div class="ng-doc-member-label" indexable="false">Parameters</div>
+                {{ parametersMacro.render(parameters, (node if kind == 'constructor' else docNode), kind == 'constructor') }}
+            {%- endif %}
+            {%- if kind != 'constructor' %}
+                <div class="ng-doc-member-label" indexable="false">Returns</div>
+                <div class="ng-doc-returns">
+                    {{ typeMacro.returnType(node) }}
+                    {%- if returnsTag.length %}
+                        <span> - </span>
+                        {{ returnsTag | markdownToHtml }}
+                    {%- endif %}
+                </div>
+            {%- endif %}
+            {{ examples(docNode) }}
+            {%- if overloads.length %}
+                <div class="ng-doc-member-label" indexable="false">Overloads</div>
+                {{ overloadMacro.render(overloads) }}
+            {%- endif %}
+        </td>
+    </tr>
+{%- endmacro %}
+
+{#- The number of rows of a group: an accessor pair has a row per get and set. #}
+{% macro count(group) -%}
+    {%- if group.kind == 'accessor' -%}
+        {%- set marks %}{% for pair in group.members %}{{ 'x' if pair.get }}{{ 'x' if pair.set }}{% endfor %}{% endset -%}
+        {{- marks | length -}}
+    {%- else -%}
+        {{- group.members.length -}}
+    {%- endif -%}
+{%- endmacro %}
+
+{% macro groupRow(group, title, total) -%}
+    <tr class="ng-doc-members-group" data-group="{{ group }}">
+        <td colspan="2"><h3 class="ng-doc-members-group-title">{{ title }}</h3><span class="ng-doc-members-count" indexable="false">{{ total }}</span></td>
+    </tr>
+{%- endmacro %}
+
+{#- `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(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 -%}
+        {%- set accessors = allAccessors | filterByStatic(false) | groupAccessors -%}
+        {%- set staticMethods = allMethods | filterByStatic(true) -%}
+        {%- set methods = allMethods | filterByStatic(false) -%}
+        {%- set groups = [
+            { id: 'constructor', title: 'Constructor', kind: 'constructor', members: constructors.slice(0, 1) },
+            { id: 'static-properties', title: 'Static Properties', kind: 'property', members: staticProperties },
+            { id: 'properties', title: 'Properties', kind: 'property', members: properties },
+            { id: 'static-accessors', title: 'Static Accessors', kind: 'accessor', members: staticAccessors },
+            { id: 'accessors', title: 'Accessors', kind: 'accessor', members: accessors },
+            { id: 'static-methods', title: 'Static Methods', kind: 'method', members: staticMethods },
+            { id: 'methods', title: 'Methods', kind: 'method', members: methods }
+        ] -%}
+    {%- elseif Node.isInterfaceDeclaration(declaration) %}
+        {%- set properties = declaration | getInterfaceProperties | excludeByJsDocTags('internal') | filterUselessMembers | sortByNodesName -%}
+        {%- set accessors = declaration | getInterfaceAccessors | excludeByJsDocTags('internal') | filterUselessMembers | sortByNodesName | groupAccessors -%}
+        {%- set methods = declaration | getInterfaceMethods | excludeByJsDocTags('internal') | filterUselessMembers | sortByNodesName -%}
+        {%- set callSignatures = declaration | getInterfaceCallSignatures | excludeByJsDocTags('internal') -%}
+        {%- set groups = [
+            { id: 'properties', title: 'Properties', kind: 'property', members: properties },
+            { id: 'accessors', title: 'Accessors', kind: 'accessor', members: accessors },
+            { id: 'methods', title: 'Methods', kind: 'method', members: methods },
+            { id: 'call-signatures', title: 'Call Signatures', kind: 'call', members: callSignatures }
+        ] -%}
+    {%- elseif Node.isTypeAliasDeclaration(declaration) %}
+        {%- set properties = declaration | getTypeAliasProperties | excludeByJsDocTags('internal') | filterUselessMembers | sortByNodesName -%}
+        {%- set groups = [{ id: 'properties', title: 'Properties', kind: 'defined-property', members: properties }] -%}
+    {%- elseif Node.isEnumDeclaration(declaration) %}
+        {%- set groups = [{ id: 'members', title: 'Members', kind: 'enum', members: declaration.getMembers() | excludeByJsDocTags('internal') }] -%}
+    {%- else %}
+        {%- set groups = [] -%}
+    {%- endif %}
+    {%- set populated = [] %}
+    {%- for group in groups %}{% if group.members.length %}{% set populated = (populated.push(group), populated) %}{% endif %}{% endfor %}
+
+    {%- set rows %}
+        {%- for group in groups %}
+            {%- if group.members.length %}
+                {{ groupRow(group.id, group.title, count(group)) }}
+                {%- for member in group.members %}
+                    {%- if group.kind == 'property' %}
+                        {{ propertyRow(member, group.id, declaration) }}
+                    {%- elseif group.kind == 'defined-property' %}
+                        {{ propertyRow(member, group.id, declaration, 'definedIn') }}
+                    {%- elseif group.kind == 'enum' %}
+                        {{ enumRow(member, group.id) }}
+                    {%- elseif group.kind == 'accessor' %}
+                        {{ accessorRow(member.get, 'get', group.id, declaration) if member.get }}
+                        {{ accessorRow(member.set, 'set', group.id, declaration) if member.set }}
+                    {%- elseif group.kind == 'method' %}
+                        {{ callableRow(member, 'method', member.getName(), member.getName() + '()', group.id, declaration, member | methodPresentation, 'ng-doc-member-detail-' + group.id + '-' + member.getName()) }}
+                    {%- elseif group.kind == 'constructor' %}
+                        {{ callableRow(member, 'constructor', 'constructor', 'constructor', group.id, declaration, member | constructorPresentation, 'ng-doc-member-detail-constructor') }}
+                    {%- else %}
+                        {{ callableRow(member, 'call', 'Call Signature #' + loop.index, 'Call Signature #' + loop.index, group.id, declaration, member | callSignaturePresentation, 'ng-doc-member-detail-call-signature-' + loop.index) }}
+                    {%- endif %}
+                {%- endfor %}
+            {%- endif %}
+        {%- endfor %}
+    {%- endset %}
+
+    {%- if rows | trim %}
+        {%- set total = rows.split('class="ng-doc-member ').length - 1 %}
+        {%- set inherited = rows.split(' data-inherited ').length - 1 %}
+        {#- An enum's only group is its members, whose row already holds the Members heading. #}
+        {%- if not (populated.length == 1 and populated[0].kind == 'enum') %}
+        <h2 id="ng-doc-members">Members</h2>
+        {%- endif %}
+        <ng-doc-members>
+            <div class="ng-doc-members-bar" indexable="false">
+                {%- if populated.length > 1 or inherited %}
+                <div class="ng-doc-members-tabs" role="tablist" aria-label="Filter members">
+                    <button type="button" role="tab" data-ng-doc-members-tab="all" aria-selected="true">All <span class="ng-doc-members-count">{{ total }}</span></button>
+                    {%- for group in groups %}
+                        {%- if group.members.length %}
+                            <button type="button" role="tab" data-ng-doc-members-tab="{{ group.id }}" aria-selected="false" tabindex="-1">{{ group.title }} <span class="ng-doc-members-count">{{ count(group) }}</span></button>
+                        {%- endif %}
+                    {%- endfor %}
+                    {%- if inherited %}
+                        <button type="button" role="tab" data-ng-doc-members-tab="inherited" aria-selected="false" tabindex="-1">Inherited <span class="ng-doc-members-count">{{ inherited }}</span></button>
+                    {%- endif %}
+                </div>
+                {%- endif %}
+                <label class="ng-doc-members-filter"><svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M22 3H2l8 9.46V19l4 2v-8.54L22 3z"></path></svg><input type="text" placeholder="Filter by name" aria-label="Filter members by name" data-ng-doc-members-filter aria-keyshortcuts="F"></label>
+            </div>
+            <div class="ng-doc-members-table-wrapper">
+                <table class="ng-doc-members-table">
+                    <tbody>{{ rows }}</tbody>
+                </table>
+                <div class="ng-doc-members-empty" indexable="false" hidden>No members match.</div>
+            </div>
+        </ng-doc-members>
+    {%- endif %}
+{% endmacro %}

package/generator/templates/symbol/page.html.nunj

@@ -0,0 +1,76 @@
+{#-
+    An API page in the symbol view: the description, the details (also in the right rail), the
+    declaration panel, the kind's own sections and the page-level notes, see-also, examples and
+    usage notes. Every heading and member anchor of the per-section layout
+    (`api-page-content.html.nunj`) is kept, so page keywords and links do not change: the
+    declaration panel carries the `presentation` anchor of the declarations that had one.
+-#}
+{% import "helpers/no-content.html.nunj" as noContentMacro %}
+{% import "helpers/code.html.nunj" as codeMacro %}
+{% import "helpers/type.html.nunj" as typeMacro %}
+{% import "helpers/parameters.html.nunj" as parametersMacro %}
+{% import "helpers/overload.html.nunj" as overloadMacro %}
+{% import "symbol/members.html.nunj" as membersMacro %}
+{% import "symbol/details.html.nunj" as detailsMacro %}
+
+{% set isClass = Node.isClassDeclaration(declaration) %}
+{% set isInterface = Node.isInterfaceDeclaration(declaration) %}
+{% set isFunction = Node.isFunctionDeclaration(declaration) %}
+{% set isTypeAlias = Node.isTypeAliasDeclaration(declaration) %}
+{% set isVariable = Node.isVariableDeclaration(declaration) %}
+
+{% set description = docNode | getJsDocDescription %}
+<div class="ng-doc-api-description">
+    {{ description if description else noContentMacro.render('No documentation has been provided.') }}
+</div>
+
+{{ detailsMacro.render(declaration, scope) }}
+{{ detailsMacro.render(declaration, scope, 'rail') }}
+
+{%- if isFunction %}
+    {% set code = declaration | functionPresentation %}
+{%- elseif isTypeAlias %}
+    {% set code = declaration | typeAliasPresentation %}
+{%- elseif isVariable %}
+    {% set code = declaration | variablePresentation %}
+{%- else %}
+    {% set code = declaration | apiDeclaration %}
+{%- endif %}
+<div class="ng-doc-api-declaration" indexable="false"{% if isFunction or isTypeAlias or isVariable %} dataSlug="Presentation" dataSlugType="heading"{% endif %}>
+    <pre><code class="language-typescript" lang="typescript" metastring='{"name":"Declaration"}'>{{ code | escape }}</code></pre>
+</div>
+
+{% include "symbol/extended-by.html.nunj" %}
+
+{% include "parts/remarks.html.nunj" %}
+{% include "symbol/see-also.html.nunj" %}
+
+{% if isFunction %}
+    {%- set parameters = declaration.getParameters() -%}
+    {%- set overloads = declaration.getOverloads() -%}
+    {%- set returnsTag = docNode | getJsDocTag('returns') -%}
+
+    <h2>Returns</h2>
+    <div class="ng-doc-returns">
+        {{ typeMacro.returnType(declaration) }}
+        {%- if returnsTag.length %}
+            <span> - </span>
+            {{ returnsTag | markdownToHtml }}
+        {%- endif %}
+    </div>
+
+    {% if parameters.length -%}
+        <h2>Parameters</h2>
+        {{ parametersMacro.render(parameters, declaration) }}
+    {%- endif %}
+
+    {% if overloads.length %}
+        <h2>Overloads</h2>
+        {{ overloadMacro.render(overloads) }}
+    {% endif %}
+{% else %}
+    {{ membersMacro.render(declaration, hideProtectedMembers) }}
+{% endif %}
+
+{% include "parts/examples.html.nunj" %}
+{% include "parts/usage-notes.html.nunj" %}

package/generator/templates/symbol/see-also.html.nunj

@@ -0,0 +1,16 @@
+{#-
+    The `@see` tags of a declaration; derived classes are listed by `symbol/extended-by.html.nunj`.
+-#}
+{%- set seeDocs = docNode | getJsDocTags('see') %}
+
+{%- if seeDocs.length %}
+    <section indexable="false">
+        <h2>See Also</h2>
+
+        <ul class="ng-doc-see-also">
+            {%- for see in seeDocs %}
+                <li>{{ see }}</li>
+            {%- endfor %}
+        </ul>
+    </section>
+{%- endif %}

package/generator/vite/angular/ANALOG-LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 Brandon Roberts
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.