@mono-lit/helper 0.0.2 → 0.0.4

package/dist/src/utils/data-source-summary.d.ts

@@ -1,12 +1,13 @@
-import { arrayToODataString } from '../components/filter/filter-odata';
+import { arrayToODataString } from "../components/filter/filter-odata.js";
+//#region src/utils/data-source-summary.d.ts
 /** Aggregate kinds a spec may ask for — mirrors `MonoSummaryType` structurally. */
 export type MonoAggregateType = 'sum' | 'avg' | 'count' | 'min' | 'max' | 'countDistinct';
 /** The part of a summary spec that decides what to ask for. */
 export interface MonoAggregateSpec {
-    field?: string;
-    type?: MonoAggregateType;
-    /** Disambiguates two aggregates on the same field; also used as the alias. */
-    name?: string;
+  field?: string;
+  type?: MonoAggregateType;
+  /** Disambiguates two aggregates on the same field; also used as the alias. */
+  name?: string;
 }
 /**
  * A field a server can aggregate.
@@ -51,5 +52,5 @@ export declare function composeSummaryApply(apply: string, filter: unknown): str
  * searched away, which is worse than being slow.
  */
 export declare function summaryFilterOf(source: unknown): unknown;
-/** Re-exported so a resolver can convert a devextreme filter itself. */
-export { arrayToODataString as summaryODataFilter };
+//#endregion
+export { arrayToODataString as summaryODataFilter };

package/dist/src/utils/normalize-error.d.ts

@@ -1,3 +1,4 @@
+//#region src/utils/normalize-error.d.ts
 /**
  * A readable message for `raw`, or `fallback` when nothing legible can be found.
  *
@@ -51,20 +52,20 @@ export declare function errorStatus(raw: unknown): number | undefined;
  */
 export declare function collectErrorMessages(raw: unknown, status?: number | undefined): string[];
 export interface DescribedError {
-    /** The headline: the preset for the status when there is one, else the error's own text. */
-    message: string;
-    /** The HTTP status, `0` for a network failure, absent when the error carries none. */
-    status?: number;
-    /**
-     * Text the server (or the error itself) added beyond the status — the part a
-     * user CAN act on ("Budget period is closed"). Never a bare reason phrase.
-     */
-    detail?: string;
-    /**
-     * Every distinct message the error carried (see {@link collectErrorMessages}) —
-     * what `detail` joins. Empty when the error said nothing beyond its status.
-     */
-    messages: string[];
+  /** The headline: the preset for the status when there is one, else the error's own text. */
+  message: string;
+  /** The HTTP status, `0` for a network failure, absent when the error carries none. */
+  status?: number;
+  /**
+   * Text the server (or the error itself) added beyond the status — the part a
+   * user CAN act on ("Budget period is closed"). Never a bare reason phrase.
+   */
+  detail?: string;
+  /**
+   * Every distinct message the error carried (see {@link collectErrorMessages}) —
+   * what `detail` joins. Empty when the error said nothing beyond its status.
+   */
+  messages: string[];
 }
 /**
  * The one line a field shows for `err`: what the server said, every distinct
@@ -88,3 +89,4 @@ export declare function describeError(raw: unknown, messages?: MonoErrorMessages
  * Not a failure — nothing should be shown for it.
  */
 export declare function isCanceled(err: any): boolean;
+//#endregion

package/dist/src/vite/index.d.ts

@@ -1,36 +1,37 @@
 /// <reference path="../../vue.d.ts" />
