@svadmin/core 0.74.0 → 0.76.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@svadmin/core",
3
- "version": "0.74.0",
3
+ "version": "0.76.0",
4
4
  "author": "zuohuadong",
5
5
  "repository": {
6
6
  "type": "git",
@@ -4,6 +4,7 @@ import { definedOptions } from './defined-options';
4
4
 
5
5
  import { createContext } from 'svelte';
6
6
  import type { DataProvider,AuthProvider,ResourceDefinition,TaskProvider } from './types';
7
+ import type { StorageProvider } from './storage-contract';
7
8
  import type { RouterProvider } from './router-provider';
8
9
  import type { LiveProvider } from './live.svelte';
9
10
  import type { RegisteredAccessControlProvider } from './permissions.svelte';
@@ -90,6 +91,7 @@ export interface AdminContextValue {
90
91
  readonly identityGovernanceProvider: ProviderBundle['identityGovernanceProvider'];
91
92
  readonly sessionProvider: ProviderBundle['sessionProvider'];
92
93
  readonly credentialProvider: ProviderBundle['credentialProvider'];
94
+ readonly storageProvider: StorageProvider|null|undefined;
93
95
  readonly tenant: TenantContext|undefined;
94
96
  readonly tenantAdapter: TenantAdapter|undefined;
95
97
  }
@@ -119,6 +121,7 @@ export interface AdminContextAccessor {
119
121
  readonly identityGovernanceProvider: ProviderBundle['identityGovernanceProvider'];
120
122
  readonly sessionProvider: ProviderBundle['sessionProvider'];
121
123
  readonly credentialProvider: ProviderBundle['credentialProvider'];
124
+ readonly storageProvider: StorageProvider|null|undefined;
122
125
  readonly tenant: TenantContext|undefined;
123
126
  readonly tenantAdapter: TenantAdapter|undefined;
124
127
  readonly tenantCacheKey: TenantCacheKey|undefined;
@@ -196,6 +199,9 @@ function resolveProviderBundle(source: AdminContextSource): ResolvedProviderBund
196
199
  credentialProvider: source.credentialProvider!==undefined
197
200
  ? source.credentialProvider
198
201
  :bundled?.credentialProvider,
202
+ storageProvider: source.storageProvider!==undefined
203
+ ? source.storageProvider
204
+ :bundled?.storageProvider,
199
205
  }));
200
206
  }
201
207
 
@@ -218,6 +224,7 @@ export function createAdminContext(source: AdminContextSource): AdminContextValu
218
224
  get identityGovernanceProvider() { return resolveProviderBundle(source).identityGovernanceProvider??null; },
219
225
  get sessionProvider() { return resolveProviderBundle(source).sessionProvider??null; },
220
226
  get credentialProvider() { return resolveProviderBundle(source).credentialProvider??null; },
227
+ get storageProvider() { return resolveProviderBundle(source).storageProvider??null; },
221
228
  get tenant() { return source.tenant??inheritedTenant; },
222
229
  get tenantAdapter() { return resolveProviderBundle(source).tenantAdapter; },
223
230
  });
@@ -270,6 +277,7 @@ export function captureAdminContext(): AdminContextAccessor {
270
277
  chatProvider: getLegacyChatProvider(),
271
278
  agentProvider: getLegacyAgentProvider(),
272
279
  taskProvider: taskProviderState,
280
+ storageProvider: storageProviderState,
273
281
  routerProvider,
274
282
  }));
275
283
  },
