@pascal-app/editor 1.0.6 → 1.1.0

package/src/i18n/locales/zh-CN/messages.ts

@@ -0,0 +1 @@
+/*eslint-disable*/import type{Messages}from"@lingui/core";export const messages=JSON.parse("{\"core.level.basement\":[\"地下层\"],\"core.level.basementNumber\":[\"地下 \",[\"number\"],\" 层\"],\"core.level.floorNumber\":[[\"number\"],\" 层\"],\"core.level.groundFloor\":[\"首层\"],\"editor.buildPanel.advanced\":[\"高级\"],\"editor.buildPanel.rooms.hint\":[\"墙体 · 楼板 · 天花板\"],\"editor.buildPanel.rooms.idle\":[\"选择一种形状开始绘制。每个房间都会同时创建墙体、楼板和天花板。\"],\"editor.buildPanel.rooms.polygon.caption\":[[\"lead\"],\"然后再次点击起点闭合。适用于 L 形和斜角房间。\"],\"editor.buildPanel.rooms.polygon.label\":[\"多边形\"],\"editor.buildPanel.rooms.polygon.lead\":[\"依次点击各个角点，\"],\"editor.buildPanel.rooms.polygon.title\":[\"多边形房间\"],\"editor.buildPanel.rooms.rectangle.caption\":[\"在网格上\",[\"lead\"],\"。墙体、楼板和天花板将一并创建。\"],\"editor.buildPanel.rooms.rectangle.label\":[\"矩形\"],\"editor.buildPanel.rooms.rectangle.lead\":[\"点击两个对角点\"],\"editor.buildPanel.rooms.rectangle.title\":[\"矩形房间\"],\"editor.buildPanel.rooms.title\":[\"房间\"],\"editor.buildPanel.rooms.walls.label\":[\"墙体\"],\"editor.buildPanel.rooms.walls.title\":[\"墙体\"],\"viewer.camera.orbitLeft\":[\"向左旋转\"],\"viewer.camera.orbitRight\":[\"向右旋转\"],\"viewer.camera.topView\":[\"俯视图\"],\"viewer.common.off\":[\"关闭\"],\"viewer.common.on\":[\"开启\"],\"viewer.display.camera\":[\"相机\"],\"viewer.display.colored\":[\"彩色\"],\"viewer.display.colors\":[\"颜色\"],\"viewer.display.edges.title\":[\"边线\"],\"viewer.display.monochrome\":[\"单色\"],\"viewer.display.orthographic\":[\"正交\"],\"viewer.display.perspective\":[\"透视\"],\"viewer.display.shadows\":[\"阴影\"],\"viewer.display.title\":[\"显示设置\"],\"viewer.floorplan.alignNorth\":[\"视图对齐北向\"],\"viewer.floorplan.empty\":[\"此场景没有可用的平面图。\"],\"viewer.floorplan.fit\":[\"适合窗口\"],\"viewer.floorplan.floor\":[\"楼层\"],\"viewer.floorplan.floorPlan\":[\"平面图\"],\"viewer.floorplan.viewLabel\":[[\"floor\"],\"二维视图\"],\"viewer.floorplan.zoomIn\":[\"放大\"],\"viewer.floorplan.zoomOut\":[\"缩小\"],\"viewer.header.back\":[\"返回\"],\"viewer.header.levels\":[\"楼层\"],\"viewer.header.rooms\":[\"房间\"],\"viewer.header.selection\":[\"当前选择\"],\"viewer.header.units\":[\"单元\"],\"viewer.header.untitled\":[\"未命名\"],\"viewer.header.zones\":[\"分区\"],\"viewer.levels.exploded\":[\"分解\"],\"viewer.levels.label\":[\"楼层：\",[\"mode\"]],\"viewer.levels.manual\":[\"手动\"],\"viewer.levels.solo\":[\"单层\"],\"viewer.levels.stacked\":[\"叠层\"],\"viewer.stage.layout\":[\"视图布局\"],\"viewer.stage.split\":[\"分屏\"],\"viewer.theme.blueprint\":[\"蓝图\"],\"viewer.theme.mediterranean\":[\"地中海\"],\"viewer.theme.night\":[\"夜景\"],\"viewer.theme.overcast\":[\"阴天\"],\"viewer.theme.paper\":[\"纸面\"],\"viewer.theme.studio\":[\"影棚\"],\"viewer.theme.sunset\":[\"日落\"],\"viewer.theme.title\":[\"场景主题\"],\"viewer.theme.twilight\":[\"暮色\"],\"viewer.theme.verdant\":[\"绿意\"],\"viewer.visibility.guides\":[\"参考图\"],\"viewer.visibility.scans\":[\"扫描模型\"],\"viewer.visibility.title\":[\"可见性\"],\"viewer.walkthrough.label\":[\"漫游：\",[\"state\"]],\"viewer.walls.cutaway\":[\"剖切墙\"],\"viewer.walls.fullHeight\":[\"全高墙\"],\"viewer.walls.label\":[\"墙体：\",[\"mode\"]],\"viewer.walls.low\":[\"矮墙\"]}")as Messages;

