@eduboxpro/studio 0.1.2 → 0.1.4

package/README.md

@@ -61,6 +61,53 @@ import { ButtonComponent } from '@eduboxpro/studio/primitives';
 - **Tree-shakeable** - Optimized bundle size
 - **Zero Dependencies** - Only Angular core
 
+## Utilities
+
+The library includes helper utilities for common tasks:
+
+### URL Validation
+
+```typescript
+import { isSafeUrl, sanitizeUrl } from '@eduboxpro/studio/utils';
+
+// Check if URL is safe
+isSafeUrl('https://example.com'); // true
+isSafeUrl('javascript:alert(1)'); // false
+
+// Sanitize URL (blocks unsafe schemes)
+sanitizeUrl('https://example.com'); // 'https://example.com'
+sanitizeUrl('javascript:alert(1)'); // '#' (blocked with console warning)
+```
+
+### Class Names Helper
+
+```typescript
+import { classNames } from '@eduboxpro/studio/utils';
+
+// Combine CSS classes, filtering out falsy values
+classNames('btn', 'btn-primary'); // 'btn btn-primary'
+classNames('btn', isActive && 'active'); // 'btn active' or 'btn'
+classNames('btn', undefined, null, false); // 'btn'
+```
+
+### Config Helpers
+
+```typescript
+import { withConfigDefault } from '@eduboxpro/studio/utils';
+
+// Create configurable component inputs with fallback chain
+export class MyComponent {
+  private defaults = computed(() => this.config().components?.myComponent);
+
+  variantInput = input<Variant>(undefined, { alias: 'variant' });
+  variant = withConfigDefault(
+    this.variantInput,
+    computed(() => this.defaults()?.variant),
+    'solid' // fallback value
+  );
+}
+```
+
 ## Documentation
 
 Full documentation: https://github.com/eduboxpro/studio