@graview/core 0.1.59 → 0.1.61

package/dist/sync/recurrence.js

@@ -0,0 +1,192 @@
+import { instantIn, wallIn } from "../days.js";
+import { WEEKDAYS, isRepeat } from "../repeat.js";
+import { addDays, pad, weekdayOf as weekdayIndexOf } from "../wall-time.js";
+/*
+ * A RECORD THAT RECURS, AS ONE GOOGLE EVENT (Roadmap
+ * f-connection-weekly-records-recur, FR-230). Two shapes of record say a
+ * week: a weekday set and two times of day ("mon, wed", "09:00"–"10:30"),
+ * and a date that repeats (`repeat.ts`: the first occurrence and the rule
+ * beside it). Either is one event with a rule — `RRULE:FREQ=WEEKLY;BYDAY=MO,WE`
+ * — in the app's time zone, and a day set apart is an `EXDATE` on it. This
+ * is the arithmetic between the two, apart from the mapping that uses it:
+ * the rule written and read, a time of day and a wall time turned into the
+ * instant Google wants and back, the first day a weekly series falls on.
+ */
+const BYDAY = { sun: "SU", mon: "MO", tue: "TU", wed: "WE", thu: "TH", fri: "FR", sat: "SA" };
+const WEEKDAY_OF = Object.fromEntries(Object.entries(BYDAY).map(([day, code]) => [code, day]));
+const FREQ = { day: "DAILY", week: "WEEKLY", month: "MONTHLY", year: "YEARLY" };
+const EVERY_OF = { DAILY: "day", WEEKLY: "week", MONTHLY: "month", YEARLY: "year" };
+const DAY = /^\d{4}-\d{2}-\d{2}$/;
+/** The weekday a value names, read loosely: "mon", "Monday", "MO", "tues". */
+export function weekdayOf(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const word = value.trim().toLowerCase();
+    if (word.length === 2)
+        return WEEKDAY_OF[word.toUpperCase()];
+    return WEEKDAYS.find((day) => word.startsWith(day));
+}
+/** The weekdays a record's value names — one, or a list of them — in the week's order, each once. */
+export function weekdaysOf(value) {
+    const named = (Array.isArray(value) ? value : [value]).map(weekdayOf).filter((day) => day !== undefined);
+    return WEEKDAYS.filter((day) => named.includes(day));
+}
+/** The first day on or after `from` that is one of the weekdays; `from` itself when it is. */
+export function firstWeekday(from, days) {
+    if (days.length === 0)
+        return undefined;
+    for (let n = 0; n < 7; n += 1) {
+        const day = addDays(from, n);
+        if (days.includes(WEEKDAYS[weekdayIndexOf(day)]))
+            return day;
+    }
+    return undefined;
+}
+/** "09:00" (or "9:00", "09:00:00") as minutes after midnight; undefined for anything else. */
+export function minutesOf(value) {
+    const match = typeof value === "string" ? /^\s*(\d{1,2}):(\d{2})(?::\d{2})?\s*$/.exec(value) : null;
+    if (!match)
+        return undefined;
+    const hours = Number(match[1]);
+    const minutes = Number(match[2]);
+    return hours < 24 && minutes < 60 ? hours * 60 + minutes : undefined;
+}
+/** Minutes after midnight as "HH:MM". */
+export const hhmm = (minutes) => `${pad(Math.floor(minutes / 60))}:${pad(minutes % 60)}`;
+/** An instant as Google writes one, to the second. */
+export const isoInstant = (stamp) => new Date(stamp).toISOString().replace(/\.\d{3}Z$/, "Z");
+/** A day and, where it has one, the minutes after midnight a record's date or moment says, on the app's wall. */
+export function wallOfMoment(value, zone) {
+    if (typeof value !== "string")
+        return undefined;
+    if (DAY.test(value))
+        return { day: value };
+    const written = /^(\d{4}-\d{2}-\d{2})[T ](\d{2}):(\d{2})(?::\d{2}(?:\.\d+)?)?$/.exec(value);
+    if (written)
+        return { day: written[1], minutes: Number(written[2]) * 60 + Number(written[3]) };
+    const stamp = Date.parse(value);
+    return Number.isNaN(stamp) ? undefined : wallIn(stamp, zone);
+}
+/** The instant a record's moment names: a wall time in the zone, or the instant it carries. Not a date. */
+export function instantOfMoment(value, zone) {
+    const wall = wallOfMoment(value, zone);
+    if (!wall || wall.minutes === undefined)
+        return undefined;
+    return isoInstant(instantIn(wall.day, wall.minutes, zone));
+}
+/** An instant as a record keeps a wall time in the zone: "2026-10-20T18:00". */
+export function momentOfInstant(value, zone) {
+    if (typeof value !== "string")
+        return value;
+    const stamp = Date.parse(value);
+    if (Number.isNaN(stamp))
+        return value;
+    const wall = wallIn(stamp, zone);
+    return `${wall.day}T${hhmm(wall.minutes)}`;
+}
+/** A weekly rule for a weekday set. */
+export const weeklyRule = (days) => `RRULE:FREQ=WEEKLY;BYDAY=${days.map((day) => BYDAY[day]).join(",")}`;
+const compact = (day) => day.replace(/-/g, "");
+const stampOf = (day, minutes) => `${compact(day)}T${pad(Math.floor(minutes / 60))}${pad(minutes % 60)}00`;
+/**
+ * The lines a repeat is as Google keeps a recurrence: its RRULE, and an
+ * EXDATE for each day set apart — at the series' time of day in the app's
+ * zone for a timed series, as a day for an all-day one. An until day ends
+ * at midnight there, said as the instant it is.
+ */
+export function recurrenceOf(repeat, start, zone) {
+    const timed = start.minutes !== undefined;
+    const parts = [`FREQ=${FREQ[repeat.every]}`];
+    if (repeat.interval && repeat.interval > 1)
+        parts.push(`INTERVAL=${repeat.interval}`);
+    if (repeat.on && repeat.on.length > 0) {
+        if (repeat.every === "week")
+            parts.push(`BYDAY=${repeat.on.map((day) => BYDAY[day]).join(",")}`);
+        else if (repeat.every === "month")
+            parts.push(`BYMONTHDAY=${repeat.on.join(",")}`);
+    }
+    if (repeat.until)
+        parts.push(`UNTIL=${timed ? isoInstant(instantIn(addDays(repeat.until, 1), 0, zone) - 1000).replace(/[-:]/g, "") : compact(repeat.until)}`);
+    if (repeat.count)
+        parts.push(`COUNT=${repeat.count}`);
+    return [`RRULE:${parts.join(";")}`, ...(repeat.except ?? []).map((day) => (timed ? `EXDATE;TZID=${zone}:${stampOf(day, start.minutes)}` : `EXDATE;VALUE=DATE:${compact(day)}`))];
+}
+/** A day from the forms a recurrence writes one in: `20261121`, `20261121T100000`, `20261231T045959Z` (read in the zone). */
+function dayOfStamp(value, zone) {
+    const match = /^(\d{4})(\d{2})(\d{2})(?:T(\d{2})(\d{2})(\d{2})(Z)?)?$/.exec(value);
+    if (!match)
+        return undefined;
+    const day = `${match[1]}-${match[2]}-${match[3]}`;
+    if (match[7] !== "Z")
+        return day;
+    return wallIn(Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3]), Number(match[4]), Number(match[5]), Number(match[6])), zone).day;
+}
+/**
+ * The repeat a recurrence says, read in the zone, or undefined where it says
+ * what a repeat cannot hold (a monthly rule by weekday, a set position, an
+ * RDATE): such an event is left as it is rather than kept wrongly.
+ */
+export function repeatOf(recurrence, zone) {
+    if (!Array.isArray(recurrence) || recurrence.length === 0)
+        return undefined;
+    let rule;
+    const except = [];
+    for (const line of recurrence) {
+        if (typeof line !== "string")
+            return undefined;
+        const [head, body = ""] = line.split(/:(.*)/s);
+        const [name, ...params] = head.split(";");
+        if (name === "RRULE") {
+            if (rule)
+                return undefined;
+            const said = Object.fromEntries(body.split(";").map((part) => part.split("=")));
+            const every = EVERY_OF[said["FREQ"] ?? ""];
+            if (!every)
+                return undefined;
+            const keys = Object.keys(said).filter((key) => !["FREQ", "INTERVAL", "BYDAY", "BYMONTHDAY", "UNTIL", "COUNT", "WKST"].includes(key));
+            if (keys.length > 0)
+                return undefined;
+            const read = { every };
+            if (said["INTERVAL"] && Number(said["INTERVAL"]) > 1)
+                read.interval = Number(said["INTERVAL"]);
+            if (said["BYDAY"]) {
+                if (every !== "week")
+                    return undefined;
+                const days = said["BYDAY"].split(",").map((code) => WEEKDAY_OF[code]);
+                if (days.some((day) => day === undefined))
+                    return undefined;
+                read.on = WEEKDAYS.filter((day) => days.includes(day));
+            }
+            if (said["BYMONTHDAY"]) {
+                if (every !== "month")
+                    return undefined;
+                read.on = said["BYMONTHDAY"].split(",").map(Number);
+            }
+            if (said["UNTIL"]) {
+                const until = dayOfStamp(said["UNTIL"], zone);
+                if (!until)
+                    return undefined;
+                read.until = until;
+            }
+            if (said["COUNT"])
+                read.count = Number(said["COUNT"]);
+            rule = read;
+        }
+        else if (name === "EXDATE") {
+            for (const stamp of body.split(",")) {
+                const day = dayOfStamp(stamp, zone);
+                if (!day)
+                    return undefined;
+                except.push(day);
+            }
+            void params;
+        }
+        else
+            return undefined;
+    }
+    if (!rule)
+        return undefined;
+    const whole = except.length > 0 ? { ...rule, except: [...new Set(except)].sort() } : rule;
+    return isRepeat(whole) ? whole : undefined;
+}
+//# sourceMappingURL=recurrence.js.map

