dasar-ui 1.5.0 → 1.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/CHANGELOG.md +44 -0
  2. package/README.md +40 -34
  3. package/docs/_config.yml +3 -0
  4. package/docs/getting-started.md +89 -0
  5. package/docs/index.md +9 -0
  6. package/docs/installation.md +46 -0
  7. package/package.json +6 -5
  8. package/projects/dasar-ui/package.json +1 -1
  9. package/projects/dasar-ui/src/lib/components/dasar-modal/dasar-modal.ts +2 -2
  10. package/projects/dasar-ui/src/lib/components/dasar-overlay/dasar-overlay.spec.ts +8 -0
  11. package/projects/dasar-ui/src/lib/components/dasar-overlay/dasar-overlay.ts +2 -2
  12. package/projects/dasar-ui/src/lib/components/dasar-theme-provider/dasar-theme-provider.spec.ts +89 -0
  13. package/projects/dasar-ui/src/lib/components/dasar-theme-provider/dasar-theme-provider.ts +23 -0
  14. package/projects/dasar-ui/src/lib/models/theme.model.ts +64 -0
  15. package/projects/dasar-ui/src/lib/services/theme.service.spec.ts +65 -0
  16. package/projects/dasar-ui/src/lib/services/theme.service.ts +70 -0
  17. package/projects/dasar-ui/src/public-api.ts +1 -0
  18. package/projects/documentation/src/app/app.html +33 -6
  19. package/projects/documentation/src/app/app.ts +36 -2
  20. package/projects/documentation/src/app/components/doc-customize-modal.component.ts +56 -2
  21. package/projects/documentation/src/app/components/doc-markdown.component.ts +154 -0
  22. package/projects/documentation/src/app/layouts/doc.layout.ts +23 -3
  23. package/projects/documentation/src/app/pages/getting-started/getting-started.page.ts +21 -0
  24. package/projects/documentation/src/app/pages/installation/installation.page.ts +18 -0
  25. package/projects/documentation/src/app/pages/introduction/introduction.page.ts +18 -0
  26. package/projects/documentation/src/app/pages/list/examples/advanced-dynamic/list-advanced-dynamic.example.html +29 -0
  27. package/projects/documentation/src/app/pages/list/examples/advanced-dynamic/list-advanced-dynamic.example.ts +33 -0
  28. package/projects/documentation/src/app/pages/list/examples/advanced-theme/list-advanced-theme.example.html +13 -0
  29. package/projects/documentation/src/app/pages/list/examples/advanced-theme/list-advanced-theme.example.ts +30 -0
  30. package/projects/documentation/src/app/pages/list/examples/basic/list-basic.example.html +5 -0
  31. package/projects/documentation/src/app/pages/list/examples/basic/list-basic.example.ts +12 -0
  32. package/projects/documentation/src/app/pages/list/examples/bordered-divider/list-bordered-divider.example.html +20 -0
  33. package/projects/documentation/src/app/pages/list/examples/bordered-divider/list-bordered-divider.example.ts +12 -0
  34. package/projects/documentation/src/app/pages/list/examples/custom-style/list-custom-style.example.html +11 -0
  35. package/projects/documentation/src/app/pages/list/examples/custom-style/list-custom-style.example.ts +19 -0
  36. package/projects/documentation/src/app/pages/list/examples/header-footer/list-header-footer.example.html +7 -0
  37. package/projects/documentation/src/app/pages/list/examples/header-footer/list-header-footer.example.ts +12 -0
  38. package/projects/documentation/src/app/pages/list/examples/interactive/list-interactive.example.html +20 -0
  39. package/projects/documentation/src/app/pages/list/examples/interactive/list-interactive.example.ts +22 -0
  40. package/projects/documentation/src/app/pages/list/examples/prefix-suffix/list-prefix-suffix.example.html +9 -0
  41. package/projects/documentation/src/app/pages/list/examples/prefix-suffix/list-prefix-suffix.example.ts +16 -0
  42. package/projects/documentation/src/app/pages/list/examples/size/list-size.example.html +20 -0
  43. package/projects/documentation/src/app/pages/list/examples/size/list-size.example.ts +12 -0
  44. package/projects/documentation/src/app/pages/list/list.page.html +95 -0
  45. package/projects/documentation/src/app/pages/list/list.page.ts +238 -0
  46. package/projects/documentation/src/app/pages/modal/modal.page.ts +15 -6
  47. package/projects/documentation/src/app/pages/tabs/tabs.page.ts +7 -0
  48. package/projects/documentation/src/app/pages/theming/examples/component-config/theming-component-config.example.html +13 -0
  49. package/projects/documentation/src/app/pages/theming/examples/component-config/theming-component-config.example.ts +20 -0
  50. package/projects/documentation/src/app/pages/theming/examples/css-override/theming-css-override.example.html +8 -0
  51. package/projects/documentation/src/app/pages/theming/examples/css-override/theming-css-override.example.scss +4 -0
  52. package/projects/documentation/src/app/pages/theming/examples/css-override/theming-css-override.example.ts +11 -0
  53. package/projects/documentation/src/app/pages/theming/examples/custom-tokens/theming-custom-tokens.example.html +13 -0
  54. package/projects/documentation/src/app/pages/theming/examples/custom-tokens/theming-custom-tokens.example.ts +33 -0
  55. package/projects/documentation/src/app/pages/theming/examples/global-theme/theming-global-theme.example.html +6 -0
  56. package/projects/documentation/src/app/pages/theming/examples/global-theme/theming-global-theme.example.ts +20 -0
  57. package/projects/documentation/src/app/pages/theming/examples/light-dark/theming-light-dark.example.html +15 -0
  58. package/projects/documentation/src/app/pages/theming/examples/light-dark/theming-light-dark.example.ts +31 -0
  59. package/projects/documentation/src/app/pages/theming/theming-component-config.page.ts +52 -0
  60. package/projects/documentation/src/app/pages/theming/theming-css-variables.page.ts +71 -0
  61. package/projects/documentation/src/app/pages/theming/theming-tokens.page.ts +56 -0
  62. package/projects/documentation/src/app/pages/theming/theming.data.ts +947 -0
  63. package/projects/documentation/src/app/pages/theming/theming.page.html +56 -0
  64. package/projects/documentation/src/app/pages/theming/theming.page.ts +144 -0
  65. package/projects/documentation/src/app/routes/app.routes.ts +63 -15
  66. package/projects/documentation/src/app/services/doc-customize.service.ts +12 -0
  67. package/projects/documentation/src/styles.scss +12 -0
