@xplortech/apollo-angular 3.2.1 → 3.4.0

package/AGENTS.md

@@ -13,6 +13,7 @@ See the root [AGENTS.md](https://github.com/xplor/apollo/blob/main/AGENTS.md) fo
 | Build | `nx build @xplortech/apollo-angular` |
 | TypeScript compile | `nx tsc @xplortech/apollo-angular` |
 | Tests (smoke) | `nx test @xplortech/apollo-angular` |
+| Tests (SSR runtime) | `nx test:ssr @xplortech/apollo-angular` (requires `nx build @xplortech/apollo-core` and `nx build @xplortech/apollo-angular`) |
 | Clean | `nx clean @xplortech/apollo-angular` |
 | Angular Storybook (dev, port 6007) | `nx storybook @xplortech/apollo-angular` |
 | Angular Storybook (static build) | `nx build:storybook @xplortech/apollo-angular` |
@@ -30,4 +31,21 @@ There is no per-package lint target; lint runs at the workspace level via `npm r
 
 ## CSS proxy files
 
-Committed one-line `@import` proxies under `css/` re-export `@xplortech/apollo-core` modular CSS without an `exports` field (subpaths resolve by file path). Per-component treeshake CSS is **not** proxied — consumers import `@xplortech/apollo-core/css/components/*` directly.
+Committed one-line `@import` proxies under `css/` re-export `@xplortech/apollo-core` modular CSS via the package `exports` map (`./css/*`). Per-component treeshake CSS is **not** proxied — consumers import `@xplortech/apollo-core/css/components/*` directly. SSR helpers (`provideApolloSSR()`) are exported from the root entry — there is no `./server` subpath.
+
+## AI tooling (MCP)
+
+The public Apollo docs expose a **streamable-HTTP MCP server** at `https://platform.xplordocs.com/mcp` (public, unauthenticated) that gives coding agents searchable access to the documentation. To use it in Cursor, add this to your project's `.cursor/mcp.json`:
+
+```json
+{
+    "mcpServers": {
+        "apollo-docs": {
+            "url": "https://platform.xplordocs.com/mcp"
+        }
+    }
+}
+```
+
+- Machine-readable doc indexes: [llms.txt](https://platform.xplordocs.com/llms.txt) and [llms-full.txt](https://platform.xplordocs.com/llms-full.txt)
+- The server covers all Xplor Platform docs; Apollo content lives under `/apollo/`

package/README.md

@@ -7,11 +7,15 @@ Angular bindings for the Apollo design system (`@xplortech/apollo-core` web comp
 Published as **`@xplortech/apollo-angular`** on the public npm registry (same scope as `@xplortech/apollo-core` and `@xplortech/apollo-react`).
 
 ```bash
-npm install @xplortech/apollo-angular @xplortech/apollo-core
+npm install @xplortech/apollo-angular
 ```
 
+`@xplortech/apollo-core` is included as a dependency — you do not need to install both.
+
 Peer dependencies: **Angular 19+**, **RxJS 7+**, and **TypeScript 5+**.
 
+The package `exports` map exposes the root entry (`@xplortech/apollo-angular`), documented `css/*` proxy paths, and `./dist/*` passthroughs for backwards compatibility. There is no separate `./server` subpath — SSR helpers such as `provideApolloSSR()` are exported from the root entry.
+
 Import styles once in your app (path may vary with your bundler):
 
 ```css
@@ -182,6 +186,26 @@ Pass objects and arrays directly as `[propName]` bindings — Angular forwards t
 <xpl-table [data]="rows" [columns]="cols"></xpl-table>
 ```
 
+## Server-side rendering (Angular Universal)
+
+`@stencil/angular-output-target` has no `hydrateModule` option (unlike React and Vue). For Angular Universal, import **`provideApolloSSR()`** from the package root — there is no separate `@xplortech/apollo-angular/server` entry. Add it to your server config alongside `provideServerRendering()`:
+
+```ts
+// app.config.server.ts
+import { mergeApplicationConfig, ApplicationConfig } from '@angular/core';
+import { provideServerRendering } from '@angular/platform-server';
+import { provideApolloSSR } from '@xplortech/apollo-angular';
+import { appConfig } from './app.config';
+
+const serverConfig: ApplicationConfig = {
+  providers: [provideServerRendering(), provideApolloSSR()],
+};
+
+export const config = mergeApplicationConfig(appConfig, serverConfig);
+```
+
+Use the same standalone imports as in the browser (`XplButton`, `XplInput`, `TextValueAccessor`, etc.). SSR HTML will include Stencil-serialized markup on `xpl-*` hosts. `provideApolloSSR()` syncs Angular property bindings (including `[(ngModel)]`) before serialization and sets `ngSkipHydration` on each host so `provideClientHydration()` does not fight Stencil's server markup. See the [SSR guide](https://platform.xplordocs.com/apollo/ssr) for React, Vue, and verification steps.
+
 ## Further reading
 
 - [Apollo repo](https://github.com/xplor/apollo)

package/dist/directives/boolean-value-accessor.d.ts

@@ -1,6 +1,9 @@
 import { ElementRef } from '@angular/core';
 import { ValueAccessor } from './value-accessor';
+import * as i0 from "@angular/core";
 export declare class BooleanValueAccessor extends ValueAccessor {
     constructor(el: ElementRef);
     writeValue(value: any): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BooleanValueAccessor, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<BooleanValueAccessor, "xpl-checkbox, xpl-toggle", never, {}, {}, never, never, true, never>;
 }

package/dist/directives/boolean-value-accessor.js

@@ -1,39 +1,39 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
 import { Directive, ElementRef, forwardRef } from '@angular/core';
 import { NG_VALUE_ACCESSOR } from '@angular/forms';
 import { ValueAccessor } from './value-accessor';
-let BooleanValueAccessor = class BooleanValueAccessor extends ValueAccessor {
+import * as i0 from "@angular/core";
+export class BooleanValueAccessor extends ValueAccessor {
     constructor(el) {
         super(el);
     }
     writeValue(value) {
         this.el.nativeElement.checked = this.lastValue = value == null ? false : value;
     }
-};
-BooleanValueAccessor = __decorate([
-    Directive({
-        selector: 'xpl-checkbox, xpl-toggle',
-        host: {
-            '(checkboxChange)': 'handleChangeEvent($event.detail)',
-            '(toggleChange)': 'handleChangeEvent($event.detail)'
-        },
-        providers: [
-            {
-                provide: NG_VALUE_ACCESSOR,
-                useExisting: forwardRef(() => BooleanValueAccessor),
-                multi: true
-            }
-        ]
-    }),
-    __metadata("design:paramtypes", [ElementRef])
-], BooleanValueAccessor);
-export { BooleanValueAccessor };
+}
+BooleanValueAccessor.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: BooleanValueAccessor, deps: [{ token: i0.ElementRef }], target: i0.ɵɵFactoryTarget.Directive });
+BooleanValueAccessor.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.25", type: BooleanValueAccessor, isStandalone: true, selector: "xpl-checkbox, xpl-toggle", host: { listeners: { "checkboxChange": "handleChangeEvent($event.detail)", "toggleChange": "handleChangeEvent($event.detail)" } }, providers: [
+        {
+            provide: NG_VALUE_ACCESSOR,
+            useExisting: forwardRef(() => BooleanValueAccessor),
+            multi: true
+        }
+    ], usesInheritance: true, ngImport: i0 });
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.25", ngImport: i0, type: BooleanValueAccessor, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: 'xpl-checkbox, xpl-toggle',
+                    standalone: true,
+                    host: {
+                        '(checkboxChange)': 'handleChangeEvent($event.detail)',
+                        '(toggleChange)': 'handleChangeEvent($event.detail)'
+                    },
+                    providers: [
+                        {
+                            provide: NG_VALUE_ACCESSOR,
+                            useExisting: forwardRef(() => BooleanValueAccessor),
+                            multi: true
+                        }
+                    ]
+                }]
+        }], ctorParameters: () => [{ type: i0.ElementRef }] });
 //# sourceMappingURL=boolean-value-accessor.js.map

package/dist/directives/boolean-value-accessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"boolean-value-accessor.js","sourceRoot":"","sources":["../../src/directives/boolean-value-accessor.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAiB1C,IAAM,oBAAoB,GAA1B,MAAM,oBAAqB,SAAQ,aAAa;IACrD,YAAY,EAAc;QACxB,KAAK,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC;IACQ,UAAU,CAAC,KAAU;QAC5B,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACjF,CAAC;CACF,CAAA;AAPY,oBAAoB;IAfhC,SAAS,CAAC;QAET,QAAQ,EAAE,0BAA0B;QACpC,IAAI,EAAE;YACJ,kBAAkB,EAAE,kCAAkC;YACtD,gBAAgB,EAAE,kCAAkC;SACrD;QACD,SAAS,EAAE;YACT;gBACE,OAAO,EAAE,iBAAiB;gBAC1B,WAAW,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC;gBACnD,KAAK,EAAE,IAAI;aACZ;SACF;KACF,CAAC;qCAEgB,UAAU;GADf,oBAAoB,CAOhC"}
+{"version":3,"file":"boolean-value-accessor.js","sourceRoot":"","sources":["../../src/directives/boolean-value-accessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;;AAkBjD,MAAM,OAAO,oBAAqB,SAAQ,aAAa;IACrD,YAAY,EAAc;QACxB,KAAK,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC;IACQ,UAAU,CAAC,KAAU;QAC5B,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACjF,CAAC;;kHANU,oBAAoB;sGAApB,oBAAoB,0MARpB;QACT;YACE,OAAO,EAAE,iBAAiB;YAC1B,WAAW,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC;YACnD,KAAK,EAAE,IAAI;SACZ;KACF;4FAEU,oBAAoB;kBAhBhC,SAAS;mBAAC;oBAET,QAAQ,EAAE,0BAA0B;oBACpC,UAAU,EAAE,IAAI;oBAChB,IAAI,EAAE;wBACJ,kBAAkB,EAAE,kCAAkC;wBACtD,gBAAgB,EAAE,kCAAkC;qBACrD;oBACD,SAAS,EAAE;wBACT;4BACE,OAAO,EAAE,iBAAiB;4BAC1B,WAAW,EAAE,UAAU,CAAC,GAAG,EAAE,qBAAqB,CAAC;4BACnD,KAAK,EAAE,IAAI;yBACZ;qBACF;iBACF"}