@aigne/aos 0.2.0-beta

package/dist/scaffold/types.d.cts

@@ -0,0 +1,264 @@
+import { AutoSurfaceLayer, AutoSurfaceProjection, AutoSurfaceProjectorName, AutoSurfaceResolvedScenario } from "../auto-surface/types.cjs";
+
+//#region src/scaffold/types.d.ts
+type ScaffoldTargetKind = "module" | "surface" | "route" | "url";
+type ScaffoldModuleKind = "site" | "app" | "agent" | "support-community" | (string & {});
+type ScaffoldProviderKind = "web" | "aup" | "agent" | "blocklet" | (string & {});
+type ScaffoldMenuPlacement = "header" | "footer" | "sidebar" | "launcher" | (string & {});
+interface ScaffoldTargetRef {
+  kind: ScaffoldTargetKind;
+  ref?: string;
+  href?: string;
+}
+interface ScaffoldManifest {
+  id?: string;
+  title: string;
+  description?: string;
+  defaultModule?: string;
+  metadata?: Record<string, unknown>;
+}
+interface ScaffoldMenuItem {
+  id: string;
+  title: string;
+  target?: ScaffoldTargetRef;
+  icon?: string;
+  badge?: string;
+  order?: number;
+  placement?: ScaffoldMenuPlacement[];
+  children?: ScaffoldMenuItem[];
+}
+interface ScaffoldMenuGroup {
+  id: string;
+  title: string;
+  order?: number;
+  items: ScaffoldMenuItem[];
+}
+interface ScaffoldMenuDefinition {
+  groups: ScaffoldMenuGroup[];
+}
+interface ScaffoldShellAction {
+  id: string;
+  title: string;
+  target: ScaffoldTargetRef;
+  order?: number;
+}
+interface ScaffoldHeaderDefinition {
+  title?: string;
+  subtitle?: string;
+  logo?: string;
+  actions?: ScaffoldShellAction[];
+}
+interface ScaffoldFooterLink {
+  id: string;
+  title: string;
+  target: ScaffoldTargetRef;
+  order?: number;
+}
+interface ScaffoldFooterDefinition {
+  text?: string;
+  links?: ScaffoldFooterLink[];
+}
+interface ScaffoldWorkspaceRoot {
+  id: string;
+  title: string;
+  path: string;
+  description?: string;
+  order?: number;
+  /**
+   * Passed through to the afs-list renderer. This keeps the shell declarative
+   * without enumerating children that already live in AFS.
+   */
+  filter?: string | Record<string, unknown>;
+  sort?: string | Record<string, unknown>;
+  maxDepth?: number;
+  layout?: "grouped" | "list" | (string & {});
+  itemStyle?: "compact" | "row" | "card" | (string & {});
+  showParent?: boolean;
+  editable?: boolean;
+}
+interface ScaffoldWorkspaceSection {
+  id: string;
+  title: string;
+  description?: string;
+  order?: number;
+  roots: ScaffoldWorkspaceRoot[];
+}
+interface ScaffoldWorkspaceAgentDefinition {
+  module?: string;
+  title?: string;
+  placeholder?: string;
+}
+interface ScaffoldWorkspaceDetailDefinition {
+  renderer?: "surface" | "auto-surface";
+  pattern?: string;
+}
+interface ScaffoldWorkspaceRailItem {
+  id: string;
+  title: string;
+  icon?: string;
+  href?: string;
+  active?: boolean;
+  order?: number;
+}
+interface ScaffoldWorkspaceDefinition {
+  title?: string;
+  description?: string;
+  variant?: string;
+  defaultPath?: string;
+  detail?: ScaffoldWorkspaceDetailDefinition;
+  rail?: ScaffoldWorkspaceRailItem[];
+  sections: ScaffoldWorkspaceSection[];
+  agent?: ScaffoldWorkspaceAgentDefinition;
+}
+interface ScaffoldShellDefinition {
+  menu?: ScaffoldMenuDefinition;
+  header?: ScaffoldHeaderDefinition;
+  footer?: ScaffoldFooterDefinition;
+  workspace?: ScaffoldWorkspaceDefinition;
+}
+interface ScaffoldWebModuleBinding {
+  provider: "web";
+  entry: string;
+  pageRoot?: string;
+  webRoot?: string;
+  homePage?: string;
+}
+interface ScaffoldAupModuleBinding {
+  provider: "aup";
+  entry: string;
+  wrapper?: string;
+  defaultPage?: string;
+}
+interface ScaffoldAgentModuleBinding {
+  provider: "agent";
+  entry: string;
+  session?: string;
+}
+interface ScaffoldBlockletModuleBinding {
+  provider: "blocklet";
+  blocklet: string;
+  mountPath?: string;
+  description?: string;
+}
+type ScaffoldModuleBinding = ScaffoldWebModuleBinding | ScaffoldAupModuleBinding | ScaffoldAgentModuleBinding | ScaffoldBlockletModuleBinding;
+interface ScaffoldModuleDefinition {
+  id: string;
+  kind: ScaffoldModuleKind;
+  title: string;
+  description?: string;
+  provider?: ScaffoldProviderKind;
+  binding?: ScaffoldModuleBinding;
+  route?: string;
+  entry?: string;
+  blocklet?: string;
+  order?: number;
+  metadata?: Record<string, unknown>;
+}
+interface ScaffoldSurfaceDefinition {
+  id: string;
+  kind: "auto-surface" | (string & {});
+  title?: string;
+  module?: string;
+  projector?: AutoSurfaceProjectorName;
+  definitionRoot?: string;
+  valueRoots?: Partial<Record<AutoSurfaceLayer, string>>;
+  scope?: AutoSurfaceLayer | "all";
+  order?: number;
+  metadata?: Record<string, unknown>;
+}
+interface ScaffoldDefinition {
+  manifest: ScaffoldManifest;
+  shell: ScaffoldShellDefinition;
+  modules: ScaffoldModuleDefinition[];
+  surfaces: ScaffoldSurfaceDefinition[];
+}
+interface ScaffoldDiagnostic {
+  code: "duplicate_module" | "duplicate_surface" | "invalid_module_definition" | "missing_default_module" | "missing_module_reference" | "missing_surface_reference";
+  severity: "error" | "warning";
+  message: string;
+  id?: string;
+}
+interface ResolvedScaffoldDefinition {
+  definition: ScaffoldDefinition;
+  diagnostics: ScaffoldDiagnostic[];
+  modulesById: Record<string, ScaffoldModuleDefinition>;
+  surfacesById: Record<string, ScaffoldSurfaceDefinition>;
+}
+interface ScaffoldSurfaceRuntimeDiagnostic {
+  code: "missing_surface" | "unsupported_surface_kind" | "surface_resolve_error";
+  severity: "error" | "warning";
+  surfaceId: string;
+  message: string;
+}
+interface ResolvedScaffoldAutoSurface {
+  kind: "auto-surface";
+  definition: ScaffoldSurfaceDefinition;
+  scenario: AutoSurfaceResolvedScenario;
+  projection: AutoSurfaceProjection;
+}
+type ResolvedScaffoldSurface = ResolvedScaffoldAutoSurface;
+interface ResolvedScaffoldSurfaces {
+  surfaces: Record<string, ResolvedScaffoldSurface>;
+  diagnostics: ScaffoldSurfaceRuntimeDiagnostic[];
+}
+interface ResolvedScaffoldModule {
+  definition: ScaffoldModuleDefinition;
+  binding?: ScaffoldModuleBinding;
+  surfaceDefinitions: ScaffoldSurfaceDefinition[];
+  surfaces: ResolvedScaffoldSurface[];
+}
+interface ResolvedScaffoldTarget {
+  kind: ScaffoldTargetKind;
+  ref?: string;
+  href?: string;
+  module?: ResolvedScaffoldModule;
+  surface?: ResolvedScaffoldSurface;
+  surfaceDefinition?: ScaffoldSurfaceDefinition;
+}
+interface ResolvedScaffoldMenuItem extends Omit<ScaffoldMenuItem, "target" | "children"> {
+  target?: ResolvedScaffoldTarget;
+  children?: ResolvedScaffoldMenuItem[];
+}
+interface ResolvedScaffoldMenuGroup extends Omit<ScaffoldMenuGroup, "items"> {
+  items: ResolvedScaffoldMenuItem[];
+}
+interface ResolvedScaffoldHeaderAction extends Omit<ScaffoldShellAction, "target"> {
+  target: ResolvedScaffoldTarget;
+}
+interface ResolvedScaffoldFooterLink extends Omit<ScaffoldFooterLink, "target"> {
+  target: ResolvedScaffoldTarget;
+}
+interface ResolvedScaffoldWorkspaceSection extends Omit<ScaffoldWorkspaceSection, "roots"> {
+  roots: ScaffoldWorkspaceRoot[];
+}
+interface ResolvedScaffoldWorkspaceDefinition extends Omit<ScaffoldWorkspaceDefinition, "sections"> {
+  sections: ResolvedScaffoldWorkspaceSection[];
+}
+interface ResolvedScaffoldShell {
+  menu?: {
+    groups: ResolvedScaffoldMenuGroup[];
+  };
+  header?: Omit<ScaffoldHeaderDefinition, "actions"> & {
+    actions?: ResolvedScaffoldHeaderAction[];
+  };
+  footer?: Omit<ScaffoldFooterDefinition, "links"> & {
+    links?: ResolvedScaffoldFooterLink[];
+  };
+  workspace?: ResolvedScaffoldWorkspaceDefinition;
+}
+interface ScaffoldCompositionDiagnostic {
+  code: "missing_runtime_surface";
+  severity: "warning";
+  targetId: string;
+  message: string;
+}
+interface ResolvedScaffoldApp {
+  manifest: ScaffoldManifest;
+  defaultModule?: ResolvedScaffoldModule;
+  modules: ResolvedScaffoldModule[];
+  shell: ResolvedScaffoldShell;
+  diagnostics: ScaffoldCompositionDiagnostic[];
+}
+//#endregion
+export { ResolvedScaffoldApp, ResolvedScaffoldDefinition, ResolvedScaffoldFooterLink, ResolvedScaffoldHeaderAction, ResolvedScaffoldMenuGroup, ResolvedScaffoldMenuItem, ResolvedScaffoldModule, ResolvedScaffoldShell, ResolvedScaffoldSurface, ResolvedScaffoldSurfaces, ResolvedScaffoldTarget, ResolvedScaffoldWorkspaceDefinition, ResolvedScaffoldWorkspaceSection, ScaffoldAgentModuleBinding, ScaffoldAupModuleBinding, ScaffoldBlockletModuleBinding, ScaffoldCompositionDiagnostic, ScaffoldDefinition, ScaffoldDiagnostic, ScaffoldFooterDefinition, ScaffoldFooterLink, ScaffoldHeaderDefinition, ScaffoldManifest, ScaffoldMenuDefinition, ScaffoldMenuGroup, ScaffoldMenuItem, ScaffoldMenuPlacement, ScaffoldModuleBinding, ScaffoldModuleDefinition, ScaffoldModuleKind, ScaffoldProviderKind, ScaffoldShellAction, ScaffoldShellDefinition, ScaffoldSurfaceDefinition, ScaffoldSurfaceRuntimeDiagnostic, ScaffoldTargetKind, ScaffoldTargetRef, ScaffoldWebModuleBinding, ScaffoldWorkspaceAgentDefinition, ScaffoldWorkspaceDefinition, ScaffoldWorkspaceRailItem, ScaffoldWorkspaceRoot, ScaffoldWorkspaceSection };
+//# sourceMappingURL=types.d.cts.map

