docs: describe scalar registry inputs as default

Co-authored-by: neilime <314088+neilime@users.noreply.github.com>

Author: Copilot

.github/workflows/docker-build-images.md

@@ -216,7 +216,7 @@ jobs:
 
 ## Multiple registries
 
-The legacy single-registry format still works:
+The default single-registry format still works:
 
 ```yaml
 with:

.github/workflows/docker-build-images.yml

@@ -17,7 +17,7 @@ on: # yamllint disable-line rule:truthy
       oci-registry:
         description: |
           OCI registry configuration used to pull, push and cache images.
-          Accepts either a registry hostname string (legacy format) or a JSON object.
+          Accepts either a registry hostname string (default format) or a JSON object.
           JSON example: `{"pull":"docker.io","pull:private":"ghcr.io","push":"ghcr.io"}`
           JSON object keys:
           - `pull`: registry used to pull public or default base images
@@ -31,7 +31,7 @@ on: # yamllint disable-line rule:truthy
       oci-registry-username:
         description: |
           Username configuration used to log against OCI registries.
-          Accepts either a single username string (legacy format) or a JSON object using the same keys as `oci-registry`.
+          Accepts either a single username string (default format) or a JSON object using the same keys as `oci-registry`.
           JSON example: `{"pull:private":"my-user","push":"my-user"}`
           See https://github.com/docker/login-action#usage.
         type: string
@@ -115,7 +115,7 @@ on: # yamllint disable-line rule:truthy
       oci-registry-password:
         description: |
           Password or GitHub token (`packages:read` and `packages:write` scopes) configuration used to log against OCI registries.
-          Accepts either a single password/token string (legacy format) or a JSON object using the same keys as `oci-registry`.
+          Accepts either a single password/token string (default format) or a JSON object using the same keys as `oci-registry`.
           JSON example: `{"pull:private":"my-token","push":"my-token"}`
           See https://github.com/docker/login-action#usage.
         required: true

actions/docker/build-image/README.md

@@ -206,7 +206,7 @@ permissions:
 
 ## Multiple registries
 
-The legacy single-registry format still works:
+The default single-registry format still works:
 
 ```yaml
 oci-registry: ghcr.io

actions/docker/build-image/action.yml

@@ -14,7 +14,7 @@ inputs:
   oci-registry:
     description: |
       OCI registry configuration used to pull, push and cache images.
-      Accepts either a registry hostname string (legacy format) or a JSON object.
+      Accepts either a registry hostname string (default format) or a JSON object.
       JSON example: `{"pull":"docker.io","pull:private":"ghcr.io","push":"ghcr.io"}`
       JSON object keys:
       - `pull`: registry used to pull public or default base images
@@ -27,15 +27,15 @@ inputs:
   oci-registry-username:
     description: |
       Username configuration used to log against OCI registries.
-      Accepts either a single username string (legacy format) or a JSON object using the same keys as `oci-registry`.
+      Accepts either a single username string (default format) or a JSON object using the same keys as `oci-registry`.
       JSON example: `{"pull:private":"${{ github.repository_owner }}","push":"${{ github.repository_owner }}"}`
       See https://github.com/docker/login-action#usage.
     default: ${{ github.repository_owner }}
     required: true
   oci-registry-password:
     description: |
       Password or personal access token configuration used to log against OCI registries.
-      Accepts either a single password/token string (legacy format) or a JSON object using the same keys as `oci-registry`.
+      Accepts either a single password/token string (default format) or a JSON object using the same keys as `oci-registry`.
       JSON example: `{"pull:private":"${{ github.token }}","push":"${{ github.token }}"}`
       Can be passed in using `secrets.GITHUB_TOKEN`.
       See https://github.com/docker/login-action#usage.
