@qualcomm-ui/mdx-vite 3.4.0 → 3.6.0

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.
@@ -1,5 +1,6 @@
1
1
  import type { Plugin } from "unified";
2
2
  import type { SimplifiedProp } from "@qualcomm-ui/mdx-common";
3
+ import type { QuiComment } from "@qualcomm-ui/typedoc-common";
3
4
  import type { ComponentProps, DocProps } from "../types";
4
5
  export interface PropFormatterOptions {
5
6
  docPropsPath?: string;
@@ -15,6 +16,7 @@ export declare class PropFormatter {
15
16
  loadDocProps(): Promise<DocProps | null>;
16
17
  private formatCommentParts;
17
18
  private formatComment;
19
+ extractSinceTag(comment: QuiComment | undefined): string | undefined;
18
20
  extractProps(props: ComponentProps, isPartial: boolean): SimplifiedProp[];
19
21
  private convertPropInfo;
20
22
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"doc-props-plugin.d.ts","sourceRoot":"","sources":["../../../../../src/docs-plugin/markdown/knowledge/plugins/doc-props-plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,SAAS,CAAA;AAGnC,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAA;AAQ3D,OAAO,KAAK,EAAC,cAAc,EAAE,QAAQ,EAAW,MAAM,UAAU,CAAA;AAoDhE,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,oBAAoB;IAMnC,YAAY,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAoC9C,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,aAAa;IAoCrB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,GAAG,cAAc,EAAE;IA0BzE,OAAO,CAAC,eAAe;IAiBvB;;;OAGG;IACH,mBAAmB,IAAI,MAAM;CA8F9B"}
1
+ {"version":3,"file":"doc-props-plugin.d.ts","sourceRoot":"","sources":["../../../../../src/docs-plugin/markdown/knowledge/plugins/doc-props-plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,SAAS,CAAA;AAGnC,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EACV,UAAU,EAEX,MAAM,6BAA6B,CAAA;AAIpC,OAAO,KAAK,EAAC,cAAc,EAAE,QAAQ,EAAW,MAAM,UAAU,CAAA;AAoDhE,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,oBAAoB;IAMnC,YAAY,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAoC9C,OAAO,CAAC,kBAAkB;IAoC1B,OAAO,CAAC,aAAa;IAoCrB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS;IAKpE,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,GAAG,cAAc,EAAE;IA0BzE,OAAO,CAAC,eAAe;IAkBvB;;;OAGG;IACH,mBAAmB,IAAI,MAAM;CAoG9B"}
@@ -1 +1 @@
1
- {"version":3,"file":"section-extractor.d.ts","sourceRoot":"","sources":["../../../../src/docs-plugin/markdown/knowledge/section-extractor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAqB,IAAI,EAAoB,MAAM,OAAO,CAAA;AAOtE,OAAO,KAAK,EAEV,SAAS,EACT,WAAW,EACX,YAAY,EAGb,MAAM,yBAAyB,CAAA;AAOhC,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IAEjB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAeD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,GAAG,EAAE,WAAW,EAAE,CAAA;CACnB;AA+BD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;gBAEzB,OAAO,CAAC,EAAE,uBAAuB;IAO7C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,gBAAgB;IA2FzD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI;IA6B7D,OAAO,CAAC,iBAAiB;IAmEzB,OAAO,CAAC,YAAY;IAwCpB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,iBAAiB;CAG1B"}
1
+ {"version":3,"file":"section-extractor.d.ts","sourceRoot":"","sources":["../../../../src/docs-plugin/markdown/knowledge/section-extractor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAqB,IAAI,EAAoB,MAAM,OAAO,CAAA;AAOtE,OAAO,KAAK,EAEV,SAAS,EACT,WAAW,EACX,YAAY,EAGb,MAAM,yBAAyB,CAAA;AAOhC,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IAEjB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAeD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,GAAG,EAAE,WAAW,EAAE,CAAA;CACnB;AA+BD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;gBAEzB,OAAO,CAAC,EAAE,uBAAuB;IAO7C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,gBAAgB;IA2FzD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI;IA6B7D,OAAO,CAAC,iBAAiB;IA6EzB,OAAO,CAAC,YAAY;IAwCpB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,iBAAiB;CAG1B"}
@@ -6,6 +6,7 @@ export interface ImportedModule {
6
6
  path: string;
7
7
  }
8
8
  export interface ComponentProps {
9
+ comment?: QuiComment;
9
10
  input?: PropInfo[];
10
11
  name: string;
11
12
  output?: PropInfo[];
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/docs-plugin/markdown/knowledge/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,OAAO,CAAA;AAE/B,OAAO,KAAK,EAAC,SAAS,EAAE,YAAY,EAAC,MAAM,yBAAyB,CAAA;AACpE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,6BAA6B,CAAA;AAE3D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE;QACb,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,UAAU,EAAE,IAAI,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,mBAAmB,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B,aAAa,EAAE,aAAa,CAAA;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAA;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/docs-plugin/markdown/knowledge/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,OAAO,CAAA;AAE/B,OAAO,KAAK,EAAC,SAAS,EAAE,YAAY,EAAC,MAAM,yBAAyB,CAAA;AACpE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,6BAA6B,CAAA;AAE3D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE;QACb,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,UAAU,EAAE,IAAI,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,mBAAmB,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B,aAAa,EAAE,aAAa,CAAA;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAA;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA"}
@@ -1,4 +1,4 @@
1
- import type { NavItem, PageFrontmatter, PageSection } from "@qualcomm-ui/mdx-common";
1
+ import { type NavItem, type PageFrontmatter, type PageSection } from "@qualcomm-ui/mdx-common";
2
2
  import type { NavMeta, RouteMetaEntryInternal, RouteMetaInternal } from "./types";
3
3
  /**
4
4
  * Given a flat remix route structure, computes nested navigation items for the QUI
@@ -52,5 +52,6 @@ export declare class NavBuilder {
52
52
  * Walks over the tree and builds search metadata using the nearest sectionTitle.
53
53
  */
54
54
  private buildSearchMeta;
55
+ private extractBadges;
55
56
  }
56
57
  //# sourceMappingURL=nav-builder.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"nav-builder.d.ts","sourceRoot":"","sources":["../../../src/docs-plugin/nav-builder/nav-builder.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,WAAW,EACZ,MAAM,yBAAyB,CAAA;AAKhC,OAAO,KAAK,EAAC,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAC,MAAM,SAAS,CAAA;AAQ/E;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAgB;IAEpC,IAAI,QAAQ,IAAI,OAAO,EAAE,CAExB;IACD,OAAO,CAAC,SAAS,CAAgB;IAEjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKzE,GAAG,CACD,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,OAAO,CAAC,eAAe,CAAC,EACzC,SAAS,CAAC,EAAE,sBAAsB,GACjC,IAAI;IAIP,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,OAAO,CAAC,WAAW;IA6CnB,mBAAmB,CACjB,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC,EACrC,SAAS,EAAE,OAAO,CAAC,sBAAsB,CAAC,EAC1C,QAAQ,EAAE,MAAM,GACf,MAAM;IAQT;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA4EpB;;;OAGG;IACH,OAAO,CAAC,YAAY;IA4CpB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IAU1B;;;OAGG;IACH,KAAK,IAAI,OAAO,EAAE;IA+BlB,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,eAAe;CA8BxB"}
1
+ {"version":3,"file":"nav-builder.d.ts","sourceRoot":"","sources":["../../../src/docs-plugin/nav-builder/nav-builder.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAA;AAKhC,OAAO,KAAK,EAAC,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAC,MAAM,SAAS,CAAA;AAQ/E;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,YAAY,CAAgB;IAEpC,IAAI,QAAQ,IAAI,OAAO,EAAE,CAExB;IACD,OAAO,CAAC,SAAS,CAAgB;IAEjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKzE,GAAG,CACD,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,OAAO,CAAC,eAAe,CAAC,EACzC,SAAS,CAAC,EAAE,sBAAsB,GACjC,IAAI;IAIP,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,OAAO,CAAC,WAAW;IA6CnB,mBAAmB,CACjB,WAAW,EAAE,OAAO,CAAC,eAAe,CAAC,EACrC,SAAS,EAAE,OAAO,CAAC,sBAAsB,CAAC,EAC1C,QAAQ,EAAE,MAAM,GACf,MAAM;IAQT;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA6EpB;;;OAGG;IACH,OAAO,CAAC,YAAY;IA4CpB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IAU1B;;;OAGG;IACH,KAAK,IAAI,OAAO,EAAE;IA+BlB,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB,OAAO,CAAC,aAAa;CAWtB"}
package/dist/index.js CHANGED
@@ -1308,6 +1308,9 @@ function getRouteMeta(pathSegments, metaJson) {
1308
1308
  // src/docs-plugin/nav-builder/nav-builder.ts
1309
1309
  import { sortBy } from "lodash-es";
1310
1310
  import { v4 as uuidv4 } from "uuid";
1311
+ import {
1312
+ isNavBadge
1313
+ } from "@qualcomm-ui/mdx-common";
1311
1314
  import { capitalCase } from "@qualcomm-ui/utils/change-case";
1312
1315
  import { defined } from "@qualcomm-ui/utils/guard";
1313
1316
  var NavBuilder = class {
@@ -1419,6 +1422,7 @@ var NavBuilder = class {
1419
1422
  this.metaJson
1420
1423
  ) ?? {};
1421
1424
  this.flatNavItems.push({
1425
+ badges: isPage ? this.extractBadges(pageFrontmatter) : void 0,
1422
1426
  depth,
1423
1427
  expanded: routeMeta?.expanded || false,
1424
1428
  group: isPage ? routeMeta.group || pageFrontmatter.group : routeMeta.group,
@@ -1591,6 +1595,13 @@ var NavBuilder = class {
1591
1595
  }
1592
1596
  return results;
1593
1597
  }
1598
+ extractBadges(pageFrontmatter) {
1599
+ const badges = pageFrontmatter.badges;
1600
+ if (badges && typeof badges === "object" && Array.isArray(badges)) {
1601
+ return badges.filter((badge) => isNavBadge(badge) && !badge.hideFromNav);
1602
+ }
1603
+ return void 0;
1604
+ }
1594
1605
  };
1595
1606
 
1596
1607
  // src/docs-plugin/nav-builder/page-map.ts
@@ -2353,6 +2364,10 @@ ${tagContent.trim()}
2353
2364
  }
2354
2365
  return parts.join("\n\n");
2355
2366
  }
2367
+ extractSinceTag(comment) {
2368
+ const sinceTag = comment?.blockTags?.find((tag) => tag?.tag === "@since");
2369
+ return sinceTag?.content?.[0]?.text;
2370
+ }
2356
2371
  extractProps(props, isPartial) {
2357
2372
  const propsInfo = [];
2358
2373
  if (props.props?.length) {
@@ -2385,7 +2400,8 @@ ${tagContent.trim()}
2385
2400
  },
2386
2401
  description: this.formatComment(propInfo.comment || null),
2387
2402
  propType,
2388
- required: extractRequired(propInfo, isPartial) || void 0
2403
+ required: extractRequired(propInfo, isPartial) || void 0,
2404
+ since: this.extractSinceTag(propInfo.comment)
2389
2405
  };
2390
2406
  }
2391
2407
  /**
@@ -2465,7 +2481,13 @@ ${propsToDefinitionList(outputs)}`);
2465
2481
  return;
2466
2482
  }
2467
2483
  Object.assign(node, {
2468
- data: { typeDocProps: { name: propsName, props: propTypes } },
2484
+ data: {
2485
+ typeDocProps: {
2486
+ name: propsName,
2487
+ props: propTypes,
2488
+ since: this.extractSinceTag(componentProps.comment)
2489
+ }
2490
+ },
2469
2491
  lang: null,
2470
2492
  meta: null,
2471
2493
  type: "code",
@@ -2761,8 +2783,12 @@ var SectionExtractor = class {
2761
2783
  if (node.type === "code") {
2762
2784
  const codeNode = node;
2763
2785
  if (codeNode.data?.typeDocProps) {
2764
- const { name, props } = codeNode.data.typeDocProps;
2765
- sectionTypes.push({ props, type: name });
2786
+ const { name, props, since } = codeNode.data.typeDocProps;
2787
+ sectionTypes.push({
2788
+ props,
2789
+ since,
2790
+ type: name
2791
+ });
2766
2792
  }
2767
2793
  codeExamples.push({
2768
2794
  code: codeNode.value,