package/dist/sync/recurrence.js.map

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

package/dist/traits.d.ts

@@ -0,0 +1,72 @@
+/**
+ * WHAT A DECLARATION IS MADE OF, in a closed vocabulary (Roadmap
+ * f-document-traits; the starter's deconstruction of templates).
+ *
+ * A template's pitch says what it is for; its declaration says what it is
+ * made of — a status that moves, people who own things, money against a
+ * budget — and two templates that share no word of prose can share most of
+ * their structure. `traitsOf` reads that structure off the declaration,
+ * never off hand-written tags, and says each trait it finds with the kinds,
+ * fields, relations, rules, lenses and acts that carry it and one sentence
+ * a person reads ("Vendors' quote against each category's budget").
+ *
+ * Conservative, as `inferJobs` is: a trait is read only where the
+ * declaration leaves no doubt — a status needs its step acts, ownership a
+ * relation of one to a kind that is people, a budget a field called one
+ * beside a money field — so a host asking "does this app have X?" is told
+ * yes only when it would draw X. The vocabulary is a stability surface
+ * (`docs/stability.md`): a name is never renamed or taken away within the
+ * major, and one added is said in the changelog.
+ *
+ * Exported on `@graview/core/compose`, on no page.
+ */
+import type { GraviewApp } from "./app.js";
+import type { GraviewDocument } from "./document/schema.js";
+import type { AnySchema } from "./schema/schema.js";
+/** The closed vocabulary, in the order traits are said. */
+export declare const TRAITS: readonly ["owners", "status", "schedule", "budget", "places", "sources", "stock", "votes", "private", "history", "publishing", "roster", "routines", "comparison"];
+export type TraitName = (typeof TRAITS)[number];
+/** Each trait in a person's words, as a chip or a question says it ("Does what they described need people who own things?"). */
+export declare const TRAIT_WORDS: Readonly<Record<TraitName, string>>;
+/** One trait a declaration carries: what carries it, named, and one sentence. Fields and relations are said as `<kind>.<name>`; lenses by title. */
+export interface Trait {
+    readonly trait: TraitName;
+    readonly words: string;
+    readonly said: string;
+    readonly kinds: readonly string[];
+    readonly fields: readonly string[];
+    readonly relations: readonly string[];
+    readonly rules: readonly string[];
+    readonly lenses: readonly string[];
+    readonly acts: readonly string[];
+}
+export declare const DUE_FIELD: RegExp;
+declare const nounOf: (document: GraviewDocument, kind: string) => string;
+declare const pluralOf: (document: GraviewDocument, kind: string) => string;
+declare const an: (noun: string) => "a" | "an";
+declare const listed: (words: readonly string[], join?: string) => string;
+/** Whether the kind stands for people: declared so, or named so. */
+export declare function isPeopleKind(document: GraviewDocument, kind: string): boolean;
+/** The kind people see most: the one with the most fields, declared earliest among equals — what `startingDocument` joins a module to. */
+export declare function mainKindOf(document: GraviewDocument): string | undefined;
+/** A choice field that moves: an enum whose values named step acts set — a status, a stage — with the acts that move it. */
+export declare function movingChoices(document: GraviewDocument, kind: string): {
+    field: string;
+    options: readonly string[];
+    steps: string[];
+}[];
+/**
+ * THE TRAITS A DECLARATION CARRIES, in `TRAITS` order, each with what
+ * carries it and one sentence. A TypeScript app is read as the document it
+ * would be (`toDocument`). Nothing is read off prose: a template that says
+ * "budget" in its pitch and declares no budget field has no budget trait,
+ * and one that declares a budget beside its quotes has it whatever its
+ * pitch says.
+ */
+export declare function traitsOf(source: GraviewDocument | GraviewApp<AnySchema>): Trait[];
+/** Whether a declaration carries one trait — what a module asks before it adds anything. */
+export declare function hasTrait(document: GraviewDocument, trait: TraitName): boolean;
+/** The words of a trait, for a chip ("people who own things") — a name off the vocabulary is said back as given. */
+export declare function traitWords(trait: string): string;
+export { an, listed as listedWords, nounOf as traitNounOf, pluralOf as traitPluralOf };
+//# sourceMappingURL=traits.d.ts.map

