Publish @umbraco-cms/search types-only npm package (#133)

* Publish @umbraco-cms/search types-only npm package

Adds TypeScript declaration publishing for the Core Client so third-party
package authors get type safety when importing @umbraco-cms/search/global
and @umbraco-cms/search/settings.

- tsconfig.types.json: uses emitDeclarationOnly so tsc emits .d.ts files
  into dist-types/ without touching the existing dev/build config
- package.json: renamed to @umbraco-cms/search, made public, added exports
  map (types-only, no JS — runtime resolution stays via Umbraco importmap),
  files: ["dist-types"], peerDependencies for @umbraco-cms/backoffice
- .gitignore: ignores Client/dist-types/
- azure-pipeline.yml: generates declarations, versions with nbgv, packs and
  publishes as npm-types artifact; adds Deploy_Npm stage using npmAuthenticate@0
  with the existing "NPM - Umbraco Backoffice" service connection, matching
  the pattern used in the main CMS pipeline

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Update package-lock.json after renaming Core Client package

npm ci fails when the lock file doesn't match package.json. The
package rename from @umbraco-cms/search-core-client to @umbraco-cms/search
requires a lock file regeneration.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Fix boolean parameter comparison in Deploy_Npm condition

ADO template boolean parameters expand to true/false (lowercase),
so comparing against the string 'True' never matches. Use the
unquoted boolean form instead.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Remove automatic npm deploy trigger on main/release tags

Deploy_Npm now only runs when the npmDeploy parameter is explicitly set
to true, consistent with how NuGet publishing works for this project.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Remove Deploy_Npm stage in favor of release pipeline

The npm publish will be handled by a classic release pipeline configured
in the DevOps UI, consuming the npm-types artifact published by the
build stage.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Run nbgv cloud upfront to set pipeline build number

Installs nbgv right after the .NET SDK setup and runs nbgv cloud so the
pipeline build number reflects the package version. The npm version
step now reuses the already-installed tool to fetch NpmPackageVersion.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Simplify npm pack pipeline steps

- Add prepack script so npm pack always regenerates types, making the
  package self-consistent regardless of who runs it
- Drop the explicit types:generate pipeline step (prepack handles it)
- Merge version + pack into a single bash step with workingDirectory
  pointing directly at the workspace
- Reuse the NBGV_NpmPackageVersion variable set by nbgv cloud instead
  of re-invoking nbgv get-version

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Fix nbgv cloud variable export and pack destination dir

- nbgv cloud needs -a (--all-vars) to expose computed versions as ADO
  pipeline variables; without it, only the build number is updated and
  \$(NBGV_NpmPackageVersion) stays unresolved
- npm pack --pack-destination does not create the target directory, so
  restore the mkdir -p that was incorrectly trimmed

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Expose manifest types, rename Examine workspace, and document npm package

- Re-export ManifestSearchIndexDetailBox + MetaSearchIndexDetailBox from
  @umbraco-cms/search/global so extension authors can both reference the
  manifest type and have searchIndexDetailBox registered on the global
  UmbExtensionManifestMap
- Drop declarationMap from tsconfig.types.json: maps reference src/
  paths that are not shipped, so they cannot resolve in consumer
  node_modules and were dead weight (cuts published file count ~50%)
- Rename the Examine workspace package from @umbraco-cms/search-examine-client
  to @umbraco-cms/search-examine to match the @umbraco-cms/search naming
  even while the package stays private
- Add an installation section to docs/backoffice-extensions.md covering
  the npm package, the two entry points, and the peer dependency

Verified by packing the tarball, installing it in a fresh test project
alongside @umbraco-cms/backoffice, writing a searchIndexDetailBox
extension, and confirming tsc --noEmit passes.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* Type ManifestSearchIndexDetailBox conditions as the full config union

ManifestWithDynamicConditions defaults its conditions array to
UmbConditionConfigBase, which strips away the typed properties contributed
by augmentations like UmbSearchIndexProviderNameConditionConfig. Passing
UmbExtensionConditionConfig (the global union of every registered
condition config) restores narrowing so extension authors can write
\`{ alias: 'Umb.Search.Condition.IndexProviderName', oneOf: [...] }\`
inline without an explicit cast.

Found via end-to-end test against an installed @umbraco-cms/search
tarball.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: iOvergaard

build/azure-pipeline.yml

@@ -37,6 +37,12 @@ stages:
             inputs:
               useGlobalJson: true
 
+          - bash: |
+              dotnet tool install --tool-path . nbgv
+              ./nbgv cloud -a
+            displayName: Set build version using nbgv
+            workingDirectory: src
+
           # Client
           - task: NodeTool@0
             displayName: Use Node.js
@@ -66,6 +72,19 @@ stages:
             displayName: Build Client
             workingDirectory: src
 
+          - bash: |
+              mkdir -p $(Build.ArtifactStagingDirectory)/npm
+              npm version $(NBGV_NpmPackageVersion) --allow-same-version --no-git-tag-version
+              npm pack --pack-destination $(Build.ArtifactStagingDirectory)/npm
+            displayName: Pack npm types package
+            workingDirectory: src/Umbraco.Cms.Search.Core.Client/Client
+
+          - task: PublishPipelineArtifact@1
+            displayName: Publish npm types artifact
+            inputs:
+              targetPath: $(Build.ArtifactStagingDirectory)/npm
+              artifactName: npm-types
+
           # Cache and restore NuGet packages
           - task: Cache@2
             condition: ${{ parameters.cache_nuget }}

src/Umbraco.Cms.Search.Core.Client/.gitignore

@@ -1 +1,2 @@
 wwwroot/App_Plugins/
+Client/dist-types/

src/Umbraco.Cms.Search.Core.Client/Client/package.json

@@ -1,11 +1,24 @@
 {
-  "name": "@umbraco-cms/search-core-client",
-  "private": true,
+  "name": "@umbraco-cms/search",
   "version": "0.0.0",
   "type": "module",
+  "exports": {
+    "./global": {
+      "types": "./dist-types/global/index.d.ts"
+    },
+    "./settings": {
+      "types": "./dist-types/settings/index.d.ts"
+    }
+  },
+  "files": ["dist-types"],
+  "peerDependencies": {
+    "@umbraco-cms/backoffice": ">=17.0.0"
+  },
   "scripts": {
     "watch": "vite build --watch",
     "build": "tsc && vite build",
+    "types:generate": "tsc -p tsconfig.types.json",
+    "prepack": "npm run types:generate",
     "generate-client": "node ../../scripts/generate-openapi.js https://localhost:44324/umbraco/swagger/search/swagger.json src/settings/api",
     "lint": "eslint . --max-warnings 0",
     "lint:fix": "eslint . --fix",

src/Umbraco.Cms.Search.Core.Client/Client/src/bundle/types.ts

@@ -4,7 +4,8 @@ import type {
 } from '@umbraco-cms/backoffice/extension-api';
 
 export interface ManifestSearchIndexDetailBox
-  extends ManifestElement, ManifestWithDynamicConditions {
+  extends ManifestElement,
+    ManifestWithDynamicConditions<UmbExtensionConditionConfig> {
   type: 'searchIndexDetailBox';
   meta?: MetaSearchIndexDetailBox;
 }

src/Umbraco.Cms.Search.Core.Client/Client/src/global/index.ts

@@ -1,2 +1,3 @@
 export * from './constants.js';
 export * from './search.global-context.js';
+export type { ManifestSearchIndexDetailBox, MetaSearchIndexDetailBox } from '../bundle/types.js';

src/Umbraco.Cms.Search.Core.Client/Client/tsconfig.types.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "emitDeclarationOnly": true,
+    "declaration": true,
+    "declarationDir": "dist-types"
+  }
+}

src/Umbraco.Cms.Search.Provider.Examine/Client/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@umbraco-cms/search-examine-client",
+  "name": "@umbraco-cms/search-examine",
   "private": true,
   "version": "0.0.0",
   "type": "module",