altium-toolkit 1.4.11 → 1.4.12

package/docs/release-notes-v1.4.12.md

@@ -0,0 +1,29 @@
+# altium-toolkit 1.4.12
+
+Version 1.4.12 preserves native schematic footer metadata when a project also
+provides document-level special-string parameters.
+
+## Project schematic fidelity
+
+- Project parameters are resolved before the convergence fidelity pass so
+  document context and native fallback metadata compose deterministically.
+- Footer fallback values synchronize the visible text, resolved-text sidecar,
+  and special-string expression before the historical renderer consumes them.
+- Organization, address, approval, and other native owner metadata no longer
+  regress to unresolved placeholders in complete project loads.
+
+## Compatibility
+
+- Historical parser and renderer sources remain byte-for-byte frozen.
+- Existing schematic colors, canvas borders, title-block chrome, and public
+  renderer signatures remain unchanged.
+- Resolution derives from the ownership and parameter data models without
+  project names, filenames, labels, or sample-specific rules.
+
+## Verification
+
+- A repository-owned generic regression covers project parameters combined
+  with native footer metadata fallbacks.
+- The complete package suite, immutable-source checks, feature-preservation
+  check, formatting check, performance guard, and npm package dry run are
+  required for release.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "altium-toolkit",
-    "version": "1.4.11",
+    "version": "1.4.12",
     "description": "Altium document parsing and non-interactive rendering utilities",
     "keywords": [
         "altium",

package/src/convergence/AltiumSchematicFidelityNormalizer.mjs

@@ -214,12 +214,47 @@ export class AltiumSchematicFidelityNormalizer {
             if (!replacement) return text
 
             changed = true
-            return { ...text, text: replacement }
+            return AltiumSchematicFidelityNormalizer.#resolvedFooterText(
+                text,
+                replacement
+            )
         })
 
         return changed ? resolvedTexts : texts
     }
 
+    /**
+     * Synchronizes one footer fallback across the visible text sidecar fields.
+     * @param {Record<string, any>} text Footer text primitive.
+     * @param {string} replacement Resolved native metadata value.
+     * @returns {Record<string, any>} Resolved footer text primitive.
+     */
+    static #resolvedFooterText(text, replacement) {
+        const specialString = text?.specialString
+        const resolvedSpecialString = specialString
+            ? {
+                  ...specialString,
+                  resolvedText: replacement,
+                  expressionParts: Array.isArray(specialString.expressionParts)
+                      ? specialString.expressionParts.map((part) =>
+                            part?.kind === 'parameter'
+                                ? { ...part, value: replacement }
+                                : part
+                        )
+                      : specialString.expressionParts
+              }
+            : specialString
+
+        return {
+            ...text,
+            text: replacement,
+            resolvedText: replacement,
+            ...(resolvedSpecialString
+                ? { specialString: resolvedSpecialString }
+                : {})
+        }
+    }
+
     /**
      * Returns true when an ownership record seeds the lower-right footer.
      * @param {Record<string, any>} record Ownership record.

package/src/convergence/SchematicSvgRenderer.mjs

@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: GPL-3.0-or-later
 
 import { SchematicSvgRenderer as LegacySchematicSvgRenderer } from '../ui/SchematicSvgRenderer.mjs'
+import { SchematicProjectParameterResolver } from '../core/altium/SchematicProjectParameterResolver.mjs'
 import { AltiumSchematicImageNormalizer } from './AltiumSchematicImageNormalizer.mjs'
 import { AltiumSchematicNativeFooterOwnerAligner } from './AltiumSchematicNativeFooterOwnerAligner.mjs'
 import { AltiumSchematicFidelityNormalizer } from './AltiumSchematicFidelityNormalizer.mjs'
@@ -21,17 +22,32 @@ export class SchematicSvgRenderer {
      * @returns {string} Rendered SVG panel markup.
      */
     static render(documentModel, options = {}) {
+        const projectParameters = options.projectParameters
+        const projectResolved = projectParameters
+            ? SchematicProjectParameterResolver.applyToDocumentModel(
+                  documentModel,
+                  projectParameters,
+                  { replaceText: true }
+              )
+            : documentModel
         const normalized =
-            AltiumSchematicImageNormalizer.normalize(documentModel)
+            AltiumSchematicImageNormalizer.normalize(projectResolved)
         const fidelityNormalized =
             AltiumSchematicFidelityNormalizer.normalize(normalized)
         const aligned =
             AltiumSchematicNativeFooterOwnerAligner.align(fidelityNormalized)
         const renderDocument =
             SchematicSvgRenderer.#visibilityAwareDocument(aligned)
+        const legacyOptions = projectParameters
+            ? Object.fromEntries(
+                  Object.entries(options).filter(
+                      ([name]) => name !== 'projectParameters'
+                  )
+              )
+            : options
         const markup = LegacySchematicSvgRenderer.render(
             renderDocument,
-            options
+            legacyOptions
         )
 
         return SchematicSvgRenderer.#injectHarnessMarkup(markup, renderDocument)