@weaver-apps/calendar 0.1.3 → 0.3.0

package/README.md

@@ -7,10 +7,15 @@ and holds no key.
 ## Compose it
 
 ```ts
-import { createCalendarPlugin, createHttpCalendarGateway, provideCalendarGateway } from '@weaver-apps/calendar';
-
-provideTranslationNamespaces('calendar'),
-provideCapabilityGrants({ calendar: ['contributions', 'navigation', 'ui'] }),
+import {
+  calendarPluginId,
+  createCalendarPlugin,
+  createHttpCalendarGateway,
+  provideCalendarGateway,
+} from '@weaver-apps/calendar';
+
+provideTranslationNamespaces(calendarPluginId),
+provideCapabilityGrants({ [calendarPluginId]: ['contributions', 'navigation', 'ui'] }),
 ...providePlugins(createCalendarPlugin({ railItem: true })),
 provideCalendarGateway(createHttpCalendarGateway({ baseUrl: '/weaver-apps' })),
 ```
@@ -18,17 +23,36 @@ provideCalendarGateway(createHttpCalendarGateway({ baseUrl: '/weaver-apps' })),
 - `baseUrl` is a same-origin path the host's backend forwards to the server, adding the forwarding key and
   the signed-in person's tenant (`X-API-Key`, `X-Act-For-Tenant`). The gateway appends the server's own
   routes, such as `/calendar/calendars/{id}/appointments`.
-- Serve the translations: the package carries them under `i18n/calendar`; add an assets glob that copies
-  `node_modules/@weaver-apps/calendar/i18n/calendar` to `i18n/calendar`.
-- If the host compiles the shell's theme with Tailwind, add the package as an `@source`.
-
-## Surfaces
-
-| Path | What it shows |
-|---|---|
-| `calendar` | the tenant's calendars |
-| `calendar/:calendarId` | one calendar's appointments, a week at a time |
-
-`calendarPath(id)` builds the second; a host that shows one entry per calendar navigates there.
-`createCalendarPlugin({ railItem: true })` adds a rail item that opens the list; without it the host decides
-where the calendar is reached from.
+- Serve the translations: the package carries them under `i18n/weaver-apps-calendar`; add an assets glob
+  that copies `node_modules/@weaver-apps/calendar/i18n/weaver-apps-calendar` to `i18n/weaver-apps-calendar`.
+- Install AG Grid, a peer dependency the list is drawn with: `npm i ag-grid-community@^36.2 ag-grid-angular@^36.2
+  @ag-grid-community/locale@^36.2`. `@weaver-apps/data-grid`, the grid both Weaver Apps weavers share, comes along as a
+  dependency; the host composes nothing for it.
+- If the host compiles the shell's theme with Tailwind, add the package and `@weaver-apps/data-grid` as an `@source`.
+
+## Names in the host
+
+The plugin id is `weaver-apps-calendar` (`calendarPluginId`). Every id the plugin registers and every icon
+it contributes starts with `weaver-apps-calendar.`, its routes live under `weaver-apps-calendar/`, and its
+translations are the namespace `weaver-apps-calendar`. The ids are exported as `calendarContributionIds`.
+
+| Id | Path | What it shows |
+|---|---|---|
+| `weaver-apps-calendar.calendars` | `weaver-apps-calendar` | the tenant's calendars |
+| `weaver-apps-calendar.calendar` | `weaver-apps-calendar/:calendarId` | one calendar's appointments, a week at a time |
+| `weaver-apps-calendar.rail` | | the rail item, only with `railItem: true` |
+
+A calendar's week is a grid: a click on a column header sorts it (earliest first by default), and the status
+column filters by any number of statuses.
+
+`calendarPath(id)` builds the address of one calendar; a host that shows one entry per calendar navigates
+there. `createCalendarPlugin({ railItem: true })` adds a rail item that opens the list; without it the host
+decides where the calendar is reached from.
+
+## Moving from 0.1.x
+
+0.2.0 draws the list with AG Grid, so a host installs it (see above). It also renamed everything the plugin puts
+into a host; a host composing it changes three places: the key of
+its capability grant (`calendar` becomes `weaver-apps-calendar`), the translation namespace it declares, and
+the folder it serves the translations from (`i18n/calendar` becomes `i18n/weaver-apps-calendar`). Addresses
+saved under `calendar/...` no longer resolve; build them with `calendarPath`.

package/fesm2022/weaver-apps-calendar-calendar-gateway-DUo797bn.mjs