package/src/i18n/locales.test.ts

@@ -0,0 +1,63 @@
+import { afterEach, expect, test } from 'bun:test'
+import { createI18n, setLocale, translate } from '@pascal-app/core'
+import { authoredLevelName, localizedLevelName } from './level-name'
+import { registerBundledLocales } from './locales'
+
+afterEach(() => setLocale('en'))
+
+test('bundled locale packs cover the converted viewer and editor surfaces', () => {
+  registerBundledLocales()
+
+  const expectations = {
+    'zh-CN': ['显示设置', '房间'],
+    fr: ['Paramètres d’affichage', 'Pièces'],
+    es: ['Ajustes de visualización', 'Estancias'],
+    ja: ['表示設定', '部屋'],
+  } as const
+
+  for (const [locale, [display, rooms]] of Object.entries(expectations)) {
+    setLocale(locale)
+    expect(translate('viewer.display.title', 'Display settings')).toBe(display)
+    expect(translate('editor.buildPanel.rooms.title', 'Rooms')).toBe(rooms)
+  }
+})
+
+test('Simplified Chinese aliases use zh-CN without affecting Traditional Chinese', () => {
+  registerBundledLocales()
+
+  setLocale('zh-Hans')
+  expect(translate('viewer.display.title', 'Display settings')).toBe('显示设置')
+
+  setLocale('zh-Hans-CN')
+  expect(translate('viewer.display.title', 'Display settings')).toBe('显示设置')
+
+  setLocale('zh-Hant')
+  expect(translate('viewer.display.title', 'Display settings')).toBe('Display settings')
+
+  setLocale('zh-TW')
+  expect(translate('viewer.display.title', 'Display settings')).toBe('Display settings')
+})
+
+test('generated stored level names localize while authored names remain unchanged', () => {
+  registerBundledLocales()
+  const french = createI18n({ locale: 'fr' })
+  const japanese = createI18n({ locale: 'ja' })
+  try {
+    expect(localizedLevelName({ level: 0, name: 'Ground floor' }, french, 'fr')).toBe(
+      'Rez-de-chaussée',
+    )
+    expect(localizedLevelName({ level: 1, name: 'Floor 1' }, french, 'fr')).toBe('Étage 1')
+    expect(localizedLevelName({ level: 1, name: 'Floor 1' }, japanese, 'ja')).toBe('2階')
+    expect(localizedLevelName({ level: 1, name: 'Mezzanine' }, french, 'fr')).toBe('Mezzanine')
+  } finally {
+    french.destroy()
+    japanese.destroy()
+  }
+})
+
+test('a stored default level name is not an authored name, so renaming starts empty', () => {
+  expect(authoredLevelName({ level: 0, name: 'Ground floor' })).toBeUndefined()
+  expect(authoredLevelName({ level: 1, name: 'Level 1' })).toBeUndefined()
+  expect(authoredLevelName({ level: 1 })).toBeUndefined()
+  expect(authoredLevelName({ level: 1, name: ' Mezzanine ' })).toBe('Mezzanine')
+})

