@shwfed/config 3.0.13 → 3.0.15

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/config.vue

@@ -0,0 +1,370 @@
+<script setup>
+import { computed } from "vue";
+import { Field, FieldLabel } from "../../../../ui/field";
+import { ExpressionEditor } from "../../../../ui/expression-editor";
+import DerivedValueEditor from "../../../DerivedValueEditor.vue";
+import ValidationRulesField from "../../../ValidationRulesField.vue";
+import { InputGroup, InputGroupInput } from "../../../../ui/input-group";
+import { Locale as LocaleField } from "../../../../ui/locale";
+import { Markdown } from "../../../../ui/markdown";
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../../../../ui/select";
+import { getStructFieldDescription, getStructFieldTitle } from "../../../schema";
+import {
+  BLOCK_FEATURES,
+  INLINE_FEATURES,
+  schema
+} from "./schema";
+defineOptions({ name: "ShwfedRichTextFieldConfig" });
+const value = defineModel({ type: null, ...{ required: true } });
+const fieldSchema = schema(() => {
+});
+const fieldTitle = (f) => getStructFieldTitle(fieldSchema, f) ?? f;
+const fieldDescription = (f) => getStructFieldDescription(fieldSchema, f);
+const INLINE_LABELS = {
+  bold: "\u52A0\u7C97",
+  italic: "\u659C\u4F53",
+  underline: "\u4E0B\u5212\u7EBF",
+  strike: "\u5220\u9664\u7EBF"
+};
+const BLOCK_LABELS = {
+  bulletList: "\u65E0\u5E8F\u5217\u8868",
+  orderedList: "\u6709\u5E8F\u5217\u8868"
+};
+const inlineSelection = computed(() => [...value.value.inline ?? []]);
+const blockSelection = computed(() => [...value.value.block ?? []]);
+const inlineSummary = computed(
+  () => inlineSelection.value.map((f) => INLINE_LABELS[f]).join("\u3001")
+);
+const blockSummary = computed(
+  () => blockSelection.value.map((f) => BLOCK_LABELS[f]).join("\u3001")
+);
+function setInline(next) {
+  const picked = new Set(next);
+  value.value = { ...value.value, inline: INLINE_FEATURES.filter((f) => picked.has(f)) };
+}
+function setBlock(next) {
+  const picked = new Set(next);
+  value.value = { ...value.value, block: BLOCK_FEATURES.filter((f) => picked.has(f)) };
+}
+const pathText = computed({
+  get: () => value.value.binding ?? "",
+  set: (next) => {
+    const trimmed = next.trim();
+    if (trimmed.length === 0) {
+      const { binding: _omit, ...rest } = value.value;
+      value.value = rest;
+    } else {
+      value.value = { ...value.value, binding: trimmed };
+    }
+  }
+});
+</script>
+
+<template>
+  <div class="flex flex-col gap-3">
+    <div class="grid grid-cols-2 gap-3">
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template
+            v-if="fieldDescription('displayName')"
+            #tooltip
+          >
+            <Markdown
+              :source="fieldDescription('displayName')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("displayName") }}
+        </FieldLabel>
+        <InputGroup>
+          <InputGroupInput
+            :model-value="value.displayName ?? ''"
+            placeholder="例：正文"
+            @update:model-value="(v) => {
+  const s = String(v ?? '');
+  value = { ...value, displayName: s.length > 0 ? s : void 0 };
+}"
+          />
+        </InputGroup>
+      </Field>
+
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
+            <Markdown
+              :source="fieldDescription('binding')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("binding") }}
+        </FieldLabel>
+        <InputGroup>
+          <InputGroupInput
+            v-model="pathText"
+            placeholder="例：article.body"
+            class="font-mono"
+          />
+        </InputGroup>
+      </Field>
+    </div>
+
+    <div class="grid grid-cols-3 gap-3">
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template
+            v-if="fieldDescription('label')"
+            #tooltip
+          >
+            <Markdown
+              :source="fieldDescription('label')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("label") }}
+        </FieldLabel>
+        <LocaleField
+          :model-value="value.label"
+          @update:model-value="(v) => value = { ...value, label: v }"
+        />
+      </Field>
+
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template
+            v-if="fieldDescription('placeholder')"
+            #tooltip
+          >
+            <Markdown
+              :source="fieldDescription('placeholder')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("placeholder") }}
+        </FieldLabel>
+        <LocaleField
+          :model-value="value.placeholder"
+          @update:model-value="(v) => value = { ...value, placeholder: v }"
+        />
+      </Field>
+
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template
+            v-if="fieldDescription('tooltip')"
+            #tooltip
+          >
+            <Markdown
+              :source="fieldDescription('tooltip')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("tooltip") }}
+        </FieldLabel>
+        <LocaleField
+          markdown
+          :model-value="value.tooltip"
+          @update:model-value="(v) => value = { ...value, tooltip: v }"
+        />
+      </Field>
+    </div>
+
+    <div class="grid grid-cols-2 gap-3">
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
+            <Markdown
+              :source="fieldDescription('inline')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("inline") }}
+        </FieldLabel>
+        <Select
+          multiple
+          :model-value="inlineSelection"
+          @update:model-value="setInline"
+        >
+          <SelectTrigger class="w-full">
+            <SelectValue placeholder="全部关闭">
+              <span v-if="inlineSummary.length > 0">{{ inlineSummary }}</span>
+              <span
+                v-else
+                class="text-zinc-400"
+              >全部关闭</span>
+            </SelectValue>
+          </SelectTrigger>
+          <SelectContent>
+            <SelectItem
+              v-for="feature in INLINE_FEATURES"
+              :key="feature"
+              :value="feature"
+            >
+              {{ INLINE_LABELS[feature] }}
+            </SelectItem>
+          </SelectContent>
+        </Select>
+      </Field>
+
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
+            <Markdown
+              :source="fieldDescription('block')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("block") }}
+        </FieldLabel>
+        <Select
+          multiple
+          :model-value="blockSelection"
+          @update:model-value="setBlock"
+        >
+          <SelectTrigger class="w-full">
+            <SelectValue placeholder="全部关闭">
+              <span v-if="blockSummary.length > 0">{{ blockSummary }}</span>
+              <span
+                v-else
+                class="text-zinc-400"
+              >全部关闭</span>
+            </SelectValue>
+          </SelectTrigger>
+          <SelectContent>
+            <SelectItem
+              v-for="feature in BLOCK_FEATURES"
+              :key="feature"
+              :value="feature"
+            >
+              {{ BLOCK_LABELS[feature] }}
+            </SelectItem>
+          </SelectContent>
+        </Select>
+      </Field>
+    </div>
+
+    <div class="grid grid-cols-3 gap-3">
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
+            <Markdown
+              :source="fieldDescription('required') ?? '\u8FD4\u56DE `true` \u65F6\u663E\u793A\u5FC5\u586B\u661F\u53F7\u5E76\u8981\u6C42\u975E\u7A7A'"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("required") }}
+        </FieldLabel>
+        <ExpressionEditor
+          :model-value="value.required ?? ''"
+          placeholder="例：form.status == 'published'"
+          result-type="bool"
+          class="min-h-10"
+          @update:model-value="(v) => value = { ...value, required: v.length > 0 ? v : void 0 }"
+        />
+      </Field>
+
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
+            <Markdown
+              :source="fieldDescription('hidden') ?? '\u8FD4\u56DE `true` \u65F6\u5B57\u6BB5\u5728\u6240\u6709\u5E03\u5C40\u4E2D\u90FD\u4E0D\u6E32\u67D3'"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("hidden") }}
+        </FieldLabel>
+        <ExpressionEditor
+          :model-value="value.hidden ?? ''"
+          placeholder="例：form.role == 'guest'"
+          result-type="bool"
+          class="min-h-10"
+          @update:model-value="(v) => value = { ...value, hidden: v.length > 0 ? v : void 0 }"
+        />
+      </Field>
+
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
+            <Markdown
+              :source="fieldDescription('disabled')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("disabled") }}
+        </FieldLabel>
+        <ExpressionEditor
+          :model-value="value.disabled ?? ''"
+          placeholder="例：form.status == 'locked'"
+          result-type="bool"
+          class="min-h-10"
+          @update:model-value="(v) => value = { ...value, disabled: v.length > 0 ? v : void 0 }"
+        />
+      </Field>
+
+      <Field orientation="vertical">
+        <FieldLabel class="text-xs text-zinc-500">
+          <template #tooltip>
+            <Markdown
+              :source="fieldDescription('readonly')"
+              block
+              class="prose prose-sm prose-zinc"
+            />
+          </template>
+          {{ fieldTitle("readonly") }}
+        </FieldLabel>
+        <ExpressionEditor
+          :model-value="value.readonly ?? ''"
+          placeholder="例：form.id != null"
+          result-type="bool"
+          class="min-h-10"
+          @update:model-value="(v) => value = { ...value, readonly: v.length > 0 ? v : void 0 }"
+        />
+      </Field>
+    </div>
+
+    <Field orientation="vertical">
+      <FieldLabel class="text-xs text-zinc-500">
+        <template #tooltip>
+          <Markdown
+            :source="fieldDescription('derived')"
+            block
+            class="prose prose-sm prose-zinc"
+          />
+        </template>
+        {{ fieldTitle("derived") }}
+      </FieldLabel>
+      <DerivedValueEditor
+        :model-value="value.derived"
+        result-type="string"
+        placeholder="例：form.template"
+        @update:model-value="(v) => value = { ...value, derived: v }"
+      />
+    </Field>
+
+    <Field orientation="vertical">
+      <FieldLabel class="text-xs text-zinc-500">
+        <template #tooltip>
+          <Markdown
+            :source="fieldDescription('validations')"
+            block
+            class="prose prose-sm prose-zinc"
+          />
+        </template>
+        {{ fieldTitle("validations") }}
+      </FieldLabel>
+      <ValidationRulesField
+        :model-value="value.validations"
+        @update:model-value="(v) => value = { ...value, validations: v.length > 0 ? v : void 0 }"
+      />
+    </Field>
+  </div>
+</template>

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/config.vue.d.ts