@@ -0,0 +1,35 @@
+import { InjectionToken } from "@angular/core";
+var CalendarHost = class {
+	ctx;
+	bind(ctx) {
+		this.ctx = ctx;
+	}
+	unbind() {
+		this.ctx = void 0;
+	}
+	get ui() {
+		if (!this.ctx) throw new Error("The calendar plugin is not active.");
+		return this.ctx.ui;
+	}
+	navigate(path) {
+		this.ctx?.navigateContent(path);
+	}
+};
+const calendarHost = new CalendarHost();
+var CalendarGatewayError = class extends Error {
+	status;
+	constructor(status) {
+		super(`The calendar answered ${status}.`);
+		this.status = status;
+	}
+};
+const CALENDAR_GATEWAY = new InjectionToken("weaver-apps.calendar.gateway");
+function provideCalendarGateway(gateway) {
+	return {
+		provide: CALENDAR_GATEWAY,
+		useValue: gateway
+	};
+}
+export { calendarHost as i, CalendarGatewayError as n, provideCalendarGateway as r, CALENDAR_GATEWAY as t };
+
+//# sourceMappingURL=weaver-apps-calendar-calendar-gateway-DUo797bn.mjs.map

package/fesm2022/weaver-apps-calendar-calendar-gateway-DUo797bn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"weaver-apps-calendar-calendar-gateway-DUo797bn.mjs","names":[],"sources":["../../../../libs/calendar/src/lib/plugin/calendar-host.ts","../../../../libs/calendar/src/lib/gateway/calendar-gateway.ts"],"sourcesContent":["import type { PluginContext } from '@loomweaver/plugin-sdk';\n\ntype HostContext = Pick<PluginContext, 'ui' | 'navigateContent'>;\n\nclass CalendarHost {\n  private ctx?: HostContext;\n\n  bind(ctx: HostContext): void {\n    this.ctx = ctx;\n  }\n\n  unbind(): void {\n    this.ctx = undefined;\n  }\n\n  get ui(): HostContext['ui'] {\n    if (!this.ctx) {\n      throw new Error('The calendar plugin is not active.');\n    }\n    return this.ctx.ui;\n  }\n\n  navigate(path: string): void {\n    this.ctx?.navigateContent(path);\n  }\n}\n\nexport const calendarHost = new CalendarHost();\n","import { InjectionToken, Provider } from '@angular/core';\nimport type { AppointmentRequest, AppointmentResponse, AppointmentStatus, CalendarResponse } from '../api/models';\n\nexport interface CalendarRange {\n  readonly from: Date;\n  readonly until: Date;\n}\n\nexport interface ConflictingAppointment {\n  readonly id: string;\n  readonly start: string;\n  readonly end: string;\n}\n\nexport type AppointmentOutcome =\n  | { readonly kind: 'saved'; readonly appointment: AppointmentResponse }\n  | { readonly kind: 'conflict'; readonly conflicts: readonly ConflictingAppointment[] }\n  | { readonly kind: 'closed' }\n  | { readonly kind: 'changed' }\n  | { readonly kind: 'invalid' }\n  | { readonly kind: 'missing' };\n\nexport interface CalendarGateway {\n  calendars(): Promise<readonly CalendarResponse[]>;\n  calendar(calendarId: string): Promise<CalendarResponse | null>;\n  saveCalendar(calendarId: string, name: string): Promise<CalendarResponse>;\n  appointments(calendarId: string, range: CalendarRange, contact?: string, signal?: AbortSignal): Promise<readonly AppointmentResponse[]>;\n  book(calendarId: string, request: AppointmentRequest): Promise<AppointmentOutcome>;\n  update(calendarId: string, appointmentId: string, request: AppointmentRequest): Promise<AppointmentOutcome>;\n  cancel(calendarId: string, appointmentId: string, reason: string | null): Promise<AppointmentOutcome>;\n  setStatus(calendarId: string, appointmentId: string, status: AppointmentStatus): Promise<AppointmentOutcome>;\n  remove(calendarId: string, appointmentId: string): Promise<void>;\n}\n\nexport class CalendarGatewayError extends Error {\n  constructor(readonly status: number) {\n    super(`The calendar answered ${status}.`);\n  }\n}\n\nexport const CALENDAR_GATEWAY = new InjectionToken<CalendarGateway>('weaver-apps.calendar.gateway');\n\nexport function provideCalendarGateway(gateway: CalendarGateway): Provider {\n  return { provide: CALENDAR_GATEWAY, useValue: gateway };\n}\n"],"mappings":";AAIA,IAAM,eAAN,MAAkB;CACR;CAER,KAAK,KAAgB;EACnB,KAAK,MAAM;CACb;CAEA,SAAM;EACJ,KAAK,MAAM;CACb;CAEA,IAAI,KAAE;EACJ,IAAI,CAAC,KAAK,KACR,MAAM,IAAI,MAAM,oCAAoC;EAEtD,OAAO,KAAK,IAAI;CAClB;CAEA,SAAS,MAAY;EACnB,KAAK,KAAK,gBAAgB,IAAI;CAChC;AACD;AAED,MAAa,eAAe,IAAI,aAAY;ACO5C,IAAa,uBAAb,cAA0C,MAAK;CACxB;CAArB,YAAqB,QAAc;EACjC,MAAM,yBAAyB,OAAM,EAAG;EADrB,KAAA,SAAA;CAErB;AACD;AAED,MAAa,mBAAmB,IAAI,eAAgC,8BAA8B;AAElG,SAAgB,uBAAuB,SAAwB;CAC7D,OAAO;EAAE,SAAS;EAAkB,UAAU;CAAO;AACvD"}

