@chill-sharp/ui-core 1.1.12

package/template-customization/upgrade.ps1.template

@@ -0,0 +1,342 @@
+[CmdletBinding()]
+param(
+  [string]$SharedFolder = 'C:\source\npm-shared',
+  [switch]$SkipConfirmation
+)
+
+$ErrorActionPreference = 'Stop'
+Set-StrictMode -Version Latest
+
+$UpgradeScriptVersion = 3
+$scriptDirectory = Split-Path -Parent $MyInvocation.MyCommand.Path
+$packageJsonPath = Join-Path $scriptDirectory 'package.json'
+$packagesFolder = Join-Path $scriptDirectory 'packages'
+
+function Resolve-ConfirmedFolderPath {
+  param(
+    [Parameter(Mandatory = $true)]
+    [string]$InitialPath,
+
+    [Parameter(Mandatory = $true)]
+    [string]$Label,
+
+    [switch]$SkipPrompt
+  )
+
+  $selectedPath = $InitialPath
+
+  if (-not $SkipPrompt) {
+    Write-Host "$Label shared folder suggestion: $InitialPath"
+    $enteredPath = [string](Read-Host 'Press Enter to confirm, or type a different path')
+    if (-not [string]::IsNullOrWhiteSpace($enteredPath)) {
+      $selectedPath = $enteredPath
+    }
+
+    $confirmation = [string](Read-Host "Continue with '$selectedPath'? [Y/n]")
+    if (-not [string]::IsNullOrWhiteSpace($confirmation) -and $confirmation -notmatch '^(?i:y|yes)$') {
+      Write-Host 'Upgrade cancelled.'
+      exit 0
+    }
+  }
+
+  if (-not (Test-Path -LiteralPath $selectedPath)) {
+    throw "$Label shared folder '$selectedPath' was not found."
+  }
+
+  return [System.IO.Path]::GetFullPath($selectedPath)
+}
+
+function Get-LatestArchive {
+  param(
+    [Parameter(Mandatory = $true)]
+    [string]$FolderPath,
+
+    [Parameter(Mandatory = $true)]
+    [string]$ArchivePrefix
+  )
+
+  $pattern = '^' + [System.Text.RegularExpressions.Regex]::Escape($ArchivePrefix) + '-(?<Version>\d+\.\d+\.\d+(?:[-+][0-9A-Za-z\.-]+)?)\.tgz$'
+
+  $candidates = foreach ($file in Get-ChildItem -LiteralPath $FolderPath -Filter "$ArchivePrefix-*.tgz" -File -ErrorAction Stop) {
+    if ($file.Name -notmatch $pattern) {
+      continue
+    }
+
+    [pscustomobject]@{
+      File = $file
+      VersionText = $matches.Version
+      Version = [System.Management.Automation.SemanticVersion]::Parse($matches.Version)
+    }
+  }
+
+  $latestArchive = $candidates | Sort-Object Version -Descending | Select-Object -First 1
+  if ($null -eq $latestArchive) {
+    throw "Could not find a '$ArchivePrefix-<version>.tgz' archive in '$FolderPath'."
+  }
+
+  return $latestArchive
+}
+
+function Test-CommandAvailable {
+  param(
+    [Parameter(Mandatory = $true)]
+    [string]$CommandName
+  )
+
+  return $null -ne (Get-Command $CommandName -ErrorAction SilentlyContinue)
+}
+
+function Update-UpgradeScriptIfNewer {
+  param(
+    [Parameter(Mandatory = $true)]
+    [string]$ArchivePath,
+
+    [Parameter(Mandatory = $true)]
+    [string]$ScriptPath
+  )
+
+  $temporaryScriptPath = [System.IO.Path]::GetTempFileName()
+  Add-Type -AssemblyName System.Formats.Tar
+  $fileStream = [System.IO.File]::OpenRead($ArchivePath)
+  $gzipStream = [System.IO.Compression.GZipStream]::new($fileStream, [System.IO.Compression.CompressionMode]::Decompress)
+  $tarReader = [System.Formats.Tar.TarReader]::new($gzipStream)
+  try {
+    $entry = $null
+    while ($null -ne ($entry = $tarReader.GetNextEntry($false))) {
+      if ($entry.Name -ne 'package/template-customization/upgrade.ps1.template') {
+        continue
+      }
+
+      $outputStream = [System.IO.File]::Open($temporaryScriptPath, [System.IO.FileMode]::Create, [System.IO.FileAccess]::Write)
+      try {
+        $entry.DataStream.CopyTo($outputStream)
+      }
+      finally {
+        $outputStream.Dispose()
+      }
+      $packagedContents = Get-Content -LiteralPath $temporaryScriptPath -Raw
+      $versionMatch = [System.Text.RegularExpressions.Regex]::Match(
+        $packagedContents,
+        '(?m)^\s*\$UpgradeScriptVersion\s*=\s*(?<Version>\d+)\s*$')
+      if (-not $versionMatch.Success) {
+        throw "The packaged upgrade script does not define a valid `$UpgradeScriptVersion."
+      }
+
+      $packagedVersion = [int]$versionMatch.Groups['Version'].Value
+      if ($packagedVersion -le $UpgradeScriptVersion) {
+        return $false
+      }
+
+      Copy-Item -LiteralPath $temporaryScriptPath -Destination $ScriptPath -Force
+      Write-Host "Updated upgrade.ps1 from internal version $UpgradeScriptVersion to $packagedVersion. Rerun the script to continue the package upgrade."
+      return $true
+    }
+
+    return $false
+  }
+  finally {
+    $tarReader.Dispose()
+    $gzipStream.Dispose()
+    $fileStream.Dispose()
+    if (Test-Path -LiteralPath $temporaryScriptPath) {
+      Remove-Item -LiteralPath $temporaryScriptPath -Force
+    }
+  }
+}
+
+function Extract-ChillSharpUiTemplateSkills {
+  param(
+    [Parameter(Mandatory = $true)]
+    [string]$ArchivePath,
+
+    [Parameter(Mandatory = $true)]
+    [string]$TargetFolder
+  )
+
+  $agentsDir = Join-Path $TargetFolder '.agents'
+  $skillsTargetDir = Join-Path $agentsDir 'skills'
+  if (Test-Path -LiteralPath $skillsTargetDir) {
+    Remove-Item -LiteralPath $skillsTargetDir -Recurse -Force | Out-Null
+  }
+  New-Item -ItemType Directory -Path $skillsTargetDir -Force | Out-Null
+  $skillsTargetRoot = [System.IO.Path]::GetFullPath($skillsTargetDir)
+
+  Add-Type -AssemblyName System.Formats.Tar
+  $fileStream = [System.IO.File]::OpenRead($ArchivePath)
+  $gzipStream = [System.IO.Compression.GZipStream]::new($fileStream, [System.IO.Compression.CompressionMode]::Decompress)
+  $tarReader = [System.Formats.Tar.TarReader]::new($gzipStream)
+  try {
+    $entry = $null
+    $entryPrefix = 'package/.agents/skills/'
+    while ($null -ne ($entry = $tarReader.GetNextEntry($false))) {
+      if (-not $entry.Name.StartsWith($entryPrefix, [System.StringComparison]::Ordinal)) {
+        continue
+      }
+
+      $relativePath = $entry.Name.Substring($entryPrefix.Length)
+      if ([string]::IsNullOrWhiteSpace($relativePath) -or $entry.EntryType -eq [System.Formats.Tar.TarEntryType]::Directory) {
+        continue
+      }
+
+      $destinationPath = [System.IO.Path]::GetFullPath((Join-Path $skillsTargetRoot ($relativePath -replace '/', [System.IO.Path]::DirectorySeparatorChar)))
+      if (-not $destinationPath.StartsWith($skillsTargetRoot + [System.IO.Path]::DirectorySeparatorChar, [System.StringComparison]::OrdinalIgnoreCase)) {
+        throw "Refusing to extract skill outside '$skillsTargetRoot'."
+      }
+      $destinationDirectory = Split-Path -Parent $destinationPath
+      New-Item -ItemType Directory -Path $destinationDirectory -Force | Out-Null
+      $outputStream = [System.IO.File]::Open($destinationPath, [System.IO.FileMode]::Create, [System.IO.FileAccess]::Write)
+      try {
+        $entry.DataStream.CopyTo($outputStream)
+      }
+      finally {
+        $outputStream.Dispose()
+      }
+    }
+  }
+  finally {
+    $tarReader.Dispose()
+    $gzipStream.Dispose()
+    $fileStream.Dispose()
+  }
+}
+
+function Extract-ChillSharpUiTemplateDocumentation {
+  param(
+    [Parameter(Mandatory = $true)]
+    [string]$ArchivePath,
+
+    [Parameter(Mandatory = $true)]
+    [string]$TargetFolder
+  )
+
+  $documentationTargetDir = Join-Path $TargetFolder 'doc'
+  if (Test-Path -LiteralPath $documentationTargetDir) {
+    Remove-Item -LiteralPath $documentationTargetDir -Recurse -Force | Out-Null
+  }
+  New-Item -ItemType Directory -Path $documentationTargetDir | Out-Null
+  $documentationTargetRoot = [System.IO.Path]::GetFullPath($documentationTargetDir)
+
+  Add-Type -AssemblyName System.Formats.Tar
+  $fileStream = [System.IO.File]::OpenRead($ArchivePath)
+  $gzipStream = [System.IO.Compression.GZipStream]::new($fileStream, [System.IO.Compression.CompressionMode]::Decompress)
+  $tarReader = [System.Formats.Tar.TarReader]::new($gzipStream)
+  try {
+    $entry = $null
+    $entryPrefix = 'package/doc/'
+    while ($null -ne ($entry = $tarReader.GetNextEntry($false))) {
+      if (-not $entry.Name.StartsWith($entryPrefix, [System.StringComparison]::Ordinal)) {
+        continue
+      }
+
+      $relativePath = $entry.Name.Substring($entryPrefix.Length)
+      if ([string]::IsNullOrWhiteSpace($relativePath)) {
+        continue
+      }
+
+      $destinationPath = [System.IO.Path]::GetFullPath((Join-Path $documentationTargetRoot ($relativePath -replace '/', [System.IO.Path]::DirectorySeparatorChar)))
+      if (-not $destinationPath.StartsWith($documentationTargetRoot + [System.IO.Path]::DirectorySeparatorChar, [System.StringComparison]::OrdinalIgnoreCase)) {
+        throw "Refusing to extract documentation outside '$documentationTargetRoot'."
+      }
+
+      if ($entry.EntryType -eq [System.Formats.Tar.TarEntryType]::Directory) {
+        New-Item -ItemType Directory -Path $destinationPath -Force | Out-Null
+        continue
+      }
+
+      $destinationDirectory = Split-Path -Parent $destinationPath
+      New-Item -ItemType Directory -Path $destinationDirectory -Force | Out-Null
+      $outputStream = [System.IO.File]::Open($destinationPath, [System.IO.FileMode]::Create, [System.IO.FileAccess]::Write)
+      try {
+        $entry.DataStream.CopyTo($outputStream)
+      }
+      finally {
+        $outputStream.Dispose()
+      }
+    }
+  }
+  finally {
+    $tarReader.Dispose()
+    $gzipStream.Dispose()
+    $fileStream.Dispose()
+  }
+}
+
+if (-not (Test-Path -LiteralPath $packageJsonPath)) {
+  throw "Could not find package.json at '$packageJsonPath'."
+}
+
+if (-not (Test-Path -LiteralPath $packagesFolder)) {
+  New-Item -ItemType Directory -Path $packagesFolder | Out-Null
+}
+
+$resolvedSharedFolder = Resolve-ConfirmedFolderPath -InitialPath $SharedFolder -Label 'npm' -SkipPrompt:$SkipConfirmation
+
+$latestUiCoreArchive = Get-LatestArchive -FolderPath $resolvedSharedFolder -ArchivePrefix 'chill-sharp-ui-core'
+if (Update-UpgradeScriptIfNewer -ArchivePath $latestUiCoreArchive.File.FullName -ScriptPath $MyInvocation.MyCommand.Path) {
+  exit 0
+}
+Extract-ChillSharpUiTemplateSkills -ArchivePath $latestUiCoreArchive.File.FullName -TargetFolder $scriptDirectory
+Extract-ChillSharpUiTemplateDocumentation -ArchivePath $latestUiCoreArchive.File.FullName -TargetFolder $scriptDirectory
+
+$packageDefinitions = @(
+  [pscustomobject]@{ PackageName = '@chill-sharp/ui-core'; ArchivePrefix = 'chill-sharp-ui-core' }
+  [pscustomobject]@{ PackageName = '@chill-sharp/ng-client'; ArchivePrefix = 'chill-sharp-ng-client' }
+  [pscustomobject]@{ PackageName = '@chill-sharp/ts-client'; ArchivePrefix = 'chill-sharp-ts-client' }
+)
+
+$packageJson = Get-Content -LiteralPath $packageJsonPath -Raw | ConvertFrom-Json
+if ($null -eq $packageJson.dependencies) {
+  throw "package.json at '$packageJsonPath' does not define a dependencies object."
+}
+
+foreach ($definition in $packageDefinitions) {
+  $latestArchive = Get-LatestArchive -FolderPath $resolvedSharedFolder -ArchivePrefix $definition.ArchivePrefix
+  $destinationArchivePath = Join-Path $packagesFolder $latestArchive.File.Name
+
+  foreach ($existingArchive in Get-ChildItem -LiteralPath $packagesFolder -Filter "$($definition.ArchivePrefix)-*.tgz" -File -ErrorAction SilentlyContinue) {
+    if (-not $existingArchive.FullName.Equals($destinationArchivePath, [System.StringComparison]::OrdinalIgnoreCase)) {
+      Remove-Item -LiteralPath $existingArchive.FullName -Force
+    }
+  }
+
+  Copy-Item -LiteralPath $latestArchive.File.FullName -Destination $destinationArchivePath -Force
+  $packageJson.dependencies | Add-Member -NotePropertyName $definition.PackageName -NotePropertyValue "file:./packages/$($latestArchive.File.Name)" -Force
+
+  Write-Host "Copied $($definition.PackageName) $($latestArchive.VersionText) to '$destinationArchivePath'."
+}
+
+$packageJson | ConvertTo-Json -Depth 100 | Set-Content -LiteralPath $packageJsonPath
+
+if (Test-CommandAvailable -CommandName 'npm') {
+  $packageLockPath = Join-Path $scriptDirectory 'package-lock.json'
+  $packageLockBackupPath = "$packageLockPath.chill-sharp-upgrade.bak"
+  $hadPackageLock = Test-Path -LiteralPath $packageLockPath
+  if ($hadPackageLock) {
+    Copy-Item -LiteralPath $packageLockPath -Destination $packageLockBackupPath -Force
+    Remove-Item -LiteralPath $packageLockPath -Force
+  }
+
+  Write-Host 'Refreshing package-lock.json and local file dependencies with npm install --ignore-scripts...'
+  Push-Location $scriptDirectory
+  try {
+    & npm install --ignore-scripts
+    if ($LASTEXITCODE -ne 0) {
+      if ($hadPackageLock -and (Test-Path -LiteralPath $packageLockBackupPath)) {
+        Move-Item -LiteralPath $packageLockBackupPath -Destination $packageLockPath -Force
+      }
+      Write-Warning 'npm install --ignore-scripts did not complete successfully. Local archives were copied, but package-lock.json and node_modules may still need a manual refresh.'
+    }
+    elseif (Test-Path -LiteralPath $packageLockBackupPath) {
+      Remove-Item -LiteralPath $packageLockBackupPath -Force
+    }
+  }
+  finally {
+    Pop-Location
+  }
+}
+else {
+  Write-Warning "npm was not found on PATH. Local archives were copied, but package-lock.json was not refreshed."
+}
+
+Write-Host 'UI template dependencies were upgraded from the shared npm folder.'
+Write-Host "Extracted and updated documentation in 'doc/'."

