@juspay/svelte-ui-components 4.18.0 → 4.19.0

package/dist/Card/properties.d.ts

@@ -1,5 +1,52 @@
 import type { Snippet } from 'svelte';
+import type { AttrsEscapeHatch, LegacyAttrs } from '../types';
 export type CardProperties = OptionalCardProperties;
+/**
+ * The attributes Card writes on its own root, named so each carries the prop to
+ * use instead. Card spreads `attrs` first and these after, so an entry for one
+ * of these keys has never reached the DOM — declaring them optional and
+ * `string`-valued keeps that code compiling, and the `@deprecated` tag is what
+ * makes the discard visible at the point it is written.
+ */
+type CardManagedAttrs = {
+    /** @deprecated Card writes its own `class`. Use `classes`; this entry is discarded. */
+    class?: string;
+    /** @deprecated Card writes its own `style`. Use `cssVars`; this entry is discarded. */
+    style?: string;
+    /**
+     * @deprecated Card derives `role` from `onclick`/`href` and writes it (or removes
+     * it) itself. There is no prop for it; this entry is discarded.
+     */
+    role?: string;
+    /**
+     * @deprecated Card derives `tabindex` from `onclick`/`href` and writes it (or
+     * removes it) itself. There is no prop for it; this entry is discarded.
+     */
+    tabindex?: string;
+    /** @deprecated Card writes its own `href`. Use `href`; this entry is discarded. */
+    href?: string;
+    /** @deprecated Card writes its own `target`. Use `target`; this entry is discarded. */
+    target?: string;
+    /** @deprecated Card writes its own `rel`. Use `rel`; this entry is discarded. */
+    rel?: string;
+    /** @deprecated Card writes its own `onclick`. Use `onclick`; this entry is discarded. */
+    onclick?: string;
+    /**
+     * @deprecated Card binds its own `onkeydown` on an interactive card, to make
+     * Enter and Space activate it. There is no prop for it; this entry is discarded.
+     */
+    onkeydown?: string;
+    /** @deprecated Card writes its own `data-pw`. Use `testId`; this entry is discarded. */
+    'data-pw'?: string;
+    /** @deprecated Card writes its own `testID`. Use `testId`; this entry is discarded. */
+    testID?: string;
+};
+/**
+ * `attrs` with Card's managed attributes rejected instead of deprecated — the
+ * shape the prop takes in the next major (#576). Annotate an object with it to
+ * get the compile error today.
+ */
+export type CardStrictAttrs = AttrsEscapeHatch<Extract<keyof CardManagedAttrs, string>>;
 export type MandatoryCardProperties = Record<string, never>;
 export type OptionalCardProperties = {
     /**
@@ -90,11 +137,13 @@ export type OptionalCardProperties = {
      * second `classes` modifier for the same state. Applied before Card's own
      * `class`/`style`/`data-pw`/`testID`/`role`/`tabindex`/`href`/`target`/`rel`/
      * `onclick`/`onkeydown` attributes, so an entry here can never override one
-     * of those — only add attributes Card does not already manage. Omitted by
-     * default, so existing consumers render exactly the same attributes as
-     * before.
+     * of those. Those keys are deprecated rather than rejected, so code that
+     * passes one keeps compiling exactly as before while saying, where it is
+     * written, that it has no effect. `CardStrictAttrs` rejects them outright
+     * for consumers who want that today. Omitted by default, so existing
+     * consumers render exactly the same attributes as before.
      */
-    attrs?: Record<string, string>;
+    attrs?: LegacyAttrs<CardManagedAttrs>;
     /**
      * Overrides the tag `svelte:element` renders for the card root — e.g.
      * `'figure'` for a card whose root needs real `<figure>` sectioning-content
@@ -123,3 +172,4 @@ export type OptionalCardProperties = {
      */
     as?: 'div' | 'a' | 'figure';
 };
+export {};

package/dist/MediaPlayer/MediaPlayer.svelte.d.ts

@@ -1,4 +1,4 @@
 import type { MediaPlayerProperties } from './properties';
-declare const MediaPlayer: import("svelte").Component<MediaPlayerProperties, {}, "duration" | "playing" | "muted" | "currentTime">;
+declare const MediaPlayer: import("svelte").Component<MediaPlayerProperties, {}, "muted" | "duration" | "playing" | "currentTime">;
 type MediaPlayer = ReturnType<typeof MediaPlayer>;
 export default MediaPlayer;

package/dist/Pill/properties.d.ts

@@ -1,5 +1,59 @@
 import type { Snippet } from 'svelte';
+import type { AttrsEscapeHatch, LegacyAttrs } from '../types';
 export type PillProperties = MandatoryPillProperties & OptionalPillProperties & PillEventProperties;