package/fesm2022/weaver-apps-calendar-calendar-list-page-dgF-nnQF.mjs

@@ -0,0 +1,74 @@
+import { i as calendarHost, t as CALENDAR_GATEWAY } from "./weaver-apps-calendar-calendar-gateway-DUo797bn.mjs";
+import { n as calendarPath } from "./weaver-apps-calendar-calendar-paths-qzIR-lDU.mjs";
+import * as i0 from "@angular/core";
+import { CUSTOM_ELEMENTS_SCHEMA, ChangeDetectionStrategy, Component, inject, resource } from "@angular/core";
+import { TranslocoPipe } from "@jsverse/transloco";
+var CalendarListPage = class CalendarListPage {
+	gateway = inject(CALENDAR_GATEWAY);
+	calendars = resource({
+		...ngDevMode ? { debugName: "calendars" } : /* istanbul ignore next */ {},
+		loader: () => this.gateway.calendars()
+	});
+	open(calendarId) {
+		calendarHost.navigate(calendarPath(calendarId));
+	}
+	async create() {
+		const name = await calendarHost.ui.prompt({
+			title: "weaver-apps-calendar.calendars.create",
+			message: "weaver-apps-calendar.calendars.createMessage",
+			confirmLabel: "weaver-apps-calendar.calendars.createConfirm"
+		});
+		if (!name?.trim()) return;
+		try {
+			const calendar = await this.gateway.saveCalendar(crypto.randomUUID(), name.trim());
+			this.open(calendar.id);
+		} catch {
+			calendarHost.ui.toast({
+				message: "weaver-apps-calendar.errors.create",
+				kind: "error"
+			});
+		}
+	}
+	static ɵfac = i0.ɵɵngDeclareFactory({
+		minVersion: "12.0.0",
+		version: "22.2.3",
+		ngImport: i0,
+		type: CalendarListPage,
+		deps: [],
+		target: i0.ɵɵFactoryTarget.Component
+	});
+	static ɵcmp = i0.ɵɵngDeclareComponent({
+		minVersion: "17.0.0",
+		version: "22.2.3",
+		type: CalendarListPage,
+		isStandalone: true,
+		selector: "wa-calendar-list-page",
+		ngImport: i0,
+		template: "<div class=\"flex h-full flex-col gap-4 overflow-auto p-6\">\n  <div class=\"flex items-center justify-between gap-4\">\n    <h2 class=\"text-lg font-semibold text-content\">{{ 'weaver-apps-calendar.calendars.title' | transloco }}</h2>\n    <button type=\"button\" class=\"lw-btn lw-btn--primary\" (click)=\"create()\">{{ 'weaver-apps-calendar.calendars.create' | transloco }}</button>\n  </div>\n  @if (calendars.error()) {\n    <p class=\"text-sm text-negative\" role=\"alert\">{{ 'weaver-apps-calendar.errors.load' | transloco }}</p>\n  } @else if (calendars.hasValue()) {\n    <ul role=\"list\" class=\"divide-y divide-border rounded-xl border border-border bg-surface\">\n      @for (calendar of calendars.value(); track calendar.id) {\n        <li>\n          <button type=\"button\" class=\"flex w-full items-center gap-3 px-4 py-3 text-left text-sm text-content hover:bg-surface-overlay\" (click)=\"open(calendar.id)\">\n            <lw-icon name=\"weaver-apps-calendar.calendar\" size=\"1.25rem\"></lw-icon>\n            <span>{{ calendar.name }}</span>\n          </button>\n        </li>\n      } @empty {\n        <li class=\"px-4 py-8 text-center text-sm text-content-faint\">{{ 'weaver-apps-calendar.calendars.empty' | transloco }}</li>\n      }\n    </ul>\n  }\n</div>\n",
+		dependencies: [{
+			kind: "pipe",
+			type: TranslocoPipe,
+			name: "transloco"
+		}],
+		changeDetection: i0.ChangeDetectionStrategy.OnPush
+	});
+};
+i0.ɵɵngDeclareClassMetadata({
+	minVersion: "12.0.0",
+	version: "22.2.3",
+	ngImport: i0,
+	type: CalendarListPage,
+	decorators: [{
+		type: Component,
+		args: [{
+			selector: "wa-calendar-list-page",
+			imports: [TranslocoPipe],
+			schemas: [CUSTOM_ELEMENTS_SCHEMA],
+			changeDetection: ChangeDetectionStrategy.OnPush,
+			template: "<div class=\"flex h-full flex-col gap-4 overflow-auto p-6\">\n  <div class=\"flex items-center justify-between gap-4\">\n    <h2 class=\"text-lg font-semibold text-content\">{{ 'weaver-apps-calendar.calendars.title' | transloco }}</h2>\n    <button type=\"button\" class=\"lw-btn lw-btn--primary\" (click)=\"create()\">{{ 'weaver-apps-calendar.calendars.create' | transloco }}</button>\n  </div>\n  @if (calendars.error()) {\n    <p class=\"text-sm text-negative\" role=\"alert\">{{ 'weaver-apps-calendar.errors.load' | transloco }}</p>\n  } @else if (calendars.hasValue()) {\n    <ul role=\"list\" class=\"divide-y divide-border rounded-xl border border-border bg-surface\">\n      @for (calendar of calendars.value(); track calendar.id) {\n        <li>\n          <button type=\"button\" class=\"flex w-full items-center gap-3 px-4 py-3 text-left text-sm text-content hover:bg-surface-overlay\" (click)=\"open(calendar.id)\">\n            <lw-icon name=\"weaver-apps-calendar.calendar\" size=\"1.25rem\"></lw-icon>\n            <span>{{ calendar.name }}</span>\n          </button>\n        </li>\n      } @empty {\n        <li class=\"px-4 py-8 text-center text-sm text-content-faint\">{{ 'weaver-apps-calendar.calendars.empty' | transloco }}</li>\n      }\n    </ul>\n  }\n</div>\n"
+		}]
+	}]
+});
+export { CalendarListPage };
+
+//# sourceMappingURL=weaver-apps-calendar-calendar-list-page-dgF-nnQF.mjs.map

