@graview/primitives 0.1.0

package/dist/seats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seats.js","sourceRoot":"","sources":["../src/seats.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,KAAK;IACnB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAK,CAAC;IACvD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,CACL,eACE,IAAI,EAAC,OAAO,gBACD,MAAM,iBACL,OAAO;QACnB;;;;;WAKG;QACH,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAErF,eACE,KAAK,EAAE;oBACL,QAAQ,EAAE,SAAS;oBACnB,aAAa,EAAE,QAAQ;oBACvB,aAAa,EAAE,WAAW;oBAC1B,KAAK,EAAE,0BAA0B;iBAClC,mBAGI,EACN,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBAClB,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBACjD,OAAO,CACL,iBAEE,IAAI,EAAC,QAAQ,kBACC,IAAI,iBACL,QAAQ,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,EACtD,KAAK,EAAE,eAAe,IAAI,CAAC,KAAK,qEAAqE,EACrG,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EACvC,KAAK,EAAE;wBACL,OAAO,EAAE,UAAU;wBACnB,YAAY,EAAE,GAAG;wBACjB,QAAQ,EAAE,UAAU;wBACpB,UAAU,EAAE,QAAQ;wBACpB,WAAW,EAAE,CAAC;wBACd,WAAW,EAAE,OAAO;wBACpB,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,qBAAqB;wBACnE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,0BAA0B;wBAClE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,aAAa;qBAC1D,YAEA,IAAI,CAAC,KAAK,IAlBN,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC,KAAK,CAmB7B,CACV,CAAC;YACJ,CAAC,CAAC,IACE,CACP,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAS,QAAQ,CAAC,CAAY,EAAE,CAAY;IAC1C,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC"}

package/dist/seeding.d.ts