package/src/i18n/locales.ts

@@ -0,0 +1,32 @@
+import { type CompiledTranslationMessages, registerCompiledMessages } from '@pascal-app/core'
+import { messages as en } from './locales/en/messages'
+import { messages as es } from './locales/es/messages'
+import { messages as fr } from './locales/fr/messages'
+import { messages as ja } from './locales/ja/messages'
+import { messages as zhCN } from './locales/zh-CN/messages'
+
+export type BundledLocale = 'en' | 'zh-CN' | 'fr' | 'es' | 'ja'
+
+type LocaleCatalog = {
+  locale: BundledLocale
+  messages: CompiledTranslationMessages
+}
+
+export const bundledLocalePacks: Record<BundledLocale, LocaleCatalog> = {
+  en: { locale: 'en', messages: en },
+  'zh-CN': { locale: 'zh-CN', messages: zhCN },
+  fr: { locale: 'fr', messages: fr },
+  es: { locale: 'es', messages: es },
+  ja: { locale: 'ja', messages: ja },
+}
+
+let registered = false
+
+export function registerBundledLocales(): void {
+  if (registered) return
+  registered = true
+
+  for (const catalog of Object.values(bundledLocalePacks)) {
+    registerCompiledMessages(catalog.locale, '', catalog.messages)
+  }
+}

package/src/i18n/message-slot.tsx

@@ -0,0 +1,25 @@
+import type { MessageDescriptor, PascalI18n } from '@pascal-app/core'
+import { Fragment, type ReactNode } from 'react'
+
+const SLOT = '\uE000'
+
+/**
+ * Renders a whole translated sentence with one React element (a bold name, a
+ * link) where the message has `{slot}`, so translators can move it anywhere.
+ */
+export function messageWithSlot(
+  i18n: PascalI18n,
+  descriptor: MessageDescriptor,
+  slot: string,
+  element: ReactNode,
+): ReactNode {
+  const values = { ...descriptor.values, [slot]: SLOT }
+  const text = i18n._(descriptor.id, values, { message: descriptor.message })
+  const parts = text.split(SLOT)
+  return parts.map((part, index) => (
+    <Fragment key={index}>
+      {index > 0 && element}
+      {part}
+    </Fragment>
+  ))
+}

package/src/i18n/node-messages.ts