package/dist/traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../src/traits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,sBAAsB,CAAC;AAGtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,2DAA2D;AAC3D,eAAO,MAAM,MAAM,oKAAqK,CAAC;AACzL,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,gIAAgI;AAChI,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAe3D,CAAC;AAEF,oJAAoJ;AACpJ,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAcD,eAAO,MAAM,SAAS,QAA0E,CAAC;AAgBjG,QAAA,MAAM,MAAM,GAAI,UAAU,eAAe,EAAE,MAAM,MAAM,WAA6D,CAAC;AACrH,QAAA,MAAM,QAAQ,GAAI,UAAU,eAAe,EAAE,MAAM,MAAM,WAAwE,CAAC;AAGlI,QAAA,MAAM,EAAE,GAAI,MAAM,MAAM,eAA0C,CAAC;AACnE,QAAA,MAAM,MAAM,GAAI,OAAO,SAAS,MAAM,EAAE,EAAE,aAAY,WAAgH,CAAC;AAavK,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAM7E;AAgDD,0IAA0I;AAC1I,wBAAgB,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAOxE;AAOD,4HAA4H;AAC5H,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,CAavI;AA+OD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,UAAU,CAAC,SAAS,CAAC,GAAG,KAAK,EAAE,CASjF;AAED,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAI7E;AAED,oHAAoH;AACpH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,OAAO,EAAE,EAAE,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,IAAI,WAAW,EAAE,QAAQ,IAAI,aAAa,EAAE,CAAC"}