@@ -199,7 +199,7 @@ runs:
             }
 
             if (typeof parsedValue === 'string') {
-              return { legacy: normalizeString(parsedValue, inputName) };
+              return { scalar: normalizeString(parsedValue, inputName) };
             }
 
             return Object.entries(parsedValue).reduce((roleMap, [key, value]) => {
@@ -213,18 +213,18 @@ runs:
           }
 
           function resolveCredentialByRole(credentialMap, role, registry, pushRegistry) {
-            const legacyCredential = credentialMap.legacy ?? '';
+            const defaultCredential = credentialMap.scalar ?? '';
 
             if (role === 'push') {
-              return credentialMap.push ?? legacyCredential;
+              return credentialMap.push ?? defaultCredential;
             }
 
             if (role === 'cache') {
-              return credentialMap.cache ?? credentialMap.push ?? legacyCredential;
+              return credentialMap.cache ?? credentialMap.push ?? defaultCredential;
             }
 
             if (!isPullRole(role)) {
-              return legacyCredential;
+              return defaultCredential;
             }
 
             if (credentialMap[role] !== undefined) {
@@ -239,7 +239,7 @@ runs:
               return credentialMap.push;
             }
 
-            return legacyCredential;
+            return defaultCredential;
           }
 
           const registryInput = normalizeRoleMapInput('oci-registry', `${{ inputs.oci-registry }}`);
@@ -249,8 +249,8 @@ runs:
           let pullRegistryEntries = [];
           let pullRegistries = [];
 
-          if (registryInput.legacy) {
-            pushRegistry = registryInput.legacy;
+          if (registryInput.scalar) {
+            pushRegistry = registryInput.scalar;
             cacheRegistry = pushRegistry;
             pullRegistries = [pushRegistry];
           } else {

actions/docker/create-images-manifests/README.md

@@ -142,7 +142,7 @@ permissions:
 
 ## Multiple registries
 
-The legacy single-registry format still works:
+The default single-registry format still works:
 
 ```yaml
 oci-registry: ghcr.io

actions/docker/create-images-manifests/action.yml

@@ -14,7 +14,7 @@ inputs:
   oci-registry:
     description: |
       OCI registry configuration used to pull, push and cache images.
-      Accepts either a registry hostname string (legacy format) or a JSON object.
+      Accepts either a registry hostname string (default format) or a JSON object.
       JSON example: `{"pull":"docker.io","pull:private":"ghcr.io","push":"ghcr.io"}`
       JSON object keys:
       - `pull`: registry used to pull public or default base images
@@ -26,15 +26,15 @@ inputs:
   oci-registry-username:
     description: |
       Username configuration used to log against OCI registries.
-      Accepts either a single username string (legacy format) or a JSON object using the same keys as `oci-registry`.
+      Accepts either a single username string (default format) or a JSON object using the same keys as `oci-registry`.
       JSON example: `{"pull:private":"${{ github.repository_owner }}","push":"${{ github.repository_owner }}"}`
       See https://github.com/docker/login-action#usage.
     default: ${{ github.repository_owner }}
     required: true
   oci-registry-password:
     description: |
       Password or personal access token configuration used to log against OCI registries.
-      Accepts either a single password/token string (legacy format) or a JSON object using the same keys as `oci-registry`.
+      Accepts either a single password/token string (default format) or a JSON object using the same keys as `oci-registry`.
       JSON example: `{"pull:private":"${{ github.token }}","push":"${{ github.token }}"}`
       Can be passed in using `secrets.GITHUB_TOKEN`.
       See https://github.com/docker/login-action#usage.
@@ -157,7 +157,7 @@ runs:
             }
 
             if (typeof parsedValue === 'string') {
-              return { legacy: normalizeString(parsedValue, inputName) };
+              return { scalar: normalizeString(parsedValue, inputName) };
             }
 
             return Object.entries(parsedValue).reduce((roleMap, [key, value]) => {
@@ -171,7 +171,7 @@ runs:
           }
 
           function resolvePushCredential(credentialMap) {
-            return credentialMap.push ?? credentialMap.legacy ?? '';
+            return credentialMap.push ?? credentialMap.scalar ?? '';
           }
 
           const builtImagesInput = `${{ inputs.built-images }}`;
@@ -207,8 +207,8 @@ runs:
           if (!registries.length) {
             const registryInputName = ['oci', 'registry'].join('-');
             const registryInput = normalizeRoleMapInput(registryInputName, `${{ inputs.oci-registry }}`);
-            if (registryInput.legacy) {
-              registries.push(registryInput.legacy);
+            if (registryInput.scalar) {
+              registries.push(registryInput.scalar);
             } else {
               const [, firstPullRegistryValue] = Object.entries(registryInput).find(([key]) => isPullRole(key)) ?? [];
               const pushRegistry = registryInput.push ?? registryInput.cache ?? firstPullRegistryValue ?? '';