@@ -0,0 +1,169 @@
+import type { MessageDescriptor, PascalI18n } from '@pascal-app/core'
+import { prettifyEnumValue, prettifyKey } from '../components/ui/panels/parametric-field-utils'
+
+/**
+ * Display copy that node definitions carry (presentation labels, tool hints)
+ * stays English in the definition, because MCP, agents and exports read it.
+ * The editor translates it at display time through IDs derived from the kind
+ * and the English text. `scripts/i18n-node-messages.ts` generates the matching
+ * descriptors for every built-in kind so they are extracted and translated; a
+ * plugin kind can ship the same IDs with `registerMessages`, and otherwise
+ * shows its own English.
+ */
+
+/** Lower-camel slug of up to six words, used in generated message IDs. */
+export function messageSlug(text: string): string {
+  const words = text
+    .replace(/\{(\w+)[^}]*\}/g, ' $1 ')
+    .normalize('NFKD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .match(/[A-Za-z0-9]+/g)
+  if (!words?.length) return 'symbol'
+  const slug = words
+    .slice(0, 6)
+    .map((word, index) => {
+      const lower = word.toLowerCase()
+      return index === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1)
+    })
+    .join('')
+  return /^[0-9]/.test(slug) ? `n${slug}` : slug
+}
+
+/** Definition copy is literal text; braces must not read as ICU arguments. */
+function literal(text: string): string {
+  return text.replace(/[{}]/g, (brace) => `'${brace}'`)
+}
+
+/** `roof-segment` → `roofSegment`. */
+export function nodeKindKey(kind: string): string {
+  return kind.replace(/[-_](\w)/g, (_, letter: string) => letter.toUpperCase())
+}
+
+export function nodeLabelDescriptor(kind: string, english: string): MessageDescriptor {
+  return { id: `node.${nodeKindKey(kind)}.label`, message: literal(english) }
+}
+
+export function nodeDescriptionDescriptor(kind: string, english: string): MessageDescriptor {
+  return { id: `node.${nodeKindKey(kind)}.description`, message: literal(english) }
+}
+
+/**
+ * Short FNV-1a hash of the whole message. Hint IDs end with it, so two hints
+ * whose first six words agree (a plugin's and a built-in's) never share an ID
+ * and so never share a translation.
+ */
+function messageHash(message: string): string {
+  let hash = 0x811c9dc5
+  for (let index = 0; index < message.length; index += 1) {
+    hash ^= message.charCodeAt(index)
+    hash = Math.imul(hash, 0x01000193)
+  }
+  return (hash >>> 0).toString(36)
+}
+
+function hintMessage(message: string): MessageDescriptor {
+  return { id: `editor.toolHint.${messageSlug(message)}.${messageHash(message)}`, message }
+}
+
+export function toolHintDescriptor(english: string): MessageDescriptor {
+  return hintMessage(literal(english))
+}
+
+/**
+ * A chip label for one chip value. Labels that spell out a numeric value
+ * ("Cuts: 3, even") share one message with the number as `{value}`.
+ */
+export function toolHintChipDescriptor(
+  value: string,
+  label: string,
+): { descriptor: MessageDescriptor; values?: { value: string } } {
+  if (/^\d+$/.test(value) && new RegExp(`\\b${value}\\b`).test(label)) {
+    const message = literal(label).replace(new RegExp(`\\b${value}\\b`), '{value}')
+    return { descriptor: hintMessage(message), values: { value } }
+  }
+  return { descriptor: toolHintDescriptor(label) }
+}
+
+export function toolHintChipLabel(value: string, label: string, i18n: PascalI18n): string {
+  const { descriptor, values } = toolHintChipDescriptor(value, label)
+  return i18n._({ ...descriptor, values })
+}
+
+/**
+ * Gesture and key names the HUD and shortcut tokens print, beyond those the
+ * built-in definitions name themselves.
+ */
+export const HINT_KEY_NAMES = [
+  'Backspace',
+  'Click',
+  'Command',
+  'Control',
+  'Delete',
+  'Double click',
+  'Drag',
+  'Enter',
+  'Hover',
+  'Left click',
+  'Middle click',
+  'Right click',
+  'Scroll',
+  'Scroll wheel',
+  'Space',
+  'Tab',
+] as const
+
+/** Key or gesture names with words in them ("Left click", "Scroll"); bare keys stay as written. */
+export function toolHintKeyDescriptor(key: string): MessageDescriptor | undefined {
+  if (!/\p{L}{2}/u.test(key) || /^(?:Alt|Ctrl|Cmd|Esc|Shift)$/.test(key)) {
+    return undefined
+  }
+  const message = literal(key)
+  return { id: `editor.toolHint.key.${messageSlug(key)}.${messageHash(message)}`, message }
+}
+
+/**
+ * Auto-inspector copy (`def.parametrics`): group and action labels, and the
+ * field names and enum options it prettifies from keys. Shared across kinds,
+ * so "Dimensions" or "Height" is translated once.
+ */
+function inspectorMessage(scope: 'action' | 'field' | 'group' | 'option', english: string) {
+  const message = literal(english)
+  return {
+    id: `editor.inspector.${scope}.${messageSlug(english)}.${messageHash(message)}`,
+    message,
+  }
+}
+
+export function inspectorGroupDescriptor(label: string): MessageDescriptor {
+  return inspectorMessage('group', label)
+}
+
+export function inspectorActionDescriptor(label: string): MessageDescriptor {
+  return inspectorMessage('action', label)
+}
+
+export function inspectorFieldDescriptor(key: string): MessageDescriptor {
+  return inspectorMessage('field', prettifyKey(key))
+}
+
+export function inspectorOptionDescriptor(value: string): MessageDescriptor {
+  return inspectorMessage('option', prettifyEnumValue(value))
+}
+
+export function nodeLabel(kind: string, english: string, i18n: PascalI18n): string {
+  return i18n._(nodeLabelDescriptor(kind, english))
+}
+
+export function toolHintLabel(english: string, i18n: PascalI18n): string {
+  return i18n._(toolHintDescriptor(english))
+}
+
+export function toolHintKey(key: string, i18n: PascalI18n): string {
+  const descriptor = toolHintKeyDescriptor(key)
+  return descriptor ? i18n._(descriptor) : key
+}
+
+/** Hint text from a descriptor (editor copy) or English definition copy. */
+export function hintText(value: MessageDescriptor | string, i18n: PascalI18n): string {
+  return typeof value === 'string' ? toolHintLabel(value, i18n) : i18n._(value)
+}

