@mdwrk/extension-catalog-hello 1.0.1 → 1.1.0

package/README.md

@@ -1,7 +1,51 @@
-# mdwrk/extension-catalog-hello
+# @mdwrk/extension-catalog-hello
 
-Sample third-party extension package used to prove the external catalog distribution path.
+Sample third-party external extension package used to validate the signed catalog installation path.
 
-This package is intentionally small and self-contained so the generated browser-installable artifact does not depend on any unbundled runtime imports.
+## Manifest and compatibility
 
-It is not bundled into `apps/client`; it is published as a source package and transformed by the CI extension artifact pipeline into a signed external catalog artifact.
+- manifest export: `./manifest`
+- manifest kind: external
+- compatibility declarations: host API, runtime, app, and theme contract ranges are declared in `src/manifest.ts`
+- distribution mode: external signed catalog artifact
+
+## Capabilities
+
+This sample demonstrates a deliberately small capability footprint:
+
+- `view.register`
+- `actionRail.register`
+- `notification.publish`
+- `settings.read`
+
+## Settings schema
+
+The sample manifest includes a minimal settings schema with a single `greeting` string field.
+That keeps the package suitable as a catalog/install/activation fixture without dragging in extra runtime surface area.
+
+## i18n readiness
+
+The manifest uses `I18nLabel` descriptors for display name, description, view title, and action-rail title.
+The shipped catalog sample keeps `en` as the only bundled locale, which is intentional for the minimal external-fixture path.
+
+## Lifecycle and host/runtime tests
+
+- `tests/run-smoke.mjs` validates the manifest export and extension entry shape
+- `tests/integration.mjs` activates the extension against a mock host/runtime context and verifies view registration, action-rail registration, and notification behavior
+
+## Installation / configuration guidance
+
+This package is **not bundled** into `apps/client`.
+It is published as a source package and transformed by the CI catalog/signing pipeline into an external browser-installable artifact.
+Use it when validating:
+
+- external catalog metadata generation
+- signed-manifest verification
+- install/enable/activate flows in the runtime
+- minimal schema-backed settings behavior for external extensions
+
+## API/reference docs
+
+See the generated reference page at:
+
+- `docs/reference/packages/mdwrk-extension-catalog-hello.md`

package/dist/manifest.js

@@ -2,7 +2,7 @@ export const extensionCatalogHelloManifest = {
     manifestVersion: 1,
     id: "external.catalog-hello",
     packageName: "@mdwrk/extension-catalog-hello",
-    version: "1.0.1",
+    version: "1.1.0",
     displayName: {
         defaultMessage: "Catalog Hello",
         key: "manifest.displayName",

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const EXTENSION_CATALOG_HELLO_VERSION = "1.0.1";
+export declare const EXTENSION_CATALOG_HELLO_VERSION = "1.1.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const EXTENSION_CATALOG_HELLO_VERSION = "1.0.1";
+export const EXTENSION_CATALOG_HELLO_VERSION = "1.1.0";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mdwrk/extension-catalog-hello",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "type": "module",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -31,7 +31,7 @@
     "build": "npm run build:deps && tsc -p tsconfig.json",
     "typecheck": "npm run build:deps && tsc --noEmit -p tsconfig.json",
     "lint": "npm run typecheck",
-    "test": "npm run build && node ./tests/run-smoke.mjs",
+    "test": "npm run build && node ./tests/run-smoke.mjs && node ./tests/integration.mjs",
     "prepack": "npm run build"
   },
   "exports": {