@cratis/showrunner.notes 0.0.0-stage → 1.15.0

package/Listing/MyNote.ts

@@ -0,0 +1,303 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+// **DO NOT EDIT** - This file is an automatically generated file.
+// @generated by Cratis. Source: Cratis.Showrunner.Notes.Listing.MyNote, Cratis.Showrunner.Notes.Listing.MyNote. Time: 2026-11-01T11:55:12.6707473Z. Hash: 53DA8F14A2D0432B6BEC55A2F1B97626D62BEC349F30D0775C0AF36A4B481266
+import { ChangeSet, ObservableQueryFor, Paging, QueryResultWithState, Sorting, SortingActions, SortingActionsForObservableQuery } from '@cratis/arc/queries';
+import { ObservableQueryWhen, SetPage, SetPageSize, SetSorting, useChangeStream, useObservableQuery, useObservableQueryWithPaging, useSuspenseObservableQuery, useSuspenseObservableQueryWithPaging } from '@cratis/arc.react/queries';
+import { SliceLocation as ArcSliceLocation, ParameterDescriptor } from '@cratis/arc/reflection';
+import { Guid, field } from '@cratis/fundamentals';
+import { NoteKind } from '../Contracts/Giving/NoteKind';
+import { NoteScreen } from '../Contracts/Context/NoteScreen';
+import { NoteStatus } from './NoteStatus';
+import { NoteTarget } from './NoteTarget';
+import { SliceLocation } from '../Contracts/Reporting/SliceLocation';
+import { SuggestedPropertyChange } from './SuggestedPropertyChange';
+
+class MyNotesSortBy {
+    private _component: SortingActionsForObservableQuery<MyNote[]>;
+    private _givenAt: SortingActionsForObservableQuery<MyNote[]>;
+    private _givenBy: SortingActionsForObservableQuery<MyNote[]>;
+    private _id: SortingActionsForObservableQuery<MyNote[]>;
+    private _kind: SortingActionsForObservableQuery<MyNote[]>;
+    private _lastActivityAt: SortingActionsForObservableQuery<MyNote[]>;
+    private _location: SortingActionsForObservableQuery<MyNote[]>;
+    private _propertyChanges: SortingActionsForObservableQuery<MyNote[]>;
+    private _screen: SortingActionsForObservableQuery<MyNote[]>;
+    private _slices: SortingActionsForObservableQuery<MyNote[]>;
+    private _status: SortingActionsForObservableQuery<MyNote[]>;
+    private _statusDetail: SortingActionsForObservableQuery<MyNote[]>;
+    private _target: SortingActionsForObservableQuery<MyNote[]>;
+    private _text: SortingActionsForObservableQuery<MyNote[]>;
+
+    constructor(readonly query: MyNotes) {
+        this._component = new SortingActionsForObservableQuery<MyNote[]>('component', query);
+        this._givenAt = new SortingActionsForObservableQuery<MyNote[]>('givenAt', query);
+        this._givenBy = new SortingActionsForObservableQuery<MyNote[]>('givenBy', query);
+        this._id = new SortingActionsForObservableQuery<MyNote[]>('id', query);
+        this._kind = new SortingActionsForObservableQuery<MyNote[]>('kind', query);
+        this._lastActivityAt = new SortingActionsForObservableQuery<MyNote[]>('lastActivityAt', query);
+        this._location = new SortingActionsForObservableQuery<MyNote[]>('location', query);
+        this._propertyChanges = new SortingActionsForObservableQuery<MyNote[]>('propertyChanges', query);
+        this._screen = new SortingActionsForObservableQuery<MyNote[]>('screen', query);
+        this._slices = new SortingActionsForObservableQuery<MyNote[]>('slices', query);
+        this._status = new SortingActionsForObservableQuery<MyNote[]>('status', query);
+        this._statusDetail = new SortingActionsForObservableQuery<MyNote[]>('statusDetail', query);
+        this._target = new SortingActionsForObservableQuery<MyNote[]>('target', query);
+        this._text = new SortingActionsForObservableQuery<MyNote[]>('text', query);
+    }
+
+    get component(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._component;
+    }
+    get givenAt(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._givenAt;
+    }
+    get givenBy(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._givenBy;
+    }
+    get id(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._id;
+    }
+    get kind(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._kind;
+    }
+    get lastActivityAt(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._lastActivityAt;
+    }
+    get location(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._location;
+    }
+    get propertyChanges(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._propertyChanges;
+    }
+    get screen(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._screen;
+    }
+    get slices(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._slices;
+    }
+    get status(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._status;
+    }
+    get statusDetail(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._statusDetail;
+    }
+    get target(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._target;
+    }
+    get text(): SortingActionsForObservableQuery<MyNote[]> {
+        return this._text;
+    }
+}
+
+class MyNotesSortByWithoutQuery {
+    private _component: SortingActions  = new SortingActions('component');
+    private _givenAt: SortingActions  = new SortingActions('givenAt');
+    private _givenBy: SortingActions  = new SortingActions('givenBy');
+    private _id: SortingActions  = new SortingActions('id');
+    private _kind: SortingActions  = new SortingActions('kind');
+    private _lastActivityAt: SortingActions  = new SortingActions('lastActivityAt');
+    private _location: SortingActions  = new SortingActions('location');
+    private _propertyChanges: SortingActions  = new SortingActions('propertyChanges');
+    private _screen: SortingActions  = new SortingActions('screen');
+    private _slices: SortingActions  = new SortingActions('slices');
+    private _status: SortingActions  = new SortingActions('status');
+    private _statusDetail: SortingActions  = new SortingActions('statusDetail');
+    private _target: SortingActions  = new SortingActions('target');
+    private _text: SortingActions  = new SortingActions('text');
+
+    get component(): SortingActions {
+        return this._component;
+    }
+    get givenAt(): SortingActions {
+        return this._givenAt;
+    }
+    get givenBy(): SortingActions {
+        return this._givenBy;
+    }
+    get id(): SortingActions {
+        return this._id;
+    }
+    get kind(): SortingActions {
+        return this._kind;
+    }
+    get lastActivityAt(): SortingActions {
+        return this._lastActivityAt;
+    }
+    get location(): SortingActions {
+        return this._location;
+    }
+    get propertyChanges(): SortingActions {
+        return this._propertyChanges;
+    }
+    get screen(): SortingActions {
+        return this._screen;
+    }
+    get slices(): SortingActions {
+        return this._slices;
+    }
+    get status(): SortingActions {
+        return this._status;
+    }
+    get statusDetail(): SortingActions {
+        return this._statusDetail;
+    }
+    get target(): SortingActions {
+        return this._target;
+    }
+    get text(): SortingActions {
+        return this._text;
+    }
+}
+
+
+/**
+ * Observes the notes the signed-in user gave, in the current tenant, most recent activity first.
+ */
+export class MyNotes extends ObservableQueryFor<MyNote[]> {
+    static readonly sliceLocation: ArcSliceLocation = new ArcSliceLocation('', '', 'Listing');
+    readonly route: string = '/api/listing/my-notes';
+    readonly queryName: string = 'Cratis.Showrunner.Notes.Listing.MyNote.MyNotes';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly defaultValue: MyNote[] = [];
+    private readonly _sortBy: MyNotesSortBy;
+    private static readonly _sortBy: MyNotesSortByWithoutQuery = new MyNotesSortByWithoutQuery();
+
+    constructor() {
+        super(MyNote, true);
+        this._sortBy = new MyNotesSortBy(this);
+    }
+
+    get requiredRequestParameters(): string[] {
+        return [
+        ];
+    }
+
+    readonly parameterDescriptors: ParameterDescriptor[] = [
+    ];
+
+
+    get sortBy(): MyNotesSortBy {
+        return this._sortBy;
+    }
+
+    static get sortBy(): MyNotesSortByWithoutQuery {
+        return this._sortBy;
+    }
+
+    static use(sorting?: Sorting): [QueryResultWithState<MyNote[]>, SetSorting] {
+        return useObservableQuery<MyNote[], MyNotes>(MyNotes, undefined, sorting);
+    }
+
+    static useWithPaging(pageSize: number, sorting?: Sorting): [QueryResultWithState<MyNote[]>, SetSorting, SetPage, SetPageSize] {
+        return useObservableQueryWithPaging<MyNote[], MyNotes>(MyNotes, new Paging(0, pageSize), undefined, sorting);
+    }
+
+    static useSuspense(sorting?: Sorting): [QueryResultWithState<MyNote[]>, SetSorting] {
+        return useSuspenseObservableQuery<MyNote[], MyNotes>(MyNotes, undefined, sorting);
+    }
+
+    static useSuspenseWithPaging(pageSize: number, sorting?: Sorting): [QueryResultWithState<MyNote[]>, SetSorting, SetPage, SetPageSize] {
+        return useSuspenseObservableQueryWithPaging<MyNote[], MyNotes>(MyNotes, new Paging(0, pageSize), undefined, sorting);
+    }
+
+    static useChangeStream(getKey?: (item: MyNote) => unknown, sorting?: Sorting): ChangeSet<MyNote> {
+        return useChangeStream<MyNote, MyNotes>(MyNotes, undefined, getKey, sorting);
+    }
+
+    static when(condition: boolean): ObservableQueryWhen<MyNotes, MyNote[]> {
+        return new ObservableQueryWhen<MyNotes, MyNote[]>(MyNotes, condition);
+    }
+}
+
+/**
+ * One of the user's notes, as the list of their notes shows it, with where it is: given, acknowledged, addressed, declined or withdrawn.
+ */
+export class MyNote {
+
+    /**
+     * The note.
+     */
+    @field(Guid)
+    id!: Guid;
+
+    /**
+     * Who gave the note.
+     */
+    @field(String)
+    givenBy!: string;
+
+    /**
+     * What the note is about.
+     */
+    @field(Number)
+    target!: NoteTarget;
+
+    /**
+     * What kind of feedback it is.
+     */
+    @field(Number)
+    kind!: NoteKind;
+
+    /**
+     * What the giver wrote; empty on a note that has suggested property changes only.
+     */
+    @field(String)
+    text!: string;
+
+    /**
+     * Where in the application the giver was.
+     */
+    @field(SliceLocation)
+    location!: SliceLocation;
+
+    /**
+     * The screen the giver was on.
+     */
+    @field(NoteScreen)
+    screen!: NoteScreen;
+
+    /**
+     * The slices the giver picked; empty unless the note is about slices.
+     */
+    @field(SliceLocation, true)
+    slices!: SliceLocation[];
+
+    /**
+     * The name of the component the giver picked; {@link NotSet} unless the note is about a component.
+     */
+    @field(String)
+    component!: string;
+
+    /**
+     * The property changes the giver suggested.
+     */
+    @field(SuggestedPropertyChange, true)
+    propertyChanges!: SuggestedPropertyChange[];
+
+    /**
+     * Where the note is.
+     */
+    @field(Number)
+    status!: NoteStatus;
+
+    /**
+     * The version that addresses the note or why it is declined; empty otherwise.
+     */
+    @field(String)
+    statusDetail!: string;
+
+    /**
+     * When the giver gave it.
+     */
+    @field(Date)
+    givenAt!: Date;
+
+    /**
+     * When anything last happened on it.
+     */
+    @field(Date)
+    lastActivityAt!: Date;
+}