-import { Plugin } from 'vite';
-import { monoClientOnlyPlugin } from './mono-client-only';
-import { monoSsrStubPlugin } from './mono-ssr-stub';
+import { MonoClientOnlyOptions, monoClientOnlyPlugin } from "./mono-client-only.js";
+import { MonoSsrStubOptions, monoSsrStubPlugin } from "./mono-ssr-stub.js";
+import { Plugin } from "vite";
+//#region src/vite/index.d.ts
 export interface MonoSsrOptions {
-    /** Custom-element tag prefix wrapped in <ClientOnly>. Default 'mono-'. */
-    prefix?: string;
-    /** Wrapper component used for client-only rendering. Default 'ClientOnly'. */
-    wrapper?: string;
-    /** Import prefix of registration modules stubbed during SSR. Default '@mono-lit/helper/ui/'. */
-    ssrStubPrefix?: string;
-    /**
-     * Tag names (e.g. `['mono-nav']`) to NOT wrap in `<ClientOnly>` — for
-     * components server-rendered by another mechanism (e.g. `nuxt-ssr-lit`
-     * shadow-DOM builds). Default `[]`.
-     */
-    exclude?: string[];
-    /**
-     * Wrap LIGHT `<prefix*>` elements in `<ClientOnly>`. Default `true`. `false`
-     * keeps the server import-stub and the shadow `<LitWrapper>` wrap but leaves
-     * light tags as they are — see `MonoClientOnlyOptions.lightWrap`.
-     */
-    lightWrap?: boolean;
-    /**
-     * Enable the import-driven SSR wrap: `<mono-*>` whose `@mono-lit/helper/ui/shadow/
-     * <entry>` build a `.vue` file imports get wrapped in `<LitWrapper>`
-     * (Declarative Shadow DOM) instead of `<ClientOnly>`. Default off.
-     */
-    litWrapper?: boolean;
-    /** Component name used for the SSR wrap. Default `'LitWrapper'`. */
-    litWrapperComponent?: string;
-    /** Tags to ALWAYS treat as shadow (for globally-registered components). */
-    shadowOverride?: string[];
+  /** Custom-element tag prefix wrapped in <ClientOnly>. Default 'mono-'. */
+  prefix?: string;
+  /** Wrapper component used for client-only rendering. Default 'ClientOnly'. */
+  wrapper?: string;
+  /** Import prefix of registration modules stubbed during SSR. Default '@mono-lit/helper/ui/'. */
+  ssrStubPrefix?: string;
+  /**
+   * Tag names (e.g. `['mono-nav']`) to NOT wrap in `<ClientOnly>` — for
+   * components server-rendered by another mechanism (e.g. `nuxt-ssr-lit`
+   * shadow-DOM builds). Default `[]`.
+   */
+  exclude?: string[];
+  /**
+   * Wrap LIGHT `<prefix*>` elements in `<ClientOnly>`. Default `true`. `false`
+   * keeps the server import-stub and the shadow `<LitWrapper>` wrap but leaves
+   * light tags as they are — see `MonoClientOnlyOptions.lightWrap`.
+   */
+  lightWrap?: boolean;
+  /**
+   * Enable the import-driven SSR wrap: `<mono-*>` whose `@mono-lit/helper/ui/shadow/
+   * <entry>` build a `.vue` file imports get wrapped in `<LitWrapper>`
+   * (Declarative Shadow DOM) instead of `<ClientOnly>`. Default off.
+   */
+  litWrapper?: boolean;
+  /** Component name used for the SSR wrap. Default `'LitWrapper'`. */
+  litWrapperComponent?: string;
+  /** Tags to ALWAYS treat as shadow (for globally-registered components). */
+  shadowOverride?: string[];
 }
 /**
  * One import, one props object — wires both halves of SSR support for the
@@ -43,6 +44,5 @@ export interface MonoSsrOptions {
  *   plugins: [monoSsr()]
  */
 export declare function monoSsr(options?: MonoSsrOptions): Plugin[];
-export { monoClientOnlyPlugin, monoSsrStubPlugin };
-export type { MonoClientOnlyOptions } from './mono-client-only';
-export type { MonoSsrStubOptions } from './mono-ssr-stub';
+//#endregion
+export { type MonoClientOnlyOptions, type MonoSsrStubOptions, monoClientOnlyPlugin, monoSsrStubPlugin };

package/dist/src/vite/mono-client-only.d.ts

