feat: enforce custom appearance policy

This commit is contained in:
2026-08-20 10:50:55 +02:00
parent 6052dde760
commit d3daf42bd9
2 changed files with 20 additions and 3 deletions
+7 -2
View File
@@ -304,13 +304,18 @@ ACCESS_DOCUMENTATION: tuple[DocumentationTopic, ...] = (
DocumentationTopic(
id="access.reference.effective-appearance",
title="Understand the effective appearance source",
summary="The authenticated profile explains whether the active palette comes from the user, tenant, system, or a policy lock.",
summary="The authenticated profile explains the effective palette, policy lock, and governed personal token overrides.",
body=(
"An explicit personal palette normally wins over tenant and system defaults. "
"Resetting it stores inheritance, not a copy of the current default. A tenant "
"policy lock suppresses personal choices; a system lock suppresses both tenant "
"and personal choices. Access enforces the lock during profile writes and returns "
"the effective palette, source, inherited value, and lock state on full profile responses."
"the effective palette, source, inherited value, and lock state on full profile responses. "
"Advanced accent, surface, and status overrides are accepted only when the system opts in, "
"the tenant does not block them, and neither palette scope is locked. Both light and dark "
"documents are versioned and validated atomically for hexadecimal values, WCAG AA paired "
"contrast, and distinct status colors. Invalid or disallowed documents are never partially "
"applied; users may still remove an inactive stored override to return to inheritance."
),
layer="always",
documentation_types=("admin", "user"),