@estiva-app/ui 0.71.0 → 0.72.0-widgets2.0

package/dist/widgets-2/fixtures.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Widgets 2 prototype: the placeholder things every widget on these pages
+ * draws. Words are placeholders (stories-and-pages.md); the kinds are named,
+ * because telling them apart is what the prototype is for.
+ */
+import type { ThingKind } from '../KindIcon';
+/** The colours a status draws in, as the apps' manifests name them. */
+export type StatusColour = 'neutral' | 'blue' | 'green' | 'muted';
+export interface Status {
+    label: string;
+    colour: StatusColour;
+}
+/** One thing a link can stand for, with every field any app draws today. */
+export interface Thing {
+    /** The kinds the prototype covers, one more than KindIcon has: a page. */
+    kind: ThingKind | 'page';
+    /** The noun a card's corner says. */
+    noun: string;
+    /** The app it opens in. */
+    app: string;
+    title: string;
+    /** Its key, the way people say it: an issue's "WID-2". */
+    key?: string;
+    /** The line under the title: the project an issue is in, a page's Folder. */
+    subtitle?: string;
+    /** The opening of its description, a page's text, a message's words: what the apps draw today. */
+    body?: string;
+    /**
+     * A short summary of the file, one or two sentences (Miky, 15 Oct: detailed
+     * shows the summary, not the opening of the long description). No file
+     * carries one yet; it is its own project.
+     */
+    summary?: string;
+    status?: Status;
+    assignee?: string;
+    author?: string;
+    /** Everyone who wrote a page. */
+    authors?: string[];
+    comments?: number;
+    /**
+     * The reader has something unread in its conversation: they are a member
+     * and it moved since they last read it (SPEC §11.8, membership-replaces-following).
+     */
+    unread?: boolean;
+    /** A project's issues, drawn as rows inside its detailed card. */
+    children?: {
+        title: string;
+        key: string;
+        status: Status;
+        assignee?: string;
+    }[];
+    /** A project's progress line. */
+    progress?: string;
+    /** A project's progress as numbers, for the ring. */
+    done?: {
+        done: number;
+        total: number;
+    };
+    /** A topic: how many conversations, who is in it, and its latest one. */
+    conversations?: number;
+    members?: string[];
+    latest?: {
+        author: string;
+        body: string;
+        at: string;
+    };
+    updated?: string;
+}
+export declare const ISSUE: Thing;
+export declare const PROJECT: Thing;
+export declare const TOPIC: Thing;
+export declare const MESSAGE: Thing;
+export declare const PAGE: Thing;
+/** A block of a description: drawn live, as the part it is. */
+export declare const PART: {
+    heading: string;
+    noun: string;
+    app: string;
+    blocks: string[];
+};
+export declare const ATTACHMENT: {
+    name: string;
+    size: number;
+    contentType: string;
+};
+export declare const ATTACHMENT_FILE: {
+    name: string;
+    size: number;
+    contentType: string;
+};
+/** A file the reader cannot read: only its kind and app are known, from its address. */
+export declare const UNREADABLE: {
+    kind: "issue";
+    noun: string;
+    app: string;
+    address: string;
+};
+/** A small picture for the attachment, drawn rather than fetched. */
+export declare const PICTURE: string;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/widgets-2/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/widgets-2/fixtures.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAEjE,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,YAAY,CAAA;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,KAAK;IACpB,0EAA0E;IAC1E,IAAI,EAAE,SAAS,GAAG,MAAM,CAAA;IACxB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kGAAkG;IAClG,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kEAAkE;IAClE,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC9E,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qDAAqD;IACrD,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAWD,eAAO,MAAM,KAAK,EAAE,KAanB,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,KAiBrB,CAAA;AAED,eAAO,MAAM,KAAK,EAAE,KAUnB,CAAA;AAED,eAAO,MAAM,OAAO,EAAE,KAQrB,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,KAYlB,CAAA;AAED,+DAA+D;AAC/D,eAAO,MAAM,IAAI;;;;;CAKhB,CAAA;AAED,eAAO,MAAM,UAAU;;;;CAAuE,CAAA;AAC9F,eAAO,MAAM,eAAe;;;;CAAgF,CAAA;AAE5G,wFAAwF;AACxF,eAAO,MAAM,UAAU;;;;;CAAiH,CAAA;AAExI,qEAAqE;AACrE,eAAO,MAAM,OAAO,QAIjB,CAAA"}

package/dist/widgets-2/proposed.d.ts