package/fesm2022/weaver-apps-calendar-calendar-list-page-dgF-nnQF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"weaver-apps-calendar-calendar-list-page-dgF-nnQF.mjs","names":[],"sources":["../../../../libs/calendar/src/lib/views/calendar-list-page.ts","../../../../libs/calendar/src/lib/views/calendar-list-page.html"],"sourcesContent":["import { ChangeDetectionStrategy, Component, CUSTOM_ELEMENTS_SCHEMA, inject, resource } from '@angular/core';\nimport { TranslocoPipe } from '@jsverse/transloco';\nimport { CALENDAR_GATEWAY } from '../gateway/calendar-gateway';\nimport { calendarHost } from '../plugin/calendar-host';\nimport { calendarPath } from '../plugin/calendar-paths';\n\n@Component({\n  selector: 'wa-calendar-list-page',\n  imports: [TranslocoPipe],\n  schemas: [CUSTOM_ELEMENTS_SCHEMA],\n  templateUrl: './calendar-list-page.html',\n  changeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport class CalendarListPage {\n  private readonly gateway = inject(CALENDAR_GATEWAY);\n\n  protected readonly calendars = resource({ loader: () => this.gateway.calendars() });\n\n  protected open(calendarId: string): void {\n    calendarHost.navigate(calendarPath(calendarId));\n  }\n\n  protected async create(): Promise<void> {\n    const name = await calendarHost.ui.prompt({\n      title: 'weaver-apps-calendar.calendars.create',\n      message: 'weaver-apps-calendar.calendars.createMessage',\n      confirmLabel: 'weaver-apps-calendar.calendars.createConfirm',\n    });\n    if (!name?.trim()) {\n      return;\n    }\n    try {\n      const calendar = await this.gateway.saveCalendar(crypto.randomUUID(), name.trim());\n      this.open(calendar.id);\n    } catch {\n      calendarHost.ui.toast({ message: 'weaver-apps-calendar.errors.create', kind: 'error' });\n    }\n  }\n}\n","<div class=\"flex h-full flex-col gap-4 overflow-auto p-6\">\n  <div class=\"flex items-center justify-between gap-4\">\n    <h2 class=\"text-lg font-semibold text-content\">{{ 'weaver-apps-calendar.calendars.title' | transloco }}</h2>\n    <button type=\"button\" class=\"lw-btn lw-btn--primary\" (click)=\"create()\">{{ 'weaver-apps-calendar.calendars.create' | transloco }}</button>\n  </div>\n  @if (calendars.error()) {\n    <p class=\"text-sm text-negative\" role=\"alert\">{{ 'weaver-apps-calendar.errors.load' | transloco }}</p>\n  } @else if (calendars.hasValue()) {\n    <ul role=\"list\" class=\"divide-y divide-border rounded-xl border border-border bg-surface\">\n      @for (calendar of calendars.value(); track calendar.id) {\n        <li>\n          <button type=\"button\" class=\"flex w-full items-center gap-3 px-4 py-3 text-left text-sm text-content hover:bg-surface-overlay\" (click)=\"open(calendar.id)\">\n            <lw-icon name=\"weaver-apps-calendar.calendar\" size=\"1.25rem\"></lw-icon>\n            <span>{{ calendar.name }}</span>\n          </button>\n        </li>\n      } @empty {\n        <li class=\"px-4 py-8 text-center text-sm text-content-faint\">{{ 'weaver-apps-calendar.calendars.empty' | transloco }}</li>\n      }\n    </ul>\n  }\n</div>\n"],"mappings":";;;;;AAaA,IAAa,mBAAb,MAAa,iBAAgB;CACV,UAAU,OAAO,gBAAgB;CAE/B,YAAY,SAAQ;EAAA,GAAA,YAAA,EAAA,WAAA,YAAA,+BAAA,CAAA;EAAG,cAAc,KAAK,QAAQ,UAAS;CAAE,CAAA;CAEtE,KAAK,YAAkB;EAC/B,aAAa,SAAS,aAAa,UAAU,CAAC;CAChD;CAEU,MAAM,SAAM;EACpB,MAAM,OAAO,MAAM,aAAa,GAAG,OAAO;GACxC,OAAO;GACP,SAAS;GACT,cAAc;EACf,CAAA;EACD,IAAI,CAAC,MAAM,KAAI,GACb;EAEF,IAAI;GACF,MAAM,WAAW,MAAM,KAAK,QAAQ,aAAa,OAAO,WAAU,GAAI,KAAK,KAAI,CAAE;GACjF,KAAK,KAAK,SAAS,EAAE;EACvB,QAAQ;GACN,aAAa,GAAG,MAAM;IAAE,SAAS;IAAsC,MAAM;GAAO,CAAE;EACxF;CACF;CAxBW,OAAA,OAAA,GAAA,mBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,UAAA;EAAA,MAAA;EAAgB,MAAA,CAAA;EAAA,QAAA,GAAA,gBAAA;CAAA,CAAA;CAAhB,OAAA,OAAA,GAAA,qBAAA;EAAA,YAAA;EAAA,SAAA;EAAA,MAAA;EAAgB,cAAA;EAAA,UAAA;EAAA,UAAA;EAAA,UCb7B;EAsBA,cAAA,CAAA;GAAA,MAAA;GAAA,MDdY;GAAa,MAAA;EAAA,CAAA;EAAA,iBAAA,GAAA,wBAAA;CAAA,CAAA;;AAKZ,GAAA,yBAAA;CAAA,YAAA;CAAA,SAAA;CAAA,UAAA;CAAA,MAAA;CAAgB,YAAA,CAAA;EAP5B,MAAA;EACW,MAAA,CAAA;GAAA,UAAA;GAAuB,SACxB,CAAC,aAAa;GAAC,SACf,CAAC,sBAAsB;GAAC,iBAEhB,wBAAwB;GAAM,UAAA;EAAA,CAAA"}