@forsakringskassan/docs-generator 2.30.0 → 2.30.2

package/dist/index.mjs

@@ -4,18 +4,18 @@ const require = $createRequire(import.meta.url);
 
 import fs from 'node:fs/promises';
 import path from 'node:path/posix';
-import { g as globSync, m as minimatch, M as MarkdownIt, d as dedent, b as closest, e as distance, f as fm, i as isCI, h as glob, j as moduleImporter, k as cliProgress, t as tinylr, w as watch, l as createInstance, n as fse, o as inter } from './vendor-B6t9njJr.mjs';
-import { g as generateId, p as parseInfostring, i as isDocumentPage, n as normalizePath, a as getFingerprint, h as hasTag, f as findTag, b as getOutputFilePath, d as htmlencode, e as exampleWorkerUrl, c as createMarkdownRenderer, j as generateExample } from './create-markdown-renderer-D5LtM0yF.mjs';
+import { g as globSync, m as minimatch, M as MarkdownIt, d as dedent, b as closest, e as distance, f as fm, i as isCI, h as glob, j as moduleImporter, k as cliProgress, t as tinylr, w as watch, l as createInstance, n as fse, o as inter } from './vendor-0oN9XFM9.mjs';
+import { g as generateId, p as parseInfostring, i as isDocumentPage, n as normalizePath, a as getFingerprint, h as hasTag, f as findTag, b as getOutputFilePath, d as htmlencode, e as exampleWorkerUrl, c as createMarkdownRenderer, j as generateExample } from './create-markdown-renderer-D5JN5FPy.mjs';
 import path$1 from 'node:path';
 import require$$1 from 'crypto';
 import 'node:crypto';
 import { exec } from 'node:child_process';
 import util, { promisify } from 'node:util';
 import { codeFrameColumns } from '@babel/code-frame';
-import { parse } from 'vue-docgen-api';
-import { parse as parse$2 } from '@babel/parser';
+import { parse as parse$1 } from '@babel/parser';
 import traverseModule from '@babel/traverse';