package/dist/scaffold/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../src/scaffold/types.ts"],"mappings":"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"}

package/dist/scaffold/types.d.mts

@@ -0,0 +1,265 @@
+import { AutoSurfaceLayer, AutoSurfaceProjection, AutoSurfaceProjectorName, AutoSurfaceResolvedScenario } from "../auto-surface/types.mjs";
+import "../auto-surface/index.mjs";
+
+//#region src/scaffold/types.d.ts
+type ScaffoldTargetKind = "module" | "surface" | "route" | "url";
+type ScaffoldModuleKind = "site" | "app" | "agent" | "support-community" | (string & {});
+type ScaffoldProviderKind = "web" | "aup" | "agent" | "blocklet" | (string & {});
+type ScaffoldMenuPlacement = "header" | "footer" | "sidebar" | "launcher" | (string & {});
+interface ScaffoldTargetRef {
+  kind: ScaffoldTargetKind;
+  ref?: string;
+  href?: string;
+}
+interface ScaffoldManifest {
+  id?: string;
+  title: string;
+  description?: string;
+  defaultModule?: string;
+  metadata?: Record<string, unknown>;
+}
+interface ScaffoldMenuItem {
+  id: string;
+  title: string;
+  target?: ScaffoldTargetRef;
+  icon?: string;
+  badge?: string;
+  order?: number;
+  placement?: ScaffoldMenuPlacement[];
+  children?: ScaffoldMenuItem[];
+}
+interface ScaffoldMenuGroup {
+  id: string;
+  title: string;
+  order?: number;
+  items: ScaffoldMenuItem[];
+}
+interface ScaffoldMenuDefinition {
+  groups: ScaffoldMenuGroup[];
+}
+interface ScaffoldShellAction {
+  id: string;
+  title: string;
+  target: ScaffoldTargetRef;
+  order?: number;
+}
+interface ScaffoldHeaderDefinition {
+  title?: string;
+  subtitle?: string;
+  logo?: string;
+  actions?: ScaffoldShellAction[];
+}
+interface ScaffoldFooterLink {
+  id: string;
+  title: string;
+  target: ScaffoldTargetRef;
+  order?: number;
+}
+interface ScaffoldFooterDefinition {
+  text?: string;
+  links?: ScaffoldFooterLink[];
+}
+interface ScaffoldWorkspaceRoot {
+  id: string;
+  title: string;
+  path: string;
+  description?: string;
+  order?: number;
+  /**
+   * Passed through to the afs-list renderer. This keeps the shell declarative
+   * without enumerating children that already live in AFS.
+   */
+  filter?: string | Record<string, unknown>;
+  sort?: string | Record<string, unknown>;
+  maxDepth?: number;
+  layout?: "grouped" | "list" | (string & {});
+  itemStyle?: "compact" | "row" | "card" | (string & {});
+  showParent?: boolean;
+  editable?: boolean;
+}
+interface ScaffoldWorkspaceSection {
+  id: string;
+  title: string;
+  description?: string;
+  order?: number;
+  roots: ScaffoldWorkspaceRoot[];
+}
+interface ScaffoldWorkspaceAgentDefinition {
+  module?: string;
+  title?: string;
+  placeholder?: string;
+}
+interface ScaffoldWorkspaceDetailDefinition {
+  renderer?: "surface" | "auto-surface";
+  pattern?: string;
+}
+interface ScaffoldWorkspaceRailItem {
+  id: string;
+  title: string;
+  icon?: string;
+  href?: string;
+  active?: boolean;
+  order?: number;
+}
+interface ScaffoldWorkspaceDefinition {
+  title?: string;
+  description?: string;
+  variant?: string;
+  defaultPath?: string;
+  detail?: ScaffoldWorkspaceDetailDefinition;
+  rail?: ScaffoldWorkspaceRailItem[];
+  sections: ScaffoldWorkspaceSection[];
+  agent?: ScaffoldWorkspaceAgentDefinition;
+}
+interface ScaffoldShellDefinition {
+  menu?: ScaffoldMenuDefinition;
+  header?: ScaffoldHeaderDefinition;
+  footer?: ScaffoldFooterDefinition;
+  workspace?: ScaffoldWorkspaceDefinition;
+}
+interface ScaffoldWebModuleBinding {
+  provider: "web";
+  entry: string;
+  pageRoot?: string;
+  webRoot?: string;
+  homePage?: string;
+}
+interface ScaffoldAupModuleBinding {
+  provider: "aup";
+  entry: string;
+  wrapper?: string;
+  defaultPage?: string;
+}
+interface ScaffoldAgentModuleBinding {
+  provider: "agent";
+  entry: string;
+  session?: string;
+}
+interface ScaffoldBlockletModuleBinding {
+  provider: "blocklet";
+  blocklet: string;
+  mountPath?: string;
+  description?: string;
+}
+type ScaffoldModuleBinding = ScaffoldWebModuleBinding | ScaffoldAupModuleBinding | ScaffoldAgentModuleBinding | ScaffoldBlockletModuleBinding;
+interface ScaffoldModuleDefinition {
+  id: string;
+  kind: ScaffoldModuleKind;
+  title: string;
+  description?: string;
+  provider?: ScaffoldProviderKind;
+  binding?: ScaffoldModuleBinding;
+  route?: string;
+  entry?: string;
+  blocklet?: string;
+  order?: number;
+  metadata?: Record<string, unknown>;
+}
+interface ScaffoldSurfaceDefinition {
+  id: string;
+  kind: "auto-surface" | (string & {});
+  title?: string;
+  module?: string;
+  projector?: AutoSurfaceProjectorName;
+  definitionRoot?: string;
+  valueRoots?: Partial<Record<AutoSurfaceLayer, string>>;
+  scope?: AutoSurfaceLayer | "all";
+  order?: number;
+  metadata?: Record<string, unknown>;
+}
+interface ScaffoldDefinition {
+  manifest: ScaffoldManifest;
+  shell: ScaffoldShellDefinition;
+  modules: ScaffoldModuleDefinition[];
+  surfaces: ScaffoldSurfaceDefinition[];
+}
+interface ScaffoldDiagnostic {
+  code: "duplicate_module" | "duplicate_surface" | "invalid_module_definition" | "missing_default_module" | "missing_module_reference" | "missing_surface_reference";
+  severity: "error" | "warning";
+  message: string;
+  id?: string;
+}
+interface ResolvedScaffoldDefinition {
+  definition: ScaffoldDefinition;
+  diagnostics: ScaffoldDiagnostic[];
+  modulesById: Record<string, ScaffoldModuleDefinition>;
+  surfacesById: Record<string, ScaffoldSurfaceDefinition>;
+}
+interface ScaffoldSurfaceRuntimeDiagnostic {
+  code: "missing_surface" | "unsupported_surface_kind" | "surface_resolve_error";
+  severity: "error" | "warning";
+  surfaceId: string;
+  message: string;
+}
+interface ResolvedScaffoldAutoSurface {
+  kind: "auto-surface";
+  definition: ScaffoldSurfaceDefinition;
+  scenario: AutoSurfaceResolvedScenario;
+  projection: AutoSurfaceProjection;
+}
+type ResolvedScaffoldSurface = ResolvedScaffoldAutoSurface;
+interface ResolvedScaffoldSurfaces {
+  surfaces: Record<string, ResolvedScaffoldSurface>;
+  diagnostics: ScaffoldSurfaceRuntimeDiagnostic[];
+}
+interface ResolvedScaffoldModule {
+  definition: ScaffoldModuleDefinition;
+  binding?: ScaffoldModuleBinding;
+  surfaceDefinitions: ScaffoldSurfaceDefinition[];
+  surfaces: ResolvedScaffoldSurface[];
+}
+interface ResolvedScaffoldTarget {
+  kind: ScaffoldTargetKind;
+  ref?: string;
+  href?: string;
+  module?: ResolvedScaffoldModule;
+  surface?: ResolvedScaffoldSurface;
+  surfaceDefinition?: ScaffoldSurfaceDefinition;
+}
+interface ResolvedScaffoldMenuItem extends Omit<ScaffoldMenuItem, "target" | "children"> {
+  target?: ResolvedScaffoldTarget;
+  children?: ResolvedScaffoldMenuItem[];
+}
+interface ResolvedScaffoldMenuGroup extends Omit<ScaffoldMenuGroup, "items"> {
+  items: ResolvedScaffoldMenuItem[];
+}
+interface ResolvedScaffoldHeaderAction extends Omit<ScaffoldShellAction, "target"> {
+  target: ResolvedScaffoldTarget;
+}
+interface ResolvedScaffoldFooterLink extends Omit<ScaffoldFooterLink, "target"> {
+  target: ResolvedScaffoldTarget;
+}
+interface ResolvedScaffoldWorkspaceSection extends Omit<ScaffoldWorkspaceSection, "roots"> {
+  roots: ScaffoldWorkspaceRoot[];
+}
+interface ResolvedScaffoldWorkspaceDefinition extends Omit<ScaffoldWorkspaceDefinition, "sections"> {
+  sections: ResolvedScaffoldWorkspaceSection[];
+}
+interface ResolvedScaffoldShell {
+  menu?: {
+    groups: ResolvedScaffoldMenuGroup[];
+  };
+  header?: Omit<ScaffoldHeaderDefinition, "actions"> & {
+    actions?: ResolvedScaffoldHeaderAction[];
+  };
+  footer?: Omit<ScaffoldFooterDefinition, "links"> & {
+    links?: ResolvedScaffoldFooterLink[];
+  };
+  workspace?: ResolvedScaffoldWorkspaceDefinition;
+}
+interface ScaffoldCompositionDiagnostic {
+  code: "missing_runtime_surface";
+  severity: "warning";
+  targetId: string;
+  message: string;
+}
+interface ResolvedScaffoldApp {
+  manifest: ScaffoldManifest;
+  defaultModule?: ResolvedScaffoldModule;
+  modules: ResolvedScaffoldModule[];
+  shell: ResolvedScaffoldShell;
+  diagnostics: ScaffoldCompositionDiagnostic[];
+}
+//#endregion
+export { ResolvedScaffoldApp, ResolvedScaffoldDefinition, ResolvedScaffoldFooterLink, ResolvedScaffoldHeaderAction, ResolvedScaffoldMenuGroup, ResolvedScaffoldMenuItem, ResolvedScaffoldModule, ResolvedScaffoldShell, ResolvedScaffoldSurface, ResolvedScaffoldSurfaces, ResolvedScaffoldTarget, ResolvedScaffoldWorkspaceDefinition, ResolvedScaffoldWorkspaceSection, ScaffoldAgentModuleBinding, ScaffoldAupModuleBinding, ScaffoldBlockletModuleBinding, ScaffoldCompositionDiagnostic, ScaffoldDefinition, ScaffoldDiagnostic, ScaffoldFooterDefinition, ScaffoldFooterLink, ScaffoldHeaderDefinition, ScaffoldManifest, ScaffoldMenuDefinition, ScaffoldMenuGroup, ScaffoldMenuItem, ScaffoldMenuPlacement, ScaffoldModuleBinding, ScaffoldModuleDefinition, ScaffoldModuleKind, ScaffoldProviderKind, ScaffoldShellAction, ScaffoldShellDefinition, ScaffoldSurfaceDefinition, ScaffoldSurfaceRuntimeDiagnostic, ScaffoldTargetKind, ScaffoldTargetRef, ScaffoldWebModuleBinding, ScaffoldWorkspaceAgentDefinition, ScaffoldWorkspaceDefinition, ScaffoldWorkspaceRailItem, ScaffoldWorkspaceRoot, ScaffoldWorkspaceSection };
+//# sourceMappingURL=types.d.mts.map