@@ -0,0 +1,150 @@
+import { type AnySchema, type Principal, type Store } from "@graview/core";
+import { type Plan, type PlanEntry, type PlanOptions, type PlannedCall } from "@graview/tools";
+import { type ReactNode } from "react";
+export interface BeginProps<S extends AnySchema = AnySchema> {
+    /** What to say once every kind has something in it. Absent, it says nothing. */
+    readonly whenFull?: ReactNode;
+    /**
+     * What goes around the DOOR, and only the door.
+     *
+     * On the routed face the door wants a page's column and landmark around
+     * it — `PageMain` — and `whenFull` is a whole page that brings its own.
+     * A Home that wrapped the two together put the derived home's `main`
+     * inside a second `main` and its gallery inside a reading column, one
+     * card wide at a desk. The frame is applied to the door alone; what
+     * comes when the graph is full is returned exactly as it was given.
+     */
+    readonly frame?: (door: ReactNode) => ReactNode;
+    readonly title?: string;
+    /**
+     * The level of the door's heading. A framed door is a page of its own —
+     * the routed face's first screen on an empty graph — so it is the page's
+     * level-one heading unless this says otherwise.
+     */
+    readonly heading?: 1 | 2 | 3 | 4;
+    /**
+     * The store, for a face that has no provider.
+     *
+     * The way in belongs on BOTH faces — the scene's first screen and the
+     * routed face's home are the same question — and only the scene has a
+     * provider. Given a store this reads it; inside a provider it needs
+     * nothing.
+     */
+    readonly store?: Store<S>;
+    /**
+     * Who is beginning. Without it a guarded store answers as an unroled
+     * human, which is refused everything — so a seat that may not act must
+     * still be TOLD, rather than shown an empty page.
+     */
+    readonly principal?: Principal;
+}
+export declare function Begin<S extends AnySchema>(props?: BeginProps<S>): import("react").JSX.Element;
+export interface PlanReviewProps<S extends AnySchema> {
+    readonly plan: Plan;
+    /** Applied under one batch; the handle comes back for the undo. */
+    readonly onApplied?: (batch: string, applied: number) => void;
+    readonly onDiscard?: () => void;
+    readonly title?: string;
+    /**
+     * Let a person decline an entry. A review nobody can disagree with is not
+     * a review, and declining the area declines the tree standing in it — the
+     * plan says what points at what, so the cascade is stated before the press
+     * rather than discovered after it.
+     */
+    readonly declinable?: boolean;
+    /** Passed on when the plan is re-made after a decline. */
+    readonly options?: PlanOptions<S>;
+    /**
+     * What a follow-up act adds, in the product's words. Given the entry and
+     * the names of everything else in the plan; return null to fall back to
+     * the mutation's own title, which is always at least true.
+     */
+    readonly also?: (entry: PlanEntry, names: ReadonlyMap<string, string>) => string | null;
+    /** Anything the product wants said above the list — a summary, a warning. */
+    readonly header?: ReactNode;
+    /** Render without the panel around it, for a product with its own frame. */
+    readonly bare?: boolean;
+    /** A name for the turn, so the activity rail reads as one thing. */
+    readonly batch?: string;
+    /** For the routed face, which has no provider. See `<Begin>`. */
+    readonly store?: Store<S>;
+    readonly principal?: Principal;
+}
+/**
+ * WHAT A MODEL WANTS TO DO, BEFORE IT DOES IT.
+ *
+ * In the order it will run, with what it makes counted, and the refusals
+ * struck through with their reason rather than dropped — the same honesty
+ * the actions strip gives a seat that may not act. Applying is one press and
+ * one turn, so taking it back is one press too.
+ */
+export declare function PlanReview<S extends AnySchema>(props: PlanReviewProps<S>): import("react").JSX.Element;
+/** The long edge, in pixels. Enough to see a blockage, not a print. */
+export declare const PHOTO_MAX_EDGE = 1280;
+/** JPEG quality. What a model is asked to look at is texture, not a print. */
+export declare const PHOTO_QUALITY = 0.7;
+/**
+ * A file from a camera or the filesystem, down to something sendable.
+ *
+ * Browser-only: it is the one part of the photograph path that needs a
+ * canvas. It ALWAYS re-encodes, even when the original is small, so what
+ * comes out is one known format rather than whatever the phone produced —
+ * HEIC and 12-bit PNGs both arrive here and neither belongs in a snapshot
+ * or on the wire.
+ *
+ * Every product that lets a model look at something wrote this, and the one
+ * that did not sent six megabytes per frame and wondered why it was slow.
+ */
+export declare function downscale(file: Blob, maxEdge?: number, quality?: number): Promise<string>;
+export interface IntakeProps {
+    /** Data URLs, in the order they were given, already made smaller. */
+    readonly onPhotos: (photos: readonly string[]) => void;
+    readonly accept?: string;
+    readonly label?: string;
+    /**
+     * The most one ask may carry. A model's context is finite and so is the
+     * patience of whoever is waiting, so this is a number a product states
+     * rather than a wall it discovers.
+     */
+    readonly most?: number;
+    /** How many are already chosen, when the product is holding them. */
+    readonly chosen?: number;
+    /** The long edge to resize to before handing them over. */
+    readonly maxEdge?: number;
+    readonly quality?: number;
+    /** Said when more were offered than there was room for. */
+    readonly onTrouble?: (message: string) => void;
+}
+/**
+ * PHOTOGRAPHS IN. A drop zone and a file input over one handler, because a
+ * product that lets a model look at something has to get the something in,
+ * and every one of them wrote this — including the downscaling, which is
+ * not a detail: a phone photograph is three to six megabytes, and a dozen
+ * of them at full size will exhaust a browser's whole storage quota and
+ * lose the graph along with them.
+ *
+ * It says what it does, every time, because "and none is kept" is the
+ * sentence a person actually wants before they hand over pictures of their
+ * house.
+ */
+export declare function Intake({ onPhotos, accept, label, most, chosen, maxEdge, quality, onTrouble, }: IntakeProps): import("react").JSX.Element;
+export interface DoorProps {
+    /** The declared provider this door is for. */
+    readonly provider: string;
+    /** What to ask it, built by the app from its own graph. */
+    readonly prompt: string;
+    readonly photos?: readonly string[];
+    /** Proposals read out of whatever came back. */
+    readonly onProposals: (proposals: readonly PlannedCall[]) => void;
+}
+/**
+ * THE DOORS A PROVIDER DECLARED, drawn.
+ *
+ * `reach: ["paste", "local"]` is the declaration; this is what it looks like.
+ * Paste is the floor and works everywhere — a prompt to copy out, an answer
+ * to paste back — and needs no key, no network and no permission. `local` is
+ * the machine under the dev server, offered only when something is actually
+ * answering there. A door the provider did not declare is not drawn.
+ */
+export declare function Door<S extends AnySchema>({ provider, prompt, photos, onProposals }: DoorProps): import("react").JSX.Element | null;
+//# sourceMappingURL=seeding.d.ts.map

package/dist/seeding.d.ts.map

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