package/Listing/NoteStatus.ts

@@ -0,0 +1,15 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+// **DO NOT EDIT** - This file is an automatically generated file.
+// @generated by Cratis. Source: Cratis.Showrunner.Notes.Listing.NoteStatus. Time: 2026-11-01T11:55:12.6707473Z. Hash: 8A4EB1CDFDCC33226EDCA2C905DF131D826F8B88D67FAA027E76B9CEBAF7BB0B
+/**
+ * Where a note is, as the giver sees it.
+ */
+export enum NoteStatus {
+    given = 0,
+    acknowledged = 1,
+    addressed = 2,
+    declined = 3,
+    withdrawn = 4,
+}

package/Listing/NoteTarget.ts

@@ -0,0 +1,14 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+// **DO NOT EDIT** - This file is an automatically generated file.
+// @generated by Cratis. Source: Cratis.Showrunner.Notes.Listing.NoteTarget. Time: 2026-11-01T11:55:12.6707473Z. Hash: D3CEBE50C47D6F88D67A3005BEFAB6B0794F6B872FB64C0108B8B94B3B5B4585
+/**
+ * What a note is about.
+ */
+export enum NoteTarget {
+    context = 0,
+    slices = 1,
+    screen = 2,
+    component = 3,
+}

package/Listing/SuggestedPropertyChange.ts