package/dist/scaffold/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/scaffold/types.ts"],"mappings":";;;;KAOY,kBAAA;AAAA,KACA,kBAAA;AAAA,KACA,oBAAA;AAAA,KACA,qBAAA;AAAA,UAEK,iBAAA;EACf,IAAA,EAAM,kBAAA;EACN,GAAA;EACA,IAAA;AAAA;AAAA,UAGe,gBAAA;EACf,EAAA;EACA,KAAA;EACA,WAAA;EACA,aAAA;EACA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,gBAAA;EACf,EAAA;EACA,KAAA;EACA,MAAA,GAAS,iBAAA;EACT,IAAA;EACA,KAAA;EACA,KAAA;EACA,SAAA,GAAY,qBAAA;EACZ,QAAA,GAAW,gBAAA;AAAA;AAAA,UAGI,iBAAA;EACf,EAAA;EACA,KAAA;EACA,KAAA;EACA,KAAA,EAAO,gBAAA;AAAA;AAAA,UAGQ,sBAAA;EACf,MAAA,EAAQ,iBAAA;AAAA;AAAA,UAGO,mBAAA;EACf,EAAA;EACA,KAAA;EACA,MAAA,EAAQ,iBAAA;EACR,KAAA;AAAA;AAAA,UAGe,wBAAA;EACf,KAAA;EACA,QAAA;EACA,IAAA;EACA,OAAA,GAAU,mBAAA;AAAA;AAAA,UAGK,kBAAA;EACf,EAAA;EACA,KAAA;EACA,MAAA,EAAQ,iBAAA;EACR,KAAA;AAAA;AAAA,UAGe,wBAAA;EACf,IAAA;EACA,KAAA,GAAQ,kBAAA;AAAA;AAAA,UAGO,qBAAA;EACf,EAAA;EACA,KAAA;EACA,IAAA;EACA,WAAA;EACA,KAAA;EA7CW;;;AAGb;EA+CE,MAAA,YAAkB,MAAA;EAClB,IAAA,YAAgB,MAAA;EAChB,QAAA;EACA,MAAA;EACA,SAAA;EACA,UAAA;EACA,QAAA;AAAA;AAAA,UAGe,wBAAA;EACf,EAAA;EACA,KAAA;EACA,WAAA;EACA,KAAA;EACA,KAAA,EAAO,qBAAA;AAAA;AAAA,UAGQ,gCAAA;EACf,MAAA;EACA,KAAA;EACA,WAAA;AAAA;AAAA,UAGe,iCAAA;EACf,QAAA;EACA,OAAA;AAAA;AAAA,UAGe,yBAAA;EACf,EAAA;EACA,KAAA;EACA,IAAA;EACA,IAAA;EACA,MAAA;EACA,KAAA;AAAA;AAAA,UAGe,2BAAA;EACf,KAAA;EACA,WAAA;EACA,OAAA;EACA,WAAA;EACA,MAAA,GAAS,iCAAA;EACT,IAAA,GAAO,yBAAA;EACP,QAAA,EAAU,wBAAA;EACV,KAAA,GAAQ,gCAAA;AAAA;AAAA,UAGO,uBAAA;EACf,IAAA,GAAO,sBAAA;EACP,MAAA,GAAS,wBAAA;EACT,MAAA,GAAS,wBAAA;EACT,SAAA,GAAY,2BAAA;AAAA;AAAA,UAGG,wBAAA;EACf,QAAA;EACA,KAAA;EACA,QAAA;EACA,OAAA;EACA,QAAA;AAAA;AAAA,UAGe,wBAAA;EACf,QAAA;EACA,KAAA;EACA,OAAA;EACA,WAAA;AAAA;AAAA,UAGe,0BAAA;EACf,QAAA;EACA,KAAA;EACA,OAAA;AAAA;AAAA,UAGe,6BAAA;EACf,QAAA;EACA,QAAA;EACA,SAAA;EACA,WAAA;AAAA;AAAA,KAGU,qBAAA,GACR,wBAAA,GACA,wBAAA,GACA,0BAAA,GACA,6BAAA;AAAA,UAEa,wBAAA;EACf,EAAA;EACA,IAAA,EAAM,kBAAA;EACN,KAAA;EACA,WAAA;EACA,QAAA,GAAW,oBAAA;EACX,OAAA,GAAU,qBAAA;EACV,KAAA;EACA,KAAA;EACA,QAAA;EACA,KAAA;EACA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,yBAAA;EACf,EAAA;EACA,IAAA;EACA,KAAA;EACA,MAAA;EACA,SAAA,GAAY,wBAAA;EACZ,cAAA;EACA,UAAA,GAAa,OAAA,CAAQ,MAAA,CAAO,gBAAA;EAC5B,KAAA,GAAQ,gBAAA;EACR,KAAA;EACA,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,kBAAA;EACf,QAAA,EAAU,gBAAA;EACV,KAAA,EAAO,uBAAA;EACP,OAAA,EAAS,wBAAA;EACT,QAAA,EAAU,yBAAA;AAAA;AAAA,UAGK,kBAAA;EACf,IAAA;EAOA,QAAA;EACA,OAAA;EACA,EAAA;AAAA;AAAA,UAGe,0BAAA;EACf,UAAA,EAAY,kBAAA;EACZ,WAAA,EAAa,kBAAA;EACb,WAAA,EAAa,MAAA,SAAe,wBAAA;EAC5B,YAAA,EAAc,MAAA,SAAe,yBAAA;AAAA;AAAA,UAGd,gCAAA;EACf,IAAA;EACA,QAAA;EACA,SAAA;EACA,OAAA;AAAA;AAAA,UAGe,2BAAA;EACf,IAAA;EACA,UAAA,EAAY,yBAAA;EACZ,QAAA,EAAU,2BAAA;EACV,UAAA,EAAY,qBAAA;AAAA;AAAA,KAGF,uBAAA,GAA0B,2BAAA;AAAA,UAErB,wBAAA;EACf,QAAA,EAAU,MAAA,SAAe,uBAAA;EACzB,WAAA,EAAa,gCAAA;AAAA;AAAA,UAGE,sBAAA;EACf,UAAA,EAAY,wBAAA;EACZ,OAAA,GAAU,qBAAA;EACV,kBAAA,EAAoB,yBAAA;EACpB,QAAA,EAAU,uBAAA;AAAA;AAAA,UAGK,sBAAA;EACf,IAAA,EAAM,kBAAA;EACN,GAAA;EACA,IAAA;EACA,MAAA,GAAS,sBAAA;EACT,OAAA,GAAU,uBAAA;EACV,iBAAA,GAAoB,yBAAA;AAAA;AAAA,UAGL,wBAAA,SAAiC,IAAA,CAAK,gBAAA;EACrD,MAAA,GAAS,sBAAA;EACT,QAAA,GAAW,wBAAA;AAAA;AAAA,UAGI,yBAAA,SAAkC,IAAA,CAAK,iBAAA;EACtD,KAAA,EAAO,wBAAA;AAAA;AAAA,UAGQ,4BAAA,SAAqC,IAAA,CAAK,mBAAA;EACzD,MAAA,EAAQ,sBAAA;AAAA;AAAA,UAGO,0BAAA,SAAmC,IAAA,CAAK,kBAAA;EACvD,MAAA,EAAQ,sBAAA;AAAA;AAAA,UAGO,gCAAA,SAAyC,IAAA,CAAK,wBAAA;EAC7D,KAAA,EAAO,qBAAA;AAAA;AAAA,UAGQ,mCAAA,SACP,IAAA,CAAK,2BAAA;EACb,QAAA,EAAU,gCAAA;AAAA;AAAA,UAGK,qBAAA;EACf,IAAA;IACE,MAAA,EAAQ,yBAAA;EAAA;EAEV,MAAA,GAAS,IAAA,CAAK,wBAAA;IACZ,OAAA,GAAU,4BAAA;EAAA;EAEZ,MAAA,GAAS,IAAA,CAAK,wBAAA;IACZ,KAAA,GAAQ,0BAAA;EAAA;EAEV,SAAA,GAAY,mCAAA;AAAA;AAAA,UAGG,6BAAA;EACf,IAAA;EACA,QAAA;EACA,QAAA;EACA,OAAA;AAAA;AAAA,UAGe,mBAAA;EACf,QAAA,EAAU,gBAAA;EACV,aAAA,GAAgB,sBAAA;EAChB,OAAA,EAAS,sBAAA;EACT,KAAA,EAAO,qBAAA;EACP,WAAA,EAAa,6BAAA;AAAA"}