@supersoniks/concorde 4.6.0 → 4.7.3

package/src/docs/search/markdown-renderer.ts

@@ -4,6 +4,7 @@ import { unsafeHTML } from "lit/directives/unsafe-html.js";
 import { Subscriber } from "@supersoniks/concorde/mixins";
 import { Marked } from "marked-ts";
 import { gfmHeadingId } from "marked-gfm-heading-id";
+import { parseMarkdownWithSonicCode } from "./sonic-code-markdown";
 declare const window: { marked: Marked };
 const tagName = "docs-markdown-renderer"; // For Astro.build
 const marked = window.marked;
@@ -17,9 +18,10 @@ export class DocsMakdownRenderer extends Subscriber(LitElement) {
   @property() anchor = "";
   private _text = "";
   set text(value: string) {
-    const html = marked.parse(value);
-
-    this._text = html;
+    this._text = parseMarkdownWithSonicCode(
+      (markdown) => marked.parse(markdown) as string,
+      value,
+    );
     this.requestUpdate();
     setTimeout(() => {
       const anchor = this.querySelector("#" + this.anchor) as HTMLElement;
@@ -36,6 +38,8 @@ export class DocsMakdownRenderer extends Subscriber(LitElement) {
   }
 
   appendImport() {
+    if (this.querySelector("h1 + sonic-code")) return;
+
     const locationHash = document.location.hash;
     const isComponent = locationHash.includes("components");
 

package/src/docs/search/page.ts

@@ -2,6 +2,8 @@ import { html, LitElement, nothing, PropertyValues } from "lit";
 import { customElement, property } from "lit/decorators.js";
 import { Subscriber } from "@supersoniks/concorde/mixins";
 import { LocationHandler } from "@supersoniks/concorde/utils";
+import { parseDocsLocation } from "../docs-location";
+
 const tagName = "docs-page"; // For Astro.build
 @customElement(tagName)
 export class DocsPage extends Subscriber(LitElement) {
@@ -24,27 +26,22 @@ export class DocsPage extends Subscriber(LitElement) {
   anchor = "";
 
   willUpdate(changedProperties: PropertyValues) {
-    const sharpIdx = this.location.indexOf("#");
-    if (sharpIdx) {
-      const split = this.location.substring(sharpIdx + 1).split("/");
-      this.anchor = decodeURI(split.pop());
-      this.url = split.join("/");
-    }
+    const { url, anchor } = parseDocsLocation(this.location);
+    this.anchor = anchor;
+    this.url = url;
     super.willUpdate(changedProperties);
   }
 
   render() {
     if (!this.url) return nothing;
     return html`
-    
-        <sonic-fetch noShadowDom dataProvider="pageHTML" endPoint="${
-          this.markDownsURL + this.url + "?" + Math.random()
-        }">
-          <docs-markdown-renderer anchor="${
-            this.anchor
-          }"></docs-markdown-renderer>
+        <sonic-fetch
+          noShadowDom
+          dataProvider="pageHTML"
+          endPoint=${this.markDownsURL + this.url}
+        >
+          <docs-markdown-renderer anchor="${this.anchor}"></docs-markdown-renderer>
         </sonic-fetch>
-      </sonic-fetch>
     `;
   }
 }

package/src/docs/search/sonic-code-markdown.spec.ts

@@ -0,0 +1,29 @@
+import { describe, it, expect } from "vitest";
+import { marked } from "marked";
+import { parseMarkdownWithSonicCode } from "./sonic-code-markdown";
+
+describe("parseMarkdownWithSonicCode", () => {
+  it("preserves blank lines inside sonic-code templates", () => {
+    const md = `<sonic-code language="typescript">
+  <template>
+import { sub } from "@supersoniks/concorde/directives";
+
+const counterKey = new DataProviderKey("myCounter");
+
+render() {
+  return html\`<p>\${sub(counterKey.count)}</p>\`;
+}
+  </template>
+</sonic-code>`;
+
+    const html = parseMarkdownWithSonicCode(
+      (source) => marked.parse(source) as string,
+      md,
+    );
+
+    expect(html).toContain('import { sub } from "@supersoniks/concorde/directives";');
+    expect(html).toContain("const counterKey");
+    expect(html).not.toContain("<p>const counterKey");
+    expect(html).not.toMatch(/<p>render\(\)/);
+  });
+});

package/src/docs/search/sonic-code-markdown.ts

@@ -0,0 +1,28 @@
+const SONIC_CODE_BLOCK_RE = /<sonic-code\b[\s\S]*?<\/sonic-code>/gi;
+const PLACEHOLDER_RE = /<!--SONIC_CODE_(\d+)-->/g;
+
+/** HTML comment placeholders survive marked blank-line HTML-block breaks. */
+export function protectSonicCodeBlocks(markdown: string): {
+  markdown: string;
+  blocks: string[];
+} {
+  const blocks: string[] = [];
+  const protectedMarkdown = markdown.replace(SONIC_CODE_BLOCK_RE, (block) => {
+    const index = blocks.length;
+    blocks.push(block);
+    return `\n\n<!--SONIC_CODE_${index}-->\n\n`;
+  });
+  return { markdown: protectedMarkdown, blocks };
+}
+
+export function restoreSonicCodeBlocks(html: string, blocks: string[]): string {
+  return html.replace(PLACEHOLDER_RE, (_, index) => blocks[Number(index)] ?? "");
+}
+
+export function parseMarkdownWithSonicCode(
+  parse: (markdown: string) => string,
+  markdown: string,
+): string {
+  const { markdown: protectedMd, blocks } = protectSonicCodeBlocks(markdown);
+  return restoreSonicCodeBlocks(parse(protectedMd), blocks);
+}

package/src/docs.ts

@@ -1,4 +1,8 @@
 import "./index";
+import { registerDocsMockApiServiceWorker } from "./docs/mock-api/register";
+
+void registerDocsMockApiServiceWorker();
+
 import "./docs/docs";
 import "./docs/example/decorators-demo";
 import "./core/components/functional/router/router.demo";

package/src/tsconfig.json

@@ -846,6 +846,9 @@
       "./decorators/subscriber/subscribe.type-test": [
         "/sites/concorde/src/core/decorators/subscriber/subscribe.type-test.ts"
       ],
+      "./directives/DataProvider.sub.spec": [
+        "/sites/concorde/src/core/directives/DataProvider.sub.spec.ts"
+      ],
       "./directives/DataProvider": [
         "/sites/concorde/src/core/directives/DataProvider.ts"
       ],
@@ -918,6 +921,9 @@
       "./utils/endpoint": [
         "/sites/concorde/src/core/utils/endpoint.ts"
       ],
+      "./utils/publisherPathKey.spec": [
+        "/sites/concorde/src/core/utils/publisherPathKey.spec.ts"
+      ],
       "./utils/route.spec": [
         "/sites/concorde/src/core/utils/route.spec.ts"
       ],
@@ -930,6 +936,33 @@
       "./code": [
         "/sites/concorde/src/docs/code.ts"
       ],
+      "./docs-demo-sources": [
+        "/sites/concorde/src/docs/components/docs-demo-sources.ts"
+      ],
+      "./undefined/docs-demo-sources": [
+        "/sites/concorde/src/docs/components/docs-demo-sources.ts"
+      ],
+      "./docs-lit-demo-raw": [
+        "/sites/concorde/src/docs/components/docs-lit-demo-raw.ts"
+      ],
+      "./undefined/docs-lit-demo-raw": [
+        "/sites/concorde/src/docs/components/docs-lit-demo-raw.ts"
+      ],
+      "./docs-lit-demo": [
+        "/sites/concorde/src/docs/components/docs-lit-demo.ts"
+      ],
+      "./undefined/docs-lit-demo": [
+        "/sites/concorde/src/docs/components/docs-lit-demo.ts"
+      ],
+      "./docs-source-link": [
+        "/sites/concorde/src/docs/components/docs-source-link.ts"
+      ],
+      "./undefined/docs-source-link": [
+        "/sites/concorde/src/docs/components/docs-source-link.ts"
+      ],
+      "./docs-location": [
+        "/sites/concorde/src/docs/docs-location.ts"
+      ],
       "./docs": [
         "/sites/concorde/src/docs/docs.ts"
       ],
@@ -948,6 +981,36 @@
       "./example/decorators-demo": [
         "/sites/concorde/src/docs/example/decorators-demo.ts"
       ],
+      "./example/docs-api-config-demos": [
+        "/sites/concorde/src/docs/example/docs-api-config-demos.ts"
+      ],
+      "./example/docs-joke-demos": [
+        "/sites/concorde/src/docs/example/docs-joke-demos.ts"
+      ],
+      "./example/docs-list-demos": [
+        "/sites/concorde/src/docs/example/docs-list-demos.ts"
+      ],
+      "./example/docs-provider-keys": [
+        "/sites/concorde/src/docs/example/docs-provider-keys.ts"
+      ],
+      "./example/docs-queue-demos": [
+        "/sites/concorde/src/docs/example/docs-queue-demos.ts"
+      ],
+      "./example/docs-router-demos": [
+        "/sites/concorde/src/docs/example/docs-router-demos.ts"
+      ],
+      "./example/docs-submit-demos": [
+        "/sites/concorde/src/docs/example/docs-submit-demos.ts"
+      ],
+      "./example/docs-toggle-demos": [
+        "/sites/concorde/src/docs/example/docs-toggle-demos.ts"
+      ],
+      "./example/docs-user-two-scopes": [
+        "/sites/concorde/src/docs/example/docs-user-two-scopes.ts"
+      ],
+      "./example/docs-users-list": [
+        "/sites/concorde/src/docs/example/docs-users-list.ts"
+      ],
       "./example/users": [
         "/sites/concorde/src/docs/example/users.ts"
       ],
@@ -957,6 +1020,24 @@
       "./layout": [
         "/sites/concorde/src/docs/layout.ts"
       ],
+      "./mock-api/api-config-mock": [
+        "/sites/concorde/src/docs/mock-api/api-config-mock.ts"
+      ],
+      "./mock-api/fixtures": [
+        "/sites/concorde/src/docs/mock-api/fixtures.ts"
+      ],
+      "./mock-api/register": [
+        "/sites/concorde/src/docs/mock-api/register.ts"
+      ],
+      "./mock-api/router": [
+        "/sites/concorde/src/docs/mock-api/router.ts"
+      ],
+      "./mock-api/service-worker": [
+        "/sites/concorde/src/docs/mock-api/service-worker.ts"
+      ],
+      "./mock-api/urls": [
+        "/sites/concorde/src/docs/mock-api/urls.ts"
+      ],
       "./navigation/navigation": [
         "/sites/concorde/src/docs/navigation/navigation.ts"
       ],
@@ -972,6 +1053,12 @@
       "./search/search": [
         "/sites/concorde/src/docs/search/search.ts"
       ],
+      "./search/sonic-code-markdown.spec": [
+        "/sites/concorde/src/docs/search/sonic-code-markdown.spec.ts"
+      ],
+      "./search/sonic-code-markdown": [
+        "/sites/concorde/src/docs/search/sonic-code-markdown.ts"
+      ],
       "./tailwind/css/tailwind.d": [
         "/sites/concorde/src/docs/tailwind/css/tailwind.d.ts"
       ],

package/src/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./components.ts","./concorde-loaded.ts","./dataprovider.ts","./decorators.ts","./directives.ts","./index.ts","./mixins.ts","./utils.ts","./core/core.ts","./core/_types/endpoint.ts","./core/_types/key.ts","./core/_types/types.ts","./core/components/functional/functional.ts","./core/components/functional/date/date.ts","./core/components/functional/example/example.ts","./core/components/functional/fetch/fetch.ts","./core/components/functional/if/if.test.ts","./core/components/functional/if/if.ts","./core/components/functional/list/list.demo.ts","./core/components/functional/list/list.spec.ts","./core/components/functional/list/list.ts","./core/components/functional/mix/mix.ts","./core/components/functional/queue/queue.demo.ts","./core/components/functional/queue/queue.ts","./core/components/functional/router/redirect.ts","./core/components/functional/router/router.demo.ts","./core/components/functional/router/router.spec.ts","./core/components/functional/router/router.ts","./core/components/functional/sdui/SDUIDescriptorTransformer.ts","./core/components/functional/sdui/sdui-utils.ts","./core/components/functional/sdui/sdui.ts","./core/components/functional/sdui/types.ts","./core/components/functional/sonic-scope/sonic-scope.ts","./core/components/functional/states/states.demo.ts","./core/components/functional/states/states.spec.ts","./core/components/functional/states/states.ts","./core/components/functional/submit/submit.ts","./core/components/functional/subscriber/subscriber.ts","./core/components/functional/translation/translation.ts","./core/components/functional/value/value.ts","./core/components/ui/ui.ts","./core/components/ui/_css/scroll.ts","./core/components/ui/_css/shadow.ts","./core/components/ui/_css/size.ts","./core/components/ui/_css/type.ts","./core/components/ui/alert/alert.ts","./core/components/ui/alert-messages/alert-messages.ts","./core/components/ui/badge/badge.ts","./core/components/ui/button/button.ts","./core/components/ui/captcha/altchaStyles.ts","./core/components/ui/captcha/captcha.ts","./core/components/ui/card/card-footer.ts","./core/components/ui/card/card-header-descripton.ts","./core/components/ui/card/card-header.ts","./core/components/ui/card/card-main.ts","./core/components/ui/card/card.ts","./core/components/ui/divider/divider.ts","./core/components/ui/form/checkbox/checkbox.ts","./core/components/ui/form/css/form-control.ts","./core/components/ui/form/fieldset/fieldset.ts","./core/components/ui/form/fieldset/legend-description.ts","./core/components/ui/form/fieldset/legend.ts","./core/components/ui/form/form-actions/form-actions.ts","./core/components/ui/form/form-layout/form-layout.ts","./core/components/ui/form/input/input.ts","./core/components/ui/form/input/password-helper.ts","./core/components/ui/form/input/same-value-helper.ts","./core/components/ui/form/input-autocomplete/input-autocomplete.ts","./core/components/ui/form/radio/radio.ts","./core/components/ui/form/select/select.ts","./core/components/ui/form/switch/switch.ts","./core/components/ui/form/textarea/textarea.ts","./core/components/ui/group/group.ts","./core/components/ui/icon/icon.stories.ts","./core/components/ui/icon/icon.ts","./core/components/ui/icon/icons.ts","./core/components/ui/image/image.ts","./core/components/ui/link/link.ts","./core/components/ui/loader/loader.stories.ts","./core/components/ui/loader/loader.ts","./core/components/ui/loader/styles/fixed.ts","./core/components/ui/loader/styles/inline.ts","./core/components/ui/menu/menu-item.ts","./core/components/ui/menu/menu.ts","./core/components/ui/modal/modal-actions.ts","./core/components/ui/modal/modal-close.ts","./core/components/ui/modal/modal-content.ts","./core/components/ui/modal/modal-subtitle.ts","./core/components/ui/modal/modal-title.ts","./core/components/ui/modal/modal-utils.ts","./core/components/ui/modal/modal.ts","./core/components/ui/pop/pop.ts","./core/components/ui/progress/progress.ts","./core/components/ui/table/table-caption.ts","./core/components/ui/table/table-tbody.ts","./core/components/ui/table/table-td.ts","./core/components/ui/table/table-tfoot.ts","./core/components/ui/table/table-th.ts","./core/components/ui/table/table-thead.ts","./core/components/ui/table/table-tr.ts","./core/components/ui/table/table.ts","./core/components/ui/theme/theme.ts","./core/components/ui/theme/theme-collection/core-variables.ts","./core/components/ui/theme/theme-collection/dark.ts","./core/components/ui/theme/theme-collection/light.ts","./core/components/ui/toast/message-subscriber.ts","./core/components/ui/toast/toast-item.ts","./core/components/ui/toast/toast.ts","./core/components/ui/toast/types.ts","./core/components/ui/tooltip/tooltip.ts","./core/decorators/Subscriber.ts","./core/decorators/api.spec.ts","./core/decorators/api.ts","./core/decorators/lifecycle.ts","./core/decorators/subscriber/ancestorAttribute.ts","./core/decorators/subscriber/autoFill.ts","./core/decorators/subscriber/autoSubscribe.ts","./core/decorators/subscriber/bind.ts","./core/decorators/subscriber/common.ts","./core/decorators/subscriber/dynamicPath.ts","./core/decorators/subscriber/dynamicPropertyWatch.spec.ts","./core/decorators/subscriber/dynamicPropertyWatch.ts","./core/decorators/subscriber/handle.disambig.spec.ts","./core/decorators/subscriber/handle.skip.spec.ts","./core/decorators/subscriber/handle.ts","./core/decorators/subscriber/onAssign.ts","./core/decorators/subscriber/publish.spec.ts","./core/decorators/subscriber/publish.ts","./core/decorators/subscriber/publisherPath.ts","./core/decorators/subscriber/subscribe.spec.ts","./core/decorators/subscriber/subscribe.ts","./core/directives/DataProvider.ts","./core/directives/Wording.ts","./core/mixins/Fetcher.ts","./core/mixins/FormCheckable.ts","./core/mixins/FormElement.ts","./core/mixins/FormInput.ts","./core/mixins/Subscriber.ts","./core/mixins/TemplatesContainer.ts","./core/mixins/mixins.ts","./core/utils/Arrays.ts","./core/utils/DataBindObserver.ts","./core/utils/Electron.ts","./core/utils/Format.ts","./core/utils/HTML.ts","./core/utils/LocationHandler.ts","./core/utils/Objects.ts","./core/utils/PublisherProxy.ts","./core/utils/Utils.ts","./core/utils/aesCrypto.ts","./core/utils/api.ts","./core/utils/dataProviderKey.spec.ts","./core/utils/dataProviderKey.ts","./core/utils/endpoint.spec.ts","./core/utils/endpoint.ts","./core/utils/route.spec.ts","./core/utils/route.ts","./core/utils/url-pattern.ts","./test-utils/TestUtils.ts"],"version":"5.9.2"}
+{"root":["./components.ts","./concorde-loaded.ts","./dataprovider.ts","./decorators.ts","./directives.ts","./index.ts","./mixins.ts","./utils.ts","./core/core.ts","./core/_types/endpoint.ts","./core/_types/key.ts","./core/_types/types.ts","./core/components/functional/functional.ts","./core/components/functional/date/date.ts","./core/components/functional/example/example.ts","./core/components/functional/fetch/fetch.ts","./core/components/functional/if/if.test.ts","./core/components/functional/if/if.ts","./core/components/functional/list/list.demo.ts","./core/components/functional/list/list.spec.ts","./core/components/functional/list/list.ts","./core/components/functional/mix/mix.ts","./core/components/functional/queue/queue.demo.ts","./core/components/functional/queue/queue.ts","./core/components/functional/router/redirect.ts","./core/components/functional/router/router.demo.ts","./core/components/functional/router/router.spec.ts","./core/components/functional/router/router.ts","./core/components/functional/sdui/SDUIDescriptorTransformer.ts","./core/components/functional/sdui/sdui-utils.ts","./core/components/functional/sdui/sdui.ts","./core/components/functional/sdui/types.ts","./core/components/functional/sonic-scope/sonic-scope.ts","./core/components/functional/states/states.demo.ts","./core/components/functional/states/states.spec.ts","./core/components/functional/states/states.ts","./core/components/functional/submit/submit.ts","./core/components/functional/subscriber/subscriber.ts","./core/components/functional/translation/translation.ts","./core/components/functional/value/value.ts","./core/components/ui/ui.ts","./core/components/ui/_css/scroll.ts","./core/components/ui/_css/shadow.ts","./core/components/ui/_css/size.ts","./core/components/ui/_css/type.ts","./core/components/ui/alert/alert.ts","./core/components/ui/alert-messages/alert-messages.ts","./core/components/ui/badge/badge.ts","./core/components/ui/button/button.ts","./core/components/ui/captcha/altchaStyles.ts","./core/components/ui/captcha/captcha.ts","./core/components/ui/card/card-footer.ts","./core/components/ui/card/card-header-descripton.ts","./core/components/ui/card/card-header.ts","./core/components/ui/card/card-main.ts","./core/components/ui/card/card.ts","./core/components/ui/divider/divider.ts","./core/components/ui/form/checkbox/checkbox.ts","./core/components/ui/form/css/form-control.ts","./core/components/ui/form/fieldset/fieldset.ts","./core/components/ui/form/fieldset/legend-description.ts","./core/components/ui/form/fieldset/legend.ts","./core/components/ui/form/form-actions/form-actions.ts","./core/components/ui/form/form-layout/form-layout.ts","./core/components/ui/form/input/input.ts","./core/components/ui/form/input/password-helper.ts","./core/components/ui/form/input/same-value-helper.ts","./core/components/ui/form/input-autocomplete/input-autocomplete.ts","./core/components/ui/form/radio/radio.ts","./core/components/ui/form/select/select.ts","./core/components/ui/form/switch/switch.ts","./core/components/ui/form/textarea/textarea.ts","./core/components/ui/group/group.ts","./core/components/ui/icon/icon.stories.ts","./core/components/ui/icon/icon.ts","./core/components/ui/icon/icons.ts","./core/components/ui/image/image.ts","./core/components/ui/link/link.ts","./core/components/ui/loader/loader.stories.ts","./core/components/ui/loader/loader.ts","./core/components/ui/loader/styles/fixed.ts","./core/components/ui/loader/styles/inline.ts","./core/components/ui/menu/menu-item.ts","./core/components/ui/menu/menu.ts","./core/components/ui/modal/modal-actions.ts","./core/components/ui/modal/modal-close.ts","./core/components/ui/modal/modal-content.ts","./core/components/ui/modal/modal-subtitle.ts","./core/components/ui/modal/modal-title.ts","./core/components/ui/modal/modal-utils.ts","./core/components/ui/modal/modal.ts","./core/components/ui/pop/pop.ts","./core/components/ui/progress/progress.ts","./core/components/ui/table/table-caption.ts","./core/components/ui/table/table-tbody.ts","./core/components/ui/table/table-td.ts","./core/components/ui/table/table-tfoot.ts","./core/components/ui/table/table-th.ts","./core/components/ui/table/table-thead.ts","./core/components/ui/table/table-tr.ts","./core/components/ui/table/table.ts","./core/components/ui/theme/theme.ts","./core/components/ui/theme/theme-collection/core-variables.ts","./core/components/ui/theme/theme-collection/dark.ts","./core/components/ui/theme/theme-collection/light.ts","./core/components/ui/toast/message-subscriber.ts","./core/components/ui/toast/toast-item.ts","./core/components/ui/toast/toast.ts","./core/components/ui/toast/types.ts","./core/components/ui/tooltip/tooltip.ts","./core/decorators/Subscriber.ts","./core/decorators/api.spec.ts","./core/decorators/api.ts","./core/decorators/lifecycle.ts","./core/decorators/subscriber/ancestorAttribute.ts","./core/decorators/subscriber/autoFill.ts","./core/decorators/subscriber/autoSubscribe.ts","./core/decorators/subscriber/bind.ts","./core/decorators/subscriber/common.ts","./core/decorators/subscriber/dynamicPath.ts","./core/decorators/subscriber/dynamicPropertyWatch.spec.ts","./core/decorators/subscriber/dynamicPropertyWatch.ts","./core/decorators/subscriber/handle.disambig.spec.ts","./core/decorators/subscriber/handle.skip.spec.ts","./core/decorators/subscriber/handle.ts","./core/decorators/subscriber/onAssign.ts","./core/decorators/subscriber/publish.spec.ts","./core/decorators/subscriber/publish.ts","./core/decorators/subscriber/publisherPath.ts","./core/decorators/subscriber/subscribe.spec.ts","./core/decorators/subscriber/subscribe.ts","./core/directives/DataProvider.sub.spec.ts","./core/directives/DataProvider.ts","./core/directives/Wording.ts","./core/mixins/Fetcher.ts","./core/mixins/FormCheckable.ts","./core/mixins/FormElement.ts","./core/mixins/FormInput.ts","./core/mixins/Subscriber.ts","./core/mixins/TemplatesContainer.ts","./core/mixins/mixins.ts","./core/utils/Arrays.ts","./core/utils/DataBindObserver.ts","./core/utils/Electron.ts","./core/utils/Format.ts","./core/utils/HTML.ts","./core/utils/LocationHandler.ts","./core/utils/Objects.ts","./core/utils/PublisherProxy.ts","./core/utils/Utils.ts","./core/utils/aesCrypto.ts","./core/utils/api.ts","./core/utils/dataProviderKey.spec.ts","./core/utils/dataProviderKey.ts","./core/utils/endpoint.spec.ts","./core/utils/endpoint.ts","./core/utils/publisherPathKey.spec.ts","./core/utils/route.spec.ts","./core/utils/route.ts","./core/utils/url-pattern.ts","./test-utils/TestUtils.ts"],"version":"5.9.2"}

package/vite.config.mts

@@ -5,6 +5,8 @@ import basicSsl from "@vitejs/plugin-basic-ssl";
 import { defineConfig } from "vite";
 import path from "path";
 import fs from "fs";
+import { docsMockApiVitePlugin } from "./scripts/docs-mock-api-vite-plugin";
+import { docsOpenInEditorPlugin } from "./scripts/docs-open-in-editor-plugin";
 
 function CustomHmr() {
   return {
@@ -39,6 +41,9 @@ export const config = {
 let libName = process.env.LIB_NAME;
 if (!libName) libName = "core";
 const currentConfig = config[libName];
+/** `yarn dev` sert la doc (index.html → docs.ts) sans LIB_NAME=docs */
+const enableDocsMockApi =
+  libName === "docs" || process.env.npm_lifecycle_event === "dev";
 const build = {
   // minify: "terser",
   emptyOutDir: true, //!currentConfig.isLibrary,
@@ -119,5 +124,8 @@ export default defineConfig({
     postcssLit({
       include: ["src/**/*.css", "src/**/*.css?*"],
     }),
+    ...(enableDocsMockApi
+      ? [docsMockApiVitePlugin(), docsOpenInEditorPlugin()]
+      : []),
   ],
 });