feat(sheet): add input comments and use readonly for property

Author: marcjulian

apps/app/src/app/pages/(components)/components/(sheet)/sheet.page.ts

@@ -1,7 +1,7 @@
 import type { RouteMeta } from '@analogjs/router';
 import { Component, computed, inject } from '@angular/core';
 import { PrimitiveSnippetsService } from '@spartan-ng/app/app/core/services/primitive-snippets.service';
-import { hlmH4, hlmCode, hlmP } from '@spartan-ng/helm/typography';
+import { hlmCode, hlmH4, hlmP } from '@spartan-ng/helm/typography';
 import { Code } from '../../../../shared/code/code';
 import { CodePreview } from '../../../../shared/code/code-preview';
 import { MainSection } from '../../../../shared/layout/main-section';

libs/brain/sheet/src/lib/brn-sheet-trigger.ts

@@ -8,6 +8,7 @@ import { BrnSheet } from './brn-sheet';
 export class BrnSheetTrigger extends BrnDialogTrigger {
 	private readonly _sheet = inject(BrnSheet, { optional: true });
 
+	/** Override the side from where the sheet appears for this trigger. */
 	public readonly side = input<'top' | 'bottom' | 'left' | 'right' | undefined>(undefined);
 
 	override open() {

libs/brain/sheet/src/lib/brn-sheet.ts

@@ -26,6 +26,7 @@ import { BrnDialog } from '@spartan-ng/brain/dialog';
 	exportAs: 'brnSheet',
 })
 export class BrnSheet extends BrnDialog {
+	/** Specifies the side of the screen where the sheet will appear. */
 	public readonly side = input<'top' | 'bottom' | 'left' | 'right'>('top');
 	public readonly sideState = linkedSignal(() => this.side());
 	constructor() {

libs/helm/sheet/src/lib/hlm-sheet-content.ts

@@ -57,7 +57,7 @@ export const sheetVariants = cva(
 export class HlmSheetContent {
 	private readonly _stateProvider = injectExposesStateProvider({ host: true });
 	private readonly _sideProvider = injectExposedSideProvider({ host: true });
-	public state = this._stateProvider.state ?? signal('closed');
+	public readonly state = this._stateProvider.state ?? signal('closed');
 	private readonly _renderer = inject(Renderer2);
 	private readonly _element = inject(ElementRef);