package/template-customization/upgrade.sh.template

@@ -0,0 +1,271 @@
+#!/usr/bin/env bash
+set -Eeuo pipefail
+
+upgrade_script_version=2
+script_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
+package_json_path="$script_dir/package.json"
+packages_folder="$script_dir/packages"
+shared_folder="${CHILL_NPM_SHARED_FOLDER:-$HOME/source/npm-shared}"
+env_file="${CHILL_ENV_FILE:-$HOME/.profile}"
+skip_confirmation=false
+resolved_shared_folder=''
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --shared-folder|-s)
+      shared_folder="${2:-}"
+      shift 2
+      ;;
+    --skip-confirmation|-y)
+      skip_confirmation=true
+      shift
+      ;;
+    *)
+      printf "Error: Unknown argument '%s'.\n" "$1" >&2
+      exit 1
+      ;;
+  esac
+done
+
+die() {
+  printf 'Error: %s\n' "$*" >&2
+  exit 1
+}
+
+warn() {
+  printf 'Warning: %s\n' "$*" >&2
+}
+
+require_command() {
+  command -v "$1" >/dev/null 2>&1 || die "Required command '$1' was not found."
+}
+
+normalize_path() {
+  python3 -c 'import os, sys; print(os.path.abspath(sys.argv[1]))' "$1"
+}
+
+shell_quote() {
+  local value="$1"
+  printf "'%s'" "${value//\'/\'\\\'\'}"
+}
+
+persist_user_env_var() {
+  local name="$1"
+  local value="$2"
+  local quoted_value temp_file
+
+  quoted_value="$(shell_quote "$value")"
+  mkdir -p -- "$(dirname -- "$env_file")"
+  touch "$env_file"
+
+  temp_file="$(mktemp)"
+  awk -v name="$name" '
+    $0 ~ "^[[:space:]]*export[[:space:]]+" name "=" { next }
+    $0 ~ "^[[:space:]]*" name "=" { next }
+    { print }
+  ' "$env_file" > "$temp_file"
+  printf 'export %s=%s\n' "$name" "$quoted_value" >> "$temp_file"
+  mv -- "$temp_file" "$env_file"
+}
+
+resolve_confirmed_shared_folder() {
+  local selected_path="$shared_folder"
+  local entered_path confirmation
+
+  if [[ "$skip_confirmation" == false ]]; then
+    printf 'npm shared folder suggestion: %s\n' "$selected_path" >&2
+    read -r -p 'Press Enter to confirm, or type a different path: ' entered_path
+    if [[ -n "${entered_path//[[:space:]]/}" ]]; then
+      selected_path="$entered_path"
+    fi
+
+    read -r -p "Continue with '$selected_path'? [Y/n]: " confirmation
+    if [[ -n "${confirmation//[[:space:]]/}" && ! "$confirmation" =~ ^[Yy]([Ee][Ss])?$ ]]; then
+      printf 'Upgrade cancelled.\n' >&2
+      exit 0
+    fi
+  fi
+
+  selected_path="$(normalize_path "$selected_path")"
+  [[ -d "$selected_path" ]] || die "npm shared folder '$selected_path' was not found."
+
+  export CHILL_NPM_SHARED_FOLDER="$selected_path"
+  persist_user_env_var CHILL_NPM_SHARED_FOLDER "$selected_path"
+
+  resolved_shared_folder="$selected_path"
+}
+
+latest_archive_line() {
+  local folder_path="$1"
+  local archive_prefix="$2"
+
+  find "$folder_path" -maxdepth 1 -type f -name "$archive_prefix-*.tgz" -printf '%f\t%p\n' |
+    sed -n "s/^$archive_prefix-\([0-9][0-9]*\.[0-9][0-9]*\.[0-9][0-9]*[-+0-9A-Za-z.]*\)\.tgz\t/\1\t/p" |
+    sort -V -r |
+    head -n 1
+}
+
+set_package_dependency() {
+  local package_name="$1"
+  local dependency_spec="$2"
+  local temp_json
+
+  jq -e '.dependencies | type == "object"' "$package_json_path" >/dev/null ||
+    die "package.json at '$package_json_path' does not define a dependencies object."
+
+  temp_json="$(mktemp)"
+  jq --arg name "$package_name" --arg spec "$dependency_spec" \
+    '.dependencies[$name] = $spec' \
+    "$package_json_path" > "$temp_json"
+  mv -- "$temp_json" "$package_json_path"
+}
+
+copy_latest_package_archive() {
+  local package_name="$1"
+  local archive_prefix="$2"
+  local latest_line package_version source_archive_path destination_archive_path
+
+  latest_line="$(latest_archive_line "$resolved_shared_folder" "$archive_prefix")"
+  [[ -n "$latest_line" ]] ||
+    die "Could not find a '$archive_prefix-<version>.tgz' archive in '$resolved_shared_folder'."
+
+  IFS=$'\t' read -r package_version source_archive_path <<<"$latest_line"
+  destination_archive_path="$packages_folder/$(basename -- "$source_archive_path")"
+
+  while IFS= read -r -d '' existing_archive; do
+    if [[ "$(normalize_path "$existing_archive")" != "$(normalize_path "$destination_archive_path")" ]]; then
+      rm -f -- "$existing_archive"
+    fi
+  done < <(find "$packages_folder" -maxdepth 1 -type f -name "$archive_prefix-*.tgz" -print0)
+
+  cp -f -- "$source_archive_path" "$destination_archive_path"
+  set_package_dependency "$package_name" "file:./packages/$(basename -- "$destination_archive_path")"
+
+  printf "Copied %s %s to '%s'.\n" "$package_name" "$package_version" "$destination_archive_path"
+}
+
+update_upgrade_script_if_newer() {
+  local archive_path="$1"
+  local script_path="$2"
+
+  python3 -c '
+import os, re, stat, sys, tarfile, tempfile
+
+archive_path, script_path, current_version = sys.argv[1], sys.argv[2], int(sys.argv[3])
+entry_name = "package/template-customization/upgrade.sh.template"
+
+with tarfile.open(archive_path, "r:gz") as archive:
+    try:
+        entry = archive.getmember(entry_name)
+    except KeyError:
+        sys.exit(0)
+    contents = archive.extractfile(entry).read().decode("utf-8")
+
+match = re.search(r"(?m)^\\s*upgrade_script_version\\s*=\\s*(\\d+)\\s*$", contents)
+if match is None:
+    raise RuntimeError("The packaged upgrade script does not define a valid upgrade_script_version.")
+
+packaged_version = int(match.group(1))
+if packaged_version <= current_version:
+    sys.exit(0)
+
+script_dir = os.path.dirname(os.path.abspath(script_path))
+original_mode = stat.S_IMODE(os.stat(script_path).st_mode)
+fd, temporary_script_path = tempfile.mkstemp(prefix=".upgrade-", dir=script_dir)
+try:
+    with os.fdopen(fd, "w", encoding="utf-8", newline="") as file:
+        file.write(contents)
+    os.chmod(temporary_script_path, original_mode)
+    os.replace(temporary_script_path, script_path)
+finally:
+    if os.path.exists(temporary_script_path):
+        os.unlink(temporary_script_path)
+
+print(f"Updated upgrade.sh from internal version {current_version} to {packaged_version}. Rerun the script to continue the package upgrade.")
+sys.exit(10)
+' "$archive_path" "$script_path" "$upgrade_script_version"
+}
+
+extract_chillsharp_ui_template_skills() {
+  local archive_path="$1"
+  local target_folder="$2"
+
+  python3 -c '
+import os, shutil, sys, tarfile
+
+archive_path, target_folder = sys.argv[1], sys.argv[2]
+skills_dir = os.path.join(target_folder, ".agents", "skills")
+skills_root = os.path.abspath(skills_dir)
+prefix = "package/.agents/skills/"
+
+if os.path.exists(skills_dir):
+    shutil.rmtree(skills_dir)
+os.makedirs(skills_dir, exist_ok=True)
+
+with tarfile.open(archive_path, "r:gz") as archive:
+    for entry in archive.getmembers():
+        if not entry.isfile() or not entry.name.startswith(prefix):
+            continue
+        relative_path = entry.name[len(prefix):]
+        destination = os.path.abspath(os.path.join(skills_root, relative_path))
+        if os.path.commonpath((skills_root, destination)) != skills_root:
+            raise RuntimeError(f"Refusing to extract outside the skills folder: {entry.name}")
+        os.makedirs(os.path.dirname(destination), exist_ok=True)
+        with archive.extractfile(entry) as source, open(destination, "wb") as output:
+            shutil.copyfileobj(source, output)
+' "$archive_path" "$target_folder"
+}
+
+require_command python3
+require_command jq
+
+[[ -f "$package_json_path" ]] || die "Could not find package.json at '$package_json_path'."
+mkdir -p -- "$packages_folder"
+
+resolve_confirmed_shared_folder
+
+latest_ui_core_line="$(latest_archive_line "$resolved_shared_folder" 'chill-sharp-ui-core')"
+[[ -n "$latest_ui_core_line" ]] ||
+  die "Could not find a 'chill-sharp-ui-core-<version>.tgz' archive in '$resolved_shared_folder'."
+IFS=$'\t' read -r _latest_ui_core_version latest_ui_core_archive_path <<<"$latest_ui_core_line"
+if update_upgrade_script_if_newer "$latest_ui_core_archive_path" "${BASH_SOURCE[0]}"; then
+  :
+else
+  update_status=$?
+  if [[ "$update_status" -eq 10 ]]; then
+    exit 0
+  fi
+  die 'Could not update upgrade.sh from the UI core package.'
+fi
+extract_chillsharp_ui_template_skills "$latest_ui_core_archive_path" "$script_dir"
+
+copy_latest_package_archive '@chill-sharp/ui-core' 'chill-sharp-ui-core'
+copy_latest_package_archive '@chill-sharp/ng-client' 'chill-sharp-ng-client'
+copy_latest_package_archive '@chill-sharp/ts-client' 'chill-sharp-ts-client'
+
+printf "Saved CHILL_NPM_SHARED_FOLDER to '%s'.\n" "$env_file"
+
+if command -v npm >/dev/null 2>&1; then
+  package_lock_path="$script_dir/package-lock.json"
+  package_lock_backup_path="$package_lock_path.chill-sharp-upgrade.bak"
+  had_package_lock=false
+  if [[ -f "$package_lock_path" ]]; then
+    cp -f -- "$package_lock_path" "$package_lock_backup_path"
+    rm -f -- "$package_lock_path"
+    had_package_lock=true
+  fi
+
+  printf 'Refreshing package-lock.json and local file dependencies with npm install --ignore-scripts...\n'
+  if ! (cd "$script_dir" && npm install --ignore-scripts); then
+    if [[ "$had_package_lock" == true && -f "$package_lock_backup_path" ]]; then
+      mv -f -- "$package_lock_backup_path" "$package_lock_path"
+    fi
+    warn 'npm install --ignore-scripts did not complete successfully. Local archives were copied, but package-lock.json and node_modules may still need a manual refresh.'
+  else
+    rm -f -- "$package_lock_backup_path"
+  fi
+else
+  warn 'npm was not found on PATH. Local archives were copied, but package-lock.json was not refreshed.'
+fi
+
+printf 'UI template dependencies were upgraded from the shared npm folder.\n'