chore(fullcalendar): regen 6 leaves + READMEs for merged plugins + noEventsContent slot (10)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: serpentblade

packages/ui/fullcalendar/packages/angular/README.md

@@ -104,3 +104,4 @@ export class DemoComponent {
 | moreLink | arg |
 | allDayContent | arg |
 | slotLaneContent | arg |
+| noEventsContent | arg |

packages/ui/fullcalendar/packages/angular/src/FullCalendar.ts

@@ -52,6 +52,11 @@ interface SlotLaneContentCtx {
   arg: any;
 }
 
+interface NoEventsContentCtx {
+  $implicit: { arg: any };
+  arg: any;
+}
+
 @Component({
   selector: 'rozie-full-calendar',
   standalone: true,
@@ -69,6 +74,7 @@ interface SlotLaneContentCtx {
 
 
 
+
     <ng-container #rozie_portalAnchor></ng-container>
   `,
   styles: [`
@@ -125,6 +131,7 @@ export class FullCalendar {
   @ContentChild('moreLink', { read: TemplateRef }) moreLinkTpl?: TemplateRef<MoreLinkCtx>;
   @ContentChild('allDayContent', { read: TemplateRef }) allDayContentTpl?: TemplateRef<AllDayContentCtx>;
   @ContentChild('slotLaneContent', { read: TemplateRef }) slotLaneContentTpl?: TemplateRef<SlotLaneContentCtx>;
+  @ContentChild('noEventsContent', { read: TemplateRef }) noEventsContentTpl?: TemplateRef<NoEventsContentCtx>;
   templates = input<Record<string, TemplateRef<unknown>> | undefined>(undefined);
   private _portalViews = new Set<EmbeddedViewRef<unknown>>();
   private _portalAnchor = viewChild('rozie_portalAnchor', { read: ViewContainerRef });
@@ -137,6 +144,7 @@ export class FullCalendar {
   private _moreLinkTpl = contentChild('moreLink', { read: TemplateRef });
   private _allDayContentTpl = contentChild('allDayContent', { read: TemplateRef });
   private _slotLaneContentTpl = contentChild('slotLaneContent', { read: TemplateRef });
+  private _noEventsContentTpl = contentChild('noEventsContent', { read: TemplateRef });
   private __rozieDestroyRef = inject(DestroyRef);
   private __rozieWatchInitial_0 = true;
   private __rozieWatchInitial_1 = true;
@@ -315,13 +323,38 @@ export class FullCalendar {
           this._portalViews.delete(view as EmbeddedViewRef<unknown>);
         };
       },
+      noEventsContent: (container: HTMLElement, scope: { arg: unknown }): (() => void) => {
+        const tpl = this._noEventsContentTpl();
+        const vcr = this._portalAnchor();
+        if (!tpl || !vcr) return () => {};
+        // Spike 004: portal-scope attribute injection.
+        container.setAttribute('data-rozie-portal-noEventsContent', '5589629a');
+        const view = vcr.createEmbeddedView(tpl, scope as unknown as Record<string, unknown>);
+        view.detectChanges();
+        for (const node of view.rootNodes as Node[]) container.appendChild(node);
+        this._portalViews.add(view as EmbeddedViewRef<unknown>);
+        return () => {
+          view.destroy();
+          this._portalViews.delete(view as EmbeddedViewRef<unknown>);
+        };
+      },
     };
+    const __options = this.options();
     const opts = {
       // :options passthrough spread FIRST — the curated keys below + the portal
       // *Content handlers added after this object override any colliding key, so
       // an explicitly-bound prop (e.g. :height) wins over options.height.
-      ...this.options(),
-      plugins: this.PLUGINS,
+      //
+      // EXCEPTION — `plugins` is the one curated key that AUGMENTS rather than
+      // overrides: instead of clobbering a consumer-supplied `:options.plugins`,
+      // it MERGES the always-on baked-in defaults (dayGrid + timeGrid +
+      // interaction) with any consumer-added plugins. This makes the wrapper
+      // consumer-extensible (opt-in) — a consumer can engage list/rrule/premium/
+      // etc. via `:options="{ plugins: [listPlugin] }"` with NO bundle cost and NO
+      // per-plugin wrapper code. FullCalendar dedupes plugins by identity, so a
+      // consumer re-passing a default is harmless.
+      ...__options,
+      plugins: [...this.PLUGINS, ...(__options?.plugins ?? [])],
       initialView: this.view(),
       weekends: this.weekends(),
       editable: this.editable(),
@@ -475,24 +508,24 @@ export class FullCalendar {
         };
       };
     }
-    // The 8 remaining *Content portal-slots — wired identically to `event`, one
-    // per FullCalendar per-cell content hook that fires with the bundled plugins
-    // (core + daygrid + timegrid + interaction). Each guarded by its own slot so
-    // unfilled slots keep FullCalendar's default rendering. (9 portal-slots total
+    // The 9 remaining *Content portal-slots — wired identically to `event`, one
+    // per FullCalendar per-cell content hook. Each guarded by its own slot so
+    // unfilled slots keep FullCalendar's default rendering. (10 portal-slots total
     // counting `event` above; allDayContent + slotLaneContent are the two timeGrid
-    // axis/lane hooks added last.)
+    // axis/lane hooks, and noEventsContent is the list-view "no events" hook —
+    // inert unless the consumer engages @fullcalendar/list via :options.plugins.)
     //
     // NOTE the `nowIndicatorContent` slot is named for its FullCalendar engine
     // hook (`nowIndicatorContent`) so it does NOT clash with the boolean
     // `nowIndicator` PROP — a slot name that equals a declared prop name is now a
     // hard compile error (ROZ127 SLOT_PROP_NAME_COLLISION), because Svelte 5
     // unifies snippets and props into one `$props` namespace.
-    // The 8 remaining *Content portal-slots — wired identically to `event`, one
-    // per FullCalendar per-cell content hook that fires with the bundled plugins
-    // (core + daygrid + timegrid + interaction). Each guarded by its own slot so
-    // unfilled slots keep FullCalendar's default rendering. (9 portal-slots total
+    // The 9 remaining *Content portal-slots — wired identically to `event`, one
+    // per FullCalendar per-cell content hook. Each guarded by its own slot so
+    // unfilled slots keep FullCalendar's default rendering. (10 portal-slots total
     // counting `event` above; allDayContent + slotLaneContent are the two timeGrid
-    // axis/lane hooks added last.)
+    // axis/lane hooks, and noEventsContent is the list-view "no events" hook —
+    // inert unless the consumer engages @fullcalendar/list via :options.plugins.)
     //
     // NOTE the `nowIndicatorContent` slot is named for its FullCalendar engine
     // hook (`nowIndicatorContent`) so it does NOT clash with the boolean
@@ -595,13 +628,30 @@ export class FullCalendar {
         };
       };
     }
-    // The one still-excluded *Content slot (documented, not a gap): noEventsContent
-    // — list-view only, and @fullcalendar/list is not a bundled engine peer. A
-    // consumer needing it uses the :options passthrough + getApi().
-    // The one still-excluded *Content slot (documented, not a gap): noEventsContent
-    // — list-view only, and @fullcalendar/list is not a bundled engine peer. A
-    // consumer needing it uses the :options passthrough + getApi().
-
+    // noEventsContent — the list-view "no events to display" hook. Pre-declared
+    // and wired like the other 9 *Content slots, but INERT unless the consumer
+    // (a) engages @fullcalendar/list via the now-merged :options.plugins AND
+    // (b) shows a list view (listWeek/listDay/listMonth) with ZERO events. With
+    // the bundled-only plugin set there is no list view, so this hook never fires
+    // — by design, documented, zero bundle cost.
+    // noEventsContent — the list-view "no events to display" hook. Pre-declared
+    // and wired like the other 9 *Content slots, but INERT unless the consumer
+    // (a) engages @fullcalendar/list via the now-merged :options.plugins AND
+    // (b) shows a list view (listWeek/listDay/listMonth) with ZERO events. With
+    // the bundled-only plugin set there is no list view, so this hook never fires
+    // — by design, documented, zero bundle cost.
+    if ((this.noEventsContentTpl ?? this.templates()?.['noEventsContent'])) {
+      opts.noEventsContent = (arg: any) => {
+        const node = document.createElement('div');
+        const dispose = portals.noEventsContent(node, {
+          arg
+        });
+        return {
+          domNodes: [node],
+          dispose
+        };
+      };
+    }
     this.instance = new Calendar(this.__rozieRoot()!.nativeElement, opts);
     this.instance.render();
     this.__rozieDestroyRef.onDestroy(() => this.instance?.destroy());
@@ -672,7 +722,7 @@ export class FullCalendar {
   static ngTemplateContextGuard(
     _dir: FullCalendar,
     _ctx: unknown,
-  ): _ctx is EventCtx | DayCellCtx | DayHeaderCtx | SlotLabelCtx | WeekNumberCtx | NowIndicatorContentCtx | MoreLinkCtx | AllDayContentCtx | SlotLaneContentCtx {
+  ): _ctx is EventCtx | DayCellCtx | DayHeaderCtx | SlotLabelCtx | WeekNumberCtx | NowIndicatorContentCtx | MoreLinkCtx | AllDayContentCtx | SlotLaneContentCtx | NoEventsContentCtx {
     return true;
   }
 }

packages/ui/fullcalendar/packages/lit/README.md

@@ -98,3 +98,4 @@ const api = el.getApi();
 | moreLink | arg |
 | allDayContent | arg |
 | slotLaneContent | arg |
+| noEventsContent | arg |

packages/ui/fullcalendar/packages/lit/src/FullCalendar.ts

@@ -43,6 +43,10 @@ interface RozieSlotLaneContentSlotCtx {
   arg: unknown;
 }
 
+interface RozieNoEventsContentSlotCtx {
+  arg: unknown;
+}
+
 @customElement('rozie-full-calendar')
 export default class FullCalendar extends SignalWatcher(LitElement) {
   static styles = css`
@@ -102,6 +106,9 @@ private _portalContainers = new Set<HTMLElement>();
   @state() private _hasSlotSlotLaneContent = false;
   @queryAssignedElements({ slot: 'slotLaneContent', flatten: true }) private _slotSlotLaneContentElements!: Element[];
   @property({ attribute: false }) slotLaneContent?: (scope: { arg: unknown }) => unknown;
+  @state() private _hasSlotNoEventsContent = false;
+  @queryAssignedElements({ slot: 'noEventsContent', flatten: true }) private _slotNoEventsContentElements!: Element[];
+  @property({ attribute: false }) noEventsContent?: (scope: { arg: unknown }) => unknown;
 
   private _disconnectCleanups: Array<() => void> = [];
   // Re-parenting guard: set true once the deferred teardown has actually
@@ -207,6 +214,17 @@ private _portalContainers = new Set<HTMLElement>();
         update();
       }
     }
+
+    {
+      const slotEl = this.shadowRoot?.querySelector('slot[name="noEventsContent"]');
+      if (slotEl !== null && slotEl !== undefined) {
+        const update = () => { this._hasSlotNoEventsContent = this._slotNoEventsContentElements.length > 0; };
+        slotEl.addEventListener('slotchange', update);
+        // CR-05 fix: push cleanup so the listener is removed on disconnectedCallback.
+        this._disconnectCleanups.push(() => slotEl.removeEventListener('slotchange', update));
+        update();
+      }
+    }
   }
 
   connectedCallback(): void {
@@ -220,6 +238,7 @@ private _portalContainers = new Set<HTMLElement>();
     this._hasSlotMoreLink = Array.from(this.children).some((el) => el.getAttribute('slot') === 'moreLink');
     this._hasSlotAllDayContent = Array.from(this.children).some((el) => el.getAttribute('slot') === 'allDayContent');
     this._hasSlotSlotLaneContent = Array.from(this.children).some((el) => el.getAttribute('slot') === 'slotLaneContent');
+    this._hasSlotNoEventsContent = Array.from(this.children).some((el) => el.getAttribute('slot') === 'noEventsContent');
     super.connectedCallback();
     if (this.hasUpdated && this._rozieTornDown) { this._rozieTornDown = false; this._armListeners(); }
   }
@@ -336,6 +355,18 @@ private _portalContainers = new Set<HTMLElement>();
           this._portalContainers.delete(container);
         };
       },
+      noEventsContent: (container: HTMLElement, scope: { arg: unknown }): (() => void) => {
+        const tpl = this.noEventsContent;
+        if (typeof tpl !== 'function') return () => {};
+        // Spike 004: portal-scope attribute injection.
+        container.setAttribute('data-rozie-portal-noEventsContent', '5589629a');
+        render(tpl(scope), container);
+        this._portalContainers.add(container);
+        return () => {
+          render(nothing, container);
+          this._portalContainers.delete(container);
+        };
+      },
     };
 
     this._disconnectCleanups.push((() => this.instance?.destroy()));
@@ -351,8 +382,17 @@ private _portalContainers = new Set<HTMLElement>();
       // :options passthrough spread FIRST — the curated keys below + the portal
       // *Content handlers added after this object override any colliding key, so
       // an explicitly-bound prop (e.g. :height) wins over options.height.
+      //
+      // EXCEPTION — `plugins` is the one curated key that AUGMENTS rather than
+      // overrides: instead of clobbering a consumer-supplied `:options.plugins`,
+      // it MERGES the always-on baked-in defaults (dayGrid + timeGrid +
+      // interaction) with any consumer-added plugins. This makes the wrapper
+      // consumer-extensible (opt-in) — a consumer can engage list/rrule/premium/
+      // etc. via `:options="{ plugins: [listPlugin] }"` with NO bundle cost and NO
+      // per-plugin wrapper code. FullCalendar dedupes plugins by identity, so a
+      // consumer re-passing a default is harmless.
       ...this.options,
-      plugins: this.PLUGINS,
+      plugins: [...this.PLUGINS, ...(this.options?.plugins ?? [])],
       initialView: this.view,
       weekends: this.weekends,
       editable: this.editable,
@@ -550,24 +590,24 @@ private _portalContainers = new Set<HTMLElement>();
         };
       };
     }
-    // The 8 remaining *Content portal-slots — wired identically to `event`, one
-    // per FullCalendar per-cell content hook that fires with the bundled plugins
-    // (core + daygrid + timegrid + interaction). Each guarded by its own slot so
-    // unfilled slots keep FullCalendar's default rendering. (9 portal-slots total
+    // The 9 remaining *Content portal-slots — wired identically to `event`, one
+    // per FullCalendar per-cell content hook. Each guarded by its own slot so
+    // unfilled slots keep FullCalendar's default rendering. (10 portal-slots total
     // counting `event` above; allDayContent + slotLaneContent are the two timeGrid
-    // axis/lane hooks added last.)
+    // axis/lane hooks, and noEventsContent is the list-view "no events" hook —
+    // inert unless the consumer engages @fullcalendar/list via :options.plugins.)
     //
     // NOTE the `nowIndicatorContent` slot is named for its FullCalendar engine
     // hook (`nowIndicatorContent`) so it does NOT clash with the boolean
     // `nowIndicator` PROP — a slot name that equals a declared prop name is now a
     // hard compile error (ROZ127 SLOT_PROP_NAME_COLLISION), because Svelte 5
     // unifies snippets and props into one `$props` namespace.
-    // The 8 remaining *Content portal-slots — wired identically to `event`, one
-    // per FullCalendar per-cell content hook that fires with the bundled plugins
-    // (core + daygrid + timegrid + interaction). Each guarded by its own slot so
-    // unfilled slots keep FullCalendar's default rendering. (9 portal-slots total
+    // The 9 remaining *Content portal-slots — wired identically to `event`, one
+    // per FullCalendar per-cell content hook. Each guarded by its own slot so
+    // unfilled slots keep FullCalendar's default rendering. (10 portal-slots total
     // counting `event` above; allDayContent + slotLaneContent are the two timeGrid
-    // axis/lane hooks added last.)
+    // axis/lane hooks, and noEventsContent is the list-view "no events" hook —
+    // inert unless the consumer engages @fullcalendar/list via :options.plugins.)
     //
     // NOTE the `nowIndicatorContent` slot is named for its FullCalendar engine
     // hook (`nowIndicatorContent`) so it does NOT clash with the boolean
@@ -670,13 +710,30 @@ private _portalContainers = new Set<HTMLElement>();
         };
       };
     }
-    // The one still-excluded *Content slot (documented, not a gap): noEventsContent
-    // — list-view only, and @fullcalendar/list is not a bundled engine peer. A
-    // consumer needing it uses the :options passthrough + getApi().
-    // The one still-excluded *Content slot (documented, not a gap): noEventsContent
-    // — list-view only, and @fullcalendar/list is not a bundled engine peer. A
-    // consumer needing it uses the :options passthrough + getApi().
-
+    // noEventsContent — the list-view "no events to display" hook. Pre-declared
+    // and wired like the other 9 *Content slots, but INERT unless the consumer
+    // (a) engages @fullcalendar/list via the now-merged :options.plugins AND
+    // (b) shows a list view (listWeek/listDay/listMonth) with ZERO events. With
+    // the bundled-only plugin set there is no list view, so this hook never fires
+    // — by design, documented, zero bundle cost.
+    // noEventsContent — the list-view "no events to display" hook. Pre-declared
+    // and wired like the other 9 *Content slots, but INERT unless the consumer
+    // (a) engages @fullcalendar/list via the now-merged :options.plugins AND
+    // (b) shows a list view (listWeek/listDay/listMonth) with ZERO events. With
+    // the bundled-only plugin set there is no list view, so this hook never fires
+    // — by design, documented, zero bundle cost.
+    if (this.noEventsContent !== undefined) {
+      opts.noEventsContent = (arg: any) => {
+        const node = document.createElement('div');
+        const dispose = portals.noEventsContent(node, {
+          arg
+        });
+        return {
+          domNodes: [node],
+          dispose
+        };
+      };
+    }
     this.instance = new Calendar(this._ref__rozieRoot, opts);
     this.instance.render();
   }
@@ -733,6 +790,7 @@ private _portalContainers = new Set<HTMLElement>();
 <slot name="moreLink"></slot>
 <slot name="allDayContent"></slot>
 <slot name="slotLaneContent"></slot>
+<slot name="noEventsContent"></slot>
 `;
   }
 

packages/ui/fullcalendar/packages/react/README.md

@@ -102,3 +102,4 @@ const api = cal.current?.getApi();
 | moreLink | arg |
 | allDayContent | arg |
 | slotLaneContent | arg |
+| noEventsContent | arg |

packages/ui/fullcalendar/packages/react/src/FullCalendar.d.ts

@@ -38,6 +38,7 @@ export interface FullCalendarProps {
   renderMoreLink?: (params: { arg: () => void }) => ReactNode;
   renderAllDayContent?: (params: { arg: () => void }) => ReactNode;
   renderSlotLaneContent?: (params: { arg: () => void }) => ReactNode;
+  renderNoEventsContent?: (params: { arg: () => void }) => ReactNode;
   slots?: Record<string, () => ReactNode>;
 }