@@ -0,0 +1,30 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+// **DO NOT EDIT** - This file is an automatically generated file.
+// @generated by Cratis. Source: Cratis.Showrunner.Notes.Listing.SuggestedPropertyChange. Time: 2026-11-01T11:55:12.6707473Z. Hash: 12DABFA7B05F41B5A25C6FEB38D618AC0FFF2E30C1C4637FD08A8E4212F95C5E
+import { field } from '@cratis/fundamentals';
+
+/**
+ * A presentation property change the giver suggested on a note.
+ */
+export class SuggestedPropertyChange {
+
+    /**
+     * The property.
+     */
+    @field(String)
+    property!: string;
+
+    /**
+     * The value it has.
+     */
+    @field(String)
+    currentValue!: string;
+
+    /**
+     * The value the giver suggests.
+     */
+    @field(String)
+    suggestedValue!: string;
+}

package/Listing/index.ts

@@ -0,0 +1,7 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+export * from './MyNote';
+export * from './NoteStatus';
+export * from './NoteTarget';
+export * from './SuggestedPropertyChange';

package/README.md

@@ -1,3 +1,87 @@
-# Temporary Holding Version
+# Showrunner
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> Showrunner is a set of ready-made product parts for applications built on [Cratis](https://www.cratis.io) — drop-in backend and frontend packages, built as Arc and Chronicle vertical slices.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Build](https://github.com/Cratis/Showrunner/actions/workflows/build.yml/badge.svg)](https://github.com/Cratis/Showrunner/actions/workflows/build.yml)
+[![Publish](https://github.com/Cratis/Showrunner/actions/workflows/publish.yml/badge.svg)](https://github.com/Cratis/Showrunner/actions/workflows/publish.yml)
+[![Discord](https://img.shields.io/discord/1182595891576717413?label=Discord&logo=discord&logoColor=white)](https://discord.gg/kt4AMpV8WV)
+
+## Usher
+
+**Usher** is the support part: it lets the users of an application report issues and hold support conversations with the people running it. It is a library an application hosts, not a service of its own — the backend package adds Usher's commands, queries and events to the host's Arc application and Chronicle event store, and the frontend packages give the host's React UI the generated proxies and components to drive them.
+
+Usher covers reporting an issue, error capture, the conversation, time-limited support access through AuthProxy's on-behalf sessions and the exchange of events with a desk; see [Documentation](./Documentation/Usher/index.md).
+
+**Box Office** is the licensing part: trials, seats, modules, compute allowances and suspension, decided by the operator of a managed product and honored by the product. Its event contracts, its catalog of offers and prices, and a product's offering declaration and compute metering are in place; see [Documentation](./Documentation/BoxOffice/index.md).
+
+**Marquee** is the announcements part: the people running a product write an announcement with an audience, a display and an exact window, and the product shows it to the people it reaches, as a banner or a dialog. Drop `<Marquee />` into the application shell and it brings its own queries and commands; see [Documentation](./Documentation/Marquee/index.md).
+
+**Notes** is the product feedback part: the users of an application give a note about what they are looking at — the slice, the screen or a single component — and the people building the application receive it as events and answer it. The application hosts `Cratis.Showrunner.Notes`, the builder hosts `Cratis.Showrunner.Notes.Collecting`; see [Documentation](./Documentation/Notes/index.md).
+
+**Herald** is the email part: an application asks it to send an email of a kind, such as an invitation, and it fills the template for that kind and language, makes the HTML safe for email clients, embeds the images, sends it over SMTP and records the outcome. Failed sends are queued and retried; see [Documentation](./Documentation/Herald/index.md).
+
+**Stage Manager** is the Kubernetes operator. Unlike the other parts it is a service you install with the `cratis/showrunner-operator` Helm chart: a `Performance` runs an application, or a published Stage application, with its AuthProxy and its own Ante from a Cratis environment, reachable only through AuthProxy; see [Documentation](./Documentation/StageManager/index.md).
+
+## Packages
+
+| Package | Registry | What it is |
+| --- | --- | --- |
+| `Cratis.Showrunner.BoxOffice.Catalog` | NuGet | Box Office's catalog — offers (seat plans, modules, compute packs), prices and the pricing arithmetic, published to products |
+| `Cratis.Showrunner.BoxOffice.Offering` | NuGet | Box Office for a product — declares what the product sells (modules, meters, seat licensing) and measures its compute per tenant and day |
+| `Cratis.Showrunner.BoxOffice.Product` | NuGet | Box Office for a managed product, in one call — creates the tenants the operator registers and reports them ready, answers whether a person may take a seat and whether a tenant is read-only, and reports who was active |
+| `Cratis.Showrunner.BoxOffice.Contracts` | NuGet | Box Office's event contracts: what an operator decides about a tenant and what a product reports back |
+| `Cratis.Showrunner.Herald.Contracts` | NuGet | Herald's event contracts: the facts recorded when an email was sent, failed or bounced |
+| `Cratis.Showrunner.Herald` | NuGet | Herald's backend — templates, strict rendering, images, SMTP and folder transports, queued delivery with retries, recorded in the application's Chronicle event store |
+| `cratis/showrunner-operator` | Docker Hub, Helm (OCI) | Stage Manager, the Kubernetes operator, as a container image and a Helm chart released with the same version |
+| `Cratis.Showrunner.Usher.Contracts` | NuGet | Usher's event contracts, for hosts that react to what Usher records |
+| `Cratis.Showrunner.Marquee.Contracts` | NuGet | Marquee's event contracts: the public events a product receives announcements through |
+| `Cratis.Showrunner.Marquee.Authoring` | NuGet | Marquee's authoring backend — commands, query and outbox for writing announcements, built on Arc and Chronicle |
+| `Cratis.Showrunner.Marquee` | NuGet | Marquee's backend for products — receives announcements once, shows each tenant what its audience matches and records acknowledgements |
+| `Cratis.Showrunner.Usher` | NuGet | Usher's backend — Arc commands and queries over Chronicle |
+| `Cratis.Showrunner.Notes.Contracts` | NuGet | Notes' event contracts: the public events an application and the people building it exchange about product feedback |
+| `Cratis.Showrunner.Notes` | NuGet | Notes' backend for applications — commands to give, suggest and withdraw notes, the live list of a user's notes with their status, and the outbox that publishes them |
+| `Cratis.Showrunner.Notes.Collecting` | NuGet | Notes' receiving side for the builder of an application — reads the applications' notes into the tenant's namespace and answers them |
+| `@cratis/showrunner.marquee` | npm | The generated TypeScript proxies for Marquee's receiving commands and queries; no UI framework dependency |
+| `@cratis/showrunner.marquee.authoring` | npm | The generated TypeScript proxies for Marquee's authoring commands and query; no UI framework dependency |
+| `@cratis/showrunner.marquee.react` | npm | The Marquee drop-in React component: banners and dialogs for a product's announcements, built on `@cratis/arc.react` and `@cratis/components` |
+| `@cratis/showrunner.usher` | npm | The generated TypeScript proxies for Usher's commands and queries; no UI framework dependency |
+| `@cratis/showrunner.usher.react` | npm | React components for Usher, built on `@cratis/arc.react` and `@cratis/components` |
+| `@cratis/showrunner.notes` | npm | The generated TypeScript proxies for Notes' commands and queries; no UI framework dependency |
+| `@cratis/showrunner.notes.react` | npm | React components for Notes: the feedback button with its context drop-down, the feedback dialogs, the component picker and the user's own feedback, built on `@cratis/arc.react` and `@cratis/components` |
+
+## Building
+
+Prerequisites: the .NET SDK from [`global.json`](./global.json) (10.0.400 or later) and Node.js 20 or later with Corepack enabled (`corepack enable`); Yarn itself is checked in under `.yarn/releases`.
+
+```shell
+# Backend: Debug builds compile the inline specs and regenerate the TypeScript proxies
+dotnet build Showrunner.slnx --configuration Debug
+dotnet test Showrunner.slnx --configuration Debug --no-build
+
+# Release is warnings-as-errors; clearing CratisProxiesOutputPath skips proxy generation
+dotnet build Showrunner.slnx --configuration Release -p:CratisProxiesOutputPath=
+
+# Frontend
+yarn install
+yarn lint:ci
+yarn compile
+yarn test
+yarn build
+```
+
+Specifications live beside the code they specify — `for_*/when_*/` folders compiled into Debug builds only for .NET, and Vitest specs in the same layout for TypeScript.
+
+The end-to-end specifications in [`Integration`](./Integration) run Usher and a desk against a real Chronicle kernel in a container, so `dotnet test Showrunner.slnx` needs Docker. The end-to-end specifications for Notes in [`Integration.Notes`](./Integration.Notes) run an application and a collecting host the same way, sharing Usher's kernel container. Set `USHER_CHRONICLE_IMAGE` to run them against another kernel image, and `USHER_INTEGRATION_LOG` to a file path to keep the application's log.
+
+## Releasing
+
+Every pull request carries exactly one of the `major`, `minor`, `patch` or `no-release` labels. Merging a version-labelled pull request to `main` releases all four packages under one semantic version through [`cratis/release-action`](https://github.com/Cratis/release-action) — NuGet packages through NuGet trusted publishing and npm packages through npm trusted publishing with provenance. The packages are built and packed in jobs without publishing rights; separate jobs that run no build or install script hold the short-lived OIDC token and only push what was packed.
+
+## Part of the Cratis ecosystem
+
+Showrunner is a [Cratis](https://www.cratis.io) project, built on event sourcing with [Chronicle](https://github.com/Cratis/Chronicle) and CQRS with [Arc](https://github.com/Cratis/Arc), with frontends on [`@cratis/components`](https://github.com/Cratis/Components). Join the community on [Discord](https://discord.gg/kt4AMpV8WV).
+
+## License
+
+Showrunner is licensed under the [MIT License](LICENSE) and free to use.

package/Withdrawing/WithdrawNote/WithdrawNote.ts

@@ -0,0 +1,61 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+// **DO NOT EDIT** - This file is an automatically generated file.
+// @generated by Cratis. Source: Cratis.Showrunner.Notes.Withdrawing.WithdrawNote.WithdrawNote. Time: 2026-11-01T11:55:12.6707473Z. Hash: 6187372217CAB22FD8266A2E14512A47E2170C4FB9DF46D463F85BDBBF911481
+import { Command } from '@cratis/arc/commands';
+import { ClearCommandValues, SetCommandValues, useCommand } from '@cratis/arc.react/commands';
+import { SliceLocation as ArcSliceLocation, PropertyDescriptor } from '@cratis/arc/reflection';
+import { Guid } from '@cratis/fundamentals';
+
+/**
+ * The giver withdraws one of their notes; the people building the application no longer need to act on it.
+ */
+export interface IWithdrawNote {
+
+    /**
+     * The note to withdraw.
+     */
+    noteId?: Guid;
+}
+
+
+/**
+ * The giver withdraws one of their notes; the people building the application no longer need to act on it.
+ */
+export class WithdrawNote extends Command<IWithdrawNote> implements IWithdrawNote {
+    static readonly sliceLocation: ArcSliceLocation = new ArcSliceLocation('', 'Withdrawing', 'WithdrawNote');
+    readonly route: string = '/api/withdrawing/withdraw-note';
+    readonly treatWarningsAsErrors: boolean = false;
+    readonly roles: string[] = [];
+    readonly propertyDescriptors: PropertyDescriptor[] = [
+        new PropertyDescriptor('noteId', Guid, false),
+    ];
+
+    #noteId!: Guid;
+
+    constructor() {
+        super(Object, false);
+    }
+
+    get requestParameters(): string[] {
+        return [
+        ];
+    }
+
+    /**
+     * The note to withdraw.
+     */
+    get noteId(): Guid {
+        return this.#noteId;
+    }
+
+    set noteId(value: Guid) {
+        this.#noteId = value;
+        this.propertyChanged('noteId');
+    }
+
+    static use(initialValues?: IWithdrawNote): [WithdrawNote, SetCommandValues<IWithdrawNote>, ClearCommandValues] {
+        return useCommand<WithdrawNote, IWithdrawNote>(WithdrawNote, initialValues);
+    }
+}

package/Withdrawing/WithdrawNote/index.ts

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+export * from './WithdrawNote';

package/dist/cjs/Availability/NotesAvailability.d.ts

@@ -0,0 +1,21 @@
+import { QueryFor, QueryResultWithState } from '@cratis/arc/queries';
+import { PerformQuery, QueryWhen, SetSorting } from '@cratis/arc.react/queries';
+import { SliceLocation as ArcSliceLocation, ParameterDescriptor } from '@cratis/arc/reflection';
+export declare class Availability extends QueryFor<NotesAvailability> {
+    static readonly sliceLocation: ArcSliceLocation;
+    readonly route: string;
+    readonly queryName: string;
+    readonly treatWarningsAsErrors: boolean;
+    readonly roles: string[];
+    readonly defaultValue: NotesAvailability;
+    constructor();
+    get requiredRequestParameters(): string[];
+    readonly parameterDescriptors: ParameterDescriptor[];
+    static use(): [QueryResultWithState<NotesAvailability>, PerformQuery, SetSorting];
+    static useSuspense(): [QueryResultWithState<NotesAvailability>, PerformQuery, SetSorting];
+    static when(condition: boolean): QueryWhen<Availability, NotesAvailability>;
+}
+export declare class NotesAvailability {
+    isEnabled: boolean;
+}
+//# sourceMappingURL=NotesAvailability.d.ts.map

package/dist/cjs/Availability/NotesAvailability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotesAvailability.d.ts","sourceRoot":"","sources":["../../../Availability/NotesAvailability.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAA8B,MAAM,2BAA2B,CAAC;AAC5G,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAMhG,qBAAa,YAAa,SAAQ,QAAQ,CAAC,iBAAiB,CAAC;IACzD,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAgD;IAC/F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAoC;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAyE;IACnG,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAS;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAM;IAC9B,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAA2B;;IAMnE,IAAI,yBAAyB,IAAI,MAAM,EAAE,CAGxC;IAED,QAAQ,CAAC,oBAAoB,EAAE,mBAAmB,EAAE,CAClD;IAIF,MAAM,CAAC,GAAG,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC;IAIjF,MAAM,CAAC,WAAW,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,YAAY,EAAE,UAAU,CAAC;IAIzF,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC,YAAY,EAAE,iBAAiB,CAAC;CAG9E;AAKD,qBAAa,iBAAiB;IAM1B,SAAS,EAAG,OAAO,CAAC;CACvB"}

package/dist/cjs/Availability/NotesAvailability.js

@@ -0,0 +1,66 @@
+'use strict';
+
+var queries = require('@cratis/arc/queries');
+var queries$1 = require('@cratis/arc.react/queries');
+var reflection = require('@cratis/arc/reflection');
+var fundamentals = require('@cratis/fundamentals');
+
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : 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;
+}
+function _ts_metadata(metadataKey, metadataValue) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+        return Reflect.metadata(metadataKey, metadataValue);
+    }
+}
+/**
+ * Gets whether Notes is switched on. It is the same answer for everyone, so it needs no sign-in: the button shows only to a signed-in user anyway, and the commands refuse everyone else.
+ */ class Availability extends queries.QueryFor {
+    static sliceLocation = new reflection.SliceLocation('', '', 'Availability');
+    route = '/api/availability/availability';
+    queryName = 'Cratis.Showrunner.Notes.Availability.NotesAvailability.Availability';
+    treatWarningsAsErrors = false;
+    roles = [];
+    defaultValue = {};
+    constructor(){
+        super(NotesAvailability, false);
+    }
+    get requiredRequestParameters() {
+        return [];
+    }
+    parameterDescriptors = [];
+    static use() {
+        return queries$1.useQuery(Availability);
+    }
+    static useSuspense() {
+        return queries$1.useSuspenseQuery(Availability);
+    }
+    static when(condition) {
+        return new queries$1.QueryWhen(Availability, condition);
+    }
+}
+/**
+ * Whether Notes is switched on in the application. The feedback button renders only when it is.
+ */ class NotesAvailability {
+    /**
+     * Whether the host switched Notes on.
+     */ isEnabled;
+}
+_ts_decorate([
+    fundamentals.field(Boolean),
+    _ts_metadata("design:type", Boolean)
+], NotesAvailability.prototype, "isEnabled", void 0);
+
+exports.Availability = Availability;
+exports.NotesAvailability = NotesAvailability;
+//# sourceMappingURL=NotesAvailability.js.map

package/dist/cjs/Availability/NotesAvailability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotesAvailability.js","sources":["../../../Availability/NotesAvailability.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n// **DO NOT EDIT** - This file is an automatically generated file.\n// @generated by Cratis. Source: Cratis.Showrunner.Notes.Availability.NotesAvailability, Cratis.Showrunner.Notes.Availability.NotesAvailability. Time: 2026-11-01T11:55:12.6707473Z. Hash: 7D28D58AEA837A3CBE5F66D04986F5BD5F4F7F950F141F37B794A04B3F6A7781\nimport { QueryFor, QueryResultWithState } from '@cratis/arc/queries';\nimport { PerformQuery, QueryWhen, SetSorting, useQuery, useSuspenseQuery } from '@cratis/arc.react/queries';\nimport { SliceLocation as ArcSliceLocation, ParameterDescriptor } from '@cratis/arc/reflection';\nimport { field } from '@cratis/fundamentals';\n\n/**\n * Gets whether Notes is switched on. It is the same answer for everyone, so it needs no sign-in: the button shows only to a signed-in user anyway, and the commands refuse everyone else.\n */\nexport class Availability extends QueryFor<NotesAvailability> {\n    static readonly sliceLocation: ArcSliceLocation = new ArcSliceLocation('', '', 'Availability');\n    readonly route: string = '/api/availability/availability';\n    readonly queryName: string = 'Cratis.Showrunner.Notes.Availability.NotesAvailability.Availability';\n    readonly treatWarningsAsErrors: boolean = false;\n    readonly roles: string[] = [];\n    readonly defaultValue: NotesAvailability = {} as NotesAvailability;\n\n    constructor() {\n        super(NotesAvailability, false);\n    }\n\n    get requiredRequestParameters(): string[] {\n        return [\n        ];\n    }\n\n    readonly parameterDescriptors: ParameterDescriptor[] = [\n    ];\n\n\n\n    static use(): [QueryResultWithState<NotesAvailability>, PerformQuery, SetSorting] {\n        return useQuery<NotesAvailability, Availability>(Availability);\n    }\n\n    static useSuspense(): [QueryResultWithState<NotesAvailability>, PerformQuery, SetSorting] {\n        return useSuspenseQuery<NotesAvailability, Availability>(Availability);\n    }\n\n    static when(condition: boolean): QueryWhen<Availability, NotesAvailability> {\n        return new QueryWhen<Availability, NotesAvailability>(Availability, condition);\n    }\n}\n\n/**\n * Whether Notes is switched on in the application. The feedback button renders only when it is.\n */\nexport class NotesAvailability {\n\n    /**\n     * Whether the host switched Notes on.\n     */\n    @field(Boolean)\n    isEnabled!: boolean;\n}\n"],"names":["Availability","QueryFor","sliceLocation","ArcSliceLocation","route","queryName","treatWarningsAsErrors","roles","defaultValue","NotesAvailability","requiredRequestParameters","parameterDescriptors","use","useQuery","useSuspense","useSuspenseQuery","when","condition","QueryWhen","isEnabled"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAUA;;IAGO,MAAMA,YAAAA,SAAqBC,gBAAAA,CAAAA;AAC9B,IAAA,OAAgBC,aAAAA,GAAkC,IAAIC,wBAAAA,CAAiB,EAAA,EAAI,IAAI,cAAA,CAAA;AACtEC,IAAAA,KAAAA,GAAgB,gCAAA;AAChBC,IAAAA,SAAAA,GAAoB,qEAAA;AACpBC,IAAAA,qBAAAA,GAAiC,KAAA;AACjCC,IAAAA,KAAAA,GAAkB,EAAE;AACpBC,IAAAA,YAAAA,GAAkC,EAAC;IAE5C,WAAA,EAAc;AACV,QAAA,KAAK,CAACC,iBAAAA,EAAmB,KAAA,CAAA;AAC7B,IAAA;AAEA,IAAA,IAAIC,yBAAAA,GAAsC;AACtC,QAAA,OAAO,EACN;AACL,IAAA;AAESC,IAAAA,oBAAAA,GAA8C,EACtD;AAID,IAAA,OAAOC,GAAAA,GAA2E;AAC9E,QAAA,OAAOC,kBAAAA,CAA0Cb,YAAAA,CAAAA;AACrD,IAAA;AAEA,IAAA,OAAOc,WAAAA,GAAmF;AACtF,QAAA,OAAOC,0BAAAA,CAAkDf,YAAAA,CAAAA;AAC7D,IAAA;IAEA,OAAOgB,IAAAA,CAAKC,SAAkB,EAA8C;QACxE,OAAO,IAAIC,oBAA2ClB,YAAAA,EAAciB,SAAAA,CAAAA;AACxE,IAAA;AACJ;AAEA;;AAEC,IACM,MAAMR,iBAAAA,CAAAA;AAET;;AAEC,QACD,SACAU;AACJ;;;;;;;"}

package/dist/cjs/Availability/index.d.ts

@@ -0,0 +1,2 @@
+export * from './NotesAvailability';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/Availability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../Availability/index.ts"],"names":[],"mappings":"AAGA,cAAc,qBAAqB,CAAC"}

package/dist/cjs/Contracts/Components/PickedComponent.d.ts

@@ -0,0 +1,9 @@
+import { SliceLocation } from '../Reporting/SliceLocation';
+export declare class PickedComponent {
+    componentName: string;
+    componentId: string;
+    part: string;
+    ancestors: string[];
+    location: SliceLocation;
+}
+//# sourceMappingURL=PickedComponent.d.ts.map

package/dist/cjs/Contracts/Components/PickedComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PickedComponent.d.ts","sourceRoot":"","sources":["../../../../Contracts/Components/PickedComponent.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAK3D,qBAAa,eAAe;IAMxB,aAAa,EAAG,MAAM,CAAC;IAMvB,WAAW,EAAG,MAAM,CAAC;IAMrB,IAAI,EAAG,MAAM,CAAC;IAMd,SAAS,EAAG,MAAM,EAAE,CAAC;IAMrB,QAAQ,EAAG,aAAa,CAAC;CAC5B"}