@@ -0,0 +1,107 @@
+import { type Value } from './schema.js';
+type __VLS_ModelProps = {
+    modelValue: Value;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: {
+        readonly label?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly disabled?: string | undefined;
+        readonly type: "com.shwfed.form.field.richtext";
+        readonly id: string;
+        readonly inline: readonly ("bold" | "strike" | "italic" | "underline")[];
+        readonly hidden?: string | undefined;
+        readonly block: readonly ("bulletList" | "orderedList")[];
+        readonly tooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly required?: string | undefined;
+        readonly displayName?: string | undefined;
+        readonly compatibilityDate: "2026-07-18";
+        readonly placeholder?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly readonly?: string | undefined;
+        readonly binding?: string | undefined;
+        readonly derived?: {
+            readonly mode: "formula" | "prefill";
+            readonly expression: string;
+        } | undefined;
+        readonly validations?: readonly {
+            readonly message: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]];
+            readonly warning?: boolean | undefined;
+            readonly when: string;
+        }[] | undefined;
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: {
+        readonly label?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly disabled?: string | undefined;
+        readonly type: "com.shwfed.form.field.richtext";
+        readonly id: string;
+        readonly inline: readonly ("bold" | "strike" | "italic" | "underline")[];
+        readonly hidden?: string | undefined;
+        readonly block: readonly ("bulletList" | "orderedList")[];
+        readonly tooltip?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly required?: string | undefined;
+        readonly displayName?: string | undefined;
+        readonly compatibilityDate: "2026-07-18";
+        readonly placeholder?: readonly [{
+            readonly locale: "zh";
+            readonly message: string;
+        }, ...{
+            readonly locale: "en" | "ja" | "ko";
+            readonly message: string;
+        }[]] | undefined;
+        readonly readonly?: string | undefined;
+        readonly binding?: string | undefined;
+        readonly derived?: {
+            readonly mode: "formula" | "prefill";
+            readonly expression: string;
+        } | undefined;
+        readonly validations?: readonly {
+            readonly message: readonly [{
+                readonly locale: "zh";
+                readonly message: string;
+            }, ...{
+                readonly locale: "en" | "ja" | "ko";
+                readonly message: string;
+            }[]];
+            readonly warning?: boolean | undefined;
+            readonly when: string;
+        }[] | undefined;
+    }) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/extensions.d.ts