@@ -0,0 +1,130 @@
+import type { ReactNode } from 'react';
+import type { Status, Thing } from './fixtures';
+/** A status as its shape: Ship's icons, which read without colour. */
+export declare function StatusMark({ status }: {
+    status: Status;
+}): import("react").JSX.Element;
+/** The icon for a kind. A page gets its own (proposed): today every app draws it as "another app's file". */
+export declare function ThingIcon({ kind, size, tone }: {
+    kind: Thing['kind'];
+    size?: 14 | 16;
+    tone?: 'secondary' | 'inherit';
+}): import("react").JSX.Element;
+/**
+ * Progress as a small ring with the count beside it as a label (Miky, 15 Oct,
+ * second round: the ring with the count inside was too big).
+ */
+export declare function ProgressRing({ done, total }: {
+    done: number;
+    total: number;
+}): import("react").JSX.Element;
+export interface ReferenceChipProps {
+    thing: Thing;
+    state?: 'ready' | 'loading' | 'unavailable';
+    /** Hovering the chip shows the detailed card. */
+    preview?: boolean;
+}
+/**
+ * A link in running text: the icon (or the author's face), the key, the
+ * title cut at 24ch, the status as its shape. Loading keeps the icon (the
+ * kind is known from the address); not available says so in words.
+ */
+export declare function ReferenceChip({ thing, state, preview }: ReferenceChipProps): import("react").JSX.Element;
+export type CardLayout = 'compact' | 'detailed';
+/** Compact: one 36px line. Every kind, every app. Hovering it shows the detailed card. */
+export declare function CompactCard({ thing, preview }: {
+    thing: Thing;
+    preview?: boolean;
+}): import("react").JSX.Element;
+/**
+ * Detailed: what compact cannot hold. The header is compact's line (icon, key,
+ * title as the link; a project's ring or a topic's members in the corner),
+ * then the summary, the kind's own extras (a project's issues, a topic's
+ * latest conversation), and a footer: the pickers and the comments for an
+ * issue or a project, who and when for a page and a topic.
+ *
+ * `bare` drops the card's frame, for the hover preview, which draws the
+ * package's one elevated box around it.
+ */
+export declare function DetailedCard({ thing, bare, readOnly }: {
+    thing: Thing;
+    bare?: boolean;
+    readOnly?: boolean;
+}): import("react").JSX.Element;
+/** The detailed card, on hover over a chip or a compact card: the package's preview card. */
+export declare function HoverPreview({ thing, block, children }: {
+    thing: Thing;
+    block?: boolean;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** The hover preview drawn open, for a still picture of it: the same box PreviewCard draws. */
+export declare function HoverPreviewOpen({ thing }: {
+    thing: Thing;
+}): import("react").JSX.Element;
+/**
+ * A linked message, detailed: a card, the frame every other detailed card has
+ * (Miky, 15 Oct: "card it is", over a quote). The time is the link.
+ */
+export declare function MessageCard({ thing }: {
+    thing: Thing;
+}): import("react").JSX.Element;
+/** What a kind's detailed card will hold, known before it loads (the kind is in the address). */
+export interface LoadingShape {
+    subtitle?: boolean;
+    summary?: boolean;
+    rows?: number;
+    preview?: boolean;
+    ring?: boolean;
+    footer?: 'pickers' | 'people' | 'line' | 'none';
+}
+/** The shape a thing's detailed card takes, for its placeholder. */
+export declare function loadingShapeOf(thing: Thing): LoadingShape;
+/**
+ * Loading: the card it will become, drawn in bars, at the card's own height,
+ * so the conversation does not jump when it arrives.
+ */
+export declare function CardLoading({ kind, layout, shape }: {
+    kind: Thing['kind'];
+    layout: CardLayout;
+    shape?: LoadingShape;
+}): import("react").JSX.Element;
+/**
+ * Not available: one line, at compact's height, whichever layout was chosen.
+ * Deleted and unreadable read the same (Widgets 2, Not in scope). Here the
+ * way out stays: there is no title to click, and the app it lives in may
+ * still open it for you.
+ */
+export declare function CardUnavailable({ kind, noun, app }: {
+    kind: Thing['kind'];
+    noun: string;
+    app: string;
+}): import("react").JSX.Element;
+/**
+ * A block of a description, shared live (a part). No compact or detailed:
+ * a pasted block link inserts the part itself (the-author-chooses-a-links-card,
+ * Accepted). The same header as a detailed card: the key and the title of
+ * the file it is part of, as the link.
+ */
+export declare function PartCard({ kind, heading, partKey, children, state, noun, app }: {
+    kind: Thing['kind'];
+    heading: string;
+    partKey?: string;
+    children?: ReactNode;
+    state?: 'ready' | 'loading' | 'unavailable';
+    noun: string;
+    app: string;
+}): import("react").JSX.Element;
+/**
+ * A comment's anchor: the part it is about, quoted above the comment.
+ * Unchanged from today (the two apps already agree), with the deleted line in
+ * the same muted voice as "not available.".
+ */
+export declare function CommentAnchor({ text }: {
+    text?: string;
+}): import("react").JSX.Element;
+/** An attachment's chip: a paperclip and the file's name. */
+export declare function AttachmentChip({ name, state }: {
+    name: string;
+    state?: 'ready' | 'loading' | 'unavailable';
+}): import("react").JSX.Element;
+//# sourceMappingURL=proposed.d.ts.map

package/dist/widgets-2/proposed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposed.d.ts","sourceRoot":"","sources":["../../src/widgets-2/proposed.tsx"],"names":[],"mappings":"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"}

package/dist/widgets-2.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@estiva-app/ui/widgets-2` — the Widgets 2 prototype, unlisted (WID-3).
+ *
+ * Published only as a `concept` prerelease from `concept/widgets-2`, so Peek,
+ * Ship and Leaf can draw every place a widget appears in their own Storybooks
+ * from one copy, the one Katerina's look pass changes. Never in a release: the
+ * build project shapes the real exports once the stories are approved.
+ */
+export * from './widgets-2/proposed';
+export * from './widgets-2/fixtures';
+//# sourceMappingURL=widgets-2.d.ts.map

package/dist/widgets-2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgets-2.d.ts","sourceRoot":"","sources":["../src/widgets-2.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}