@@ -1,35 +1,37 @@
-import { Plugin } from 'vite';
+import { Plugin } from "vite";
+//#region src/vite/mono-client-only.d.ts
 export interface MonoClientOnlyOptions {
-    prefix?: string;
-    wrapper?: string;
-    /**
-     * Tag names (e.g. `'mono-nav'`) to NOT wrap in the client-only wrapper.
-     * Use this for components that are server-rendered by another mechanism
-     * (e.g. `@lit-labs/ssr` / `nuxt-ssr-lit` shadow-DOM builds) — wrapping them
-     * in `<ClientOnly>` would suppress their server markup.
-     */
-    exclude?: string[];
-    /**
-     * Wrap LIGHT `<prefix*>` elements in the client-only wrapper. Default `true`.
-     * `false` leaves light tags untouched (they server-render as inert custom-element
-     * tags and upgrade in the browser) while the shadow `<LitWrapper>` wrap below
-     * keeps working — for apps whose pages are client-only as a whole and must not
-     * have each `<mono-*>` deferred past the page's `onMounted`.
-     */
-    lightWrap?: boolean;
-    /**
-     * Enable the import-driven SSR wrap: a `.vue` file that imports
-     * `@mono-lit/helper/ui/shadow/<entry>` gets its matching `<mono-*>` wrapped in
-     * `<LitWrapper>` (Declarative Shadow DOM) instead of `<ClientOnly>`. Needs
-     * `nuxt-ssr-lit` installed (provides the `<LitWrapper>` component). Default off.
-     */
-    litWrapper?: boolean;
-    /** Component name used for the SSR wrap. Default `'LitWrapper'`. */
-    litWrapperComponent?: string;
-    /**
-     * Tags to ALWAYS treat as shadow (LitWrapper-wrapped) regardless of per-file
-     * imports — for components registered once in a shared plugin. Default `[]`.
-     */
-    shadowOverride?: string[];
+  prefix?: string;
+  wrapper?: string;
+  /**
+   * Tag names (e.g. `'mono-nav'`) to NOT wrap in the client-only wrapper.
+   * Use this for components that are server-rendered by another mechanism
+   * (e.g. `@lit-labs/ssr` / `nuxt-ssr-lit` shadow-DOM builds) — wrapping them
+   * in `<ClientOnly>` would suppress their server markup.
+   */
+  exclude?: string[];
+  /**
+   * Wrap LIGHT `<prefix*>` elements in the client-only wrapper. Default `true`.
+   * `false` leaves light tags untouched (they server-render as inert custom-element
+   * tags and upgrade in the browser) while the shadow `<LitWrapper>` wrap below
+   * keeps working — for apps whose pages are client-only as a whole and must not
+   * have each `<mono-*>` deferred past the page's `onMounted`.
+   */
+  lightWrap?: boolean;
+  /**
+   * Enable the import-driven SSR wrap: a `.vue` file that imports
+   * `@mono-lit/helper/ui/shadow/<entry>` gets its matching `<mono-*>` wrapped in
+   * `<LitWrapper>` (Declarative Shadow DOM) instead of `<ClientOnly>`. Needs
+   * `nuxt-ssr-lit` installed (provides the `<LitWrapper>` component). Default off.
+   */
+  litWrapper?: boolean;
+  /** Component name used for the SSR wrap. Default `'LitWrapper'`. */
+  litWrapperComponent?: string;
+  /**
+   * Tags to ALWAYS treat as shadow (LitWrapper-wrapped) regardless of per-file
+   * imports — for components registered once in a shared plugin. Default `[]`.
+   */
+  shadowOverride?: string[];
 }
 export declare function monoClientOnlyPlugin(options?: MonoClientOnlyOptions): Plugin;
+//#endregion

package/dist/src/vite/mono-ssr-stub.d.ts