@@ -0,0 +1,27 @@
+import { type Extensions } from '@tiptap/vue-3';
+import type { RichTextFeatures } from './features.js';
+export interface RichTextExtensionOptions {
+    features: RichTextFeatures;
+    getPlaceholder: () => string;
+}
+/**
+ * The editor's extension set — the single source of truth for what this field
+ * can produce. Lives apart from `RichTextEditor.vue` so it can be exercised
+ * against a real `Editor` in a test without dragging the toolbar's popovers
+ * and portals into jsdom.
+ *
+ * `getPlaceholder` is read lazily so a locale switch is reflected without
+ * reconfiguring the editor.
+ *
+ * Two different meanings of "off" live here, and the difference matters:
+ *
+ * - Nodes and marks the CONFIG switches off stay REGISTERED. Only the means of
+ *   authoring them is withdrawn (button hidden, shortcut unbound), because
+ *   dropping the extension would make ProseMirror discard the tag while
+ *   parsing — so merely opening a record authored before the box was unchecked
+ *   would strip it, and the next save would persist the loss.
+ * - Nodes this field does not support AT ALL are removed from the schema
+ *   outright. Content carrying them is flattened on load. That is a deliberate
+ *   trade: the field has never shipped, so no stored document can contain them.
+ */
+export declare function richTextExtensions(options: RichTextExtensionOptions): Extensions;

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/extensions.js

