@openviking/react 0.1.5 → 0.1.7

package/dist/components/file-tree/style.css

@@ -1,4 +1,173 @@
-.ov-directory-tour, .ov-agent-connect, .ov-console, .ov-divider, .ov-file-browser-entries, .ov-drawer, .ov-file-browser, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-popover, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__popover, .ov-viking-bot__reference-picker--mention, .ov-viking-bot__interaction {
+.ov-button {
+  --ov-ui-button-height: 32px;
+  --ov-ui-button-padding: 16px;
+  --ov-ui-button-primary: var(--ov-ui-color-primary, var(--ov-ui-primary-default));
+  --ov-ui-button-text: var(--ov-ui-color-text-2, var(--ov-ui-text-2-default));
+  --ov-ui-button-fill: var(--ov-ui-color-bg-5, var(--ov-ui-bg-5-default));
+  --ov-ui-button-fill-hover: var(--ov-ui-color-bg-11, var(--ov-ui-bg-11-default));
+  --ov-ui-button-focus-ring: var(--ov-ui-color-neutral-4, var(--ov-ui-neutral-4-default));
+  appearance: none;
+  box-sizing: border-box;
+  height: var(--ov-ui-button-height);
+  padding: 0 var(--ov-ui-button-padding);
+  background: var(--ov-ui-button-fill);
+  color: var(--ov-ui-button-text);
+  white-space: nowrap;
+  cursor: pointer;
+  -webkit-user-select: none;
+  user-select: none;
+  border: 1px solid #0000;
+  border-radius: 6px;
+  flex-shrink: 0;
+  justify-content: center;
+  align-items: center;
+  gap: 8px;
+  margin: 0;
+  font-family: inherit;
+  font-size: 13px;
+  font-weight: 500;
+  line-height: 1.53846;
+  text-decoration: none;
+  transition: background-color .1s cubic-bezier(0, 0, 1, 1), border-color .1s cubic-bezier(0, 0, 1, 1), color .1s cubic-bezier(0, 0, 1, 1);
+  display: inline-flex;
+}
+
+.ov-button--mini {
+  --ov-ui-button-height: 24px;
+  --ov-ui-button-padding: 12px;
+  gap: 4px;
+  font-size: 12px;
+}
+
+.ov-button--small {
+  --ov-ui-button-height: 28px;
+}
+
+.ov-button--large {
+  --ov-ui-button-height: 36px;
+}
+
+.ov-button--icon-only {
+  width: var(--ov-ui-button-height);
+  padding: 0;
+}
+
+.ov-button--circle {
+  border-radius: 50%;
+}
+
+.ov-button--long {
+  width: 100%;
+}
+
+.ov-button:not(:disabled):not([aria-disabled="true"]):hover {
+  background: var(--ov-ui-button-fill-hover);
+}
+
+.ov-button:not(:disabled):not([aria-disabled="true"]):active {
+  background: var(--ov-ui-button-fill);
+  color: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default));
+  transition: none;
+}
+
+.ov-button:focus-visible {
+  box-shadow: 0 0 0 2px var(--ov-ui-button-focus-ring);
+  outline: none;
+}
+
+.ov-button:disabled:not(.ov-button--loading), .ov-button.ov-button--disabled, .ov-button[aria-disabled="true"] {
+  background: var(--ov-ui-color-bg-4, var(--ov-ui-bg-4-default));
+  cursor: not-allowed;
+  color: var(--ov-ui-color-text-disabled, var(--ov-ui-text-disabled-default));
+}
+
+.ov-button--primary, .ov-button--outline {
+  --ov-ui-button-focus-ring: var(--ov-ui-color-primary-disabled, var(--ov-ui-primary-disabled-default));
+}
+
+.ov-button--primary {
+  background: var(--ov-ui-button-primary);
+  color: var(--ov-ui-color-text-on-primary, var(--ov-ui-text-on-primary-default));
+  border-style: dashed;
+}
+
+.ov-button--primary:not(:disabled):not([aria-disabled="true"]):hover {
+  background: var(--ov-ui-color-primary-strong, var(--ov-ui-primary-strong-default));
+  color: var(--ov-ui-color-text-on-primary, var(--ov-ui-text-on-primary-default));
+}
+
+.ov-button--primary:not(:disabled):not([aria-disabled="true"]):active {
+  background: var(--ov-ui-button-primary);
+  color: var(--ov-ui-color-text-on-primary, var(--ov-ui-text-on-primary-default));
+}
+
+.ov-button--primary:disabled:not(.ov-button--loading), .ov-button--primary.ov-button--disabled, .ov-button--primary[aria-disabled="true"] {
+  background: var(--ov-ui-color-primary-disabled, var(--ov-ui-primary-disabled-default));
+  color: var(--ov-ui-color-text-on-primary-disabled, var(--ov-ui-on-primary-disabled-default));
+}
+
+.ov-button--outline, .ov-button--outline:disabled:not(.ov-button--loading), .ov-button--outline.ov-button--disabled, .ov-button--outline[aria-disabled="true"] {
+  border-color: var(--ov-ui-color-border-3, var(--ov-ui-border-3-default));
+  background: none;
+}
+
+.ov-button--outline:not(:disabled):not([aria-disabled="true"]):hover, .ov-button--outline:not(:disabled):not([aria-disabled="true"]):active {
+  background: var(--ov-ui-color-bg-7, var(--ov-ui-bg-7-default));
+  color: var(--ov-ui-button-text);
+}
+
+.ov-button--outline:not(:disabled):not([aria-disabled="true"]):active {
+  border-color: var(--ov-ui-color-border-4, var(--ov-ui-border-4-default));
+}
+
+.ov-button--text {
+  color: var(--ov-ui-color-link, var(--ov-ui-link-default));
+  background: none;
+}
+
+.ov-button--text:not(:disabled):not([aria-disabled="true"]):hover, .ov-button--text:disabled:not(.ov-button--loading), .ov-button--text.ov-button--disabled, .ov-button--text[aria-disabled="true"] {
+  color: var(--ov-ui-color-primary-muted, var(--ov-ui-primary-muted-default));
+  background: none;
+}
+
+.ov-button--text:not(:disabled):not([aria-disabled="true"]):active {
+  color: var(--ov-ui-color-link-active, var(--ov-ui-link-active-default));
+  background: none;
+}
+
+.ov-button__icon {
+  flex: none;
+  align-items: center;
+  display: inline-flex;
+}
+
+.ov-button__spinner {
+  box-sizing: border-box;
+  border: 1.5px solid;
+  border-inline-start-color: #0000;
+  border-radius: 50%;
+  width: 1em;
+  height: 1em;
+  animation: 1s linear infinite ov-button-spin;
+}
+
+@keyframes ov-button-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ov-button {
+    transition: none;
+  }
+
+  .ov-button__spinner {
+    animation: none;
+  }
+}
+
+.ov-button, .ov-input, .ov-textarea, .ov-directory-tour, .ov-wiki-dashboard, .ov-experience-dashboard, .ov-agent-connect, .ov-console, .ov-divider, .ov-file-browser-entries, .ov-drawer, .ov-modal, .ov-file-browser, .ov-file-preview, .ov-file-tree, .ov-module-placeholder, .ov-popover, .ov-scope-switcher, .ov-tooltip, .ov-tui, .ov-viking-bot, .ov-viking-bot__popover, .ov-viking-bot__reference-picker--mention, .ov-viking-bot__interaction {
   --ov-ui-tour-shadow-default: 0 15px 35px #0000000d, 0 5px 15px #0000000d;
   --ov-ui-tour-highlight-default: #5252ff14;
   --ov-ui-primary-default: #5252ff;
@@ -35,9 +204,29 @@
   --ov-ui-overlay-default: #0006;
   --ov-ui-tooltip-bg-default: #1f2329;
   --ov-ui-tooltip-text-default: #fff;
-}
-
-.dark .ov-directory-tour, .dark .ov-agent-connect, .dark .ov-console, .dark .ov-divider, .dark .ov-file-browser-entries, .dark .ov-drawer, .dark .ov-file-browser, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-popover, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__popover, .dark .ov-viking-bot__reference-picker--mention, .dark .ov-viking-bot__interaction {
+  --ov-ui-library-swatch-1-default: linear-gradient(145deg,
+    #ffd8ec 8%,
+    #ffabc8 46%,
+    #d8cbff 100%);
+  --ov-ui-library-swatch-2-default: linear-gradient(145deg,
+    #d9e8ff 8%,
+    #b8a6ff 52%,
+    #f3d6ff 100%);
+  --ov-ui-library-swatch-3-default: linear-gradient(145deg,
+    #ffe6bc 8%,
+    #ffaf96 48%,
+    #ff8bc5 100%);
+  --ov-ui-library-swatch-4-default: linear-gradient(145deg,
+    #eaf7ba 8%,
+    #b5efb8 52%,
+    #73d9c6 100%);
+  --ov-ui-library-swatch-5-default: linear-gradient(145deg,
+    #fff1ba 8%,
+    #ffc776 52%,
+    #bd9cff 100%);
+}
+
+html.dark .ov-button, html.dark .ov-input, html.dark .ov-textarea, .dark .ov-directory-tour, html.dark .ov-wiki-dashboard, html.dark .ov-experience-dashboard, .dark .ov-agent-connect, .dark .ov-console, .dark .ov-divider, .dark .ov-file-browser-entries, .dark .ov-drawer, .dark .ov-modal, .dark .ov-file-browser, .dark .ov-file-preview, .dark .ov-file-tree, .dark .ov-module-placeholder, .dark .ov-popover, .dark .ov-scope-switcher, .dark .ov-tooltip, .dark .ov-tui, .dark .ov-viking-bot, .dark .ov-viking-bot__popover, .dark .ov-viking-bot__reference-picker--mention, .dark .ov-viking-bot__interaction {
   --ov-ui-primary-default: #5f5fff;
   --ov-ui-primary-hover-default: #7075ff;
   --ov-ui-primary-active-default: #4242ba;
@@ -67,6 +256,52 @@
   --ov-ui-tooltip-text-default: #f0f1f3;
 }
 
+.ov-button, .ov-input, .ov-textarea {
+  --ov-ui-bg-white-default: var(--ov-ui-bg-1-default);
+  --ov-ui-bg-2-default: #fafbfd;
+  --ov-ui-bg-7-default: var(--ov-ui-border-1-default);
+  --ov-ui-bg-11-default: #e1e3ef;
+  --ov-ui-border-4-default: #acb0c5;
+  --ov-ui-neutral-4-default: #c9cdd4;
+  --ov-ui-primary-muted-default: #8e96ff;
+  --ov-ui-primary-strong-default: var(--ov-ui-primary-active-default);
+  --ov-ui-link-default: var(--ov-ui-primary-default);
+  --ov-ui-link-active-default: var(--ov-ui-primary-active-default);
+  --ov-ui-text-5-default: #c9c9d4;
+  --ov-ui-on-primary-disabled-default: var(--ov-ui-text-on-primary-default);
+  --ov-ui-input-focus-ring-default: color-mix(in srgb,
+    var(--ov-ui-color-primary, var(--ov-ui-primary-default)) 30%,
+    transparent);
+  --ov-ui-error-default: #e31b54;
+  --ov-ui-error-bg-default: #ffecec;
+  --ov-ui-error-border-default: #ffa3a0;
+}
+
+html.dark .ov-button, html.dark .ov-input, html.dark .ov-textarea {
+  --ov-ui-bg-white-default: #fff0;
+  --ov-ui-bg-2-default: #fcfdfe03;
+  --ov-ui-bg-4-default: #f6f8fa0f;
+  --ov-ui-bg-5-default: #f1f3f514;
+  --ov-ui-bg-7-default: #1a1b1e;
+  --ov-ui-bg-11-default: #1e2023;
+  --ov-ui-border-2-default: #dde2e926;
+  --ov-ui-border-3-default: #dde2e94d;
+  --ov-ui-border-4-default: #6d6d6d;
+  --ov-ui-neutral-4-default: #5f5f60;
+  --ov-ui-primary-disabled-default: #3f3a89;
+  --ov-ui-primary-muted-default: #4c48b4;
+  --ov-ui-primary-strong-default: var(--ov-ui-primary-hover-default);
+  --ov-ui-link-default: #787dff;
+  --ov-ui-link-active-default: #949cff;
+  --ov-ui-text-disabled-default: #42464e;
+  --ov-ui-text-5-default: #e1e3ef;
+  --ov-ui-on-primary-disabled-default: #ffffff4d;
+  --ov-ui-input-focus-ring-default: #4583ff4d;
+  --ov-ui-error-default: #ff706d;
+  --ov-ui-error-bg-default: #9f211c33;
+  --ov-ui-error-border-default: #ff706d4d;
+}
+
 .dark .ov-viking-bot {
   --ov-ui-code-bg-default: var(--ov-ui-bg-3-default);
 }
@@ -91,6 +326,30 @@
   --ov-ui-connect-notice-default: var(--ov-ui-text-2-default);
 }
 
+.ov-wiki-dashboard, .ov-experience-dashboard, .ov-file-browser {
+  --ov-ui-dashboard-surface-default: #f8f8f8;
+  --ov-ui-dashboard-card-default: #fafafa;
+  --ov-ui-dashboard-muted-default: #787c91;
+  --ov-ui-dashboard-border-default: #edeef2;
+  --ov-ui-dashboard-warning-default: #eb7d00;
+  --ov-ui-dashboard-warning-light-default: #fff0e5;
+  --ov-ui-dashboard-danger-default: #d92d54;
+  --ov-ui-dashboard-danger-light-default: #ffecee;
+  --ov-ui-dashboard-success-default: #4f9c70;
+}
+
+html.dark .ov-wiki-dashboard, html.dark .ov-experience-dashboard, html.dark .ov-file-browser {
+  --ov-ui-dashboard-surface-default: var(--ov-ui-bg-3-default);
+  --ov-ui-dashboard-card-default: var(--ov-ui-bg-3-default);
+  --ov-ui-dashboard-muted-default: var(--ov-ui-text-3-default);
+  --ov-ui-dashboard-border-default: var(--ov-ui-border-1-default);
+  --ov-ui-dashboard-warning-default: var(--ov-ui-warning-default);
+  --ov-ui-dashboard-warning-light-default: var(--ov-ui-warning-light-default);
+  --ov-ui-dashboard-danger-default: var(--ov-ui-status-error-default);
+  --ov-ui-dashboard-danger-light-default: var(--ov-ui-bg-5-default);
+  --ov-ui-dashboard-success-default: var(--ov-ui-status-success-default);
+}
+
 .ov-popover {
   --ov-ui-popover-bg: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default, #fff));
   --ov-ui-popover-text: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default, #0b0b0f));
@@ -128,6 +387,55 @@
   }
 }
 
+.ov-tooltip {
+  --ov-ui-tooltip-bg: var(--ov-ui-color-tooltip-bg, var(--ov-ui-tooltip-bg-default, #1f2329));
+  --ov-ui-tooltip-text: var(--ov-ui-color-tooltip-text, var(--ov-ui-tooltip-text-default, #fff));
+  --ov-ui-tooltip-border: transparent;
+  --ov-ui-tooltip-radius: var(--ov-ui-radius, 6px);
+  --ov-ui-tooltip-offset: 6px;
+  z-index: 1000;
+  box-sizing: border-box;
+  border: 1px solid var(--ov-ui-tooltip-border);
+  border-radius: var(--ov-ui-tooltip-radius);
+  background: var(--ov-ui-tooltip-bg);
+  max-width: 320px;
+  color: var(--ov-ui-tooltip-text);
+  overflow-wrap: break-word;
+  padding: 6px 8px;
+  font-family: inherit;
+  font-size: 12px;
+  line-height: 18px;
+  animation: .12s ease-out ov-tooltip-enter;
+  position: fixed;
+  box-shadow: 0 4px 12px #0000001f;
+}
+
+.ov-tooltip[role="dialog"] {
+  --ov-ui-tooltip-bg: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default, #fff));
+  --ov-ui-tooltip-text: var(--ov-ui-color-text-1, var(--ov-ui-text-1-default, #0b0b0f));
+  --ov-ui-tooltip-border: var(--ov-ui-color-border-2, var(--ov-ui-border-2-default, #e1e4f2));
+  min-width: 120px;
+  max-width: 360px;
+  padding: 4px;
+  box-shadow: 0 6px 16px #0000001f;
+}
+
+@keyframes ov-tooltip-enter {
+  from {
+    opacity: 0;
+  }
+
+  to {
+    opacity: 1;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .ov-tooltip {
+    animation: none;
+  }
+}
+
 .ov-file-tree {
   --ov-ui-file-tree-row-height: 32px;
   --ov-ui-file-tree-row-radius: 4px;
@@ -199,6 +507,21 @@
   transition: background-color .12s;
 }
 
+.ov-file-tree__popover-anchor-container {
+  pointer-events: none;
+  justify-content: flex-end;
+  display: flex;
+  position: absolute;
+  inset: 0;
+}
+
+.ov-file-tree__popover-anchor {
+  flex: none;
+  width: 0;
+  position: sticky;
+  right: 0;
+}
+
 .ov-file-tree__row:hover {
   background-color: var(--ov-ui-file-tree-row-hover);
 }
@@ -434,24 +757,6 @@
   }
 }
 
-.ov-file-tree__action {
-  color: inherit;
-  font: inherit;
-  cursor: pointer;
-  background: none;
-  border: 0;
-  padding: 0;
-  transition: color .12s;
-}
-
-.ov-file-tree__action:hover:not(:disabled) {
-  color: var(--ov-ui-file-tree-action);
-}
-
-.ov-file-tree__action:disabled {
-  cursor: default;
-}
-
 @media (prefers-reduced-motion: reduce) {
   .ov-file-tree__chevron, .ov-file-tree__folder-layer {
     transition: none;
@@ -470,6 +775,14 @@
   color: var(--ov-file-tree-icon-dark, var(--ov-ui-file-tree-icon));
 }
 
+.ov-file-tree .ov-button.ov-file-tree__action, .ov-file-tree .ov-button.ov-file-tree__action:disabled, .ov-file-tree .ov-button.ov-file-tree__action[aria-disabled="true"] {
+  color: var(--ov-ui-color-text-3, var(--ov-ui-text-3-default));
+}
+
+.ov-file-tree .ov-button.ov-file-tree__action:not(:disabled):not([aria-disabled="true"]):hover {
+  color: var(--ov-ui-color-primary, var(--ov-ui-primary-default));
+}
+
 .ov-file-tree__controls {
   flex: none;
   align-items: center;
@@ -479,98 +792,69 @@
   display: flex;
 }
 
-.ov-file-tree__search, .ov-file-tree__refresh {
-  box-sizing: border-box;
-  border: 1px solid var(--ov-ui-color-border-2, var(--ov-ui-border-2-default));
-  background: var(--ov-ui-color-bg-1, var(--ov-ui-bg-1-default));
-  height: 32px;
-  color: var(--ov-ui-file-tree-icon);
-  box-shadow: 0 1px 1px
-    var(--ov-ui-color-shadow-control, var(--ov-ui-shadow-control-default));
-  cursor: pointer;
-  border-radius: 6px;
-  flex-shrink: 0;
-  justify-content: center;
-  align-items: center;
-  margin: 0;
-  padding: 0;
-  font-family: inherit;
-  font-size: 12px;
-  font-weight: 400;
-  line-height: 22px;
-  transition: border-color .16s, background-color .16s;
-  display: inline-flex;
-}
-
-.ov-file-tree__search {
+.ov-file-tree__controls .ov-file-tree__search {
+  --ov-ui-button-fill: var(--ov-ui-color-bg-white, var(--ov-ui-bg-white-default));
+  --ov-ui-button-fill-hover: var(--ov-ui-button-fill);
+  text-align: start;
   min-width: 0;
-  color: var(--ov-ui-file-tree-text-muted);
-  text-align: left;
+  box-shadow: 0 0 0 1px var(--ov-ui-color-border-2, var(--ov-ui-border-2-default)),
+    0 1px 1px
+      var(--ov-ui-color-shadow-control, var(--ov-ui-shadow-control-default));
+  border: 0;
   flex: auto;
   justify-content: flex-start;
   gap: 4px;
   padding: 4px 12px;
+  font-weight: 400;
 }
 
-.ov-file-tree__search svg {
-  flex: none;
-  width: 16px;
-  height: 16px;
-  display: block;
+.ov-file-tree__controls .ov-file-tree__search:not(:disabled):hover {
+  box-shadow: 0 0 0 1px var(--ov-ui-color-border-3, var(--ov-ui-border-3-default)),
+    0 1px 1px
+      var(--ov-ui-color-shadow-control, var(--ov-ui-shadow-control-default));
 }
 
 .ov-file-tree__search-label {
-  letter-spacing: .036px;
   text-overflow: ellipsis;
   white-space: nowrap;
   min-width: 0;
+  color: var(--ov-ui-color-text-3, var(--ov-ui-text-3-default));
+  letter-spacing: .036px;
+  font-size: 12px;
+  line-height: 22px;
   overflow: hidden;
 }
 
-.ov-file-tree__refresh {
-  width: 32px;
-}
-
-.ov-file-tree__refresh svg {
-  flex: none;
-  display: block;
-}
-
-.ov-file-tree__search:hover:not(:disabled), .ov-file-tree__refresh:hover:not(:disabled) {
-  border-color: var(--ov-ui-color-border-3, var(--ov-ui-border-3-default));
-}
-
-.ov-file-tree__refresh:hover:not(:disabled) {
-  background: var(--ov-ui-file-tree-row-hover);
-}
-
-.ov-file-tree__search:focus-visible, .ov-file-tree__refresh:focus-visible {
-  outline: 2px solid var(--ov-ui-file-tree-action);
-  outline-offset: 2px;
+.ov-file-tree__controls .ov-file-tree__refresh {
+  --ov-ui-button-fill: var(--ov-ui-color-bg-white, var(--ov-ui-bg-white-default));
+  --ov-ui-button-fill-hover: var(--ov-ui-color-bg-3, var(--ov-ui-bg-3-default));
+  box-shadow: 0 0 0 1px var(--ov-ui-color-border-2, var(--ov-ui-border-2-default)),
+    0 1px 1px
+      var(--ov-ui-color-shadow-control, var(--ov-ui-shadow-control-default));
+  border: 0;
 }
 
-.ov-file-tree__search:disabled, .ov-file-tree__refresh:disabled {
-  cursor: not-allowed;
+.ov-file-tree__controls :is(.ov-file-tree__search, .ov-file-tree__refresh):disabled {
+  background: var(--ov-ui-button-fill);
+  color: var(--ov-ui-color-text-2, var(--ov-ui-text-2-default));
   opacity: .6;
 }
 
-.ov-file-tree__refresh[aria-busy="true"] {
-  cursor: wait;
+.ov-file-tree__controls .ov-file-tree__refresh[aria-busy="true"] {
   opacity: 1;
+  cursor: default;
 }
 
-.ov-file-tree__refresh-spinning {
-  animation: .9s linear infinite ov-file-tree-spin;
+.ov-file-tree__search > svg {
+  color: var(--ov-ui-color-text-3, var(--ov-ui-text-3-default));
 }
 
-@media (prefers-reduced-motion: reduce) {
-  .ov-file-tree__search, .ov-file-tree__refresh {
-    transition: none;
-  }
-
-  .ov-file-tree__refresh-spinning {
-    animation-duration: 2s;
-  }
+.ov-file-tree__controls .ov-button:focus-visible {
+  box-shadow: 0 0 0 1px var(--ov-ui-color-border-2, var(--ov-ui-border-2-default)),
+    0 1px 1px
+      var(--ov-ui-color-shadow-control, var(--ov-ui-shadow-control-default));
+  outline: 2px solid var(--ov-ui-color-focus, var(--ov-ui-focus-default));
+  outline-offset: -2px;
 }
 
 

package/dist/components/file-tree/types.d.ts

@@ -96,6 +96,10 @@ export interface FileTreeEntryRow extends FileTreeRowBase {
      * without detail permission.
      */
     disabled?: boolean;
+    /** 允许展开但不选中，例如仅能遍历的目录。Allows expansion without selection. */
+    selectable?: boolean;
+    /** 权限状态的纯展示标签，不执行鉴权。Display-only permission status. */
+    access?: 'read-only' | 'denied' | 'container';
     /**
      * 名称下方的次要说明，例如摘要或行内描述。
      * Secondary line under the name, for example an abstract or inline
@@ -385,6 +389,9 @@ export interface FileTreeInfoLabels {
  * Replaceable copy with built-in Chinese and English defaults.
  */
 export interface FileTreeLabels {
+    readOnly?: string;
+    noAccess?: string;
+    traverseOnly?: string;
     /** 搜索入口文案。Search trigger label. */
     search?: string;
     /** 刷新按钮的无障碍名称。Accessible refresh button label. */
@@ -523,20 +530,22 @@ export interface FileTreeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'chi
      */
     selectedId?: string | null;
     /**
-     * 显示内置搜索入口；默认隐藏，未提供 operations.search 时禁用。
-     * Shows the built-in search trigger. Hidden by default; disabled without operations.search.
+     * 显示内置搜索入口；默认显示，未提供 operations.search 时禁用。
+     * Shows the built-in search trigger. Visible by default; disabled without operations.search.
      */
     search?: boolean | {
         disabled?: boolean;
     };
     /**
-     * 显示内置刷新按钮；默认隐藏。loading 可表达宿主额外的刷新状态。
-     * Shows the refresh button. Hidden by default; loading adds a host-controlled pending state.
+     * 显示内置刷新按钮；默认显示。loading 可表达宿主额外的刷新状态。
+     * Shows the refresh button. Visible by default; loading adds a host-controlled pending state.
      */
     refresh?: boolean | {
         disabled?: boolean;
         loading?: boolean;
     };
+    /** 刷新按钮的受控加载态，与异步刷新、refresh.loading 合并。Host-controlled refresh pending state. */
+    loading?: boolean;
     /**
      * 首次加载是否已完成。
      * Whether the tree has finished its first load.