@@ -1,10 +1,11 @@
-import { Plugin } from 'vite';
+import { Plugin } from "vite";
+//#region src/vite/mono-ssr-stub.d.ts
 export interface MonoSsrStubOptions {
-    /**
-     * Import prefix whose side-effect (web component registration) modules
-     * should be stubbed during the server build. CSS entries are never stubbed.
-     */
-    packagePrefix?: string;
+  /**
+   * Import prefix whose side-effect (web component registration) modules
+   * should be stubbed during the server build. CSS entries are never stubbed.
+   */
+  packagePrefix?: string;
 }
 /**
  * `@mono-lit/helper/ui/*` entries register Lit custom elements at module load
@@ -18,3 +19,4 @@ export interface MonoSsrStubOptions {
  * still register and render after hydration.
  */
 export declare function monoSsrStubPlugin(options?: MonoSsrStubOptions): Plugin;
+//#endregion

package/dist/src/vite/shadow-manifest.d.ts

@@ -1,3 +1,4 @@
+//#region src/vite/shadow-manifest.d.ts
 export declare const SHADOW_ENTRY_TO_TAGS: Record<string, readonly string[]>;
 /** Flat list of every shadow-built custom-element tag. */
 export declare const SHADOW_TAGS: readonly string[];
@@ -6,3 +7,4 @@ export declare const SHADOW_TAGS: readonly string[];
  * `@mono-lit/helper/ui/shadow/<entry>` imports and mapping each entry to its tag(s).
  */
 export declare function shadowTagsFromScript(script: string): Set<string>;
+//#endregion

package/dist/ssr-lit/runtime/components/LitWrapper.vue

@@ -0,0 +1,11 @@
+<script>
+import { h, defineComponent, defineAsyncComponent } from "vue";
+import LitWrapperClient from "./LitWrapperClient.vue";
+const LitWrapperServer = defineAsyncComponent(() => import("./LitWrapperServer.vue"));
+export default defineComponent({
+  name: "LitWrapper",
+  render() {
+    return h(import.meta.server ? LitWrapperServer : LitWrapperClient, this.$slots.default);
+  }
+});
+</script>

package/dist/ssr-lit/runtime/components/LitWrapperClient.vue

@@ -0,0 +1,11 @@
+<script>
+import { defineComponent } from "vue";
+export default defineComponent({
+  setup(_, context) {
+    return () => context.slots.default?.()?.[0];
+  },
+  mounted() {
+    this.$el?.removeAttribute?.("defer-hydration");
+  }
+});
+</script>

package/dist/ssr-lit/runtime/components/LitWrapperServer.vue

@@ -0,0 +1,38 @@
+<script>
+import { defineComponent, ssrUtils, mergeProps } from "vue";
+import { ssrRenderVNode, ssrRenderAttrs } from "@vue/server-renderer";
+import { LitElementRenderer } from "@lit-labs/ssr/lib/lit-element-renderer.js";
+import { createLitElementRenderer } from "../utils/litElementRenderer";
+export default defineComponent({
+  ssrRender(ctx, push, litWrapperInstance, litWrapperAttrs) {
+    const [litElementVNode] = litWrapperInstance.slots.default();
+    const litElementTagName = String(litElementVNode.type);
+    const litElementVNodeProps = litElementVNode.props || {};
+    const renderer = createLitElementRenderer(litElementTagName, litElementVNodeProps);
+    if (!renderer) {
+      return null;
+    }
+    try {
+      renderer.connectedCallback();
+      const attributes = ssrRenderAttrs(mergeProps(litElementVNodeProps, litWrapperAttrs));
+      push(
+        `<${litElementTagName}${attributes} defer-hydration="true"><template shadowrootmode="open" shadowroot="open">`
+      );
+      for (const shadowContent of renderer.renderShadow({
+        elementRenderers: [LitElementRenderer],
+        customElementInstanceStack: [renderer],
+        customElementHostStack: [renderer]
+      })) {
+        push(shadowContent);
+      }
+      push(`</template>`);
+      const litElementChildren = litElementVNode.children ? Array.isArray(litElementVNode.children) ? litElementVNode.children : [litElementVNode.children] : [];
+      litElementChildren.forEach((child) => ssrRenderVNode(push, ssrUtils.normalizeVNode(child), litWrapperInstance));
+      push(`</${litElementTagName}>`);
+    } catch (e) {
+      console.error(e);
+      return null;
+    }
+  }
+});
+</script>