@@ -0,0 +1,83 @@
+import { TextAlign } from "@tiptap/extension-text-align";
+import { OrderedList } from "@tiptap/extension-list";
+import { Placeholder } from "@tiptap/extensions";
+import StarterKit from "@tiptap/starter-kit";
+import { Extension } from "@tiptap/vue-3";
+import { INLINE_FEATURES } from "./schema.js";
+import { Indent } from "./indent.js";
+const INLINE_SHORTCUTS = {
+  bold: ["Mod-b", "Mod-B"],
+  italic: ["Mod-i", "Mod-I"],
+  underline: ["Mod-u", "Mod-U"],
+  strike: ["Mod-Shift-s"]
+};
+const BULLET_LIST_SHORTCUT = "Mod-Shift-8";
+const ORDERED_LIST_SHORTCUT = "Mod-Shift-7";
+function shortcutGuard(features) {
+  return Extension.create({
+    name: "richtextShortcutGuard",
+    priority: 1e3,
+    addKeyboardShortcuts() {
+      const handlers = {};
+      const block = (key) => {
+        handlers[key] = () => true;
+      };
+      for (const kind of INLINE_FEATURES) {
+        if (features.inline.has(kind)) continue;
+        for (const key of INLINE_SHORTCUTS[kind]) block(key);
+      }
+      if (!features.block.has("bulletList")) block(BULLET_LIST_SHORTCUT);
+      if (!features.block.has("orderedList")) block(ORDERED_LIST_SHORTCUT);
+      return handlers;
+    }
+  });
+}
+export function richTextExtensions(options) {
+  const { features, getPlaceholder } = options;
+  return [
+    // StarterKit v3 bundles bold / italic / strike / underline and the list
+    // nodes — in v2 underline was a separate install.
+    StarterKit.configure({
+      // Off outright, not merely unbound. These are the nodes whose input rules
+      // are the markdown behaviour being complained about (`# `, `> `, ``` ),
+      // and the toolbar never offered them, so removing them from the schema
+      // closes the door structurally rather than relying on `enableInputRules`
+      // alone.
+      heading: false,
+      blockquote: false,
+      codeBlock: false,
+      code: false,
+      horizontalRule: false,
+      // Links and tables are deferred, not merely disabled — the interaction
+      // design for both needs more thought than a toolbar button. Removed from
+      // the schema rather than left switchable so no half-built affordance
+      // ships. Loading content that contains them flattens an `<a>` to its text
+      // and drops the table; acceptable only because this field has never
+      // shipped and no stored document can contain either.
+      link: false,
+      // ProseMirror's own drop cursor drew a thick black bar during drags.
+      // Nothing in this field drags document nodes, so it has no job here.
+      dropcursor: false,
+      // Re-registered below with its paste plugin stripped.
+      orderedList: false
+    }),
+    // `OrderedList` ships a `handlePaste` ProseMirror plugin that converts
+    // plain-text `1. foo` into a real list whenever the clipboard carries no
+    // `text/html`. It is not an input rule and not a paste rule, so neither
+    // editor-level switch touches it — this is the last piece of markdown
+    // parsing, and the only way out is to drop the plugin.
+    OrderedList.extend({ addProseMirrorPlugins: () => [] }),
+    shortcutGuard(features),
+    // Alignment is deliberately not configurable — it is always-on toolbar
+    // furniture.
+    TextAlign.configure({
+      types: ["paragraph"],
+      alignments: ["left", "center", "right"],
+      // `null` rather than `'left'`: unaligned paragraphs then emit no `style`
+      // at all, keeping the stored HTML free of no-op attributes.
+      defaultAlignment: null
+    }),
+    Indent.configure({ types: ["paragraph"] }),
+    Placeholder.configure({ placeholder: () => getPlaceholder() })
+  ];
+}

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/features.d.ts

