@svadmin/ui 0.129.0 → 0.130.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.
@@ -0,0 +1,94 @@
1
+ import { SvelteMap } from 'svelte/reactivity';
2
+ /** 快照隔离调用方、不同 Studio 以及消费组件,写入必须经过 registry.set。 */
3
+ export function cloneFeatureFlag(flag) {
4
+ return {
5
+ ...flag,
6
+ ...(flag.rules ? { rules: flag.rules.map(rule => ({ ...rule, values: [...rule.values] })) } : {}),
7
+ ...(flag.tags ? { tags: [...flag.tags] } : {}),
8
+ };
9
+ }
10
+ /** 每个应用或 SSR 请求创建自己的注册表;不向模块级服务端状态写入数据。 */
11
+ export function createFeatureFlagRegistry(initialFlags = []) {
12
+ const flags = new SvelteMap();
13
+ const registry = {
14
+ get(key) {
15
+ const flag = flags.get(key);
16
+ return flag ? cloneFeatureFlag(flag) : undefined;
17
+ },
18
+ set(flag) { flags.set(flag.key, cloneFeatureFlag(flag)); },
19
+ register(values) { for (const flag of values)
20
+ registry.set(flag); },
21
+ replace(values) {
22
+ flags.clear();
23
+ registry.register(values);
24
+ },
25
+ clear() { flags.clear(); },
26
+ };
27
+ registry.register(initialFlags);
28
+ return registry;
29
+ }
30
+ let browserRegistry;
31
+ function defaultRegistry() {
32
+ if (typeof window === 'undefined') {
33
+ throw new Error('SSR feature flags require an explicit createFeatureFlagRegistry() instance');
34
+ }
35
+ return browserRegistry ??= createFeatureFlagRegistry();
36
+ }
37
+ /** FNV-1a:同一实体在不同调用中始终落入相同的 0–99 分桶。 */
38
+ export function hashStringToPercentage(value) {
39
+ let hash = 0x811c9dc5;
40
+ for (let index = 0; index < value.length; index++) {
41
+ hash = Math.imul(hash ^ value.charCodeAt(index), 0x01000193);
42
+ }
43
+ return (hash >>> 0) % 100;
44
+ }
45
+ export function evaluateFeatureFlag(flag, context = {}) {
46
+ if (flag.killSwitch || !flag.enabled)
47
+ return false;
48
+ const rules = flag.rules ?? [];
49
+ const matches = (rule) => {
50
+ const value = context[rule.field];
51
+ return (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean')
52
+ && rule.values.includes(String(value));
53
+ };
54
+ // 排除规则优先,不能因为白名单排在前面而绕过排除名单。
55
+ if (rules.some(rule => rule.operator === 'notIn' && matches(rule)))
56
+ return false;
57
+ const allowRules = rules.filter(rule => rule.operator === 'in' || rule.operator === 'equals');
58
+ if (allowRules.some(matches))
59
+ return true;
60
+ if (flag.percentage !== undefined) {
61
+ if (!Number.isFinite(flag.percentage) || flag.percentage <= 0)
62
+ return false;
63
+ if (flag.percentage >= 100)
64
+ return true;
65
+ const entityKey = context.userId || context.tenantId;
66
+ // 渐进发布必须有稳定实体;缺失身份时不把所有匿名访问者一起放行。
67
+ if (!entityKey)
68
+ return false;
69
+ return hashStringToPercentage(`${flag.key}:${entityKey}`) < flag.percentage;
70
+ }
71
+ return allowRules.length === 0;
72
+ }
73
+ export function registerFeatureFlags(flags, registry = defaultRegistry()) {
74
+ registry.register(flags);
75
+ }
76
+ export function setFeatureFlag(flag, registry = defaultRegistry()) {
77
+ registry.set(flag);
78
+ }
79
+ export function getFeatureFlag(key, registry = defaultRegistry()) {
80
+ return registry.get(key);
81
+ }
82
+ export function clearFeatureFlags(registry = defaultRegistry()) {
83
+ registry.clear();
84
+ }
85
+ /** 在组件初始化时捕获注册表,在响应式表达式中读取 enabled / flag。 */
86
+ export function useFeatureFlag(key, contextGetter, defaultFallback = false, registry = defaultRegistry()) {
87
+ return {
88
+ get enabled() {
89
+ const flag = registry.get(key);
90
+ return flag ? evaluateFeatureFlag(flag, contextGetter?.() ?? {}) : defaultFallback;
91
+ },
92
+ get flag() { return registry.get(key); },
93
+ };
94
+ }
package/dist/index.d.ts CHANGED
@@ -652,6 +652,8 @@ export { default as LiveStreamLogViewer, default as TailLogConsole, type LiveStr
652
652
  export { default as ElectronicSealStamp, default as ContractSigningPad, type ElectronicSealStampProps, type SealType } from './components/ElectronicSealStamp.svelte';
653
653
  export { default as SystemCapacityForecastCard, default as ResourceCapacityPredictor, type SystemCapacityForecastCardProps, type CapacityMetricPoint } from './components/SystemCapacityForecastCard.svelte';
654
654
  export { default as TenantContextSwitcher, default as WorkspaceContextSwitcher, type TenantContextSwitcherProps, type TenantItem, type TenantRole } from './components/TenantContextSwitcher.svelte';
655
+ export { default as FeatureFlagStudio, default as GrayReleaseManager, type FeatureFlagStudioProps } from './components/FeatureFlagStudio.svelte';
656
+ export { useFeatureFlag, createFeatureFlagRegistry, evaluateFeatureFlag, registerFeatureFlags, setFeatureFlag, getFeatureFlag, clearFeatureFlags, hashStringToPercentage, type FeatureFlag, type FeatureFlagRule, type FeatureFlagContext, type FeatureFlagRegistry, } from './components/useFeatureFlag.svelte.js';
655
657
  export { default as OmnibarCommandPalette, default as GlobalCommandOmnibar, type OmnibarCommandPaletteProps, type CommandPaletteItem } from './components/OmnibarCommandPalette.svelte';
656
658
  export { default as AuditTrailInspector, default as SecurityAuditTimeline, type AuditTrailInspectorProps, type AuditEventItem, type AuditActor, type AuditFieldChange } from './components/AuditTrailInspector.svelte';
657
659
  export { default as DashboardGridLayout, default as DynamicWidgetGrid, type DashboardGridLayoutProps, type DashboardGridItem } from './components/DashboardGridLayout.svelte';
@@ -660,7 +662,11 @@ export { default as ChartAnnotationOverlay, default as MetricEventAnnotation, ty
660
662
  export { default as AbacPolicyMatrix, default as AttributeBasedAccessControlMatrix, type AbacPolicyMatrixProps, type AbacPolicyRule, type AbacCondition } from './components/AbacPolicyMatrix.svelte';
661
663
  export { default as PermissionSimulator, default as RolePermissionSandbox, type PermissionSimulatorProps, type SimulationTargetUser, type SimulatedMenuNode, type SimulatedAction } from './components/PermissionSimulator.svelte';
662
664
  export { default as WorkflowNodeInspector, default as ApprovalNodeDrawer, type WorkflowNodeInspectorProps, type WorkflowNodeData } from './components/WorkflowNodeInspector.svelte';
665
+ export { default as MediaGallery, default as MultiModalMediaGallery, type MediaGalleryProps, type MediaGalleryItem } from './components/MediaGallery.svelte';
666
+ export { default as HotkeysHelpModal, default as HotkeysGuideModal, type HotkeysHelpModalProps, type HotkeysHelpEntry } from './components/HotkeysHelpModal.svelte';
667
+ export { default as ResizableSplitter, default as DynamicSplitter, type ResizableSplitterProps } from './components/ResizableSplitter.svelte';
663
668
  export { default as MicroAppSandbox, default as SubAppRuntimeSandbox, type MicroAppSandboxProps } from './components/MicroAppSandbox.svelte';
664
669
  export { useMicroAppState, type UseMicroAppStateOptions, type MicroAppStateMessage } from './components/useMicroAppState.svelte.js';
665
670
  export { default as MicroAppStateBusIndicator, default as CrossAppStateBus, type MicroAppStateBusIndicatorProps } from './components/MicroAppStateBusIndicator.svelte';
666
671
  export { default as MicroAppRouteSync, default as SubAppUrlSynchronizer, type MicroAppRouteSyncProps } from './components/MicroAppRouteSync.svelte';
672
+ export { default as NotificationDrawer, default as GlobalNoticeDrawer, type NotificationDrawerProps, type NotificationItem as NotificationDrawerItem, type NotificationAction, type NotificationCategory, } from './components/NotificationDrawer.svelte';
package/dist/index.js CHANGED
@@ -596,6 +596,9 @@ export { default as ElectronicSealStamp, default as ContractSigningPad } from '.
596
596
  export { default as SystemCapacityForecastCard, default as ResourceCapacityPredictor } from './components/SystemCapacityForecastCard.svelte';
597
597
  // Enterprise workspace & multi-tenant context switcher suite
598
598
  export { default as TenantContextSwitcher, default as WorkspaceContextSwitcher } from './components/TenantContextSwitcher.svelte';
599
+ // Enterprise feature flag & gray release control suite
600
+ export { default as FeatureFlagStudio, default as GrayReleaseManager } from './components/FeatureFlagStudio.svelte';
601
+ export { useFeatureFlag, createFeatureFlagRegistry, evaluateFeatureFlag, registerFeatureFlags, setFeatureFlag, getFeatureFlag, clearFeatureFlags, hashStringToPercentage, } from './components/useFeatureFlag.svelte.js';
599
602
  // Enterprise global omnibar command palette & resource search suite
600
603
  export { default as OmnibarCommandPalette, default as GlobalCommandOmnibar } from './components/OmnibarCommandPalette.svelte';
601
604
  // Enterprise audit trail inspector & cross-tenant security tracker suite
@@ -608,8 +611,14 @@ export { default as ChartAnnotationOverlay, default as MetricEventAnnotation } f
608
611
  export { default as AbacPolicyMatrix, default as AttributeBasedAccessControlMatrix } from './components/AbacPolicyMatrix.svelte';
609
612
  export { default as PermissionSimulator, default as RolePermissionSandbox } from './components/PermissionSimulator.svelte';
610
613
  export { default as WorkflowNodeInspector, default as ApprovalNodeDrawer } from './components/WorkflowNodeInspector.svelte';
614
+ // Enterprise multimodal media gallery, hotkeys guide & resizable splitter suite
615
+ export { default as MediaGallery, default as MultiModalMediaGallery } from './components/MediaGallery.svelte';
616
+ export { default as HotkeysHelpModal, default as HotkeysGuideModal } from './components/HotkeysHelpModal.svelte';
617
+ export { default as ResizableSplitter, default as DynamicSplitter } from './components/ResizableSplitter.svelte';
611
618
  // Enterprise micro-app isolated sandbox runtime, state bus & route sync suite
612
619
  export { default as MicroAppSandbox, default as SubAppRuntimeSandbox } from './components/MicroAppSandbox.svelte';
613
620
  export { useMicroAppState } from './components/useMicroAppState.svelte.js';
614
621
  export { default as MicroAppStateBusIndicator, default as CrossAppStateBus } from './components/MicroAppStateBusIndicator.svelte';
615
622
  export { default as MicroAppRouteSync, default as SubAppUrlSynchronizer } from './components/MicroAppRouteSync.svelte';
623
+ // Enterprise global notification drawer suite
624
+ export { default as NotificationDrawer, default as GlobalNoticeDrawer, } from './components/NotificationDrawer.svelte';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@svadmin/ui",
3
- "version": "0.129.0",
3
+ "version": "0.130.0",
4
4
  "description": "Pre-built admin UI components — AdminApp, AutoTable, AutoForm, Sidebar, Layout",
5
5
  "type": "module",
6
6
  "sideEffects": [