-import { parse as parse$1, compileScript as compileScript$1, compileTemplate } from 'vue/compiler-sfc';
+import { parse, compileScript as compileScript$1, compileTemplate } from 'vue/compiler-sfc';
+import { parse as parse$2 } from 'vue-docgen-api';
 import fs__default, { existsSync, readFileSync, copyFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { compileStringAsync, NodePackageImporter } from 'sass';
@@ -46,7 +46,7 @@ import 'tls';
 import 'tty';
 import 'querystring';
 import 'vue';
-import './vue3-CRwEnRGE.mjs';
+import './vue3-Bvwupe7o.mjs';
 
 function toArray$2(value) {
   return Array.isArray(value) ? value : [value];
@@ -1117,193 +1117,213 @@ async function frontMatterFileReader(filePath, basePath) {
   return [doc];
 }
 
-function getPropSlotDeprecated(prop) {
-  const tags = prop.tags;
-  if (!tags?.deprecated) {
+function isStringLiteral(node) {
+  return node.type === "StringLiteral";
+}
+function isObjectExpression(node) {
+  return node.type === "ObjectExpression";
+}
+function isDocComment(node) {
+  return node.type === "CommentBlock";
+}
+function getDescription(node) {
+  if (!node) {
     return null;
   }
-  const tag = tags.deprecated[0];
-  if (!tag?.description) {
+  const text = node.value;
+  if (!text.startsWith("*")) {
     return null;
   }
-  if (tag.description === true) {
-    return "";
-  } else {
-    return tag.description;
-  }
+  return node.value.replace(/^\s*[*]\s/gm, "").replace(/\s+$/gm, "");
 }
-function getEventDeprecated(event) {
-  const tags = event.tags;
-  if (!tags) {
+function flattenMemberExpression(node) {
+  const { object, property } = node;
+  if (property.type !== "Identifier") {
     return null;
   }
-  const tag = tags.find((it) => it.title === "deprecated");
-  if (!tag?.content) {
-    return null;
+  if (object.type === "Identifier") {
+    return [object.name, property.name].join(".");
   }
-  if (tag.content === true) {
-    return "";
-  } else {
-    return tag.content;
+  if (object.type === "ThisExpression") {
+    return ["this", property.name].join(".");
   }
-}
-function translateProps(props) {
-  const isRelevant = (prop) => {
-    return prop.tags?.ignore === void 0;
-  };
-  return props.filter(isRelevant).map((prop) => {
-    const defaultValue = prop.defaultValue ? { value: prop.defaultValue.value } : null;
-    return {
-      name: prop.name,
-      description: prop.description ?? null,
-      type: prop.type?.name ?? null,
-      required: Boolean(prop.required),
-      default: defaultValue,
-      deprecated: getPropSlotDeprecated(prop)
-    };
-  });
-}
-function translateEvents(events) {
-  const translatedEvents = [];
-  for (const event of events) {
-    if (event.tags?.find((it) => it.title === "ignore")) {
-      continue;
+  if (object.type === "MemberExpression") {
+    const nested = flattenMemberExpression(object);
+    if (nested) {
+      return [nested, property.name].join(".");
     }
-    const translatedEvent = {
-      name: event.name,
-      description: event.description ?? null,
-      properties: translateEventProperties(event),
-      deprecated: getEventDeprecated(event)
-    };
-    translatedEvents.push(translatedEvent);
   }
-  return translatedEvents;
+  return null;
 }
-function translateEventProperties(event) {
-  const properties = event.properties;
-  const types = event.type ? Object.values(event.type.names) : [];
-  if (!properties && !types.length) {
+function getParameters(node) {
+  if (!node) {
     return [];
   }
-  if (!properties) {
-    return [
-      { name: "<anonymous>", type: String(types), description: null }
-    ];
-  }
-  const translatedProperties = [];
-  for (let i = 0; i < properties.length; i++) {
-    const property = properties[i];
-    const name = property.name ?? "<anonymous>";
-    const eventType = types[i];
-    const hasEventType = Boolean(eventType) && eventType !== "undefined";
-    const type = hasEventType ? eventType : property.type.names.join(" ");
-    const description = typeof property.description === "string" ? property.description : null;
-    translatedProperties.push({
-      name,
-      type,
-      description
+  const parameters = [];
+  for (const property of node.properties) {
+    if (property.type !== "ObjectProperty") {
+      continue;
+    }
+    if (property.key.type !== "Identifier") {
+      continue;
+    }
+    const docComment = property.leadingComments?.find(isDocComment);
+    parameters.push({
+      name: property.key.name,
+      description: getDescription(docComment)
     });
   }
-  return translatedProperties;
+  return parameters;
 }
-function translateSlots(slots) {
-  const translatedSlots = [];
-  for (const slot of slots) {
-    if (slot.tags?.ignore) {
-      continue;
+function isTranslateCall(node) {
+  const allowedNames = [
+    "this.$t",
+    // options api (inside computed, methods, etc)
+    "_ctx.$t",
+    // options api (template)
+    "$setup.$t",
+    // script setup or setup in options api
+    "TranslationService.provider.translate"
+    // props call this directly
+  ];
+  if (node.callee.type === "MemberExpression") {
+    const fullName = flattenMemberExpression(node.callee);
+    return Boolean(fullName && allowedNames.includes(fullName));
+  }
+  if (node.callee.type === "Identifier") {
+    return node.callee.name === "$t";
+  }
+  return false;
+}
+function findDocComment(path, node) {
+  if (node.leadingComments) {
+    const doc = node.leadingComments.find(isDocComment);
+    if (doc) {
+      return doc;
     }
-    const translatedSlot = {
-      name: slot.name,
-      description: slot.description ?? null,
-      bindings: translateSlotBindings(slot),
-      deprecated: getPropSlotDeprecated(slot)
-    };
-    translatedSlots.push(translatedSlot);
   }
-  return translatedSlots;
+  const parent = path.parent;
+  if (parent.leadingComments && (parent.type === "ReturnStatement" || parent.type === "ObjectProperty")) {
+    const doc = parent.leadingComments.find(isDocComment);
+    if (doc) {
+      return doc;
+    }
+  }
+  const grandparent = path.parentPath?.parent;
+  if (parent.type === "VariableDeclarator" && grandparent?.leadingComments) {
+    const doc = grandparent.leadingComments.find(isDocComment);
+    if (doc) {
+      return doc;
+    }
+  }
+  return null;
 }
-function translateSlotBindings(slot) {
-  if (!slot.bindings) {
+function findTranslations(filename, content) {
+  const { descriptor, errors } = parse(content, { filename });
+  if (errors.length > 0) {
+    if (isCI) {
+      const first = errors[0].message;
+      throw new Error(
+        `Errors occurred when trying to parse "${filename}": ${first}`
+      );
+    }
     return [];
   }
-  const translatedBindings = [];
-  for (const binding of slot.bindings) {
-    const name = binding.name ?? "<anonymous>";
-    const type = binding.type?.name ?? "unknown";
-    const description = typeof binding.description === "string" ? binding.description : null;
-    translatedBindings.push({
-      name,
-      type,
-      description
+  const id = "faux-id";
+  let sourcecode = "";
+  let bindings = void 0;
+  if (descriptor.script || descriptor.scriptSetup) {
+    const script = compileScript$1(descriptor, {
+      id,
+      isProd: false,
+      sourceMap: false,
+      inlineTemplate: false,
+      genDefaultAs: "exampleComponent",
+      templateOptions: {
+        filename,
+        source: descriptor.template?.content,
+        slotted: descriptor.slotted,
+        compilerOptions: {
+          comments: true,
+          whitespace: "condense",
+          mode: "module"
+        }
+      }
     });
+    bindings = script.bindings;
+    sourcecode += `${script.content}
+
+`;
   }
-  return translatedBindings;
-}
-function filterModels(rawProps, rawEvents) {
-  const modelEvents = rawEvents.filter((it) => it.name.startsWith("update:"));
-  const rawModels = modelEvents.map((it) => {
-    const propName = it.name.slice("update:".length);
-    const prop = rawProps.find((it2) => it2.name === propName);
-    if (!prop) {
-      return null;
-    }
-    return {
-      ...prop,
-      name: propName === "modelValue" ? "v-model" : `v-model:${propName}`
-    };
+  if (descriptor.template) {
+    const template = compileTemplate({
+      id,
+      filename,
+      source: descriptor.template.content,
+      slotted: descriptor.slotted,
+      preprocessLang: descriptor.template.lang,
+      compilerOptions: {
+        bindingMetadata: bindings,
+        comments: true,
+        whitespace: "condense",
+        mode: "module"
+      }
+    });
+    sourcecode += `${template.code}
+
+`;
+  }
+  const ast = parse$1(sourcecode, {
+    sourceType: "module",
+    plugins: ["typescript"]
   });
-  const models = rawModels.filter((model) => model !== null);
-  const events = rawEvents.filter((it) => !it.name.startsWith("update:"));
-  const props = rawProps.filter((prop) => {
-    const hasModelName = models.some(
-      (model) => model.name.slice("v-model:".length) === prop.name
-    );
-    return !(hasModelName || prop.name.startsWith("modelValue"));
+  const traverse = "default" in traverseModule ? traverseModule.default : traverseModule;
+  const result = [];
+  traverse(ast, {
+    CallExpression(path) {
+      const { node } = path;
+      if (isTranslateCall(node)) {
+        const [name, ...defaultOrParams] = node.arguments;
+        const textArgument = defaultOrParams.find(isStringLiteral);
+        const paramArgument = defaultOrParams.find(isObjectExpression);
+        if (name.type !== "StringLiteral") {
+          return;
+        }
+        const defaultTranslation = textArgument ? textArgument.value : null;
+        const docComment = findDocComment(path, node);
+        result.push({
+          name: name.value,
+          defaultTranslation,
+          description: getDescription(docComment),
+          parameters: getParameters(paramArgument)
+        });
+      }
+    }
   });
-  return { models, props, events };
-}
-async function translateAPI(filePath) {
-  try {
-    const api = await parse(filePath);
-    const rawProps = api.props ? translateProps(api.props) : [];
-    const rawEvents = api.events ? translateEvents(api.events) : [];
-    const { models, props, events } = filterModels(rawProps, rawEvents);
-    const slots = api.slots ? translateSlots(api.slots) : [];
-    return {
-      name: api.displayName,
-      slug: slugify(api.displayName),
-      models,
-      props,
-      events,
-      slots
-    };
-  } catch (err) {
-    throw new Error(
-      `Failed to generate API description from "${filePath}"`,
-      { cause: err }
-    );
-  }
+  return result;
 }
 
 const md$4 = MarkdownIt();
 const EMPTY_CHAR$4 = "&#8208;";
+const EM_DASH$2 = `<span role="presentation">&mdash;</span>`;
 function render$5(text) {
   return text ? md$4.render(text) : EMPTY_CHAR$4;
 }
 function renderInline$4(text) {
   return text ? md$4.renderInline(text) : EMPTY_CHAR$4;
 }
-function generateModelTable(slug, models) {
+function generateEventTable(slug, events) {
   return (
     /* HTML */
     `
-        <next-heading-level id="${slug}-models">
-            <a class="header-anchor" href="#${slug}-models">Models</a>
+        <next-heading-level id="${slug}-events">
+            <a class="header-anchor" href="#${slug}-events">Events</a>
         </next-heading-level>
-        <dl class="docs-api docs-api--models">
-            ${models.map((model) => {
-      const { name } = model;
-      const id = `${slug}-model-${slugify(name)}`;
+        <dl class="docs-api docs-api--events">
+            ${events.map((event) => {
+      const { name } = event;
+      const id = `${slug}-event-${slugify(name)}`;
+      const haveProperties = event.properties.length > 0;
       return (
         /* HTML */
         `
@@ -1312,16 +1332,23 @@ function generateModelTable(slug, models) {
                                 ><a class="docs-api__anchor" href="#${id}"
                                     ><span class="docs-api__name"
                                         >${htmlencode(name)}</span
-                                    >: ${htmlencode(model.type ?? "unknown")}</a
+                                    ></a
                                 ></code
                             >
-                            ${model.required ? "" : `<span class="docs-tag docs-tag--default">Optional</span>`}
-                            ${model.deprecated === null ? "" : `<span class="docs-tag docs-tag--deprecated">Deprecated</span>`}
+                            ${event.deprecated === null ? "" : `<span class="docs-tag docs-tag--deprecated">Deprecated</span>`}
                         </dt>
                         <dd>
-                            ${render$5(model.description)}
-                            ${model.default ? `<p class="doc-api__item">Default: <code>${htmlencode(model.default.value)}</code></p>` : ""}
-                            ${model.deprecated ? `<p class="doc-api__item docs-deprecated">Deprecated: ${renderInline$4(model.deprecated)}</p>` : ""}
+                            ${render$5(event.description)}
+                            ${haveProperties ? `<p class="docs-api__list-title">Arguments:</p><ul class="docs-api__list">` : ""}
+                            ${event.properties.map((it) => {
+          if (it.description) {
+            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code> ${EM_DASH$2} ${renderInline$4(it.description)}</li>`;
+          } else {
+            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code></li>`;
+          }
+        }).join("")}
+                            ${haveProperties ? `</ul>` : ""}
+                            ${event.deprecated ? `<p class="docs-api__deprecated docs-deprecated">Deprecated: ${renderInline$4(event.deprecated)}</p>` : ""}
                         </dd>
                     `
       );
@@ -1339,17 +1366,17 @@ function render$4(text) {
 function renderInline$3(text) {
   return text ? md$3.renderInline(text) : EMPTY_CHAR$3;
 }
-function generatePropTable(slug, props) {
+function generateModelTable(slug, models) {
   return (
     /* HTML */
     `
-        <next-heading-level id="${slug}-props">
-            <a class="header-anchor" href="#${slug}-props">Props</a>
+        <next-heading-level id="${slug}-models">
+            <a class="header-anchor" href="#${slug}-models">Models</a>
         </next-heading-level>
-        <dl class="docs-api docs-api--slots">
-            ${props.map((prop) => {
-      const { name } = prop;
-      const id = `${slug}-prop-${slugify(name)}`;
+        <dl class="docs-api docs-api--models">
+            ${models.map((model) => {
+      const { name } = model;
+      const id = `${slug}-model-${slugify(name)}`;
       return (
         /* HTML */
         `
@@ -1358,16 +1385,16 @@ function generatePropTable(slug, props) {
                                 ><a class="docs-api__anchor" href="#${id}"
                                     ><span class="docs-api__name"
                                         >${htmlencode(name)}</span
-                                    >: ${htmlencode(prop.type ?? "unknown")}</a
+                                    >: ${htmlencode(model.type ?? "unknown")}</a
                                 ></code
                             >
-                            ${prop.required ? "" : `<span class="docs-tag docs-tag--default">Optional</span>`}
-                            ${prop.deprecated === null ? "" : `<span class="docs-tag docs-tag--deprecated">Deprecated</span>`}
+                            ${model.required ? "" : `<span class="docs-tag docs-tag--default">Optional</span>`}
+                            ${model.deprecated === null ? "" : `<span class="docs-tag docs-tag--deprecated">Deprecated</span>`}
                         </dt>
                         <dd>
-                            ${render$4(prop.description)}
-                            ${prop.default ? `<p class="doc-api__item">Default: <code>${htmlencode(prop.default.value)}</code></p>` : ""}
-                            ${prop.deprecated ? `<p class="doc-api__item docs-deprecated">Deprecated: ${renderInline$3(prop.deprecated)}</p>` : ""}
+                            ${render$4(model.description)}
+                            ${model.default ? `<p class="doc-api__item">Default: <code>${htmlencode(model.default.value)}</code></p>` : ""}
+                            ${model.deprecated ? `<p class="doc-api__item docs-deprecated">Deprecated: ${renderInline$3(model.deprecated)}</p>` : ""}
                         </dd>
                     `
       );
@@ -1379,25 +1406,23 @@ function generatePropTable(slug, props) {
 
 const md$2 = MarkdownIt();
 const EMPTY_CHAR$2 = "&#8208;";
-const EM_DASH$2 = `<span role="presentation">&mdash;</span>`;
 function render$3(text) {
   return text ? md$2.render(text) : EMPTY_CHAR$2;
 }
 function renderInline$2(text) {
   return text ? md$2.renderInline(text) : EMPTY_CHAR$2;
 }
-function generateEventTable(slug, events) {
+function generatePropTable(slug, props) {
   return (
     /* HTML */
     `
-        <next-heading-level id="${slug}-events">
-            <a class="header-anchor" href="#${slug}-events">Events</a>
+        <next-heading-level id="${slug}-props">
+            <a class="header-anchor" href="#${slug}-props">Props</a>
         </next-heading-level>
-        <dl class="docs-api docs-api--events">
-            ${events.map((event) => {
-      const { name } = event;
-      const id = `${slug}-event-${slugify(name)}`;
-      const haveProperties = event.properties.length > 0;
+        <dl class="docs-api docs-api--slots">
+            ${props.map((prop) => {
+      const { name } = prop;
+      const id = `${slug}-prop-${slugify(name)}`;
       return (
         /* HTML */
         `
@@ -1406,23 +1431,16 @@ function generateEventTable(slug, events) {
                                 ><a class="docs-api__anchor" href="#${id}"
                                     ><span class="docs-api__name"
                                         >${htmlencode(name)}</span
-                                    ></a
+                                    >: ${htmlencode(prop.type ?? "unknown")}</a
                                 ></code
                             >
-                            ${event.deprecated === null ? "" : `<span class="docs-tag docs-tag--deprecated">Deprecated</span>`}
+                            ${prop.required ? "" : `<span class="docs-tag docs-tag--default">Optional</span>`}
+                            ${prop.deprecated === null ? "" : `<span class="docs-tag docs-tag--deprecated">Deprecated</span>`}
                         </dt>
                         <dd>
-                            ${render$3(event.description)}
-                            ${haveProperties ? `<p class="docs-api__list-title">Arguments:</p><ul class="docs-api__list">` : ""}
-                            ${event.properties.map((it) => {
-          if (it.description) {
-            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code> ${EM_DASH$2} ${renderInline$2(it.description)}</li>`;
-          } else {
-            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code></li>`;
-          }
-        }).join("")}
-                            ${haveProperties ? `</ul>` : ""}
-                            ${event.deprecated ? `<p class="docs-api__deprecated docs-deprecated">Deprecated: ${renderInline$2(event.deprecated)}</p>` : ""}
+                            ${render$3(prop.description)}
+                            ${prop.default ? `<p class="doc-api__item">Default: <code>${htmlencode(prop.default.value)}</code></p>` : ""}
+                            ${prop.deprecated ? `<p class="doc-api__item docs-deprecated">Deprecated: ${renderInline$2(prop.deprecated)}</p>` : ""}
                         </dd>
                     `
       );
@@ -1471,13 +1489,64 @@ function generateSlotTable(slug, slots) {
                             ${haveBindings ? `<p class="docs-api__list-title">Bindings:</p><ul class="docs-api__list">` : ""}
                             ${slot.bindings.map((it) => {
           if (it.description) {
-            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code> ${EM_DASH$1} ${renderInline$1(it.description)}</li>`;
+            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code> ${EM_DASH$1} ${renderInline$1(it.description)}</li>`;
+          } else {
+            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code></li>`;
+          }
+        }).join("")}
+                            ${haveBindings ? `</ul>` : ""}
+                            ${slot.deprecated ? `<p class="docs-api__deprecated docs-deprecated">Deprecated: ${renderInline$1(slot.deprecated)}</p>` : ""}
+                        </dd>
+                    `
+      );
+    }).join("")}
+        </dl>
+    `
+  );
+}
+
+const md = MarkdownIt();
+const EMPTY_CHAR = "&#8208;";
+const EM_DASH = `<span role="presentation">&mdash;</span>`;
+function render$1(text) {
+  return text ? md.render(text) : EMPTY_CHAR;
+}
+function renderInline(text) {
+  return text ? md.renderInline(text) : EMPTY_CHAR;
+}
+function generateTranslationTable(slug, translations) {
+  return (
+    /* HTML */
+    `
+        <dl class="docs-api docs-api--translation">
+            ${translations.map((translation) => {
+      const { name } = translation;
+      const id = `${slug}-translation-${slugify(name)}`;
+      const haveParameters = translation.parameters.length > 0;
+      return (
+        /* HTML */
+        `
+                        <dt>
+                            <code id="${id}"
+                                ><a class="docs-api__anchor" href="#${id}"
+                                    ><span class="docs-api__name"
+                                        >${htmlencode(name)}</span
+                                    ></a
+                                ></code
+                            >
+                        </dt>
+                        <dd>
+                            ${render$1(translation.description)}
+                            ${translation.defaultTranslation ? `<p class="doc-api__item">Default: "${htmlencode(translation.defaultTranslation)}"</p>` : ""}
+                            ${haveParameters ? `<p class="docs-api__list-title">Parameters:</p><ul class="docs-api__list">` : ""}
+                            ${translation.parameters.map((it) => {
+          if (it.description) {
+            return `<li><code>${htmlencode(it.name)}</code> ${EM_DASH} ${renderInline(it.description)}</li>`;
           } else {
-            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code></li>`;
+            return `<li><code>${htmlencode(it.name)}</code></li>`;
           }
         }).join("")}
-                            ${haveBindings ? `</ul>` : ""}
-                            ${slot.deprecated ? `<p class="docs-api__deprecated docs-deprecated">Deprecated: ${renderInline$1(slot.deprecated)}</p>` : ""}
+                            ${haveParameters ? `</ul>` : ""}
                         </dd>
                     `
       );
@@ -1487,241 +1556,172 @@ function generateSlotTable(slug, slots) {
   );
 }
 
-function isStringLiteral(node) {
-  return node.type === "StringLiteral";
-}
-function isObjectExpression(node) {
-  return node.type === "ObjectExpression";
-}
-function isDocComment(node) {
-  return node.type === "CommentBlock";
-}
-function getDescription(node) {
-  if (!node) {
+function getPropSlotDeprecated(prop) {
+  const tags = prop.tags;
+  if (!tags?.deprecated) {
     return null;
   }
-  const text = node.value;
-  if (!text.startsWith("*")) {
+  const tag = tags.deprecated[0];
+  if (!tag?.description) {
     return null;
   }
-  return node.value.replace(/^\s*[*]\s/gm, "").replace(/\s+$/gm, "");
+  if (tag.description === true) {
+    return "";
+  } else {
+    return tag.description;
+  }
 }
-function flattenMemberExpression(node) {
-  const { object, property } = node;
-  if (property.type !== "Identifier") {
+function getEventDeprecated(event) {
+  const tags = event.tags;
+  if (!tags) {
     return null;
   }
-  if (object.type === "Identifier") {
-    return [object.name, property.name].join(".");
-  }
-  if (object.type === "ThisExpression") {
-    return ["this", property.name].join(".");
-  }
-  if (object.type === "MemberExpression") {
-    const nested = flattenMemberExpression(object);
-    if (nested) {
-      return [nested, property.name].join(".");
-    }
-  }
-  return null;
-}
-function getParameters(node) {
-  if (!node) {
-    return [];
+  const tag = tags.find((it) => it.title === "deprecated");
+  if (!tag?.content) {
+    return null;
   }
-  const parameters = [];
-  for (const property of node.properties) {
-    if (property.type !== "ObjectProperty") {
-      continue;
-    }
-    if (property.key.type !== "Identifier") {
-      continue;
-    }
-    const docComment = property.leadingComments?.find(isDocComment);
-    parameters.push({
-      name: property.key.name,
-      description: getDescription(docComment)
-    });
+  if (tag.content === true) {
+    return "";
+  } else {
+    return tag.content;
   }
-  return parameters;
 }
-function isTranslateCall(node) {
-  const allowedNames = [
-    "this.$t",
-    // options api (inside computed, methods, etc)
-    "_ctx.$t",
-    // options api (template)
-    "$setup.$t",
-    // script setup or setup in options api
-    "TranslationService.provider.translate"
-    // props call this directly
-  ];
-  if (node.callee.type === "MemberExpression") {
-    const fullName = flattenMemberExpression(node.callee);
-    return Boolean(fullName && allowedNames.includes(fullName));
-  }
-  if (node.callee.type === "Identifier") {
-    return node.callee.name === "$t";
-  }
-  return false;
+function translateProps(props) {
+  const isRelevant = (prop) => {
+    return prop.tags?.ignore === void 0;
+  };
+  return props.filter(isRelevant).map((prop) => {
+    const defaultValue = prop.defaultValue ? { value: prop.defaultValue.value } : null;
+    return {
+      name: prop.name,
+      description: prop.description ?? null,
+      type: prop.type?.name ?? null,
+      required: Boolean(prop.required),
+      default: defaultValue,
+      deprecated: getPropSlotDeprecated(prop)
+    };
+  });
 }
-function findDocComment(path, node) {
-  if (node.leadingComments) {
-    const doc = node.leadingComments.find(isDocComment);
-    if (doc) {
-      return doc;
-    }
-  }
-  const parent = path.parent;
-  if (parent.leadingComments && (parent.type === "ReturnStatement" || parent.type === "ObjectProperty")) {
-    const doc = parent.leadingComments.find(isDocComment);
-    if (doc) {
-      return doc;
-    }
-  }
-  const grandparent = path.parentPath?.parent;
-  if (parent.type === "VariableDeclarator" && grandparent?.leadingComments) {
-    const doc = grandparent.leadingComments.find(isDocComment);
-    if (doc) {
-      return doc;
+function translateEvents(events) {
+  const translatedEvents = [];
+  for (const event of events) {
+    if (event.tags?.find((it) => it.title === "ignore")) {
+      continue;
     }
+    const translatedEvent = {
+      name: event.name,
+      description: event.description ?? null,
+      properties: translateEventProperties(event),
+      deprecated: getEventDeprecated(event)
+    };
+    translatedEvents.push(translatedEvent);
   }
-  return null;
+  return translatedEvents;
 }
-function findTranslations(filename, content) {
-  const { descriptor, errors } = parse$1(content, { filename });
-  if (errors.length > 0) {
-    if (isCI) {
-      const first = errors[0].message;
-      throw new Error(
-        `Errors occurred when trying to parse "${filename}": ${first}`
-      );
-    }
+function translateEventProperties(event) {
+  const properties = event.properties;
+  const types = event.type ? Object.values(event.type.names) : [];
+  if (!properties && !types.length) {
     return [];
   }
-  const id = "faux-id";
-  let sourcecode = "";
-  let bindings = void 0;
-  if (descriptor.script || descriptor.scriptSetup) {
-    const script = compileScript$1(descriptor, {
-      id,
-      isProd: false,
-      sourceMap: false,
-      inlineTemplate: false,
-      genDefaultAs: "exampleComponent",
-      templateOptions: {
-        filename,
-        source: descriptor.template?.content,
-        slotted: descriptor.slotted,
-        compilerOptions: {
-          comments: true,
-          whitespace: "condense",
-          mode: "module"
-        }
-      }
-    });
-    bindings = script.bindings;
-    sourcecode += `${script.content}
-
-`;
+  if (!properties) {
+    return [
+      { name: "<anonymous>", type: String(types), description: null }
+    ];
   }
-  if (descriptor.template) {
-    const template = compileTemplate({
-      id,
-      filename,
-      source: descriptor.template.content,
-      slotted: descriptor.slotted,
-      preprocessLang: descriptor.template.lang,
-      compilerOptions: {
-        bindingMetadata: bindings,
-        comments: true,
-        whitespace: "condense",
-        mode: "module"
-      }
+  const translatedProperties = [];
+  for (let i = 0; i < properties.length; i++) {
+    const property = properties[i];
+    const name = property.name ?? "<anonymous>";
+    const eventType = types[i];
+    const hasEventType = Boolean(eventType) && eventType !== "undefined";
+    const type = hasEventType ? eventType : property.type.names.join(" ");
+    const description = typeof property.description === "string" ? property.description : null;
+    translatedProperties.push({
+      name,
+      type,
+      description
     });
-    sourcecode += `${template.code}
-
-`;
   }
-  const ast = parse$2(sourcecode, {
-    sourceType: "module",
-    plugins: ["typescript"]
-  });
-  const traverse = "default" in traverseModule ? traverseModule.default : traverseModule;
-  const result = [];
-  traverse(ast, {
-    CallExpression(path) {
-      const { node } = path;
-      if (isTranslateCall(node)) {
-        const [name, ...defaultOrParams] = node.arguments;
-        const textArgument = defaultOrParams.find(isStringLiteral);
-        const paramArgument = defaultOrParams.find(isObjectExpression);
-        if (name.type !== "StringLiteral") {
-          return;
-        }
-        const defaultTranslation = textArgument ? textArgument.value : null;
-        const docComment = findDocComment(path, node);
-        result.push({
-          name: name.value,
-          defaultTranslation,
-          description: getDescription(docComment),
-          parameters: getParameters(paramArgument)
-        });
-      }
+  return translatedProperties;
+}
+function translateSlots(slots) {
+  const translatedSlots = [];
+  for (const slot of slots) {
+    if (slot.tags?.ignore) {
+      continue;
     }
-  });
-  return result;
+    const translatedSlot = {
+      name: slot.name,
+      description: slot.description ?? null,
+      bindings: translateSlotBindings(slot),
+      deprecated: getPropSlotDeprecated(slot)
+    };
+    translatedSlots.push(translatedSlot);
+  }
+  return translatedSlots;
 }
-
-const md = MarkdownIt();
-const EMPTY_CHAR = "&#8208;";
-const EM_DASH = `<span role="presentation">&mdash;</span>`;
-function render$1(text) {
-  return text ? md.render(text) : EMPTY_CHAR;
+function translateSlotBindings(slot) {
+  if (!slot.bindings) {
+    return [];
+  }
+  const translatedBindings = [];
+  for (const binding of slot.bindings) {
+    const name = binding.name ?? "<anonymous>";
+    const type = binding.type?.name ?? "unknown";
+    const description = typeof binding.description === "string" ? binding.description : null;
+    translatedBindings.push({
+      name,
+      type,
+      description
+    });
+  }
+  return translatedBindings;
 }
-function renderInline(text) {
-  return text ? md.renderInline(text) : EMPTY_CHAR;
+function filterModels(rawProps, rawEvents) {
+  const modelEvents = rawEvents.filter((it) => it.name.startsWith("update:"));
+  const rawModels = modelEvents.map((it) => {
+    const propName = it.name.slice("update:".length);
+    const prop = rawProps.find((it2) => it2.name === propName);
+    if (!prop) {
+      return null;
+    }
+    return {
+      ...prop,
+      name: propName === "modelValue" ? "v-model" : `v-model:${propName}`
+    };
+  });
+  const models = rawModels.filter((model) => model !== null);
+  const events = rawEvents.filter((it) => !it.name.startsWith("update:"));
+  const props = rawProps.filter((prop) => {
+    const hasModelName = models.some(
+      (model) => model.name.slice("v-model:".length) === prop.name
+    );
+    return !(hasModelName || prop.name.startsWith("modelValue"));
+  });
+  return { models, props, events };
 }
-function generateTranslationTable(slug, translations) {
-  return (
-    /* HTML */
-    `
-        <dl class="docs-api docs-api--translation">
-            ${translations.map((translation) => {
-      const { name } = translation;
-      const id = `${slug}-translation-${slugify(name)}`;
-      const haveParameters = translation.parameters.length > 0;
-      return (
-        /* HTML */
-        `
-                        <dt>
-                            <code id="${id}"
-                                ><a class="docs-api__anchor" href="#${id}"
-                                    ><span class="docs-api__name"
-                                        >${htmlencode(name)}</span
-                                    ></a
-                                ></code
-                            >
-                        </dt>
-                        <dd>
-                            ${render$1(translation.description)}
-                            ${translation.defaultTranslation ? `<p class="doc-api__item">Default: "${htmlencode(translation.defaultTranslation)}"</p>` : ""}
-                            ${haveParameters ? `<p class="docs-api__list-title">Parameters:</p><ul class="docs-api__list">` : ""}
-                            ${translation.parameters.map((it) => {
-          if (it.description) {
-            return `<li><code>${htmlencode(it.name)}</code> ${EM_DASH} ${renderInline(it.description)}</li>`;
-          } else {
-            return `<li><code>${htmlencode(it.name)}</code></li>`;
-          }
-        }).join("")}
-                            ${haveParameters ? `</ul>` : ""}
-                        </dd>
-                    `
-      );
-    }).join("")}
-        </dl>
-    `
-  );
+async function translateAPI(filePath) {
+  try {
+    const api = await parse$2(filePath);
+    const rawProps = api.props ? translateProps(api.props) : [];
+    const rawEvents = api.events ? translateEvents(api.events) : [];
+    const { models, props, events } = filterModels(rawProps, rawEvents);
+    const slots = api.slots ? translateSlots(api.slots) : [];
+    return {
+      name: api.displayName,
+      slug: slugify(api.displayName),
+      models,
+      props,
+      events,
+      slots
+    };
+  } catch (err) {
+    throw new Error(
+      `Failed to generate API description from "${filePath}"`,
+      { cause: err }
+    );
+  }
 }
 
 function parseAPI(filePath, api) {
@@ -2107,6 +2107,44 @@ function compileProcessorRuntime(generator, distDir, processors) {
   }
 }
 
+var translation$1 = {
+	component: {
+		component: "Component",
+		status: "Status"
+	},
+	outline: {
+		"in-this-article": "In this article"
+	},
+	search: {
+		button: "Search",
+		instructions: "<kbd>Esc</kbd> to close <kbd>Arrow up/down</kbd> to navigate <kbd>Enter</kbd> to select",
+		title: "Search",
+		placeholder: "Type to begin searching"
+	}
+};
+var langEn = {
+	translation: translation$1
+};
+
+var translation = {
+	component: {
+		component: "Komponent",
+		status: "Status"
+	},
+	outline: {
+		"in-this-article": "Innehåll"
+	},
+	search: {
+		button: "Sök",
+		instructions: "<kbd>Esc</kbd> för att stänga <kbd>Pil upp/ner</kbd> för att navigera <kbd>Enter</kbd> för att välja",
+		title: "Sök",
+		placeholder: "Skriv för att börja söka"
+	}
+};
+var langSv = {
+	translation: translation
+};
+
 function isNavigationSection(node) {
   return "key" in node;
 }
@@ -2312,68 +2350,6 @@ function sortNavigationTree(tree) {
 const templateUrl = new URL("../templates", import.meta.url);
 const templateDirectory = fileURLToPath(templateUrl);
 
-class TemplateLoader {
-  async = true;
-  folders;
-  templateCache;
-  constructor(folders = []) {
-    this.folders = [...folders, templateDirectory];
-    this.templateCache = /* @__PURE__ */ new Map();
-  }
-  /* eslint-disable-next-line @typescript-eslint/no-misused-promises -- technical debt */
-  async getSource(name, callback) {
-    try {
-      const { content, filePath } = await this.resolveTemplate(name);
-      callback(null, {
-        src: content,
-        path: filePath,
-        noCache: false
-      });
-    } catch (err) {
-      if (err instanceof Error) {
-        callback(err, null);
-      } else {
-        callback(new Error(String(err)), null);
-      }
-    }
-  }
-  hasTemplate(name) {
-    const { templateCache } = this;
-    const cached = templateCache.get(name);
-    if (cached) {
-      return true;
-    }
-    const filePath = this.findTemplateFile(name);
-    return Boolean(filePath);
-  }
-  async resolveTemplate(name) {
-    const { templateCache, folders } = this;
-    const cached = templateCache.get(name);
-    if (cached) {
-      return cached;
-    }
-    const filePath = this.findTemplateFile(name);
-    if (!filePath) {
-      const searched = folders.map((it) => `  - "${it}"`).join("\n");
-      const message = `Failed to resolve template "${name}", searched in:
-
-${searched}
-
-Make sure the name is correct and the template file exists in one of the listed directories.`;
-      throw new Error(message);
-    }
-    const content = await fs.readFile(filePath, "utf-8");
-    const resolved = { content, filePath };
-    templateCache.set(name, resolved);
-    return resolved;
-  }
-  findTemplateFile(name) {
-    const { folders } = this;
-    const searchPaths = folders.map((it) => path$1.join(it, name));
-    return searchPaths.find((it) => existsSync(it));
-  }
-}
-
 class MissingTemplateError extends Error {
   searchDir;
   constructor(fileInfo, template, format, searchDir) {
@@ -2404,22 +2380,84 @@ function findTemplate(folders, from, src, format) {
     layout = src.template;
     format = src.format !== "json" ? "html" : "json";
   }
-  const key = cacheKey(layout, format);
-  const cached = cache$1.get(key);
-  if (cached) {
-    return cached;
+  const key = cacheKey(layout, format);
+  const cached = cache$1.get(key);
+  if (cached) {
+    return cached;
+  }
+  folders = [...folders, templateDirectory];
+  const template = `${layout}.template.${format}`;
+  const searchPaths = folders.map((it) => {
+    return path$1.join(it, template);
+  });
+  const found = searchPaths.find((it) => fs__default.existsSync(it));
+  if (!found) {
+    throw new MissingTemplateError(from, template, format, folders);
+  }
+  cache$1.set(key, template);
+  return template;
+}
+
+class TemplateLoader {
+  async = true;
+  folders;
+  templateCache;
+  constructor(folders = []) {
+    this.folders = [...folders, templateDirectory];
+    this.templateCache = /* @__PURE__ */ new Map();
+  }
+  /* eslint-disable-next-line @typescript-eslint/no-misused-promises -- technical debt */
+  async getSource(name, callback) {
+    try {
+      const { content, filePath } = await this.resolveTemplate(name);
+      callback(null, {
+        src: content,
+        path: filePath,
+        noCache: false
+      });
+    } catch (err) {
+      if (err instanceof Error) {
+        callback(err, null);
+      } else {
+        callback(new Error(String(err)), null);
+      }
+    }
+  }
+  hasTemplate(name) {
+    const { templateCache } = this;
+    const cached = templateCache.get(name);
+    if (cached) {
+      return true;
+    }
+    const filePath = this.findTemplateFile(name);
+    return Boolean(filePath);
+  }
+  async resolveTemplate(name) {
+    const { templateCache, folders } = this;
+    const cached = templateCache.get(name);
+    if (cached) {
+      return cached;
+    }
+    const filePath = this.findTemplateFile(name);
+    if (!filePath) {
+      const searched = folders.map((it) => `  - "${it}"`).join("\n");
+      const message = `Failed to resolve template "${name}", searched in:
+
+${searched}
+
+Make sure the name is correct and the template file exists in one of the listed directories.`;
+      throw new Error(message);
+    }
+    const content = await fs.readFile(filePath, "utf-8");
+    const resolved = { content, filePath };
+    templateCache.set(name, resolved);
+    return resolved;
   }
-  folders = [...folders, templateDirectory];
-  const template = `${layout}.template.${format}`;
-  const searchPaths = folders.map((it) => {
-    return path$1.join(it, template);
-  });
-  const found = searchPaths.find((it) => fs__default.existsSync(it));
-  if (!found) {
-    throw new MissingTemplateError(from, template, format, folders);
+  findTemplateFile(name) {
+    const { folders } = this;
+    const searchPaths = folders.map((it) => path$1.join(it, name));
+    return searchPaths.find((it) => existsSync(it));
   }
-  cache$1.set(key, template);
-  return template;
 }
 
 const messageRegex = /^[(][^)]+[)] \[Line \d+, Column \d+\]\n\s+Error: (.*)$/;
@@ -2818,132 +2856,6 @@ function nunjucksProcessor(options) {
   };
 }
 
-var translation$1 = {
-	component: {
-		component: "Component",
-		status: "Status"
-	},
-	outline: {
-		"in-this-article": "In this article"
-	},
-	search: {
-		button: "Search",
-		instructions: "<kbd>Esc</kbd> to close <kbd>Arrow up/down</kbd> to navigate <kbd>Enter</kbd> to select",
-		title: "Search",
-		placeholder: "Type to begin searching"
-	}
-};
-var langEn = {
-	translation: translation$1
-};
-
-var translation = {
-	component: {
-		component: "Komponent",
-		status: "Status"
-	},
-	outline: {
-		"in-this-article": "Innehåll"
-	},
-	search: {
-		button: "Sök",
-		instructions: "<kbd>Esc</kbd> för att stänga <kbd>Pil upp/ner</kbd> för att navigera <kbd>Enter</kbd> för att välja",
-		title: "Sök",
-		placeholder: "Skriv för att börja söka"
-	}
-};
-var langSv = {
-	translation: translation
-};
-
-function getAssetSource(asset) {
-  const lines = [];
-  const pkg = asset.package.replace(/\\/g, "/");
-  lines.push(`export * from "${pkg}";`);
-  return lines.join("\n");
-}
-async function compileVendor(assetFolder, vendor, options) {
-  const name = path$1.isAbsolute(vendor.package) ? path$1.basename(vendor.package) : vendor.package;
-  const slug = slugify(name);
-  const outfile = `temp/vendor-${slug}.out.js`;
-  const tmpfile = `temp/vendor-${slug}.in.js`;
-  const source = getAssetSource(vendor);
-  await fs.writeFile(tmpfile, source, "utf-8");
-  await esbuild$1.build({
-    entryPoints: [tmpfile],
-    outfile,
-    bundle: true,
-    format: "esm",
-    platform: "browser",
-    tsconfig: tsconfigPath,
-    define: {
-      "process.env.NODE_ENV": JSON.stringify("development"),
-      __VUE_OPTIONS_API__: "true",
-      __VUE_PROD_DEVTOOLS__: "true",
-      __VUE_PROD_HYDRATION_MISMATCH_DETAILS__: "false"
-    },
-    alias: vendor.alias ? { [vendor.package]: vendor.alias } : void 0,
-    ...options
-  });
-  const content = await fs.readFile(outfile, "utf-8");
-  const fingerprint = getFingerprint(content);
-  const integrity = getIntegrity(content);
-  const filename = `vendor-${slug}-${fingerprint}.js`;
-  const dst = path$1.join(assetFolder, filename).replace(/\\/g, "/");
-  await fs.rename(outfile, dst);
-  const stat = await fs.stat(dst);
-  return {
-    package: vendor.package,
-    filename,
-    publicPath: `./assets/${filename}`,
-    integrity,
-    size: stat.size
-  };
-}
-
-function normalizeVendorDefinition(vendor) {
-  if (typeof vendor === "string") {
-    return {
-      package: vendor,
-      alias: void 0
-    };
-  } else {
-    return {
-      package: vendor.package,
-      alias: vendor.alias ?? void 0
-    };
-  }
-}
-
-function getPackageName(vendor) {
-  return typeof vendor === "string" ? vendor : vendor.package;
-}
-function generateVendorAssets(assetFolder, assets) {
-  const packages = assets.map(getPackageName);
-  const normalized = assets.map(normalizeVendorDefinition);
-  const promises = normalized.map((it) => {
-    const external = packages.filter((pkg) => pkg !== it.package);
-    return compileVendor(assetFolder, it, {
-      external
-    });
-  });
-  return Promise.all(promises);
-}
-function vendorProcessor(assetFolder, vendor) {
-  return {
-    stage: "assets",
-    name: "vendor-processor",
-    async handler(context) {
-      const assets = await generateVendorAssets(assetFolder, vendor);
-      context.addVendorAsset(assets);
-      for (const asset of assets) {
-        const filename = path.basename(asset.publicPath);
-        context.log(filename, formatSize(asset.size));
-      }
-    }
-  };
-}
-
 function livereloadProcessor(options) {
   const { enabled } = options;
   return {
@@ -3059,6 +2971,94 @@ async function serve(options) {
   }
 }
 
+function getAssetSource(asset) {
+  const lines = [];
+  const pkg = asset.package.replace(/\\/g, "/");
+  lines.push(`export * from "${pkg}";`);
+  return lines.join("\n");
+}
+async function compileVendor(assetFolder, vendor, options) {
+  const name = path$1.isAbsolute(vendor.package) ? path$1.basename(vendor.package) : vendor.package;
+  const slug = slugify(name);
+  const outfile = `temp/vendor-${slug}.out.js`;
+  const tmpfile = `temp/vendor-${slug}.in.js`;
+  const source = getAssetSource(vendor);
+  await fs.writeFile(tmpfile, source, "utf-8");
+  await esbuild$1.build({
+    entryPoints: [tmpfile],
+    outfile,
+    bundle: true,
+    format: "esm",
+    platform: "browser",
+    tsconfig: tsconfigPath,
+    define: {
+      "process.env.NODE_ENV": JSON.stringify("development"),
+      __VUE_OPTIONS_API__: "true",
+      __VUE_PROD_DEVTOOLS__: "true",
+      __VUE_PROD_HYDRATION_MISMATCH_DETAILS__: "false"
+    },
+    alias: vendor.alias ? { [vendor.package]: vendor.alias } : void 0,
+    ...options
+  });
+  const content = await fs.readFile(outfile, "utf-8");
+  const fingerprint = getFingerprint(content);
+  const integrity = getIntegrity(content);
+  const filename = `vendor-${slug}-${fingerprint}.js`;
+  const dst = path$1.join(assetFolder, filename).replace(/\\/g, "/");
+  await fs.rename(outfile, dst);
+  const stat = await fs.stat(dst);
+  return {
+    package: vendor.package,
+    filename,
+    publicPath: `./assets/${filename}`,
+    integrity,
+    size: stat.size
+  };
+}
+
+function normalizeVendorDefinition(vendor) {
+  if (typeof vendor === "string") {
+    return {
+      package: vendor,
+      alias: void 0
+    };
+  } else {
+    return {
+      package: vendor.package,
+      alias: vendor.alias ?? void 0
+    };
+  }
+}
+
+function getPackageName(vendor) {
+  return typeof vendor === "string" ? vendor : vendor.package;
+}
+function generateVendorAssets(assetFolder, assets) {
+  const packages = assets.map(getPackageName);
+  const normalized = assets.map(normalizeVendorDefinition);
+  const promises = normalized.map((it) => {
+    const external = packages.filter((pkg) => pkg !== it.package);
+    return compileVendor(assetFolder, it, {
+      external
+    });
+  });
+  return Promise.all(promises);
+}
+function vendorProcessor(assetFolder, vendor) {
+  return {
+    stage: "assets",
+    name: "vendor-processor",
+    async handler(context) {
+      const assets = await generateVendorAssets(assetFolder, vendor);
+      context.addVendorAsset(assets);
+      for (const asset of assets) {
+        const filename = path.basename(asset.publicPath);
+        context.log(filename, formatSize(asset.size));
+      }
+    }
+  };
+}
+
 function toArray(value) {
   return Array.isArray(value) ? value : [value];
 }