@typespec/tspd 0.47.0-dev.0 → 0.68.0

package/dist/src/ref-doc/emitters/markdown.js

@@ -1,24 +1,26 @@
-import { resolvePath } from "@typespec/compiler";
+import { getEntityName, isType, resolvePath, } from "@typespec/compiler";
 import { readFile } from "fs/promises";
 import { stringify } from "yaml";
 import { codeblock, inlinecode, link, renderMarkdowDoc, section, table, } from "../utils/markdown.js";
-import { getTypeSignature } from "../utils/type-signature.js";
 async function loadTemplate(projectRoot, name) {
     try {
         const content = await readFile(resolvePath(projectRoot, `.tspd/docs/${name}.md`));
         return content.toString();
     }
     catch (e) {
-        if (typeof e === "object" && (e === null || e === void 0 ? void 0 : e.code) === "ENOENT") {
+        if (typeof e === "object" && e?.code === "ENOENT") {
             return undefined;
         }
         throw e;
     }
 }
 export async function renderReadme(refDoc, projectRoot) {
-    var _a;
     const content = [];
-    const renderer = new MarkdownRenderer();
+    const renderer = new MarkdownRenderer(refDoc);
+    const headerTemplate = await loadTemplate(projectRoot, "header");
+    if (headerTemplate) {
+        content.push(headerTemplate);
+    }
     if (refDoc.description) {
         content.push(refDoc.description);
     }
@@ -27,7 +29,7 @@ export async function renderReadme(refDoc, projectRoot) {
     if (usageTemplate) {
         content.push(section("Usage", [usageTemplate]));
     }
-    if ((_a = refDoc.emitter) === null || _a === void 0 ? void 0 : _a.options) {
+    if (refDoc.emitter?.options) {
         content.push(renderer.emitterUsage(refDoc));
     }
     if (refDoc.linter) {
@@ -36,6 +38,10 @@ export async function renderReadme(refDoc, projectRoot) {
     if (refDoc.namespaces.some((x) => x.decorators.length > 0)) {
         content.push(section("Decorators", renderer.decoratorsSection(refDoc, { includeToc: true })));
     }
+    const footerTemplate = await loadTemplate(projectRoot, "footer");
+    if (footerTemplate) {
+        content.push(footerTemplate);
+    }
     return renderMarkdowDoc(section(refDoc.name, content));
 }
 export function groupByNamespace(namespaces, callback) {
@@ -52,12 +58,23 @@ export function groupByNamespace(namespaces, callback) {
  * Github flavored markdown renderer.
  */
 export class MarkdownRenderer {
+    refDoc;
+    constructor(refDoc) {
+        this.refDoc = refDoc;
+    }
     headingTitle(item) {
         return inlinecode(item.name);
     }
     anchorId(item) {
         return `${item.name.toLowerCase().replace(/ /g, "-")}`;
     }
+    deprecationNotice(notice) {
+        return `_Deprecated: ${notice.message}_`;
+    }
+    typeSection(type, content) {
+        const deprecated = type.deprecated ? this.deprecationNotice(type.deprecated) : [];
+        return section(this.headingTitle(type), [deprecated, content]);
+    }
     //#region TypeSpec types
     operation(op) {
         const content = ["", op.doc, codeblock(op.signature, "typespec"), ""];
@@ -65,7 +82,7 @@ export class MarkdownRenderer {
             content.push(this.templateParameters(op.templateParameters));
         }
         content.push(this.examples(op.examples));
-        return section(this.headingTitle(op), content);
+        return this.typeSection(op, content);
     }
     interface(iface) {
         const content = ["", iface.doc, codeblock(iface.signature, "typespec"), ""];
@@ -78,7 +95,7 @@ export class MarkdownRenderer {
             }
         }
         content.push(this.examples(iface.examples));
-        return section(this.headingTitle(iface), content);
+        return this.typeSection(iface, content);
     }
     model(model) {
         const content = ["", model.doc, codeblock(model.signature, "typespec"), ""];
@@ -86,7 +103,65 @@ export class MarkdownRenderer {
             content.push(this.templateParameters(model.templateParameters));
         }
         content.push(this.examples(model.examples));
-        return section(this.headingTitle(model), content);
+        content.push(this.modelProperties(model));
+        return this.typeSection(model, content);
+    }
+    modelProperties(model) {
+        const content = [];
+        if (model.properties.size === 0 && model.type.indexer === undefined) {
+            return section("Properties", "None");
+        }
+        const rows = [
+            { name: "Name", type: "Type", doc: "Description" },
+        ];
+        for (const prop of model.properties.values()) {
+            const propRows = this.modelPropertyRows(prop);
+            for (const row of propRows) {
+                rows.push(row);
+            }
+        }
+        if (model.type.indexer) {
+            rows.push({
+                name: "",
+                type: this.ref(model.type.indexer.value),
+                doc: "Additional properties",
+            });
+        }
+        content.push(table(rows.map((x) => [x.name, x.type, x.doc])));
+        return section("Properties", content);
+    }
+    modelPropertyRows(prop) {
+        const name = `${prop.name}${prop.type.optional ? "?" : ""}`;
+        const base = {
+            name: prop.deprecated ? `~~${name}~~ _DEPRECATED_` : name,
+            type: this.ref(prop.type.type),
+            doc: prop.doc,
+        };
+        if (prop.type.type.kind === "Model" && prop.type.type.name === "") {
+            return [
+                base,
+                ...[...prop.type.type.properties.values()].map((x) => ({
+                    name: `${prop.name}.${x.name}${x.optional ? "?" : ""}`,
+                    type: this.ref(x.type),
+                    doc: "",
+                })),
+            ];
+        }
+        return [base];
+    }
+    ref(type, prefix = "") {
+        const namedType = isType(type) && this.refDoc.getNamedTypeRefDoc(type);
+        if (namedType) {
+            return link(prefix + inlinecode(namedType.name), `${this.filename(namedType)}#${this.anchorId(namedType)}`);
+        }
+        // So we don't show (anonymous model) until this gets improved.
+        if ("kind" in type && type.kind === "Model" && type.name === "" && type.properties.size > 0) {
+            return inlinecode(prefix + "{...}");
+        }
+        return inlinecode(prefix +
+            getEntityName(type, {
+                namespaceFilter: (ns) => !this.refDoc.namespaces.some((x) => x.name === ns.name),
+            }));
     }
     enum(e) {
         const content = [
@@ -94,9 +169,22 @@ export class MarkdownRenderer {
             e.doc,
             codeblock(e.signature, "typespec"),
             "",
+            this.enumMembers(e),
             this.examples(e.examples),
         ];
-        return section(this.headingTitle(e), content);
+        return this.typeSection(e, content);
+    }
+    enumMembers(e) {
+        const rows = [...e.members.values()].map((x) => {
+            return [
+                x.name,
+                x.type.value
+                    ? inlinecode(typeof x.type.value === "string" ? `"${x.type.value}"` : x.type.value.toString())
+                    : "",
+                x.doc,
+            ];
+        });
+        return table([["Name", "Value", "Description"], ...rows]);
     }
     union(union) {
         const content = ["", union.doc, codeblock(union.signature, "typespec"), ""];
@@ -104,7 +192,7 @@ export class MarkdownRenderer {
             content.push(this.templateParameters(union.templateParameters));
         }
         content.push(this.examples(union.examples));
-        return section(this.headingTitle(union), content);
+        return this.typeSection(union, content);
     }
     scalar(scalar) {
         const content = ["", scalar.doc, codeblock(scalar.signature, "typespec"), ""];
@@ -112,7 +200,7 @@ export class MarkdownRenderer {
             content.push(this.templateParameters(scalar.templateParameters));
         }
         content.push(this.examples(scalar.examples));
-        return section(this.headingTitle(scalar), content);
+        return this.typeSection(scalar, content);
     }
     templateParameters(templateParameters) {
         const paramTable = [["Name", "Description"]];
@@ -123,11 +211,11 @@ export class MarkdownRenderer {
     }
     decorator(dec) {
         const content = ["", dec.doc, codeblock(dec.signature, "typespec"), ""];
-        content.push(section("Target", [dec.target.doc, inlinecode(getTypeSignature(dec.target.type.type)), ""]));
+        content.push(section("Target", [dec.target.doc, this.ref(dec.target.type.type), ""]));
         if (dec.parameters.length > 0) {
             const paramTable = [["Name", "Type", "Description"]];
             for (const param of dec.parameters) {
-                paramTable.push([param.name, inlinecode(getTypeSignature(param.type.type)), param.doc]);
+                paramTable.push([param.name, this.MixedParameterConstraint(param.type.type), param.doc]);
             }
             content.push(section("Parameters", [table(paramTable), ""]));
         }
@@ -135,7 +223,13 @@ export class MarkdownRenderer {
             content.push(section("Parameters", ["None", ""]));
         }
         content.push(this.examples(dec.examples));
-        return section(this.headingTitle(dec), content);
+        return this.typeSection(dec, content);
+    }
+    MixedParameterConstraint(constraint) {
+        return [
+            ...(constraint.type ? [this.ref(constraint.type)] : []),
+            ...(constraint.valueType ? [this.ref(constraint.valueType, "valueof ")] : []),
+        ].join(" | ");
     }
     examples(examples) {
         const content = [];
@@ -166,26 +260,30 @@ export class MarkdownRenderer {
             ];
         });
     }
-    toc(items, filename) {
-        return items.map((item) => ` - [${inlinecode(item.name)}](${filename !== null && filename !== void 0 ? filename : ""}#${this.anchorId(item)})`);
+    toc(items) {
+        return items.map((item) => ` - [${inlinecode(item.name)}](${this.filename(item)}#${this.anchorId(item)})`);
+    }
+    filename(type) {
+        return "";
     }
     install(refDoc) {
         return section("Install", [codeblock(`npm install ${refDoc.name}`, "bash")]);
     }
     emitterUsage(refDoc) {
-        var _a;
-        if (((_a = refDoc.emitter) === null || _a === void 0 ? void 0 : _a.options) === undefined) {
+        if (refDoc.emitter?.options === undefined) {
             return [];
         }
-        return section("Emitter", [
+        return [
             section("Usage", [
                 "1. Via the command line",
                 codeblock(`tsp compile . --emit=${refDoc.name}`, "bash"),
                 "2. Via the config",
                 codeblock(`emit:\n  - "${refDoc.name}" `, "yaml"),
+                "The config can be extended with options as follows:",
+                codeblock(`emit:\n  - "${refDoc.name}"\noptions:\n  "${refDoc.name}":\n    option: value`, "yaml"),
             ]),
             this.emitterOptions(refDoc.emitter.options),
-        ]);
+        ];
     }
     emitterOptions(options) {
         const content = [];
@@ -204,13 +302,16 @@ export class MarkdownRenderer {
                 ? { extends: [refDoc.linter.ruleSets[0].name] }
                 : { rules: {} },
         });
-        return section("Linter", [
+        return [
             section("Usage", ["Add the following in `tspconfig.yaml`:", codeblock(setupExample, "yaml")]),
             refDoc.linter.ruleSets
-                ? section("RuleSets", ["Available ruleSets:", this.toc(refDoc.linter.ruleSets)])
+                ? section("RuleSets", [
+                    "Available ruleSets:",
+                    refDoc.linter.ruleSets.map((item) => ` - ${inlinecode(item.name)}`),
+                ])
                 : [],
             section("Rules", this.linterRuleToc(refDoc.linter.rules)),
-        ]);
+        ];
     }
     linterRuleToc(rules) {
         return table([

package/dist/src/ref-doc/emitters/markdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../../src/ref-doc/emitters/markdown.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../../src/ref-doc/emitters/markdown.ts"],"names":[],"mappings":"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"}

package/dist/src/ref-doc/emitters/starlight.d.ts

@@ -0,0 +1,24 @@
+import { DeprecationNotice, NamedTypeRefDoc, RefDocEntity, TypeSpecLibraryRefDoc, TypeSpecRefDoc, TypeSpecRefDocBase } from "../types.js";
+import { MarkdownDoc, MarkdownSection } from "../utils/markdown.js";
+import { MarkdownRenderer } from "./markdown.js";
+/**
+ * Render doc to a markdown using docusaurus addons.
+ */
+export declare function renderToAstroStarlightMarkdown(refDoc: TypeSpecRefDoc): Record<string, string>;
+export type DecoratorRenderOptions = {
+    title?: string;
+};
+export declare function renderDecoratorFile(renderer: StarlightRenderer, refDoc: TypeSpecRefDocBase, options?: DecoratorRenderOptions): string | undefined;
+export type DataTypeRenderOptions = {
+    title?: string;
+};
+export declare function renderDataTypes(renderer: StarlightRenderer, refDoc: TypeSpecRefDoc, options?: DataTypeRenderOptions): string | undefined;
+export declare class StarlightRenderer extends MarkdownRenderer {
+    headingTitle(item: NamedTypeRefDoc): string;
+    anchorId(item: NamedTypeRefDoc): string;
+    install(refDoc: TypeSpecLibraryRefDoc): MarkdownSection;
+    filename(type: RefDocEntity): string;
+    linterRuleLink(url: string): string;
+    deprecationNotice(notice: DeprecationNotice): MarkdownDoc;
+}
+//# sourceMappingURL=starlight.d.ts.map

package/dist/src/ref-doc/emitters/starlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starlight.d.ts","sourceRoot":"","sources":["../../../../src/ref-doc/emitters/starlight.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,eAAe,EAKhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAoB,MAAM,eAAe,CAAC;AAEnE;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B7F;AA0CD,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,GAAG,SAAS,CAepB;AAgCD,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,GAAG,SAAS,CAmCpB;AAmCD,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM;IAI3C,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM;IAKvC,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,eAAe;IAgBvD,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAgBpC,cAAc,CAAC,GAAG,EAAE,MAAM;IAU1B,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW;CAG1D"}

package/dist/src/ref-doc/emitters/starlight.js

@@ -0,0 +1,213 @@
+import { codeblock, inlinecode, renderMarkdowDoc, section, } from "../utils/markdown.js";
+import { MarkdownRenderer, groupByNamespace } from "./markdown.js";
+/**
+ * Render doc to a markdown using docusaurus addons.
+ */
+export function renderToAstroStarlightMarkdown(refDoc) {
+    const renderer = new StarlightRenderer(refDoc);
+    const files = {
+        "index.mdx": renderIndexFile(renderer, refDoc),
+    };
+    const decoratorFile = renderDecoratorFile(renderer, refDoc);
+    if (decoratorFile) {
+        files["decorators.md"] = decoratorFile;
+    }
+    const interfaceFile = renderInterfacesFile(renderer, refDoc);
+    if (interfaceFile) {
+        files["interfaces.md"] = interfaceFile;
+    }
+    const dataTypes = renderDataTypes(renderer, refDoc);
+    if (dataTypes) {
+        files["data-types.md"] = dataTypes;
+    }
+    const emitter = renderEmitter(renderer, refDoc);
+    if (emitter) {
+        files["emitter.md"] = emitter;
+    }
+    const linter = renderLinter(renderer, refDoc);
+    if (linter) {
+        files["linter.md"] = linter;
+    }
+    return files;
+}
+function renderIndexFile(renderer, refDoc) {
+    const content = [
+        "---",
+        `title: Overview`,
+        `sidebar_position: 0`,
+        "toc_min_heading_level: 2",
+        "toc_max_heading_level: 3",
+        "---",
+        "import { Tabs, TabItem } from '@astrojs/starlight/components';",
+        "",
+        refDoc.description ?? [],
+        renderer.install(refDoc),
+        refDoc.emitter?.options ? section("Emitter usage", `[See documentation](./emitter.md)`) : [],
+        groupByNamespace(refDoc.namespaces, (namespace) => {
+            const content = [];
+            if (namespace.decorators.length > 0) {
+                content.push(section("Decorators", renderer.toc(namespace.decorators)));
+            }
+            if (namespace.interfaces.length > 0) {
+                content.push(section("Interfaces", renderer.toc(namespace.interfaces)));
+            }
+            if (namespace.operations.length > 0) {
+                content.push(section("Operations", renderer.toc(namespace.operations)));
+            }
+            if (namespace.models.length > 0) {
+                content.push(section("Models", renderer.toc(namespace.models)));
+            }
+            return content;
+        }),
+    ];
+    return renderMarkdowDoc(content, 2);
+}
+export function renderDecoratorFile(renderer, refDoc, options) {
+    if (!refDoc.namespaces.some((x) => x.decorators.length > 0)) {
+        return undefined;
+    }
+    const title = options?.title ?? "Decorators";
+    const content = [
+        "---",
+        `title: "${title}"`,
+        "toc_min_heading_level: 2",
+        "toc_max_heading_level: 3",
+        "---",
+    ];
+    content.push(renderer.decoratorsSection(refDoc));
+    return renderMarkdowDoc(content, 2);
+}
+function renderInterfacesFile(renderer, refDoc) {
+    if (!refDoc.namespaces.some((x) => x.operations.length > 0 || x.interfaces.length > 0)) {
+        return undefined;
+    }
+    const content = ["---", `title: "Interfaces and Operations"`, "---"];
+    content.push(groupByNamespace(refDoc.namespaces, (namespace) => {
+        if (namespace.operations.length === 0 && namespace.interfaces.length === 0) {
+            return undefined;
+        }
+        const content = [];
+        for (const iface of namespace.interfaces) {
+            content.push(renderer.interface(iface), "");
+        }
+        for (const operation of namespace.operations) {
+            content.push(renderer.operation(operation), "");
+        }
+        return content;
+    }));
+    return renderMarkdowDoc(content, 2);
+}
+export function renderDataTypes(renderer, refDoc, options) {
+    if (!refDoc.namespaces.some((x) => x.models.length > 0)) {
+        return undefined;
+    }
+    const title = options?.title ?? "Data types";
+    const content = ["---", `title: "${title}"`, "---"];
+    content.push(groupByNamespace(refDoc.namespaces, (namespace) => {
+        const modelCount = namespace.models.length +
+            namespace.enums.length +
+            namespace.unions.length +
+            namespace.scalars.length;
+        if (modelCount === 0) {
+            return undefined;
+        }
+        const content = [];
+        for (const model of namespace.models) {
+            content.push(renderer.model(model), "");
+        }
+        for (const e of namespace.enums) {
+            content.push(renderer.enum(e), "");
+        }
+        for (const union of namespace.unions) {
+            content.push(renderer.union(union), "");
+        }
+        for (const scalar of namespace.scalars) {
+            content.push(renderer.scalar(scalar), "");
+        }
+        return content;
+    }));
+    return renderMarkdowDoc(content, 2);
+}
+function renderEmitter(renderer, refDoc) {
+    if (refDoc.emitter?.options === undefined) {
+        return undefined;
+    }
+    const content = [
+        "---",
+        `title: "Emitter usage"`,
+        "---",
+        renderer.emitterUsage(refDoc),
+    ];
+    return renderMarkdowDoc(content, 2);
+}
+function renderLinter(renderer, refDoc) {
+    if (refDoc.linter === undefined) {
+        return undefined;
+    }
+    const content = [
+        "---",
+        `title: "Linter usage"`,
+        "---",
+        renderer.linterUsage(refDoc),
+    ];
+    return renderMarkdowDoc(content, 2);
+}
+export class StarlightRenderer extends MarkdownRenderer {
+    headingTitle(item) {
+        // Set an explicit anchor id.
+        return `${inlinecode(item.name)} {#${item.id}}`;
+    }
+    anchorId(item) {
+        // Set an explicit anchor id.
+        return item.id;
+    }
+    install(refDoc) {
+        return section("Install", tabs([
+            {
+                label: "In a spec",
+                content: codeblock(`npm install ${refDoc.name}`, "bash"),
+            },
+            {
+                label: "In a library",
+                content: codeblock(`npm install --save-peer ${refDoc.name}`, "bash"),
+            },
+        ]));
+    }
+    filename(type) {
+        switch (type.kind) {
+            case "decorator":
+                return "./decorators.md";
+            case "operation":
+            case "interface":
+                return "./interfaces.md";
+            case "model":
+            case "enum":
+            case "union":
+                return "./data-types.md";
+            default:
+                return "";
+        }
+    }
+    linterRuleLink(url) {
+        const homepage = this.refDoc.packageJson.docusaurusWebsite;
+        if (homepage && url.includes(homepage)) {
+            const fromRoot = url.replace(homepage, "");
+            return `${fromRoot}.md`;
+        }
+        else {
+            return url;
+        }
+    }
+    deprecationNotice(notice) {
+        return [":::caution", `**Deprecated**: ${notice.message}`, ":::"];
+    }
+}
+function tabs(tabs) {
+    const result = ["<Tabs>"];
+    for (const tab of tabs) {
+        result.push(`<TabItem  label="${tab.label}" default>`, "", tab.content, "", "</TabItem>");
+    }
+    result.push("</Tabs>", "");
+    return result.join("\n");
+}
+//# sourceMappingURL=starlight.js.map

package/dist/src/ref-doc/emitters/starlight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starlight.js","sourceRoot":"","sources":["../../../../src/ref-doc/emitters/starlight.ts"],"names":[],"mappings":"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"}

package/dist/src/ref-doc/experimental.d.ts

@@ -1,9 +1,12 @@
 import { Diagnostic } from "@typespec/compiler";
 import { ExtractRefDocOptions } from "./extractor.js";
 import { TypeSpecRefDocBase } from "./types.js";
+export interface GenerateLibraryDocsOptions {
+    skipJSApi?: boolean;
+}
 /**
  * @experimental this is for experimental and is for internal use only. Breaking change to this API can happen at anytime.
  */
-export declare function generateLibraryDocs(libraryPath: string, outputDir: string, skipJSApi?: boolean): Promise<readonly Diagnostic[]>;
+export declare function generateLibraryDocs(libraryPath: string, outputDir: string, options?: GenerateLibraryDocsOptions): Promise<readonly Diagnostic[]>;
 export declare function resolveLibraryRefDocsBase(libraryPath: string, options?: ExtractRefDocOptions): Promise<[TypeSpecRefDocBase, readonly Diagnostic[]] | undefined>;
 //# sourceMappingURL=experimental.d.ts.map

package/dist/src/ref-doc/experimental.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../../../src/ref-doc/experimental.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EAIX,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAyB,oBAAoB,EAAkB,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,OAAe,GACzB,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAqBhC;AAED,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,CAAC,kBAAkB,EAAE,SAAS,UAAU,EAAE,CAAC,GAAG,SAAS,CAAC,CAelE"}
+{"version":3,"file":"experimental.d.ts","sourceRoot":"","sources":["../../../src/ref-doc/experimental.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,UAAU,EAIX,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAyB,oBAAoB,EAAkB,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AACD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAqBhC;AAED,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,CAAC,kBAAkB,EAAE,SAAS,UAAU,EAAE,CAAC,GAAG,SAAS,CAAC,CAelE"}