特效

视觉特效组件（effects/ 模块）。

ShadowedRectangle 阴影矩形

带模糊阴影的矩形（Fluent 风格软阴影），shadowVisible 可控开关，在根模块注册：

import PrismQML as Fluent

Fluent.ShadowedRectangle {
    color: Enums.cardColor
    radius: Enums.radius.large
    shadowLevel: Enums.shadow.level4
}

其他

• Shadow — 通用阴影
• ColorOverlay — 颜色叠加
• GaussianBlur — 高斯模糊
• OpacityMask — 透明度遮罩（圆角裁剪）

FocusVisual 焦点视觉环

FocusVisual 在宿主项目获得 active focus 时绘制主题强调色焦点环。默认跟踪父级， 也可以通过 focusSource 指定要跟踪的项目；焦点环在没有焦点时不会创建实际的视觉对象。

import PrismQML as Fluent

Item {
    id: fieldShell

    Fluent.FocusVisual {
        anchors.fill: parent
        focusSource: fieldShell
        radius: Enums.radius.small
    }
}

radius 控制圆角，ringColor 默认使用 Enums.accentColor。组件本身禁用指针事件， 因此不会挡住下方控件；宿主仍需自行获得焦点。

NeoShadow 硬阴影

新粗野皮肤的招牌——偏移纯色矩形，零模糊。NeoShadow 未在根模块注册，需以目录方式 引入 effects/ 子目录后使用；且 target 为必填的 required property：

NeoShadow {
    target: bgRect          // 跟随目标矩形几何（必填）
    accent: control.focused // true 时转橙强调
}

皮肤适配

NeoShadow 专用于新粗野硬阴影范式；Fluent 皮肤用 ShadowedRectangle / RectangularShadow 模糊阴影。控件内部按皮肤自动选择阴影实现——你通常无需直接使用这些底层特效。