@smartfront/angular
v0.2.2
Published
Smartfront Angular operations and chat adapter
Readme
@smartfront/angular
Angular 20 adapter in Angular Package Format, compiled in partial-Ivy mode. Provides an injected client, headless chat handlers and readonly Signals.
Build all UI with SmartfrontService.chat and state(): typed subscribeEvents() and bound send/cancel/confirm/form/context handlers. SmartChat (<smart-chat>) is only an unstyled textarea with value/valueChange, inputClass/inputStyle, accessible input options and sent/chatEvent outputs. The complete interface is an explicit SmartChatPanel (<smart-chat-panel>) opt-in, used below. Custom UI and input examples.
Recommended: provideSmartfront({ endpoint, modules: [createDomainModule] }). Declare modules in separate integration files, reuse existing services and read their Signals through context getters. Factories may call inject(Service) because they run in the SmartfrontService injection context; optional options factories are supported too. DestroyRef cleans modules and subscriptions. Modules, service DI and lifecycle examples. Component-local registration remains supported below.
import { Component, inject, signal } from '@angular/core';
import { SmartChatPanel, SmartfrontService, provideSmartfront } from '@smartfront/angular';
// Add provideSmartfront({ endpoint: '/v1/chat' }) to application providers.
@Component({ standalone: true, selector: 'app-counter', imports: [SmartChatPanel],
template: '<p>{{ count() }}</p><smart-chat-panel [voice]="true" />' })
export class Counter {
count = signal(0);
smart = inject(SmartfrontService);
constructor() {
this.smart.context('counter', () => ({ count: this.count() }));
this.smart.operation('increment', ({ amount }) => this.count.update((n) => n + amount), {
description: 'Increase counter', params: { amount: { type: 'integer' } },
});
}
}Registrations in a component constructor use that component's DestroyRef. Outside injection context pass the owning DestroyRef explicitly. provideScopedSmartfront provides a component-local client. Externally supplied clients remain caller-owned. Sensitive application operations require their own authorization; confirmation is enforced by the shared core.
Use <smart-chat-panel [showDebug]="true" /> with backend diagnostics enabled (SMARTFRONT_DEBUG=true in the example backend). Diagnostic controls under replies or operation chips open Router · Jev, LLM and Response tabs, with round selection, message history, retries and full requests/responses. Sections expand and copy individually. The suggestions input overrides starter prompts; by default the chat uses registered operation examples.
Workspace build/test: npm run build -w @smartfront/angular, npm run test -w @smartfront/angular after building core/UI. Publish the generated dist directory, not the workspace root.