@@ -292,6 +300,7 @@ export function captureAdminContext(): AdminContextAccessor {
292
300
  get identityGovernanceProvider() { return scopedContext?.identityGovernanceProvider??null; },
293
301
  get sessionProvider() { return scopedContext?.sessionProvider??null; },
294
302
  get credentialProvider() { return scopedContext?.credentialProvider??null; },
303
+ get storageProvider() { return scopedContext? scopedContext.storageProvider:storageProviderState; },
295
304
  get tenant() { return scopedContext?.tenant; },
296
305
  get tenantAdapter() { return scopedContext?.tenantAdapter; },
297
306
  get tenantCacheKey() {
@@ -518,6 +527,24 @@ export function getTaskProvider(options?: { optional?: boolean }): TaskProvider|
518
527
  return activeTaskProvider;
519
528
  }
520
529
 
530
+ // ─── Storage Provider ───────────────────────────────────────────
531
+
532
+ let storageProviderState=$state<StorageProvider|undefined>(undefined);
533
+
534
+ export function setStorageProvider(provider: StorageProvider|undefined): void {
535
+ storageProviderState=provider;
536
+ }
537
+
538
+ export function getStorageProvider(): StorageProvider;
539
+ export function getStorageProvider(options: { optional: true }): StorageProvider|undefined;
540
+ export function getStorageProvider(options?: { optional?: boolean }): StorageProvider|undefined {
541
+ const activeStorageProvider=captureAdminContext().storageProvider;
542
+ if(!activeStorageProvider&&!options?.optional) {
543
+ throw new Error('StorageProvider not found. Did you call setStorageProvider in App.svelte?');
544
+ }
545
+ return activeStorageProvider??undefined;
546
+ }
547
+
521
548
  // ─── Reset — for testing / HMR ─────────────────────────────────
522
549
 
523
550
  export function resetContext(): void {
@@ -527,6 +554,7 @@ export function resetContext(): void {
527
554
  routerProvider=undefined;
528
555
  liveProviderState=undefined;
529
556
  taskProviderState=undefined;
557
+ storageProviderState=undefined;
530
558
  resetNotificationProvider();
531
559
  resetAuditLogProvider();
532
560
  resetAccessControlProvider();
package/src/index.ts CHANGED
@@ -9,6 +9,7 @@ export {
9
9
  setRouterProvider, getRouterProvider,
10
10
  setLiveProvider, getLiveProvider,
11
11
  setTaskProvider, getTaskProvider,
12
+ setStorageProvider, getStorageProvider,
12
13
  createAdminContext, provideAdminContext, getAdminContext, captureAdminContext,
13
14
  provideTenantContext, getTenantContext, getProviderBundle,
14
15
  resetContext,
@@ -284,9 +285,9 @@ export type {
284
285
  SchemaFormValidationError,
285
286
  } from './schema-form';
286
287
  export {
287
- auditThemeContrast, failingContrastChecks, parseDtcgTheme, presetFromDtcg,
288
+ auditThemeContrast, exportDtcgTheme, failingContrastChecks, parseDtcgTheme, presetFromDtcg,
288
289
  } from './theme-dtcg';
289
- export type { ContrastCheck, DtcgIssue, DtcgTheme } from './theme-dtcg';
290
+ export type { ContrastCheck, DtcgColorToken, DtcgIssue, DtcgTheme, DtcgThemeDocument } from './theme-dtcg';
290
291
  export { useExport } from './export-hooks.svelte';
291
292
  export { snapshotExportTaskResult, downloadExportArtifact, safeArtifactUrl } from './export-format';
292
293
  export type { ExportTaskResult } from './export-format';
@@ -480,3 +481,13 @@ export type {
480
481
  RetryOptions,
481
482
  SafeDataProvider,
482
483
  } from './resilience';
484
+
485
+ export { useStorage } from './storage-hooks.svelte';
486
+ export type {
487
+ StorageProvider,
488
+ StorageUploadOptions,
489
+ StorageUploadResult,
490
+ StoragePresignedUrlOptions,
491
+ StorageFileItem,
492
+ StorageListOptions,
493
+ } from './storage-contract';
@@ -40,6 +40,7 @@ import type {
40
40
  UpdateParams,
41
41
  UpdateResult,
42
42
  } from './types';
43
+ import type { StorageProvider } from './storage-contract';
43
44
 
44
45
  export type DataProviderInput=DataProvider|Record<string,DataProvider>;
45
46
 
@@ -63,6 +64,7 @@ export interface ProviderBundle {
63
64
  readonly identityGovernanceProvider?: IdentityGovernanceProvider|null;
64
65
  readonly sessionProvider?: SessionProvider|null;
65
66
  readonly credentialProvider?: CredentialProvider|null;
67
+ readonly storageProvider?: StorageProvider|null;
66
68
  }
67
69
 
68
70
  /** Preserves the input object's exact type while applying compile-time ProviderBundle validation. */
@@ -0,0 +1,40 @@
1
+ export interface StorageUploadOptions {
2
+ path?: string;
3
+ filename?: string;
4
+ contentType?: string;
5
+ metadata?: Record<string, string>;
6
+ onProgress?: (progress: { loaded: number; total: number; percentage: number }) => void;
7
+ }
8
+
9
+ export interface StorageUploadResult {
10
+ url: string;
11
+ path: string;
12
+ size?: number;
13
+ contentType?: string;
14
+ metadata?: Record<string, string>;
15
+ }
16
+
17
+ export interface StoragePresignedUrlOptions {
18
+ expiresInSeconds?: number;
19
+ operation?: 'get' | 'put';
20
+ }
21
+
22
+ export interface StorageFileItem {
23
+ name: string;
24
+ path: string;
25
+ size?: number;
26
+ lastModified?: string | Date;
27
+ url?: string;
28
+ }
29
+
30
+ export interface StorageListOptions {
31
+ prefix?: string;
32
+ limit?: number;
33
+ }
34
+
35
+ export interface StorageProvider {
36
+ upload(file: File | Blob | ArrayBuffer | Uint8Array, options?: StorageUploadOptions): Promise<StorageUploadResult>;
37
+ delete(path: string): Promise<void>;
38
+ getPresignedUrl?(path: string, options?: StoragePresignedUrlOptions): Promise<string>;
39
+ list?(options?: StorageListOptions): Promise<StorageFileItem[]>;
40
+ }
@@ -0,0 +1,86 @@
1
+ import { captureAdminContext } from './context.svelte';
2
+ import type {
3
+ StorageUploadOptions,
4
+ StorageUploadResult,
5
+ StorageFileItem,
6
+ StorageListOptions,
7
+ } from './storage-contract';
8
+
9
+ export function useStorage() {
10
+ const context = captureAdminContext();
11
+ const provider = context.storageProvider;
12
+
13
+ let isUploading = $state(false);
14
+ let uploadProgress = $state(0);
15
+ let error = $state<Error | null>(null);
16
+
17
+ async function upload(
18
+ file: File | Blob | ArrayBuffer | Uint8Array,
19
+ options?: StorageUploadOptions,
20
+ ): Promise<StorageUploadResult> {
21
+ if (!provider) {
22
+ throw new Error('StorageProvider not configured. Set storageProvider in context or call setStorageProvider().');
23
+ }
24
+ isUploading = true;
25
+ uploadProgress = 0;
26
+ error = null;
27
+ try {
28
+ const result = await provider.upload(file, {
29
+ ...options,
30
+ onProgress: (p) => {
31
+ uploadProgress = p.percentage;
32
+ options?.onProgress?.(p);
33
+ },
34
+ });
35
+ return result;
36
+ } catch (err) {
37
+ error = err instanceof Error ? err : new Error(String(err));
38
+ throw err;
39
+ } finally {
40
+ isUploading = false;
41
+ }
42
+ }
43
+
44
+ async function deleteFile(path: string): Promise<void> {
45
+ if (!provider) {
46
+ throw new Error('StorageProvider not configured.');
47
+ }
48
+ return provider.delete(path);
49
+ }
50
+
51
+ async function getDownloadUrl(path: string, options?: { expiresInSeconds?: number }): Promise<string> {
52
+ if (!provider) {
53
+ throw new Error('StorageProvider not configured.');
54
+ }
55
+ if (provider.getPresignedUrl) {
56
+ return provider.getPresignedUrl(path, { operation: 'get', ...options });
57
+ }
58
+ return path;
59
+ }
60
+
61
+ async function listFiles(options?: StorageListOptions): Promise<StorageFileItem[]> {
62
+ if (!provider?.list) {
63
+ return [];
64
+ }
65
+ return provider.list(options);
66
+ }
67
+
68
+ return {
69
+ get provider() {
70
+ return provider;
71
+ },
72
+ get isUploading() {
73
+ return isUploading;
74
+ },
75
+ get uploadProgress() {
76
+ return uploadProgress;
77
+ },
78
+ get error() {
79
+ return error;
80
+ },
81
+ upload,
82
+ deleteFile,
83
+ getDownloadUrl,
84
+ listFiles,
85
+ };
86
+ }
package/src/theme-dtcg.ts CHANGED
@@ -27,6 +27,18 @@ export interface DtcgTheme {
27
27
  issues: DtcgIssue[];
28
28
  }
29
29
 
30
+ export interface DtcgColorToken {
31
+ $type: 'color';
32
+ $value: string;
33
+ }
34
+
35
+ export interface DtcgThemeDocument {
36
+ color: {
37
+ light: Record<string, DtcgColorToken>;
38
+ dark: Record<string, DtcgColorToken>;
39
+ };
40
+ }
41
+
30
42
  const MAX_DEPTH = 32;
31
43
  const MAX_TOKENS = 2000;
32
44
  const CSS_VAR_PATTERN = /^--[a-z0-9-]{1,64}$/i;
@@ -163,6 +175,44 @@ export function parseDtcgTheme(document: unknown): DtcgTheme {
163
175
  return result;
164
176
  }
165
177
 
178
+ function cssVarToDtcgName(variable: string): string {
179
+ if (!CSS_VAR_PATTERN.test(variable)) {
180
+ throw new TypeError(`Invalid CSS variable name: ${variable}`);
181
+ }
182
+ const segments = variable.slice(2).split('-').filter(Boolean);
183
+ if (segments.length === 0) throw new TypeError(`Invalid CSS variable name: ${variable}`);
184
+ return segments.map((segment, index) => (
185
+ index === 0 ? segment : `${segment[0]?.toUpperCase() ?? ''}${segment.slice(1)}`
186
+ )).join('');
187
+ }
188
+
189
+ function exportDtcgMode(tokens: Record<string, string>, mode: 'light' | 'dark'): Record<string, DtcgColorToken> {
190
+ const result: Record<string, DtcgColorToken> = {};
191
+ for (const [variable, rawValue] of Object.entries(tokens)) {
192
+ const value = rawValue.trim();
193
+ if (!COLOR_VALUE_PATTERN.test(value) || /[;{}]/.test(value)) {
194
+ throw new TypeError(`${mode}.${variable} is not a portable color token value`);
195
+ }
196
+ const name = cssVarToDtcgName(variable);
197
+ if (result[name] !== undefined) {
198
+ throw new TypeError(`${mode} contains duplicate DTCG token name: ${name}`);
199
+ }
200
+ result[name] = { $type: 'color', $value: value };
201
+ }
202
+ if (Object.keys(result).length === 0) throw new TypeError(`${mode} must declare at least one color token`);
203
+ return result;
204
+ }
205
+
206
+ /** Serialize CSS color variables into a portable W3C DTCG token document. */
207
+ export function exportDtcgTheme(input: Pick<DtcgTheme, 'light' | 'dark'>): DtcgThemeDocument {
208
+ return {
209
+ color: {
210
+ light: exportDtcgMode(input.light, 'light'),
211
+ dark: exportDtcgMode(input.dark, 'dark'),
212
+ },
213
+ };
214
+ }
215
+
166
216
  /**
167
217
  * Build a complete preset from a DTCG document. Tokens present in the document
168
218
  * win; missing keys fall back to the generated palette for the same brand color.
@@ -276,4 +326,4 @@ export function formatContrastReport(presetName: string, checks: readonly Contra
276
326
  '| --- | --- | --- | --- | --- |',
277
327
  ...rows,
278
328
  ].join('\n');
279
- }
329
+ }