@@ -0,0 +1,21 @@
+import { type BlockFeature, type InlineFeature, type Value } from './schema.js';
+/**
+ * The config's feature lists, resolved into the form the editor consumes.
+ *
+ * Resolving here rather than at each read site keeps the membership tests from
+ * being scattered across the toolbar and the extension set — two places that
+ * must agree, since a button the extension set cannot serve is a dead button.
+ *
+ * A config predating the `inline` / `block` fields decodes with them absent.
+ * Treating that as "everything on" matches what such a field actually did.
+ */
+export interface RichTextFeatures {
+    inline: ReadonlySet<InlineFeature>;
+    block: ReadonlySet<BlockFeature>;
+}
+export type RichTextFeatureConfig = Partial<Pick<Value, 'inline' | 'block'>>;
+export declare function resolveFeatures(config?: RichTextFeatureConfig): RichTextFeatures;
+/** True when no list kind is enabled — indent/outdent still applies to paragraphs. */
+export declare function hasAnyList(features: RichTextFeatures): boolean;
+/** A value that changes whenever the enabled set does; see `runtime.vue`. */
+export declare function featureSignature(features: RichTextFeatures): string;

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/features.js

@@ -0,0 +1,16 @@
+import { INLINE_FEATURES, BLOCK_FEATURES } from "./schema.js";
+export function resolveFeatures(config = {}) {
+  return {
+    inline: new Set(config.inline ?? INLINE_FEATURES),
+    block: new Set(config.block ?? BLOCK_FEATURES)
+  };
+}
+export function hasAnyList(features) {
+  return features.block.has("bulletList") || features.block.has("orderedList");
+}
+export function featureSignature(features) {
+  return [
+    [...features.inline].sort().join(","),
+    [...features.block].sort().join(",")
+  ].join("|");
+}

package/dist/runtime/components/form/fields/2026-07-18/com.shwfed.form.field.richtext/indent.d.ts

@@ -0,0 +1,26 @@
+import { Extension } from '@tiptap/core';
+export interface IndentOptions {
+    /** Node types that carry the attribute. */
+    types: string[];
+    /** Indentation step, in `em`. */
+    step: number;
+    /** Ceiling, so a held Tab cannot push content off the right edge. */
+    maxLevel: number;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        indent: {
+            indent: () => ReturnType;
+            outdent: () => ReturnType;
+        };
+    }
+}
+/**
+ * Paragraph indentation, as an `indent` level attribute rendered to a margin.
+ *
+ * Tiptap has no official indent extension in v3 (`@tiptap/extension-indent`
+ * does not exist on npm), so this is ours. It exists because indent/outdent has
+ * to mean something outside lists too — inside a list the same toolbar button
+ * nests the item, which `sinkListItem` already handles.
+ */
+export declare const Indent: Extension<IndentOptions, any>;