@chill-sharp/ui-core 1.1.12 → 1.1.15

package/template-customization/upgrade.ps1.template

@@ -1,342 +0,0 @@
-[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

@@ -1,271 +0,0 @@
-#!/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'