@starasia/theme 3.1.0 → 3.3.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.
- package/dist/components/ThemeProvider.d.ts +25 -1
- package/dist/components/ThemeSwitcher.d.ts +28 -0
- package/dist/components/index.d.ts +1 -0
- package/dist/hooks/useTheme.d.ts +5 -0
- package/dist/index.es.js +853 -229
- package/dist/index.umd.js +9 -7
- package/dist/theme/buildTheme.d.ts +11 -1
- package/dist/theme/index.d.ts +1 -0
- package/dist/theme/persist.d.ts +31 -0
- package/dist/theme/semanticRecipes.d.ts +20 -0
- package/package.json +1 -1
|
@@ -1,10 +1,21 @@
|
|
|
1
1
|
import { default as React, PropsWithChildren } from 'react';
|
|
2
2
|
import { ThemeObject } from '../types/theme';
|
|
3
3
|
import { ThemeSeed } from '../theme/buildTheme';
|
|
4
|
+
import { ThemeMode } from '../theme/persist';
|
|
4
5
|
|
|
5
6
|
export interface ThemeContextProps {
|
|
6
7
|
theme?: ThemeObject;
|
|
7
8
|
setTheme: (theme?: ThemeObject) => void;
|
|
9
|
+
/** Seed custom aktif (Fase 2 runtime; null = tak ada). */
|
|
10
|
+
seed: ThemeSeed | null;
|
|
11
|
+
/** Ganti seed custom + persist. Hanya jalur UNCONTROLLED (tanpa prop `seed`). */
|
|
12
|
+
setSeed: (seed: ThemeSeed | null) => void;
|
|
13
|
+
/** Set mode terang/gelap/ikuti-sistem (`data-theme`) + persist. */
|
|
14
|
+
setMode: (mode: ThemeMode) => void;
|
|
15
|
+
/** Set skin (`data-skin`, mis. "tech"/"ocean") + persist. null = default. */
|
|
16
|
+
setSkin: (skin: string | null) => void;
|
|
17
|
+
/** Hapus seed custom + preferensi tersimpan. */
|
|
18
|
+
resetTheme: () => void;
|
|
8
19
|
}
|
|
9
20
|
export declare const ThemeContext: React.Context<ThemeContextProps>;
|
|
10
21
|
export interface ThemeProviderProps extends PropsWithChildren {
|
|
@@ -13,7 +24,20 @@ export interface ThemeProviderProps extends PropsWithChildren {
|
|
|
13
24
|
* Seed tema (brand/status/neutral/radius/font) → di-generate penuh ke token
|
|
14
25
|
* `--sa-*` lewat buildTheme dan di-inject global di `:root` (light + dark).
|
|
15
26
|
* Opt-in & additif: tanpa `seed`, perilaku lama (brand via `value`) utuh.
|
|
27
|
+
*
|
|
28
|
+
* Kalau prop ini DIISI = mode CONTROLLED (app yang pegang, tak di-persist).
|
|
29
|
+
* Kalau TIDAK diisi = mode UNCONTROLLED: seed dari `setSeed`/storage, di-persist.
|
|
16
30
|
*/
|
|
17
31
|
seed?: ThemeSeed;
|
|
32
|
+
/** Simpan & pulihkan seed custom dari localStorage. Default true (auto-on). */
|
|
33
|
+
persist?: boolean;
|
|
34
|
+
/** Key localStorage untuk preferensi tema. Default `"sa-theme"`. */
|
|
35
|
+
storageKey?: string;
|
|
36
|
+
/**
|
|
37
|
+
* Pulihkan mode (`data-theme`) & skin (`data-skin`) tersimpan saat mount.
|
|
38
|
+
* Default false supaya tak bentrok dgn app yang mengelola atribut sendiri;
|
|
39
|
+
* untuk anti-FOUC pakai `themeBootScript()` di `<head>`.
|
|
40
|
+
*/
|
|
41
|
+
manageAttributes?: boolean;
|
|
18
42
|
}
|
|
19
|
-
export declare function ThemeProvider({ value, seed, children }: ThemeProviderProps): React.JSX.Element;
|
|
43
|
+
export declare function ThemeProvider({ value, seed, persist, storageKey, manageAttributes, children, }: ThemeProviderProps): React.JSX.Element;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
|
|
3
|
+
export interface ThemeSwitcherSkin {
|
|
4
|
+
/** Nilai `data-skin`. null = skin default (atribut dilepas). */
|
|
5
|
+
name: string | null;
|
|
6
|
+
label: string;
|
|
7
|
+
}
|
|
8
|
+
export interface ThemeSwitcherProps {
|
|
9
|
+
/** Pilihan skin. Default: Default + Tech. */
|
|
10
|
+
skins?: ThemeSwitcherSkin[];
|
|
11
|
+
/** Tampilkan segmen mode (Light/Dark/System). Default true. */
|
|
12
|
+
showMode?: boolean;
|
|
13
|
+
/** Tampilkan color picker brand custom (pakai jalur seed). Default false. */
|
|
14
|
+
allowCustom?: boolean;
|
|
15
|
+
/** Key storage (hanya untuk membaca state awal; penulisan oleh ThemeProvider). */
|
|
16
|
+
storageKey?: string;
|
|
17
|
+
className?: string;
|
|
18
|
+
style?: React.CSSProperties;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* UI siap-pakai untuk pilih mode + skin (+ brand custom). Menulis atribut
|
|
22
|
+
* `data-theme`/`data-skin` & meng-inject seed lewat context ThemeProvider, dan
|
|
23
|
+
* (kalau `persist` aktif di ThemeProvider) menyimpannya ke localStorage.
|
|
24
|
+
*
|
|
25
|
+
* Catatan: untuk restore mode/skin pre-paint (anti-FOUC), pasang juga
|
|
26
|
+
* `themeBootScript()` di `<head>` — komponen ini merestor saat React mount.
|
|
27
|
+
*/
|
|
28
|
+
export declare function ThemeSwitcher({ skins, showMode, allowCustom, storageKey, className, style, }: ThemeSwitcherProps): React.JSX.Element;
|
package/dist/hooks/useTheme.d.ts
CHANGED
|
@@ -3,4 +3,9 @@ import { ThemeObject } from '../types';
|
|
|
3
3
|
export default function useTheme(): {
|
|
4
4
|
theme: ThemeObject;
|
|
5
5
|
setTheme: (theme?: ThemeObject | undefined) => void;
|
|
6
|
+
seed: import('..').ThemeSeed | null;
|
|
7
|
+
setSeed: (seed: import('..').ThemeSeed | null) => void;
|
|
8
|
+
setMode: (mode: import('..').ThemeMode) => void;
|
|
9
|
+
setSkin: (skin: string | null) => void;
|
|
10
|
+
resetTheme: () => void;
|
|
6
11
|
};
|