@nsnanocat/preference-panes 1.2.5 → 1.3.1

package/src/browser/styles.css

@@ -0,0 +1,565 @@
+/* 通用默认样式只使用 pp 命名空间；项目可通过 CSS 输入覆盖变量和组件。
+ * Generic defaults use only the pp namespace; projects may override variables and components through CSS input. */
+:root {
+    --pp-text: #18191c;
+    --pp-background: #f6f7f8;
+    --pp-surface: #fff;
+    --pp-field: #f1f2f3;
+    --pp-border: #e3e5e7;
+    --pp-muted: #797f87;
+    --pp-accent: #1677ff;
+    --pp-warning: #9a6700;
+    --pp-host-height: 0px;
+    --pp-keyboard-height: 0px;
+}
+.pp-panel {
+    font:
+        15px / 1.5 -apple-system,
+        BlinkMacSystemFont,
+        "Segoe UI",
+        sans-serif;
+    color: var(--pp-text);
+    background: var(--pp-background);
+    position: relative;
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    max-width: 100vw;
+    min-width: 0;
+}
+
+:root[data-theme="dark"] {
+    --pp-text: #f1f2f3;
+    --pp-background: #0d0e0f;
+    --pp-surface: #18191c;
+    --pp-field: #2f3238;
+    --pp-border: #2f3238;
+    --pp-muted: #9499a0;
+    --pp-warning: #f0b849;
+}
+.pp-panel * {
+    box-sizing: border-box;
+    letter-spacing: 0;
+}
+.pp-panel button {
+    font: inherit;
+    cursor: pointer;
+    border: 0;
+    background: none;
+    color: inherit;
+}
+.pp-panel button:disabled {
+    opacity: 0.5;
+    cursor: wait;
+}
+.pp-viewport {
+    min-width: 0;
+}
+.pp-fields,
+.pp-choice-page,
+.pp-settings-page,
+.pp-cache-page {
+    box-sizing: border-box;
+    min-width: 0;
+    padding: calc(12px + var(--pp-host-height)) max(16px, calc((100% - 688px) / 2)) calc(28px + env(safe-area-inset-bottom) + var(--pp-keyboard-height));
+    scroll-padding-bottom: var(--pp-keyboard-height);
+    background: var(--pp-background);
+}
+.pp-choice-link {
+    display: flex;
+    align-items: center;
+    justify-content: flex-end;
+    gap: 8px;
+    max-width: 45%;
+    min-width: 44px;
+    min-height: 44px;
+    padding: 0;
+    text-align: right;
+    flex: 1;
+}
+.pp-panel a.pp-choice-link {
+    color: var(--pp-accent);
+    text-decoration: none;
+}
+.pp-summary {
+    color: var(--pp-muted);
+    font-size: 13px;
+    line-height: 18px;
+    display: -webkit-box;
+    -webkit-line-clamp: 2;
+    -webkit-box-orient: vertical;
+    overflow: hidden;
+    overflow-wrap: anywhere;
+}
+.pp-chevron {
+    color: var(--pp-muted);
+    font-size: 22px;
+    flex: none;
+}
+.pp-editor {
+    flex: none;
+    width: 45%;
+    min-width: 0;
+    min-height: 36px;
+    padding: 8px 10px;
+    font: inherit;
+    font-size: 16px;
+    color: var(--pp-text);
+    background: var(--pp-field);
+    border: 0;
+    border-radius: 6px;
+}
+.pp-panel .pp-multiline {
+    display: block;
+}
+.pp-multiline .pp-editor {
+    width: 100%;
+    margin-top: 10px;
+}
+.pp-panel [hidden] {
+    display: none !important;
+}
+.pp-label {
+    flex: 1;
+    min-width: 0;
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+    margin-right: 16px;
+}
+.pp-field-name {
+    color: var(--pp-text);
+    font-size: 15px;
+}
+.pp-field-description {
+    margin-top: 2px;
+    color: var(--pp-muted);
+    font-size: 12px;
+}
+.pp-field-warning {
+    margin-top: 4px;
+    color: var(--pp-warning);
+    font-size: 12px;
+    overflow-wrap: anywhere;
+}
+.pp-group {
+    margin-top: 16px;
+}
+.pp-group-title {
+    margin: 0 0 8px;
+    color: var(--pp-muted);
+    font-size: 15px;
+    font-weight: 400;
+}
+.pp-row {
+    min-width: 0;
+    min-height: 48px;
+    padding: 16px;
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    background: var(--pp-surface);
+    border-bottom: 1px solid var(--pp-border);
+}
+.pp-rows > :last-child {
+    border-bottom: 0 !important;
+}
+.pp-switch {
+    flex: none;
+    accent-color: var(--pp-accent);
+}
+.pp-choice {
+    justify-content: space-between;
+    cursor: pointer;
+}
+.pp-choice input {
+    width: 20px;
+    height: 20px;
+    flex: none;
+    accent-color: var(--pp-accent);
+    margin: 0;
+}
+.pp-description {
+    font-size: 12px;
+    line-height: 1.6;
+    color: var(--pp-muted);
+    white-space: pre-wrap;
+    overflow-wrap: anywhere;
+}
+.pp-status {
+    position: absolute;
+    inset: 0;
+    display: grid;
+    place-content: center;
+    justify-items: center;
+    gap: 12px;
+    min-width: 0;
+    min-height: 0;
+    margin: 0;
+    padding: 24px;
+    color: var(--pp-muted, GrayText);
+    text-align: center;
+    background: var(--pp-background, Canvas);
+}
+.pp-viewport > .pp-status {
+    position: absolute;
+}
+.pp-status-spinner {
+    box-sizing: border-box;
+    width: 28px;
+    height: 28px;
+    border: 3px solid var(--pp-border, #8884);
+    border-top-color: var(--pp-accent, AccentColor);
+    border-radius: 50%;
+    animation: pp-status-spin 0.8s linear infinite;
+}
+.pp-status-message {
+    max-width: 100%;
+    margin: 0;
+    overflow-wrap: anywhere;
+}
+.pp-status-action {
+    min-width: 96px;
+    min-height: 44px;
+    padding: 8px 16px;
+    border: 0;
+    border-radius: 6px;
+    color: var(--pp-text, ButtonText);
+    font: inherit;
+    cursor: pointer;
+    background: var(--pp-surface, ButtonFace);
+}
+@keyframes pp-status-spin {
+    to {
+        transform: rotate(1turn);
+    }
+}
+.pp-cache {
+    white-space: pre-wrap;
+    overflow-wrap: anywhere;
+}
+.pp-panel :focus-visible {
+    outline: 2px solid var(--pp-accent);
+    outline-offset: -2px;
+}
+
+/* 首页沿用表单的分组与说明样式，入口按屏幕宽度自动换行。
+ * The landing page reuses form groups and descriptions, with entries wrapping by viewport width. */
+:root.pp-page {
+    color-scheme: light dark;
+}
+.pp-page body {
+    margin: 0;
+    overflow: hidden;
+    font:
+        16px / 1.5 -apple-system,
+        BlinkMacSystemFont,
+        "Segoe UI",
+        sans-serif;
+    background: var(--pp-background, Canvas);
+    color: var(--pp-text, CanvasText);
+}
+[data-preference-panes-pages] {
+    position: relative;
+    height: 100vh;
+    background: inherit;
+    overflow: hidden;
+}
+@supports (height: 100dvh) {
+    [data-preference-panes-pages] {
+        height: 100dvh;
+    }
+}
+.pp-home,
+.pp-module-page,
+.pp-detail,
+.pp-link-page {
+    position: absolute;
+    inset: 0;
+    overflow-x: hidden;
+    overflow-y: auto;
+    overscroll-behavior: contain;
+    background: var(--pp-background);
+}
+.pp-module-page,
+.pp-detail,
+.pp-link-page {
+    z-index: 1;
+    box-shadow: -8px 0 24px #00000014;
+}
+.pp-link-page {
+    top: var(--pp-host-height);
+}
+.pp-link-page iframe {
+    display: block;
+    border: 0;
+    width: 100%;
+    height: 100%;
+    background: inherit;
+}
+.pp-host-header {
+    box-sizing: border-box;
+    position: fixed;
+    inset: 0 0 auto;
+    z-index: 2;
+    display: flex;
+    align-items: center;
+    height: calc(64px + env(safe-area-inset-top));
+    padding: env(safe-area-inset-top) max(20px, env(safe-area-inset-right)) 0 max(20px, env(safe-area-inset-left));
+    border-bottom: 1px solid transparent;
+    background: transparent;
+    -webkit-backdrop-filter: blur(25px);
+    backdrop-filter: blur(25px);
+    color: var(--pp-text);
+    transition:
+        background-color 200ms ease-in-out,
+        border-color 200ms ease-in-out;
+}
+.pp-host-header.pp-scrolled {
+    background: rgba(255, 255, 255, 0.6);
+    border-color: var(--pp-border);
+}
+:root[data-theme="dark"] .pp-host-header.pp-scrolled {
+    background: rgba(13, 14, 15, 0.6);
+}
+@media (min-width: 1280px) {
+    .pp-host-header {
+        padding-right: max(20px, calc((100vw - 1588px) / 2));
+        padding-left: max(20px, calc((100vw - 1588px) / 2));
+    }
+}
+@media (prefers-reduced-motion: reduce) {
+    .pp-host-header {
+        transition: none;
+    }
+}
+.pp-host-brand {
+    display: flex;
+    align-items: center;
+    flex: 1;
+    height: 36px;
+    min-width: 0;
+    margin-right: 8px;
+}
+.pp-host-brand-link {
+    display: flex;
+    align-items: center;
+    height: 100%;
+    min-width: 0;
+    max-width: 100%;
+    color: inherit;
+    text-decoration: none;
+    transition: opacity 0.3s;
+}
+.pp-host-brand-link:hover {
+    opacity: 0.6;
+}
+.pp-host-logo {
+    flex: none;
+    min-width: 2rem;
+    margin-right: 0.25rem;
+}
+.pp-host-logo img {
+    display: block;
+    height: 1.6rem;
+}
+.pp-host-title {
+    min-width: 0;
+    text-align: left;
+    font-size: 16px;
+    font-weight: 600;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+.pp-host-left {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    flex: none;
+}
+.pp-host-left::after {
+    content: "";
+    display: inline-block;
+    width: 1px;
+    height: 24px;
+    margin: 0 16px;
+    background-color: #0000001f;
+}
+:root[data-theme="dark"] .pp-host-left::after {
+    background-color: #5454547a;
+}
+.pp-host-left[hidden] {
+    display: none;
+}
+.pp-host-back {
+    border: 0;
+    border-radius: 18px;
+    background: none;
+    color: inherit;
+    width: 36px;
+    height: 36px;
+    padding: 8px;
+    cursor: pointer;
+    transition: background-color 0.2s ease-in-out;
+}
+.pp-host-back svg {
+    display: block;
+    width: 20px;
+    height: 20px;
+    fill: none;
+    stroke: currentColor;
+    stroke-width: 2;
+}
+.pp-host-back:hover {
+    background: #f1f1f1;
+}
+:root[data-theme="dark"] .pp-host-back:hover {
+    background: #343a46;
+}
+.pp-host-toast {
+    position: fixed;
+    z-index: 3;
+    bottom: calc(24px + env(safe-area-inset-bottom) + var(--pp-keyboard-height));
+    left: 50%;
+    transform: translateX(-50%);
+    max-width: calc(100% - 48px);
+    padding: 10px 18px;
+    border-radius: 12px;
+    background: #222e;
+    color: #fff;
+    font-size: 14px;
+    text-align: center;
+}
+.pp-host-toast[hidden] {
+    display: none;
+}
+.pp-host-error {
+    margin: 24px;
+    padding: 16px;
+    border: 1px solid var(--pp-danger, #e45656);
+    border-radius: 12px;
+    font-size: 16px;
+    overflow-wrap: anywhere;
+}
+
+.pp-home {
+    max-width: 1000px;
+    margin: auto;
+    padding: var(--pp-host-height) max(16px, env(safe-area-inset-right)) calc(24px + env(safe-area-inset-bottom)) max(16px, env(safe-area-inset-left));
+}
+.pp-home-entries {
+    display: flex;
+    flex-wrap: wrap;
+    justify-content: space-around;
+    row-gap: 16px;
+    padding: 16px 0;
+    background: var(--pp-surface);
+}
+.pp-home-item {
+    box-sizing: border-box;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    width: 25%;
+    min-width: 0;
+    padding: 0 4px;
+    border: 0;
+    background: none;
+    color: var(--pp-text);
+    font:
+        12px / 1.5 -apple-system,
+        sans-serif;
+    cursor: pointer;
+    text-decoration: none;
+}
+@media (min-width: 500px) {
+    .pp-home-item {
+        width: calc(100% / 6);
+    }
+}
+@media (min-width: 700px) {
+    .pp-home-item {
+        width: 12.5%;
+    }
+}
+.pp-home-icon {
+    box-sizing: border-box;
+    width: 56px;
+    height: 56px;
+    padding: 8px;
+    border-radius: 50%;
+    background: var(--pp-field);
+    font-size: 32px;
+    line-height: 40px;
+    text-align: center;
+}
+.pp-home-icon img {
+    display: block;
+    width: 100%;
+    height: 100%;
+    object-fit: contain;
+}
+.pp-home-name {
+    margin-top: 8px;
+}
+.pp-home-content {
+    min-width: 0;
+    width: 100%;
+}
+.pp-home-content > span {
+    display: block;
+}
+.pp-home-name,
+.pp-home-item [data-module-status] {
+    width: 100%;
+    overflow: hidden;
+    text-align: center;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+}
+.pp-home-item [data-module-status] {
+    min-height: 20px;
+}
+.pp-home-item:disabled {
+    opacity: 0.45;
+    cursor: default;
+}
+.pp-home-entries[data-layout="list"] {
+    display: block;
+    padding: 0;
+}
+.pp-home-entries[data-layout="list"] .pp-home-item {
+    flex-direction: row;
+    gap: 12px;
+    width: 100%;
+    padding: 12px 16px;
+    font-size: 15px;
+}
+.pp-home-entries[data-layout="list"] .pp-home-item + .pp-home-item {
+    border-top: 1px solid var(--pp-border);
+}
+.pp-home-entries[data-layout="list"] .pp-home-icon {
+    flex: none;
+    width: 40px;
+    height: 40px;
+    padding: 4px;
+    font-size: 24px;
+    line-height: 32px;
+}
+.pp-home-entries[data-layout="list"] .pp-home-name {
+    margin-top: 0;
+    text-align: left;
+}
+.pp-home-arrow {
+    color: var(--pp-muted);
+    font-size: 24px;
+}
+.pp-home-footer {
+    margin-top: 16px;
+    text-align: center;
+    white-space: normal;
+}
+.pp-home-footer p {
+    margin: 8px 0 0;
+}

package/src/index.d.ts

@@ -123,6 +123,10 @@ export interface SettingsResponse {
  * Fields, storage root and optional display metadata belonging to one module.
  */
 export interface ModuleDefinition {
+    /** 页面重置的完整设置路径，默认删除当前模块数据 / Complete setting paths reset by the page; defaults to deleting this module's data. */
+    resetPaths?: string[];
+    /** 同一存储根中的完整缓存路径，默认当前模块 Caches / Complete cache path in the same storage root, defaulting to this module's Caches. */
+    cachePath?: string;
     /**
      * 字段 ID 的模块段，不能由 app 名称推断
      * Module segment from field IDs, never inferred from app names.
@@ -246,6 +250,10 @@ export interface BoxJSSetting {
  * A BoxJS application.
  */
 export interface BoxJSApp extends BoxJSMetadata {
+    /** 共享模块存储时，限定本页面可重置的设置路径 / Limit reset paths when multiple pages share module storage. */
+    resetPaths?: string[];
+    /** 可选共享缓存路径，例如 @Root.Composite.Caches / Optional shared cache path, such as @Root.Composite.Caches. */
+    cachePath?: string;
     /**
      * 应用设置
      * Application settings.

package/dist/module/index.html

@@ -1,16 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-    <head>
-        <meta charset="utf-8">
-        <meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover">
-        <meta name="color-scheme" content="light dark">
-        
-        <title>Module Preferences</title>
-        <style>body { margin: 0; }</style>
-        
-    </head>
-    <body>
-        <main id="preferences"></main>
-        <script type="module" src="/settings/assets/index.mjs?v=1.2.5"></script>
-    </body>
-</html>