package/dist/ssr-lit/runtime/plugins/antiFouc.server.js

@@ -0,0 +1,25 @@
+import { defineNuxtPlugin, useHead } from "#imports";
+export default defineNuxtPlugin(() => {
+  useHead({
+    style: [
+      {
+        innerHTML: "body[dsd-pending] { display: none; }"
+      }
+    ],
+    script: [
+      {
+        children: `
+{
+  const hasNativeDsd =
+    Object.hasOwnProperty.call(HTMLTemplateElement.prototype, "shadowRootMode") ||
+    Object.hasOwnProperty.call(HTMLTemplateElement.prototype, "shadowRoot");
+
+  if (!hasNativeDsd) {
+      document.body.setAttribute('dsd-pending', 'true');
+  }
+}`,
+        tagPosition: "bodyOpen"
+      }
+    ]
+  });
+});

package/dist/ssr-lit/runtime/plugins/hydrateSupport.client.js

@@ -0,0 +1,4 @@
+import "@lit-labs/ssr-client/lit-element-hydrate-support.js";
+import { defineNuxtPlugin } from "#imports";
+export default defineNuxtPlugin(() => {
+});

package/dist/ssr-lit/runtime/plugins/polyfill.client.js

@@ -0,0 +1,9 @@
+import { defineNuxtPlugin } from "#imports";
+export default defineNuxtPlugin(async () => {
+  const hasNativeDsd = Object.hasOwnProperty.call(HTMLTemplateElement.prototype, "shadowRootMode") || Object.hasOwnProperty.call(HTMLTemplateElement.prototype, "shadowRoot");
+  if (!hasNativeDsd) {
+    const { hydrateShadowRoots } = await import("@webcomponents/template-shadowroot/template-shadowroot.js");
+    hydrateShadowRoots(document.body);
+    document.body.removeAttribute("dsd-pending");
+  }
+});

package/dist/ssr-lit/runtime/utils/customElements.js

@@ -0,0 +1,11 @@
+export function isCustomElementTag(name) {
+  return typeof name === "string" && /-/.test(name);
+}
+export function getCustomElementConstructor(name) {
+  if (typeof customElements !== "undefined" && isCustomElementTag(name)) {
+    return customElements.get(name) || null;
+  } else if (typeof name === "function") {
+    return name;
+  }
+  return null;
+}

package/dist/ssr-lit/runtime/utils/litElementRenderer.js

@@ -0,0 +1,28 @@
+import { LitElementRenderer } from "@lit-labs/ssr/lib/lit-element-renderer.js";
+import { getCustomElementConstructor, isCustomElementTag } from "./customElements.js";
+export function createLitElementRenderer(tagName, props) {
+  if (!isCustomElementTag(tagName)) {
+    return null;
+  }
+  const renderer = new LitElementRenderer(tagName);
+  attachPropsToRenderer(renderer, props);
+  return renderer;
+}
+function attachPropsToRenderer(renderer, props) {
+  const customElementConstructor = getCustomElementConstructor(renderer.tagName);
+  if (props) {
+    for (const [key, value] of Object.entries(props)) {
+      if (customElementConstructor !== null && typeof customElementConstructor !== "string" && key in customElementConstructor.prototype) {
+        const isBooleanProp = customElementConstructor.elementProperties.get(key)?.type === Boolean;
+        if (isBooleanProp && value === "") {
+          renderer.setProperty(key, true);
+        } else {
+          renderer.setProperty(key, value);
+        }
+      } else {
+        renderer.setAttribute(key, value);
+      }
+    }
+  }
+  return renderer;
+}