@ossy/resources 3.9.0 → 3.10.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ossy/resources",
   "description": "Resource domain — aggregate and events for the Ossy resource model",
-  "version": "3.9.0",
+  "version": "3.10.0",
   "private": false,
   "type": "module",
   "main": "./src/index.js",
@@ -49,5 +49,5 @@
     "/src",
     "README.md"
   ],
-  "gitHead": "f404be69becb27a1fd853a6ff1903554e76e7d17"
+  "gitHead": "198084eb98871876396ae625d043dd0f03aa0325"
 }

package/src/SchemaDetailView.jsx

@@ -1,6 +1,10 @@
 import React from 'react'
 import { Text, View, MarkdownViewer, useLocale, hasTranslation } from '@ossy/design-system'
-import { shouldRenderFieldAsMarkdown } from './schema-field-display.js'
+import {
+  formatTemporalFieldValue,
+  isTemporalField,
+  shouldRenderFieldAsMarkdown,
+} from './schema-field-display.js'
 
 const labelStyle = { fontWeight: 600, opacity: 0.65 }
 const valueStyle = { whiteSpace: 'pre-wrap' }
@@ -12,6 +16,13 @@ function renderPlainFieldValue (value) {
   return String(value)
 }
 
+function renderFieldValue (field, value, locale) {
+  if (isTemporalField(field)) {
+    return formatTemporalFieldValue(value, field, locale) ?? '—'
+  }
+  return renderPlainFieldValue(value)
+}
+
 /**
  * Generic read-only detail projection for schema-backed resources.
  *
@@ -30,7 +41,8 @@ export function SchemaDetailView ({
   title,
   emptyMessage = 'No data',
 }) {
-  const { messages } = useLocale()
+  const { messages, language } = useLocale()
+  const locale = language === 'sv' ? 'sv-SE' : 'en-GB'
   const fields = (fieldsProp ?? []).filter((field) => !field.derived)
   const displayTitle = title ?? data.name ?? 'Preview'
 
@@ -86,7 +98,7 @@ export function SchemaDetailView ({
               ? <MarkdownViewer>{value}</MarkdownViewer>
               : (
                 <Text variant="small" style={valueStyle}>
-                  {renderPlainFieldValue(value)}
+                  {renderFieldValue(field, value, locale)}
                 </Text>
               )}
           </View>

package/src/schema-field-display.js

@@ -1,3 +1,5 @@
+const TEMPORAL_FIELD_TYPES = new Set(['date', 'month', 'timestamp'])
+
 /**
  * Whether a schema field value should render as Markdown in detail views.
  *
@@ -10,3 +12,32 @@ export function shouldRenderFieldAsMarkdown (field, value) {
     && typeof value === 'string'
     && value.trim().length > 0
 }
+
+/**
+ * @param {{ type?: string } | null | undefined} field
+ */
+export function isTemporalField (field) {
+  return TEMPORAL_FIELD_TYPES.has(field?.type)
+}
+
+/**
+ * Localized label for date / month / timestamp schema values (Unix ms).
+ *
+ * @param {unknown} value
+ * @param {{ type?: string } | null | undefined} field
+ * @param {string} [locale]
+ * @returns {string | null}
+ */
+export function formatTemporalFieldValue (value, field, locale = 'en-GB') {
+  if (value == null || value === '') return null
+  const ms = typeof value === 'number' ? value : Number(value)
+  if (!Number.isFinite(ms)) return null
+
+  const options = field?.type === 'month'
+    ? { year: 'numeric', month: 'long' }
+    : field?.type === 'timestamp'
+      ? { dateStyle: 'medium', timeStyle: 'short' }
+      : { dateStyle: 'medium' }
+
+  return new Intl.DateTimeFormat(locale, options).format(new Date(ms))
+}

package/src/schema-field-display.spec.js

@@ -0,0 +1,37 @@
+import { describe, expect, it } from '@jest/globals'
+import {
+  formatTemporalFieldValue,
+  isTemporalField,
+} from './schema-field-display.js'
+
+describe('isTemporalField', () => {
+  it('matches date, month, and timestamp', () => {
+    expect(isTemporalField({ type: 'date' })).toBe(true)
+    expect(isTemporalField({ type: 'month' })).toBe(true)
+    expect(isTemporalField({ type: 'timestamp' })).toBe(true)
+    expect(isTemporalField({ type: 'number' })).toBe(false)
+    expect(isTemporalField({})).toBe(false)
+  })
+})
+
+describe('formatTemporalFieldValue', () => {
+  const ms = Date.UTC(2020, 7, 8)
+
+  it('formats date fields as a calendar day', () => {
+    const label = formatTemporalFieldValue(ms, { type: 'date' }, 'en-GB')
+    expect(label).toContain('2020')
+    expect(label).not.toMatch(/1596844800000/)
+  })
+
+  it('formats month fields as month and year', () => {
+    const label = formatTemporalFieldValue(ms, { type: 'month' }, 'en-GB')
+    expect(label.toLowerCase()).toContain('august')
+    expect(label).toContain('2020')
+  })
+
+  it('returns em-dash fallback as null for empty values', () => {
+    expect(formatTemporalFieldValue(null, { type: 'date' })).toBe(null)
+    expect(formatTemporalFieldValue('', { type: 'date' })).toBe(null)
+    expect(formatTemporalFieldValue('not-a-date', { type: 'date' })).toBe(null)
+  })
+})