@@ -0,0 +1,8 @@
1
+ <div class="theming-override-scope">
2
+ <dasar-button variant="primary">Square button</dasar-button>
3
+ </div>
4
+
5
+ <p style="font-size: 12px; margin-top: 8px; color: gray">
6
+ The CSS tab sets --btn-radius-md to 0 inside .theming-override-scope. Only buttons in that scope
7
+ are affected.
8
+ </p>
@@ -0,0 +1,4 @@
1
+ .theming-override-scope {
2
+ --btn-radius-md: 0;
3
+ --btn-font-weight: 700;
4
+ }
@@ -0,0 +1,11 @@
1
+ import { Component } from '@angular/core';
2
+ import { DasarButtonComponent } from 'dasar-ui';
3
+
4
+ @Component({
5
+ templateUrl: './theming-css-override.example.html',
6
+ styleUrl: './theming-css-override.example.scss',
7
+ selector: 'app-theming-css-override-example',
8
+ imports: [DasarButtonComponent],
9
+ standalone: true,
10
+ })
11
+ export class ThemingCssOverrideExample {}
@@ -0,0 +1,13 @@
1
+ <dasar-theme-provider [componentConfig]="componentConfig" [tokenConfig]="tokenConfig">
2
+ <dasar-card label="Scoped theme">
3
+ <div style="display: flex; gap: 12px; align-items: center; flex-wrap: wrap">
4
+ <dasar-button variant="primary">Themed button</dasar-button>
5
+ <dasar-chip variant="primary">Themed chip</dasar-chip>
6
+ </div>
7
+ </dasar-card>
8
+ </dasar-theme-provider>
9
+
10
+ <p style="font-size: 12px; margin-top: 8px; color: gray">
11
+ tokens.light.common sets the primary color, tokens.light.button sets the md radius and the font
12
+ weight. Only content inside this provider is affected.
13
+ </p>
@@ -0,0 +1,33 @@
1
+ import { Component } from '@angular/core';
2
+ import {
3
+ DasarButtonComponent,
4
+ DasarCardComponent,
5
+ DasarChipComponent,
6
+ DasarComponentConfig,
7
+ DasarThemeConfig,
8
+ DasarThemeProviderComponent,
9
+ } from 'dasar-ui';
10
+
11
+ @Component({
12
+ templateUrl: './theming-custom-tokens.example.html',
13
+ selector: 'app-theming-custom-tokens-example',
14
+ imports: [
15
+ DasarThemeProviderComponent,
16
+ DasarButtonComponent,
17
+ DasarCardComponent,
18
+ DasarChipComponent,
19
+ ],
20
+ standalone: true,
21
+ })
22
+ export class ThemingCustomTokensExample {
23
+ protected componentConfig: DasarComponentConfig = {
24
+ button: { appearance: 'solid', size: 'sm' },
25
+ };
26
+
27
+ protected tokenConfig: DasarThemeConfig['tokens'] = {
28
+ light: {
29
+ common: { primaryColor: '#7c3aed' },
30
+ button: { radiusMd: '999px', fontWeight: '700' },
31
+ },
32
+ };
33
+ }
@@ -0,0 +1,6 @@
1
+ <dasar-button variant="primary">Unthemed by this example</dasar-button>
2
+
3
+ <p style="font-size: 12px; margin-top: 8px; color: gray">
4
+ The TypeScript tab shows setGlobalTheme. This preview is intentionally not themed, because calling
5
+ it here would restyle the whole docs site.
6
+ </p>
@@ -0,0 +1,20 @@
1
+ import { Component, inject } from '@angular/core';
2
+ import { DasarButtonComponent, DasarThemeService } from 'dasar-ui';
3
+
4
+ @Component({
5
+ templateUrl: './theming-global-theme.example.html',
6
+ selector: 'app-theming-global-theme-example',
7
+ imports: [DasarButtonComponent],
8
+ standalone: true,
9
+ })
10
+ export class ThemingGlobalThemeExample {
11
+ private themes = inject(DasarThemeService);
12
+
13
+ protected applyTheme() {
14
+ this.themes.setGlobalTheme({
15
+ mode: 'light',
16
+ components: { button: { appearance: 'solid', size: 'md' } },
17
+ tokens: { light: { common: { primaryColor: '#2563eb' } } },
18
+ });
19
+ }
20
+ }
@@ -0,0 +1,15 @@
1
+ <dasar-theme-provider [mode]="mode()" [tokenConfig]="tokenConfig">
2
+ <dasar-card label="Light and dark">
3
+ <div style="display: flex; gap: 12px; align-items: center; flex-wrap: wrap">
4
+ <dasar-button variant="primary" (click)="toggle()">
5
+ <span style="text-transform: capitalize">Theme: {{ mode() }}</span>
6
+ </dasar-button>
7
+ <dasar-button variant="secondary" appearance="outline">Secondary</dasar-button>
8
+ </div>
9
+ </dasar-card>
10
+ </dasar-theme-provider>
11
+
12
+ <p style="font-size: 12px; margin-top: 8px; color: gray">
13
+ The provider sets data-theme on its host and picks tokens.light or tokens.dark. Click the button
14
+ to switch modes.
15
+ </p>
@@ -0,0 +1,31 @@
1
+ import { Component, signal } from '@angular/core';
2
+ import {
3
+ DasarButtonComponent,
4
+ DasarCardComponent,
5
+ DasarThemeConfig,
6
+ DasarThemeMode,
7
+ DasarThemeProviderComponent,
8
+ } from 'dasar-ui';
9
+
10
+ @Component({
11
+ templateUrl: './theming-light-dark.example.html',
12
+ selector: 'app-theming-light-dark-example',
13
+ imports: [DasarThemeProviderComponent, DasarButtonComponent, DasarCardComponent],
14
+ standalone: true,
15
+ })
16
+ export class ThemingLightDarkExample {
17
+ protected mode = signal<DasarThemeMode>('light');
18
+
19
+ protected tokenConfig: DasarThemeConfig['tokens'] = {
20
+ light: {
21
+ common: { primaryColor: '#2563eb' },
22
+ },
23
+ dark: {
24
+ common: { primaryColor: '#60a5fa' },
25
+ },
26
+ };
27
+
28
+ protected toggle() {
29
+ this.mode.update((current) => (current === 'light' ? 'dark' : 'light'));
30
+ }
31
+ }
@@ -0,0 +1,52 @@
1
+ import { Component } from '@angular/core';
2
+ import { CommonModule } from '@angular/common';
3
+ import { DasarTableComponent, DasarTableColumn } from 'dasar-ui';
4
+ import { DocsLayoutComponent } from '../../layouts/doc.layout';
5
+ import { COMPONENT_CONFIG_DOCS } from './theming.data';
6
+
7
+ @Component({
8
+ imports: [CommonModule, DocsLayoutComponent, DasarTableComponent],
9
+ template: `<docs-layout
10
+ title="Component Config"
11
+ description="Every components.* key of DasarComponentConfig. Set them in setGlobalTheme or [componentConfig] on dasar-theme-provider. Explicit inputs on a component always win over these defaults."
12
+ >
13
+ @for (group of groups; track group.component) {
14
+ <h2 class="theming-group-title">components.{{ group.component }}</h2>
15
+ <dasar-table
16
+ [columns]="columns"
17
+ [hoverable]="true"
18
+ [striped]="true"
19
+ [data]="group.rows"
20
+ appearance="outline"
21
+ spacing="normal"
22
+ />
23
+ }
24
+ </docs-layout>`,
25
+ styles: [
26
+ `
27
+ .theming-group-title {
28
+ margin: var(--space-6) 0 var(--space-3);
29
+ font-size: var(--font-size-lg);
30
+ }
31
+ dasar-table {
32
+ display: block;
33
+ margin-bottom: var(--space-6);
34
+ }
35
+ `,
36
+ ],
37
+ selector: 'app-theming-component-config-page',
38
+ standalone: true,
39
+ })
40
+ export class ThemingComponentConfigDocPage {
41
+ protected columns: DasarTableColumn[] = [
42
+ { key: 'name', label: 'Property' },
43
+ { key: 'type', label: 'Type' },
44
+ { key: 'defaultValue', label: 'Default' },
45
+ { key: 'description', label: 'Description' },
46
+ ];
47
+
48
+ protected groups = Object.entries(COMPONENT_CONFIG_DOCS).map(([component, rows]) => ({
49
+ component,
50
+ rows,
51
+ }));
52
+ }
@@ -0,0 +1,71 @@
1
+ import { Component, computed, signal } from '@angular/core';
2
+ import { CommonModule } from '@angular/common';
3
+ import { FormsModule } from '@angular/forms';
4
+ import { DasarInputComponent, DasarTableComponent, DasarTableColumn } from 'dasar-ui';
5
+ import { DocsLayoutComponent } from '../../layouts/doc.layout';
6
+ import { TOKEN_ROWS } from './theming.data';
7
+
8
+ @Component({
9
+ imports: [
10
+ CommonModule,
11
+ FormsModule,
12
+ DocsLayoutComponent,
13
+ DasarTableComponent,
14
+ DasarInputComponent,
15
+ ],
16
+ template: `<docs-layout
17
+ title="CSS Variables"
18
+ description="Flat list of every CSS variable the library reads, with the component and token behind it. Override any of them in plain CSS."
19
+ >
20
+ <dasar-input
21
+ label="Search variables"
22
+ placeholder="For example --btn- or --list-"
23
+ [ngModel]="query()"
24
+ (ngModelChange)="query.set($event)"
25
+ />
26
+ <p class="theming-count">{{ rows().length }} variables</p>
27
+ <dasar-table
28
+ [columns]="columns"
29
+ [hoverable]="true"
30
+ [striped]="true"
31
+ [data]="rows()"
32
+ appearance="outline"
33
+ spacing="normal"
34
+ />
35
+ </docs-layout>`,
36
+ styles: [
37
+ `
38
+ .theming-count {
39
+ font-size: var(--font-size-sm);
40
+ color: var(--theme-text-secondary-color);
41
+ }
42
+ dasar-table {
43
+ display: block;
44
+ margin-top: var(--space-4);
45
+ }
46
+ `,
47
+ ],
48
+ selector: 'app-theming-css-variables-page',
49
+ standalone: true,
50
+ })
51
+ export class ThemingCssVariablesDocPage {
52
+ protected query = signal('');
53
+
54
+ protected columns: DasarTableColumn[] = [
55
+ { key: 'cssVar', label: 'CSS variable' },
56
+ { key: 'component', label: 'Component' },
57
+ { key: 'token', label: 'Token key' },
58
+ { key: 'path', label: 'Config path' },
59
+ ];
60
+
61
+ protected rows = computed(() => {
62
+ const q = this.query().trim().toLowerCase();
63
+ if (!q) return TOKEN_ROWS;
64
+ return TOKEN_ROWS.filter(
65
+ (row) =>
66
+ row.cssVar.toLowerCase().includes(q) ||
67
+ row.token.toLowerCase().includes(q) ||
68
+ row.component.toLowerCase().includes(q),
69
+ );
70
+ });
71
+ }
@@ -0,0 +1,56 @@
1
+ import { Component } from '@angular/core';
2
+ import { CommonModule } from '@angular/common';
3
+ import { DasarTableComponent, DasarTableColumn } from 'dasar-ui';
4
+ import { DocsLayoutComponent } from '../../layouts/doc.layout';
5
+ import { TOKEN_GROUPS } from './theming.data';
6
+
7
+ @Component({
8
+ imports: [CommonModule, DocsLayoutComponent, DasarTableComponent],
9
+ template: `<docs-layout
10
+ title="Theme Tokens"
11
+ description="Every token key, the CSS variable it writes, and the config path that sets it. Use tokens.light.<component> or tokens.dark.<component> in setGlobalTheme or [tokenConfig]."
12
+ >
13
+ @for (group of groups; track group.component) {
14
+ <h2 class="theming-group-title">{{ group.component }}</h2>
15
+ <p class="theming-group-path">{{ group.path }}</p>
16
+ <dasar-table
17
+ [columns]="columns"
18
+ [hoverable]="true"
19
+ [striped]="true"
20
+ [data]="group.rows"
21
+ appearance="outline"
22
+ spacing="normal"
23
+ />
24
+ }
25
+ </docs-layout>`,
26
+ styles: [
27
+ `
28
+ .theming-group-title {
29
+ text-transform: capitalize;
30
+ margin: var(--space-6) 0 0;
31
+ }
32
+ .theming-group-path {
33
+ font-size: var(--font-size-sm);
34
+ color: var(--theme-text-secondary-color);
35
+ }
36
+ dasar-table {
37
+ display: block;
38
+ margin-bottom: var(--space-6);
39
+ }
40
+ `,
41
+ ],
42
+ selector: 'app-theming-tokens-page',
43
+ standalone: true,
44
+ })
45
+ export class ThemingTokensDocPage {
46
+ protected columns: DasarTableColumn[] = [
47
+ { key: 'token', label: 'Token key' },
48
+ { key: 'cssVar', label: 'CSS variable' },
49
+ ];
50
+
51
+ protected groups = TOKEN_GROUPS.map((group) => ({
52
+ component: group.component,
53
+ path: group.path,
54
+ rows: Object.entries(group.map).map(([token, cssVar]) => ({ token, cssVar })),
55
+ }));
56
+ }