refactor(SignatureStamp): integrate policy-based signature_text consumption

- Create useSignatureTextPolicy() composable for desegregating consolidated policy values
- Composable loads from policiesStore.signature_text (effective policy value)
- Fallback to legacy loadState keys for backward compatibility during transition
- Update SignatureStamp.vue to consume via composable instead of direct loadState
- Remove helper functions getStringState/getNumberState (now in composable)
- All signature_text values (template, sizes, dimensions, render mode) now unified

This enables SignatureStamp to track policy-based settings in real-time while maintaining
backward compatibility. Once policies are fully active, the fallback path will be unused.

Author: vitormattos

src/composables/useSignatureTextPolicy.ts

@@ -0,0 +1,74 @@
+/**
+ * SPDX-FileCopyrightText: 2026 LibreCode coop and LibreCode contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+import { computed } from 'vue'
+import { loadState } from '@nextcloud/initial-state'
+import { usePoliciesStore } from '../store/policies'
+
+interface SignatureTextValues {
+	template: string
+	templateFontSize: number
+	signatureFontSize: number
+	signatureWidth: number
+	signatureHeight: number
+	renderMode: string
+	templateError: string
+	parsed: string
+	defaultTemplate: string
+	defaultTemplateFontSize: number
+	defaultSignatureFontSize: number
+	defaultSignatureWidth: number
+	defaultSignatureHeight: number
+}
+
+export function useSignatureTextPolicy(): { values: ReturnType<typeof computed<SignatureTextValues>> } {
+	const policiesStore = usePoliciesStore()
+
+	const values = computed<SignatureTextValues>(() => {
+		const signatureTextPolicy = policiesStore.policies.signature_text
+
+		// If policy exists, use its effective value
+		if (signatureTextPolicy?.value) {
+			const value = typeof signatureTextPolicy.value === 'string'
+				? JSON.parse(signatureTextPolicy.value)
+				: signatureTextPolicy.value
+
+			return {
+				template: String(value.template ?? ''),
+				templateFontSize: Number(value.template_font_size ?? 9.0),
+				signatureFontSize: Number(value.signature_font_size ?? 9.0),
+				signatureWidth: Number(value.signature_width ?? 90.0),
+				signatureHeight: Number(value.signature_height ?? 60.0),
+				renderMode: String(value.render_mode ?? 'default'),
+				templateError: loadState<string>('libresign', 'signature_text_template_error', ''),
+				parsed: loadState<string>('libresign', 'signature_text_parsed', ''),
+				defaultTemplate: loadState<string>('libresign', 'default_signature_text_template', ''),
+				defaultTemplateFontSize: loadState<number>('libresign', 'default_template_font_size', 9.0),
+				defaultSignatureFontSize: loadState<number>('libresign', 'default_signature_font_size', 9.0),
+				defaultSignatureWidth: loadState<number>('libresign', 'default_signature_width', 90.0),
+				defaultSignatureHeight: loadState<number>('libresign', 'default_signature_height', 60.0),
+			}
+		}
+
+		// Fallback to legacy loadState keys (for backward compatibility during transition)
+		return {
+			template: loadState<string>('libresign', 'signature_text_template', ''),
+			templateFontSize: loadState<number>('libresign', 'template_font_size', 9.0),
+			signatureFontSize: loadState<number>('libresign', 'signature_font_size', 9.0),
+			signatureWidth: loadState<number>('libresign', 'signature_width', 90.0),
+			signatureHeight: loadState<number>('libresign', 'signature_height', 60.0),
+			renderMode: loadState<string>('libresign', 'signature_render_mode', 'default'),
+			templateError: loadState<string>('libresign', 'signature_text_template_error', ''),
+			parsed: loadState<string>('libresign', 'signature_text_parsed', ''),
+			defaultTemplate: loadState<string>('libresign', 'default_signature_text_template', ''),
+			defaultTemplateFontSize: loadState<number>('libresign', 'default_template_font_size', 9.0),
+			defaultSignatureFontSize: loadState<number>('libresign', 'default_signature_font_size', 9.0),
+			defaultSignatureWidth: loadState<number>('libresign', 'default_signature_width', 90.0),
+			defaultSignatureHeight: loadState<number>('libresign', 'default_signature_height', 60.0),
+		}
+	})
+
+	return { values }
+}

src/views/Settings/SignatureStamp.vue

@@ -356,23 +356,16 @@ import NcTextField from '@nextcloud/vue/components/NcTextField'
 import { useIsDarkTheme } from '@nextcloud/vue/composables/useIsDarkTheme'
 
 import CodeEditor from '../../components/CodeEditor.vue'
+import { useSignatureTextPolicy } from '../../composables/useSignatureTextPolicy'
 
 defineOptions({
 	name: 'SignatureStamp',
 })
 
 type RenderMode = 'DESCRIPTION_ONLY' | 'GRAPHIC_AND_DESCRIPTION' | 'SIGNAME_AND_DESCRIPTION' | 'GRAPHIC_ONLY'
 
-function getStringState(key: string, fallback = '') {
-	return loadState<string>('libresign', key, fallback)
-}
-
-function getNumberState(key: string, fallback = 0) {
-	return loadState<number>('libresign', key, fallback)
-}
-
 const isDarkTheme = useIsDarkTheme()
-const templateError = loadState<string>('libresign', 'signature_text_template_error', '')
+const { values: signatureTextValues } = useSignatureTextPolicy()
 const initialBackgroundType = loadState<string>('libresign', 'signature_background_type', '')
 
 const input = ref<HTMLInputElement | null>(null)
@@ -387,23 +380,23 @@ const errorMessageBackground = ref('')
 const backgroundUrl = ref(backgroundType.value !== 'deleted'
 	? generateOcsUrl('/apps/libresign/api/v1/admin/signature-background')
 	: '')
-const defaultSignatureTextTemplate = ref(getStringState('default_signature_text_template'))
-const defaultTemplateFontSize = ref<number>(getNumberState('default_template_font_size'))
-const defaultSignatureFontSize = ref<number>(getNumberState('default_signature_font_size'))
-const defaultSignatureWidth = ref<number>(getNumberState('default_signature_width'))
-const defaultSignatureHeight = ref<number>(getNumberState('default_signature_height'))
-const signatureTextTemplate = ref(getStringState('signature_text_template'))
-const signatureWidth = ref<number>(getNumberState('signature_width'))
-const signatureHeight = ref<number>(getNumberState('signature_height'))
-const signatureFontSize = ref<number>(getNumberState('signature_font_size'))
-const templateFontSize = ref<number>(getNumberState('template_font_size'))
+const defaultSignatureTextTemplate = ref(signatureTextValues.value.defaultTemplate)
+const defaultTemplateFontSize = ref<number>(signatureTextValues.value.defaultTemplateFontSize)
+const defaultSignatureFontSize = ref<number>(signatureTextValues.value.defaultSignatureFontSize)
+const defaultSignatureWidth = ref<number>(signatureTextValues.value.defaultSignatureWidth)
+const defaultSignatureHeight = ref<number>(signatureTextValues.value.defaultSignatureHeight)
+const signatureTextTemplate = ref(signatureTextValues.value.template)
+const signatureWidth = ref<number>(signatureTextValues.value.signatureWidth)
+const signatureHeight = ref<number>(signatureTextValues.value.signatureHeight)
+const signatureFontSize = ref<number>(signatureTextValues.value.signatureFontSize)
+const templateFontSize = ref<number>(signatureTextValues.value.templateFontSize)
 const isSignatureImageLoaded = ref(false)
 const templateSaved = ref(true)
-const zoomLevel = ref<number>(getNumberState('signature_preview_zoom_level', 100))
-const renderMode = ref<RenderMode>(loadState<RenderMode>('libresign', 'signature_render_mode', 'GRAPHIC_AND_DESCRIPTION'))
+const zoomLevel = ref<number>(loadState<number>('libresign', 'signature_preview_zoom_level', 100))
+const renderMode = ref<RenderMode>(signatureTextValues.value.renderMode as RenderMode)
 const dislaySuccessTemplate = ref(false)
-const errorMessageTemplate = ref<string[]>(templateError ? [templateError] : [])
-const parsed = ref(loadState<string>('libresign', 'signature_text_parsed', ''))
+const errorMessageTemplate = ref<string[]>(signatureTextValues.value.templateError ? [signatureTextValues.value.templateError] : [])
+const parsed = ref(signatureTextValues.value.parsed)
 const isRTLDirection = isRTL()
 const availableVariables = ref<Record<string, string>>(loadState<Record<string, string>>('libresign', 'signature_available_variables', {}))
 const isOverflowing = ref(false)