@macive/ui 0.0.12 → 0.0.14

package/dist/types/src/tokens/metadata.d.ts

@@ -482,16 +482,16 @@ export declare const metadata: {
         "border-divider-on-dark": import("./types").MetadataProperties;
     };
     spacing: {
-        "space-0": import("./types").MetadataProperties;
         "space-24": import("./types").MetadataProperties;
+        "space-0": import("./types").MetadataProperties;
         "space-20": import("./types").MetadataProperties;
         "space-4": import("./types").MetadataProperties;
         "space-8": import("./types").MetadataProperties;
         "space-16": import("./types").MetadataProperties;
         "space-2": import("./types").MetadataProperties;
         "space-10": import("./types").MetadataProperties;
-        "space-3": import("./types").MetadataProperties;
         "space-12": import("./types").MetadataProperties;
+        "space-3": import("./types").MetadataProperties;
         "space-6": import("./types").MetadataProperties;
         "space-32": import("./types").MetadataProperties;
         "space-5": import("./types").MetadataProperties;
@@ -501,16 +501,16 @@ export declare const metadata: {
         "space-28": import("./types").MetadataProperties;
     };
     space: {
-        "space-0": import("./types").MetadataProperties;
         "space-24": import("./types").MetadataProperties;
+        "space-0": import("./types").MetadataProperties;
         "space-20": import("./types").MetadataProperties;
         "space-4": import("./types").MetadataProperties;
         "space-8": import("./types").MetadataProperties;
         "space-16": import("./types").MetadataProperties;
         "space-2": import("./types").MetadataProperties;
         "space-10": import("./types").MetadataProperties;
-        "space-3": import("./types").MetadataProperties;
         "space-12": import("./types").MetadataProperties;
+        "space-3": import("./types").MetadataProperties;
         "space-6": import("./types").MetadataProperties;
         "space-32": import("./types").MetadataProperties;
         "space-5": import("./types").MetadataProperties;
@@ -524,8 +524,8 @@ export declare const metadata: {
         "z-index-8": import("./types").MetadataProperties;
         "z-index-2": import("./types").MetadataProperties;
         "z-index-10": import("./types").MetadataProperties;
-        "z-index-3": import("./types").MetadataProperties;
         "z-index-12": import("./types").MetadataProperties;
+        "z-index-3": import("./types").MetadataProperties;
         "z-index-6": import("./types").MetadataProperties;
         "z-index-11": import("./types").MetadataProperties;
         "z-index-7": import("./types").MetadataProperties;
@@ -536,8 +536,8 @@ export declare const metadata: {
         "z-8": import("./types").MetadataProperties;
         "z-2": import("./types").MetadataProperties;
         "z-10": import("./types").MetadataProperties;
-        "z-3": import("./types").MetadataProperties;
         "z-12": import("./types").MetadataProperties;
+        "z-3": import("./types").MetadataProperties;
         "z-6": import("./types").MetadataProperties;
         "z-11": import("./types").MetadataProperties;
         "z-7": import("./types").MetadataProperties;

package/dist/types/src/utilities/capitalize.d.ts

@@ -1,2 +1,13 @@
-export declare function capitalize(word?: string): string;
+/**
+ * Capitalizes the first letter of a string and makes the rest of the string lowercase.
+ * @param {string | null | undefined} str - The input string to be processed. Can be a string, null, or undefined.
+ * @returns {string} - The formatted string with the first letter capitalized and the rest lowercase.
+ *                     If the input is null or undefined, an empty string is returned.
+ * @example
+ * capitalizeFirstLetter("hello"); // Returns "Hello"
+ * capitalizeFirstLetter("HELLO"); // Returns "Hello"
+ * capitalizeFirstLetter(null);    // Returns ""
+ * capitalizeFirstLetter(undefined); // Returns ""
+ */
+export declare function capitalize(str: string | null | undefined): string;
 //# sourceMappingURL=capitalize.d.ts.map

package/dist/types/src/utilities/capitalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capitalize.d.ts","sourceRoot":"","sources":["../../../../src/utilities/capitalize.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,IAAI,SAAK,UAGnC"}
+{"version":3,"file":"capitalize.d.ts","sourceRoot":"","sources":["../../../../src/utilities/capitalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAMjE"}

package/dist/types/src/utilities/renderSafeTemplate.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Renders a template string by replacing placeholders with sanitized values.
+ * @param {string} template - The template string containing placeholders (e.g., `{{key}}`).
+ * @param {Record<ExtractPlaceholders<Template>, string>} values - An object containing key-value pairs for replacement.
+ * @returns {string} - The processed string with placeholders replaced and sanitized.
+ * @example
+ * // Scenario 1: Basic usage
+ * const template1 = "Hello, {{name}}! Welcome to {{app}}.";
+ * const values1 = { name: "John", app: "MyApp" };
+ * renderSafeTemplate(template1, values1); // Returns "Hello, John! Welcome to MyApp."
+ *
+ * @example
+ * // Scenario 2: Sanitization to prevent XSS
+ * const template2 = "Hello, {{name}}! Welcome to {{app}}.";
+ * const values2 = { name: "<script>alert('XSS')</script>John", app: "MyApp" };
+ * renderSafeTemplate(template2, values2); // Returns "Hello, &lt;script&gt;alert('XSS')&lt;/script&gt;John! Welcome to MyApp."
+ *
+ * @example
+ * // Scenario 3: Missing placeholder key
+ * const template3 = "Hello, {{name}}! Welcome to {{app}}.";
+ * const values3 = { name: "John" }; // `app` key is missing
+ * renderSafeTemplate(template3, values3); // Returns "Hello, John! Welcome to ."
+ *
+ * @example
+ * // Scenario 4: HTML link replacement
+ * const template4 = "Visit us at <a href='{{link}}'>{{link}}</a>.";
+ * const values4 = { link: "https://example.com" };
+ * renderSafeTemplate(template4, values4); // Returns "Visit us at <a href='https://example.com'>https://example.com</a>."
+ */
+export declare function renderSafeTemplate<Template extends string>(template: Template, values: Record<ExtractPlaceholders<Template>, string>): string;
+/**
+ * Extracts placeholder keys from a template string.
+ * @example
+ * ExtractPlaceholders<"Hello, {{name}}! Welcome to {{app}}."> // Returns "name" | "app"
+ */
+type ExtractPlaceholders<Template extends string> = Template extends `${string}{{${infer Key}}}${infer Rest}` ? Key | ExtractPlaceholders<Rest> : never;
+export {};
+//# sourceMappingURL=renderSafeTemplate.d.ts.map

package/dist/types/src/utilities/renderSafeTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderSafeTemplate.d.ts","sourceRoot":"","sources":["../../../../src/utilities/renderSafeTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,SAAS,MAAM,EACxD,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,GACpD,MAAM,CAUR;AAED;;;;GAIG;AACH,KAAK,mBAAmB,CAAC,QAAQ,SAAS,MAAM,IAC9C,QAAQ,SAAS,GAAG,MAAM,KAAK,MAAM,GAAG,KAAK,MAAM,IAAI,EAAE,GACrD,GAAG,GAAG,mBAAmB,CAAC,IAAI,CAAC,GAC/B,KAAK,CAAA"}