package/src/i18n/pseudo-locale.ts

@@ -0,0 +1,17 @@
+import { registerCompiledMessages } from '@pascal-app/core'
+import { messages } from './locales/en-XA/messages'
+
+export const PSEUDO_LOCALE = 'en-XA'
+
+let registered = false
+
+/**
+ * Registers `en-XA`, the accented and ~30 % longer pseudo-locale generated
+ * from English. It finds untranslated copy and clipping; it is not a language,
+ * so hosts enable it only in development or test builds.
+ */
+export function registerPseudoLocale(): void {
+  if (registered) return
+  registered = true
+  registerCompiledMessages(PSEUDO_LOCALE, '', messages)
+}

package/src/i18n/published-entry.test.ts

@@ -0,0 +1,17 @@
+import { expect, test } from 'bun:test'
+import { createI18n } from '@pascal-app/editor'
+
+test('the published editor entry registers compiled English messages', () => {
+  const i18n = createI18n({ locale: 'en' })
+  try {
+    expect(
+      i18n._({
+        id: 'viewer.levels.label',
+        message: 'Levels: {mode}',
+        values: { mode: 'Stacked' },
+      }),
+    ).toBe('Levels: Stacked')
+  } finally {
+    i18n.destroy()
+  }
+})

package/src/i18n/scene-theme-name.ts

@@ -0,0 +1,16 @@
+import type { PascalI18n } from '@pascal-app/core'
+
+/** Display name of a built-in scene theme; unknown (plugin) themes keep their own name. */
+export function sceneThemeName(id: string, fallback: string, i18n: PascalI18n): string {
+  if (id === 'studio') return i18n._({ id: 'viewer.theme.studio', message: 'Studio' })
+  if (id === 'paper') return i18n._({ id: 'viewer.theme.paper', message: 'Paper' })
+  if (id === 'sunset') return i18n._({ id: 'viewer.theme.sunset', message: 'Sunset' })
+  if (id === 'overcast') return i18n._({ id: 'viewer.theme.overcast', message: 'Overcast' })
+  if (id === 'blueprint') return i18n._({ id: 'viewer.theme.blueprint', message: 'Blueprint' })
+  if (id === 'mediterranean')
+    return i18n._({ id: 'viewer.theme.mediterranean', message: 'Mediterranean' })
+  if (id === 'twilight') return i18n._({ id: 'viewer.theme.twilight', message: 'Twilight' })
+  if (id === 'night') return i18n._({ id: 'viewer.theme.night', message: 'Night' })
+  if (id === 'verdant') return i18n._({ id: 'viewer.theme.verdant', message: 'Verdant' })
+  return fallback
+}