@mono-lit/helper 0.0.1 → 0.0.3

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.
  *
@@ -37,17 +38,42 @@ export declare function resolveErrorMessages(local?: MonoErrorMessages): Record<
  * `Error`.
  */
 export declare function errorStatus(raw: unknown): number | undefined;
+/**
+ * Every message an error carries, combined the way `monoFetch`'s
+ * `extractErrorMessage` does it: each key whose name contains "message"
+ * (`message`, `errorMessage`, `Message`, …) holding text — or OData's
+ * `{ message: { value } }` — at any depth up to 3, plus a JSON body still in
+ * `responseText` / `responseJSON` / `response`, plus an `Error`'s own
+ * (non-enumerable) `message`. The usual body fields `detail` / `title` and a
+ * plain-text `response.data` count too.
+ *
+ * Deduplicated by {@link uniqueMessages}, transport boilerplate ("Bad Request",
+ * "Failed to fetch") dropped, in the order found.
+ */
+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;
+  /** 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
+ * message combined (`monoFetch` style), or the headline when it said nothing.
+ */
+export declare function errorText(err: DescribedError, separator?: string): string;
+/** The hover text: the headline, then everything the server said, each once. */
+export declare function errorTitle(err: DescribedError): string;
 /**
  * The line a person should read for `raw`.
  *
@@ -58,3 +84,9 @@ export interface DescribedError {
  * returns an empty `message`.
  */
 export declare function describeError(raw: unknown, messages?: MonoErrorMessages): DescribedError;
+/**
+ * A load a newer load superseded (devextreme rejects it with `'canceled'`).
+ * 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