@dubai-design-system/components-js 5.0.3 → 5.1.0

package/dist/types/utils/placeholder-color.d.ts

@@ -0,0 +1,10 @@
+export interface PlaceholderColorArgs {
+    /** Selector of the <input>/<textarea> that shows the placeholder. */
+    field: string;
+    /** Selector of the element that paints the background behind the placeholder. Defaults to `field`. */
+    background?: string;
+}
+export declare function readPlaceholderColors(args: PlaceholderColorArgs): {
+    placeholder: string;
+    background: string;
+};

package/dist/types/utils/unique-id.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns an id that is unique on the page, for elements such as a label's input when the
+ * consumer did not pass one. Call it once per component instance (as a field initializer),
+ * so the id stays stable across renders.
+ */
+export declare function uniqueId(prefix: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dubai-design-system/components-js",
-  "version": "5.0.3",
+  "version": "5.1.0",
   "private": false,
   "description": "JavaScript package for the Digital Dubai Design System, offering reusable, customizable components for seamless integration into web applications",
   "main": "dist/index.cjs.js",
@@ -34,7 +34,8 @@
   "files": [
     "dist/",
     "loader/",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "MIGRATION.md"
   ],
   "scripts": {
     "build": "stencil build",
@@ -108,5 +109,5 @@
     "access": "public"
   },
   "license": "UNLICENSED",
-  "gitHead": "00d5079913b142fe5fb22ba99d47cea5633e0d82"
+  "gitHead": "cf2a702316319c3018411c067051b071decffc5f"
 }

package/readme.md

@@ -75,6 +75,12 @@ import '@dubai-design-system/components-js/dist/components/dda-header.js';
 
 `dda-button`, `dda-dropdown`, `dda-modal`, `dda-card`, `dda-header`, and more.
 
+## Upgrading
+
+Upgrading from an earlier version? Read `MIGRATION.md` in this package
+(`node_modules/@dubai-design-system/components-js/MIGRATION.md`). It lists what to change when
+you come from 5.0.x, 4.1.0 or 3.x. `CHANGELOG.md` next to it has the full list of changes.
+
 ## License
 
 Copyright (c) 2018-2026 Digital Dubai. All rights reserved. An open-source license is under review and will be announced in a future release.