From fda52f5fde69b8dace0bb782ab28ff87d3dfde85 Mon Sep 17 00:00:00 2001
From: Maria Hutt <maria.hutt@outsystems.com>
Date: Thu, 12 Mar 2026 11:05:30 -0700
Subject: [PATCH] docs(tokens): update shared file comments

---
 core/src/themes/base/shared.tokens.ts  | 2 +-
 core/src/themes/ionic/shared.tokens.ts | 3 +--
 core/src/themes/ios/shared.tokens.ts   | 3 +--
 core/src/themes/md/shared.tokens.ts    | 7 +++----
 4 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/core/src/themes/base/shared.tokens.ts b/core/src/themes/base/shared.tokens.ts
index e3e614c195..cad22cab92 100644
--- a/core/src/themes/base/shared.tokens.ts
+++ b/core/src/themes/base/shared.tokens.ts
@@ -1,5 +1,5 @@
 /**
- * Tokens shared between the theme files.
+ * Common tokens utilized multiple times across all theme files.
  */
 
 const hexColors = {
diff --git a/core/src/themes/ionic/shared.tokens.ts b/core/src/themes/ionic/shared.tokens.ts
index 361f59a86d..33e7004e8d 100644
--- a/core/src/themes/ionic/shared.tokens.ts
+++ b/core/src/themes/ionic/shared.tokens.ts
@@ -1,6 +1,5 @@
 /**
- * Tokens shared between the MD theme files or are being used in the files
- * multiple times.
+ * Common tokens utilized multiple times across `ionic` theme files.
  */
 
 import { mix, rgba } from '../../utils/theme';
diff --git a/core/src/themes/ios/shared.tokens.ts b/core/src/themes/ios/shared.tokens.ts
index c019ae35cf..17379e39f1 100644
--- a/core/src/themes/ios/shared.tokens.ts
+++ b/core/src/themes/ios/shared.tokens.ts
@@ -1,6 +1,5 @@
 /**
- * Tokens shared between the iOS theme files or are being used in the files
- * multiple times.
+ * Common tokens utilized multiple times across `ios` theme files.
  */
 
 import { dynamicFont } from '../../utils/theme';
diff --git a/core/src/themes/md/shared.tokens.ts b/core/src/themes/md/shared.tokens.ts
index dc8361e91a..cf36676db0 100644
--- a/core/src/themes/md/shared.tokens.ts
+++ b/core/src/themes/md/shared.tokens.ts
@@ -1,6 +1,5 @@
 /**
- * Tokens shared between the MD theme files or are being used in the files
- * multiple times.
+ * Common tokens utilized multiple times across `md` theme files.
  */
 
 import { mix, rgba } from '../../utils/theme';
@@ -148,6 +147,6 @@ export const components = {
   itemDivider: {
     font: {
       size: 14,
-    }
-  }
+    },
+  },
 };