+/**
+ * The attributes Pill writes on its own root, named so each carries the prop to
+ * use instead. Pill spreads `attrs` first and these after, so an entry for one
+ * of these keys has never reached the DOM — declaring them optional and
+ * `string`-valued keeps that code compiling, and the `@deprecated` tag is what
+ * makes the discard visible at the point it is written.
+ */
+type PillManagedAttrs = {
+    /** @deprecated Pill writes its own `class`. Use `classes`; this entry is discarded. */
+    class?: string;
+    /**
+     * @deprecated Pill always supplies `type="button"` on a `<button>` root, so a
+     * pill never submits a form by accident. There is no prop for it; this entry
+     * is discarded.
+     */
+    type?: string;
+    /** @deprecated Pill writes its own `data-pw`. Use `testId`; this entry is discarded. */
+    'data-pw'?: string;
+    /** @deprecated Pill writes its own `testID`. Use `testId`; this entry is discarded. */
+    testID?: string;
+    /**
+     * @deprecated Pill derives `role` from whether it is interactive on a
+     * non-button root. There is no prop for it; this entry is discarded.
+     */
+    role?: string;
+    /**
+     * @deprecated Pill derives `tabindex` from whether it is interactive on a
+     * non-button root. There is no prop for it; this entry is discarded.
+     */
+    tabindex?: string;
+    /** @deprecated Pill writes its own `title`. Use `title`; this entry is discarded. */
+    title?: string;
+    /** @deprecated Pill derives `aria-disabled` from `disabled`; this entry is discarded. */
+    'aria-disabled'?: string;
+    /** @deprecated Pill derives `aria-expanded` from `ariaExpanded`; this entry is discarded. */
+    'aria-expanded'?: string;
+    /** @deprecated Pill derives `aria-pressed` from `ariaPressed`; this entry is discarded. */
+    'aria-pressed'?: string;
+    /** @deprecated Pill writes its own `onclick`. Use `onclick`; this entry is discarded. */
+    onclick?: string;
+    /**
+     * @deprecated Pill binds its own `onkeydown` on an interactive non-button
+     * root, to make Enter and Space activate it. There is no prop for it; this
+     * entry is discarded.
+     */
+    onkeydown?: string;
+};
+/**
+ * `attrs` with Pill's managed attributes rejected instead of deprecated — the
+ * shape the prop takes in the next major (#576). Annotate an object with it to
+ * get the compile error today.
+ */
+export type PillStrictAttrs = AttrsEscapeHatch<Extract<keyof PillManagedAttrs, string>>;
 export type MandatoryPillProperties = {
     text: string;
 };
@@ -77,13 +131,17 @@ export type OptionalPillProperties = {
      * just to hold the attribute, or adding a second `classes` modifier for the
      * same state. Applied before Pill's own `class`/`onclick`/`onkeydown`/
      * `role`/`tabindex`/`aria-disabled`/`data-pw`/`title`/`testID` attributes, so
-     * an entry here can never override one of those — only add attributes Pill
-     * does not already manage. Omitted by default, so existing consumers render
-     * exactly the same attributes as before.
+     * an entry here can never override one of those. Those keys are deprecated
+     * rather than rejected, so code that passes one keeps compiling exactly as
+     * before while saying, where it is written, that it has no effect.
+     * `PillStrictAttrs` rejects them outright for consumers who want that today.
+     * Omitted by default, so existing consumers render exactly the same
+     * attributes as before.
      */
-    attrs?: Record<string, string>;
+    attrs?: LegacyAttrs<PillManagedAttrs>;
 };
 export type PillEventProperties = {
     onclick?: (event: MouseEvent) => void;
     ondismiss?: () => void;
 };
+export {};

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { FlyParams } from 'svelte/transition';
+import type { HTMLAttributes } from 'svelte/elements';
 /**
  * @name InputDataType
  * @description Different types of input data which can be passed to the Input Component.
@@ -36,6 +37,39 @@ export type FlyAnimationConfig = {
     in: FlyParams;
     out: FlyParams;
 };
+/**
+ * The strict form of the escape-hatch `attrs` prop: every HTML attribute the
+ * component does not manage, and a compile error naming any it does.
+ *
+ * `attrs` itself is NOT typed this way. It stays `Record<string, string>`,
+ * which is what it has always been, so nothing that compiles today stops
+ * compiling. Each component instead names its managed keys as `@deprecated`
+ * members, which an editor strikes through and
+ * `@typescript-eslint/no-deprecated` reports, so the entry is called out where
+ * it is written rather than vanishing silently at spread time.
+ *
+ * Annotate an object with a component's `*StrictAttrs` alias to opt into the
+ * compile error today:
+ *
+ *   const attrs: CardStrictAttrs = { class: 'mine' }; // error: class is managed
+ *
+ * Optional `never` properties reject managed keys through predeclared objects,
+ * not just excess-property checks, and override the broader `data-*` index.
+ * Other HTML attributes retain Svelte's native value and event types. `attrs`
+ * adopts this shape in the next major — see #576, which specifies the
+ * narrowing as a major precisely because rejecting `class` is a break.
+ */
+export type AttrsEscapeHatch<TManagedKeys extends string> = Omit<HTMLAttributes<HTMLElement>, TManagedKeys> & {
+    [Key in TManagedKeys]?: never;
+};
+/**
+ * The wide `attrs` value type, unchanged from before #576: any attribute name
+ * mapped to a string. Intersected with a component's managed-key map so those
+ * keys carry a deprecation, which constrains nothing — every managed key is
+ * declared optional and `string`-valued, exactly what the index signature
+ * already allowed.
+ */
+export type LegacyAttrs<TManagedAttrs> = Record<string, string> & TManagedAttrs;
 export type Rgb = {
     r: number;
     g: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/svelte-ui-components",
-  "version": "4.18.0",
+  "version": "4.19.0",
   "description": "A themeable Svelte 5 UI component library with CSS custom property driven styling",
   "keywords": [
     "svelte",