@plotday/twister 0.20.0

package/dist/plot.d.ts

@@ -0,0 +1,463 @@
+import { type Tag } from "./tag";
+import { type Callback } from "./tools/callbacks";
+export { Tag } from "./tag";
+/**
+ * Represents a unique user, contact, or twist in Plot.
+ *
+ * Note contacts (i.e. people not using Plot) are also represented by ActorIds. They may be
+ * people interacting with other connected services (e.g. an email sender or event attendee).
+ */
+export type ActorId = string & {
+    readonly __brand: "ActorId";
+};
+/**
+ * Represents a priority context within Plot.
+ *
+ * Priorities are similar to projects in other apps. All Activity is in a Priority.
+ * Priorities can be nested.
+ */
+export type Priority = {
+    /** Unique identifier for the priority */
+    id: string;
+    /** Human-readable title for the priority */
+    title: string;
+};
+/**
+ * Type for creating new priorities.
+ *
+ * Excludes the auto-generated ID field and adds an optional parentId
+ * for creating hierarchical priority structures.
+ */
+export type NewPriority = Omit<Priority, "id"> & {
+    /** Optional ID of the parent priority for creating hierarchies */
+    parentId?: string;
+};
+/**
+ * Enumeration of supported activity types in Plot.
+ *
+ * Each activity type has different behaviors and rendering characteristics
+ * within the Plot application.
+ */
+export declare enum ActivityType {
+    /** A note or piece of information without actionable requirements */
+    Note = 0,
+    /** An actionable item that can be completed */
+    Task = 1,
+    /** A scheduled occurrence with start and optional end time */
+    Event = 2
+}
+/**
+ * Enumeration of supported activity link types.
+ *
+ * Different link types have different behaviors when clicked by users
+ * and may require different rendering approaches.
+ */
+export declare enum ActivityLinkType {
+    /** External web links that open in browser */
+    external = "external",
+    /** Authentication flows for connecting services */
+    auth = "auth",
+    /** Callback links that trigger twist methods when clicked */
+    callback = "callback",
+    /** Video conferencing links with provider-specific handling */
+    conferencing = "conferencing"
+}
+/**
+ * Video conferencing providers for conferencing links.
+ *
+ * Used to identify the conferencing platform and provide
+ * provider-specific UI elements (titles, icons, etc.).
+ */
+export declare enum ConferencingProvider {
+    /** Google Meet */
+    googleMeet = "googleMeet",
+    /** Zoom */
+    zoom = "zoom",
+    /** Microsoft Teams */
+    microsoftTeams = "microsoftTeams",
+    /** Cisco Webex */
+    webex = "webex",
+    /** Other or unknown conferencing provider */
+    other = "other"
+}
+/**
+ * Represents a clickable link attached to an activity.
+ *
+ * Activity links are rendered as buttons that enable user interaction with activities.
+ * Different link types have specific behaviors and required fields for proper functionality.
+ *
+ * @example
+ * ```typescript
+ * // External link - opens URL in browser
+ * const externalLink: ActivityLink = {
+ *   type: ActivityLinkType.external,
+ *   title: "Open in Google Calendar",
+ *   url: "https://calendar.google.com/event/123",
+ * };
+ *
+ * // Conferencing link - opens video conference with provider info
+ * const conferencingLink: ActivityLink = {
+ *   type: ActivityLinkType.conferencing,
+ *   url: "https://meet.google.com/abc-defg-hij",
+ *   provider: ConferencingProvider.googleMeet,
+ * };
+ *
+ * // Integrations link - initiates OAuth flow
+ * const authLink: ActivityLink = {
+ *   type: ActivityLinkType.auth,
+ *   title: "Continue with Google",
+ *   provider: AuthProvider.Google,
+ *   level: AuthLevel.User,
+ *   scopes: ["https://www.googleapis.com/auth/calendar.readonly"],
+ *   callback: "callback-token-for-auth-completion"
+ * };
+ *
+ * // Callback link - triggers a twist method
+ * const callbackLink: ActivityLink = {
+ *   type: ActivityLinkType.callback,
+ *   title: "📅 Primary Calendar",
+ *   token: "callback-token-here"
+ * };
+ * ```
+ */
+export type ActivityLink = {
+    /** External web link that opens in browser */
+    type: ActivityLinkType.external;
+    /** Display text for the link button */
+    title: string;
+    /** URL to open when clicked */
+    url: string;
+} | {
+    /** Video conferencing link with provider-specific handling */
+    type: ActivityLinkType.conferencing;
+    /** URL to join the conference */
+    url: string;
+    /** Conferencing provider for UI customization */
+    provider: ConferencingProvider;
+} | {
+    /** Authentication link that initiates an OAuth flow */
+    type: ActivityLinkType.auth;
+    /** Display text for the auth button */
+    title: string;
+    /** OAuth provider (e.g., "google", "microsoft") */
+    provider: string;
+    /** Authorization level ("user" or "priority") */
+    level: string;
+    /** Array of OAuth scopes to request */
+    scopes: string[];
+    /** Callback token for auth completion notification */
+    callback: Callback;
+} | {
+    /** Callback link that triggers a twist method when clicked */
+    type: ActivityLinkType.callback;
+    /** Display text for the callback button */
+    title: string;
+    /** Token identifying the callback to execute */
+    callback: Callback;
+};
+/**
+ * Represents metadata about an activity, typically from an external system.
+ *
+ * Activity metadata enables tracking where activities originated from,
+ * which is useful for synchronization, deduplication, and linking
+ * back to external systems.
+ *
+ * @example
+ * ```typescript
+ * const googleCalendarMeta: ActivityMeta = {
+ *   type: "google-calendar-event",
+ *   id: "event-123",
+ *   calendarId: "primary",
+ *   htmlLink: "https://calendar.google.com/event/123"
+ * };
+ * ```
+ */
+export type ActivityMeta = {
+    /** The type identifier for the source system */
+    source: string;
+    /** Additional source-specific properties */
+    [key: string]: any;
+};
+/**
+ * Represents a complete activity within the Plot system.
+ *
+ * Activities are the core entities in Plot, representing anything from simple notes
+ * to complex recurring events. They support rich metadata including scheduling,
+ * recurrence patterns, links, and external source tracking.
+ *
+ * @example
+ * ```typescript
+ * // Simple note
+ * const task: Activity = {
+ *   type: ActivityType.Note,
+ *   title: "New campaign brainstorming ideas",
+ *   note: "We could rent a bouncy castle...",
+ *   author: { id: "user-1", name: "John Doe", type: ActorType.User },
+ *   priority: { id: "work", title: "Work" },
+ *   // ... other fields
+ * };
+ *
+ * // Simple task
+ * const task: Activity = {
+ *   type: ActivityType.Task,
+ *   title: "Review budget proposal",
+ *   author: { id: "user-1", name: "John Doe", type: ActorType.User },
+ *   end: null,
+ *   priority: { id: "work", title: "Work" },
+ *   // ... other fields
+ * };
+ *
+ * // Recurring event
+ * const meeting: Activity = {
+ *   type: ActivityType.Event,
+ *   title: "Weekly standup",
+ *   recurrenceRule: "FREQ=WEEKLY;BYDAY=MO",
+ *   recurrenceCount: 12,
+ *   // ... other fields
+ * };
+ * ```
+ */
+export type Activity = {
+    /** Unique identifier for the activity */
+    id: string;
+    /** The type of activity (Note, Task, or Event) */
+    type: ActivityType;
+    /** Information about who created the activity */
+    author: Actor;
+    /** The display title/summary of the activity */
+    title: string | null;
+    /** Primary content for the activity */
+    note: string | null;
+    /**
+     * Start time of a scheduled activity. Notes are not typically scheduled unless they're about specific times.
+     * For recurring events, this represents the start of the first occurrence.
+     * Can be a Date object for timed events or a date string in "YYYY-MM-DD" format for all-day events.
+     * Null for activities without scheduled start times.
+     */
+    start: Date | string | null;
+    /**
+     * End time of a scheduled activity. Notes are not typically scheduled unless they're about specific times.
+     * For recurring events, this represents the end of the first occurrence.
+     * Can be a Date object for timed events or a date string in "YYYY-MM-DD" format for all-day events.
+     * Null for tasks or activities without defined end times.
+     */
+    end: Date | string | null;
+    /**
+     * For recurring activities, the last occurrence date (inclusive).
+     * Can be a Date object, date string in "YYYY-MM-DD" format, or null if recurring indefinitely.
+     * When both recurrenceCount and recurrenceUntil are provided, recurrenceCount takes precedence.
+     */
+    recurrenceUntil: Date | string | null;
+    /**
+     * For recurring activities, the number of occurrences to generate.
+     * Takes precedence over recurrenceUntil if both are provided.
+     * Null for non-recurring activities or indefinite recurrence.
+     */
+    recurrenceCount: number | null;
+    /** Timestamp when the activity was marked as complete. Null if not completed. */
+    doneAt: Date | null;
+    /** Reference to a parent activity for creating hierarchical relationships */
+    parent: Activity | null;
+    /** For nested activities in a thread, references the top-level activity of that thread */
+    threadRoot?: Activity;
+    /** Array of interactive links attached to the activity */
+    links: Array<ActivityLink> | null;
+    /** The priority context this activity belongs to */
+    priority: Priority;
+    /** Recurrence rule in RFC 5545 RRULE format (e.g., "FREQ=WEEKLY;BYDAY=MO,WE,FR") */
+    recurrenceRule: string | null;
+    /** Array of dates to exclude from the recurrence pattern */
+    recurrenceExdates: Date[] | null;
+    /** Array of additional occurrence dates to include in the recurrence pattern */
+    recurrenceDates: Date[] | null;
+    /**
+     * For recurring event exceptions, points to the root recurring activity.
+     * Used when an individual occurrence of a recurring event is modified.
+     */
+    recurrence: Activity | null;
+    /**
+     * For recurring event exceptions, the original occurrence date being overridden.
+     * Used to identify which occurrence of a recurring event this exception replaces.
+     */
+    occurrence: Date | null;
+    /** Metadata about the activity, typically from an external system that created it */
+    meta: ActivityMeta | null;
+    /** Tags attached to this activity. Maps tag ID to array of actor IDs who added that tag. */
+    tags: Partial<Record<Tag, ActorId[]>> | null;
+    /** Array of actor IDs (users, contacts, or twists) mentioned in this activity via @-mentions */
+    mentions: ActorId[] | null;
+};
+/**
+ * Configuration for automatic priority selection based on activity similarity.
+ *
+ * Maps activity fields to scoring weights or required exact matches:
+ * - Number value: Maximum score for similarity matching on this field
+ * - `true` value: Required exact match - activities must match exactly or be excluded
+ *
+ * Scoring rules:
+ * - content: Uses vector similarity on activity embedding (cosine similarity)
+ * - type: Exact match on ActivityType
+ * - mentions: Percentage of existing activity's mentions that appear in new activity
+ * - meta.field: Exact match on top-level meta fields (e.g., "meta.sourceId")
+ *
+ * When content is `true`, applies a strong similarity threshold to ensure only close matches.
+ * Default (when neither priority nor pickPriority specified): `{content: true}`
+ *
+ * @example
+ * ```typescript
+ * // Require exact content match with strong similarity
+ * pickPriority: { content: true }
+ *
+ * // Score based on content (max 100 points) and require exact type match
+ * pickPriority: { content: 100, type: true }
+ *
+ * // Match on meta source and score content
+ * pickPriority: { "meta.source": true, content: 50 }
+ * ```
+ */
+export type PickPriorityConfig = {
+    content?: number | true;
+    type?: number | true;
+    mentions?: number | true;
+    [key: `meta.${string}`]: number | true;
+};
+/**
+ * Type for creating new activities.
+ *
+ * Requires only the activity type, with all other fields optional.
+ * The ID and author will be automatically assigned by the Plot system
+ * based on the current execution context.
+ *
+ * Priority can be specified in three ways:
+ * 1. Explicit priority: `priority: { id: "..." }` - Use specific priority (disables pickPriority)
+ * 2. Pick priority config: `pickPriority: { ... }` - Auto-select based on similarity
+ * 3. Neither: Defaults to `pickPriority: { content: true }` for automatic matching
+ *
+ * @example
+ * ```typescript
+ * // Explicit priority (disables automatic matching)
+ * const newTask: NewActivity = {
+ *   type: ActivityType.Task,
+ *   title: "Review pull request",
+ *   priority: { id: "work-project-123" }
+ * };
+ *
+ * // Automatic priority matching (default behavior)
+ * const newNote: NewActivity = {
+ *   type: ActivityType.Note,
+ *   title: "Meeting notes",
+ *   note: "Discussed Q4 roadmap..."
+ *   // Defaults to pickPriority: { content: true }
+ * };
+ *
+ * // Custom priority matching
+ * const newEvent: NewActivity = {
+ *   type: ActivityType.Event,
+ *   title: "Team standup",
+ *   pickPriority: { type: true, content: 50 }
+ * };
+ * ```
+ */
+export type NewActivity = Pick<Activity, "type"> & Partial<Omit<Activity, "id" | "author" | "type" | "parent" | "priority" | "threadRoot"> & {
+    parent?: Pick<Activity, "id"> | null;
+    /**
+     * Format of the note content. Determines how the note is processed:
+     * - 'text': Plain text that will be converted to markdown (auto-links URLs, preserves line breaks)
+     * - 'markdown': Already in markdown format (default, no conversion)
+     * - 'html': HTML content that will be converted to markdown
+     */
+    noteType?: NoteType;
+}> & ({
+    /** Explicit priority (required when specified) - disables automatic priority matching */
+    priority: Pick<Priority, "id">;
+} | {
+    /** Configuration for automatic priority selection based on similarity */
+    pickPriority?: PickPriorityConfig;
+} | {});
+export type ActivityUpdate = Pick<Activity, "id"> & Partial<Pick<Activity, "type" | "start" | "end" | "doneAt" | "note" | "title" | "meta" | "links" | "recurrenceRule" | "recurrenceDates" | "recurrenceExdates" | "recurrenceUntil" | "recurrenceCount" | "occurrence" | "mentions">> & {
+    parent?: Pick<Activity, "id"> | null;
+    /**
+     * Format of the note content. Determines how the note is processed:
+     * - 'text': Plain text that will be converted to markdown (auto-links URLs, preserves line breaks)
+     * - 'markdown': Already in markdown format (default, no conversion)
+     * - 'html': HTML content that will be converted to markdown
+     */
+    noteType?: NoteType;
+    /**
+     * Full tags object from Activity. Maps tag ID to array of actor IDs who added that tag.
+     * Only allowed for activities created by the twist.
+     * Use twistTags instead for adding/removing the twist's tags on other activities.
+     */
+    tags?: Partial<Record<Tag, ActorId[]>>;
+    /**
+     * Add or remove the twist's tags.
+     * Maps tag ID to boolean: true = add tag, false = remove tag.
+     * This is allowed on all activities the twist has access to.
+     */
+    twistTags?: Partial<Record<Tag, boolean>>;
+};
+/**
+ * Represents an actor in Plot - a user, contact, or twist.
+ *
+ * Actors can be associated with activities as authors, assignees, or mentions.
+ * The email field is only included when ContactAccess.Read permission is granted.
+ *
+ * @example
+ * ```typescript
+ * const actor: Actor = {
+ *   id: "f0ffd5f8-1635-4b13-9532-35f97446db90" as ActorId,
+ *   type: ActorType.Contact,
+ *   email: "john.doe@example.com",  // Only if ContactAccess.Read
+ *   name: "John Doe"
+ * };
+ * ```
+ */
+export type Actor = {
+    /** Unique identifier for the actor */
+    id: ActorId;
+    /** Type of actor (User, Contact, or Twist) */
+    type: ActorType;
+    /** Email address (only included with ContactAccess.Read permission) */
+    email?: string;
+    /** Display name (undefined if not included due to permissions, null if not set) */
+    name?: string | null;
+};
+/**
+ * Enumeration of author types that can create activities.
+ *
+ * The author type affects how activities are displayed and processed
+ * within the Plot system.
+ */
+export declare enum ActorType {
+    /** Activities created by human users */
+    User = 0,
+    /** Activities created by external contacts */
+    Contact = 1,
+    /** Activities created by automated twists */
+    Twist = 2
+}
+/**
+ * Represents contact information for creating a new contact.
+ *
+ * Contacts are used throughout Plot for representing people associated
+ * with activities, such as event attendees or task assignees.
+ *
+ * @example
+ * ```typescript
+ * const newContact: NewContact = {
+ *   email: "john.doe@example.com",
+ *   name: "John Doe",
+ *   avatar: "https://avatar.example.com/john.jpg"
+ * };
+ * ```
+ */
+export type NewContact = {
+    /** Email address of the contact (required) */
+    email: string;
+    /** Optional display name for the contact */
+    name?: string;
+    /** Optional avatar image URL for the contact */
+    avatar?: string;
+};
+export type NoteType = "text" | "markdown" | "html";
+//# sourceMappingURL=plot.d.ts.map

package/dist/plot.d.ts.map

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

package/dist/plot.js

@@ -0,0 +1,68 @@
+export { Tag } from "./tag";
+/**
+ * Enumeration of supported activity types in Plot.
+ *
+ * Each activity type has different behaviors and rendering characteristics
+ * within the Plot application.
+ */
+export var ActivityType;
+(function (ActivityType) {
+    /** A note or piece of information without actionable requirements */
+    ActivityType[ActivityType["Note"] = 0] = "Note";
+    /** An actionable item that can be completed */
+    ActivityType[ActivityType["Task"] = 1] = "Task";
+    /** A scheduled occurrence with start and optional end time */
+    ActivityType[ActivityType["Event"] = 2] = "Event";
+})(ActivityType || (ActivityType = {}));
+/**
+ * Enumeration of supported activity link types.
+ *
+ * Different link types have different behaviors when clicked by users
+ * and may require different rendering approaches.
+ */
+export var ActivityLinkType;
+(function (ActivityLinkType) {
+    /** External web links that open in browser */
+    ActivityLinkType["external"] = "external";
+    /** Authentication flows for connecting services */
+    ActivityLinkType["auth"] = "auth";
+    /** Callback links that trigger twist methods when clicked */
+    ActivityLinkType["callback"] = "callback";
+    /** Video conferencing links with provider-specific handling */
+    ActivityLinkType["conferencing"] = "conferencing";
+})(ActivityLinkType || (ActivityLinkType = {}));
+/**
+ * Video conferencing providers for conferencing links.
+ *
+ * Used to identify the conferencing platform and provide
+ * provider-specific UI elements (titles, icons, etc.).
+ */
+export var ConferencingProvider;
+(function (ConferencingProvider) {
+    /** Google Meet */
+    ConferencingProvider["googleMeet"] = "googleMeet";
+    /** Zoom */
+    ConferencingProvider["zoom"] = "zoom";
+    /** Microsoft Teams */
+    ConferencingProvider["microsoftTeams"] = "microsoftTeams";
+    /** Cisco Webex */
+    ConferencingProvider["webex"] = "webex";
+    /** Other or unknown conferencing provider */
+    ConferencingProvider["other"] = "other";
+})(ConferencingProvider || (ConferencingProvider = {}));
+/**
+ * Enumeration of author types that can create activities.
+ *
+ * The author type affects how activities are displayed and processed
+ * within the Plot system.
+ */
+export var ActorType;
+(function (ActorType) {
+    /** Activities created by human users */
+    ActorType[ActorType["User"] = 0] = "User";
+    /** Activities created by external contacts */
+    ActorType[ActorType["Contact"] = 1] = "Contact";
+    /** Activities created by automated twists */
+    ActorType[ActorType["Twist"] = 2] = "Twist";
+})(ActorType || (ActorType = {}));
+//# sourceMappingURL=plot.js.map

package/dist/plot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot.js","sourceRoot":"","sources":["../src/plot.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAkC5B;;;;;GAKG;AACH,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,qEAAqE;IACrE,+CAAI,CAAA;IACJ,+CAA+C;IAC/C,+CAAI,CAAA;IACJ,8DAA8D;IAC9D,iDAAK,CAAA;AACP,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,gBASX;AATD,WAAY,gBAAgB;IAC1B,8CAA8C;IAC9C,yCAAqB,CAAA;IACrB,mDAAmD;IACnD,iCAAa,CAAA;IACb,6DAA6D;IAC7D,yCAAqB,CAAA;IACrB,+DAA+D;IAC/D,iDAA6B,CAAA;AAC/B,CAAC,EATW,gBAAgB,KAAhB,gBAAgB,QAS3B;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,oBAWX;AAXD,WAAY,oBAAoB;IAC9B,kBAAkB;IAClB,iDAAyB,CAAA;IACzB,WAAW;IACX,qCAAa,CAAA;IACb,sBAAsB;IACtB,yDAAiC,CAAA;IACjC,kBAAkB;IAClB,uCAAe,CAAA;IACf,6CAA6C;IAC7C,uCAAe,CAAA;AACjB,CAAC,EAXW,oBAAoB,KAApB,oBAAoB,QAW/B;AAsYD;;;;;GAKG;AACH,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,wCAAwC;IACxC,yCAAI,CAAA;IACJ,8CAA8C;IAC9C,+CAAO,CAAA;IACP,6CAA6C;IAC7C,2CAAK,CAAA;AACP,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB"}

package/dist/tag.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Activity tags. Three types:
+ * 1. Special tags, which trigger other behaviors
+ * 2. Toggle tags, which anyone can toggle a shared value on or off
+ * 3. Count tags, where everyone can add or remove their own
+ */
+export declare enum Tag {
+    Now = 1,
+    Later = 2,
+    Done = 3,
+    Archived = 4,
+    Pinned = 100,
+    Urgent = 101,
+    Todo = 102,
+    Goal = 103,
+    Decision = 104,
+    Waiting = 105,
+    Blocked = 106,
+    Warning = 107,
+    Question = 108,
+    Twist = 109,
+    Star = 110,
+    Idea = 111,
+    Attachment = 112,
+    Link = 113,
+    Yes = 1000,
+    No = 1001,
+    Volunteer = 1002,
+    Tada = 1003,
+    Fire = 1004,
+    Totally = 1005,
+    Looking = 1006,
+    Love = 1007,
+    Rocket = 1008,
+    Sparkles = 1009,
+    Thanks = 1010,
+    Smile = 1011,
+    Wave = 1012,
+    Praise = 1015,
+    Applause = 1016,
+    Cool = 1017,
+    Sad = 1018,
+    Attend = 1019,
+    Skip = 1020,
+    Undecided = 1021
+}
+//# sourceMappingURL=tag.d.ts.map

package/dist/tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.d.ts","sourceRoot":"","sources":["../src/tag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,GAAG;IAEb,GAAG,IAAI;IACP,KAAK,IAAI;IACT,IAAI,IAAI;IACR,QAAQ,IAAI;IAGZ,MAAM,MAAM;IACZ,MAAM,MAAM;IACZ,IAAI,MAAM;IACV,IAAI,MAAM;IACV,QAAQ,MAAM;IACd,OAAO,MAAM;IACb,OAAO,MAAM;IACb,OAAO,MAAM;IACb,QAAQ,MAAM;IACd,KAAK,MAAM;IACX,IAAI,MAAM;IACV,IAAI,MAAM;IACV,UAAU,MAAM;IAChB,IAAI,MAAM;IAGV,GAAG,OAAO;IACV,EAAE,OAAO;IACT,SAAS,OAAO;IAChB,IAAI,OAAO;IACX,IAAI,OAAO;IACX,OAAO,OAAO;IACd,OAAO,OAAO;IACd,IAAI,OAAO;IACX,MAAM,OAAO;IACb,QAAQ,OAAO;IACf,MAAM,OAAO;IACb,KAAK,OAAO;IACZ,IAAI,OAAO;IACX,MAAM,OAAO;IACb,QAAQ,OAAO;IACf,IAAI,OAAO;IACX,GAAG,OAAO;IACV,MAAM,OAAO;IACb,IAAI,OAAO;IACX,SAAS,OAAO;CACjB"}

package/dist/tag.js

@@ -0,0 +1,51 @@
+/**
+ * Activity tags. Three types:
+ * 1. Special tags, which trigger other behaviors
+ * 2. Toggle tags, which anyone can toggle a shared value on or off
+ * 3. Count tags, where everyone can add or remove their own
+ */
+export var Tag;
+(function (Tag) {
+    // Special tags
+    Tag[Tag["Now"] = 1] = "Now";
+    Tag[Tag["Later"] = 2] = "Later";
+    Tag[Tag["Done"] = 3] = "Done";
+    Tag[Tag["Archived"] = 4] = "Archived";
+    // Toggle tags
+    Tag[Tag["Pinned"] = 100] = "Pinned";
+    Tag[Tag["Urgent"] = 101] = "Urgent";
+    Tag[Tag["Todo"] = 102] = "Todo";
+    Tag[Tag["Goal"] = 103] = "Goal";
+    Tag[Tag["Decision"] = 104] = "Decision";
+    Tag[Tag["Waiting"] = 105] = "Waiting";
+    Tag[Tag["Blocked"] = 106] = "Blocked";
+    Tag[Tag["Warning"] = 107] = "Warning";
+    Tag[Tag["Question"] = 108] = "Question";
+    Tag[Tag["Twist"] = 109] = "Twist";
+    Tag[Tag["Star"] = 110] = "Star";
+    Tag[Tag["Idea"] = 111] = "Idea";
+    Tag[Tag["Attachment"] = 112] = "Attachment";
+    Tag[Tag["Link"] = 113] = "Link";
+    // Count tags
+    Tag[Tag["Yes"] = 1000] = "Yes";
+    Tag[Tag["No"] = 1001] = "No";
+    Tag[Tag["Volunteer"] = 1002] = "Volunteer";
+    Tag[Tag["Tada"] = 1003] = "Tada";
+    Tag[Tag["Fire"] = 1004] = "Fire";
+    Tag[Tag["Totally"] = 1005] = "Totally";
+    Tag[Tag["Looking"] = 1006] = "Looking";
+    Tag[Tag["Love"] = 1007] = "Love";
+    Tag[Tag["Rocket"] = 1008] = "Rocket";
+    Tag[Tag["Sparkles"] = 1009] = "Sparkles";
+    Tag[Tag["Thanks"] = 1010] = "Thanks";
+    Tag[Tag["Smile"] = 1011] = "Smile";
+    Tag[Tag["Wave"] = 1012] = "Wave";
+    Tag[Tag["Praise"] = 1015] = "Praise";
+    Tag[Tag["Applause"] = 1016] = "Applause";
+    Tag[Tag["Cool"] = 1017] = "Cool";
+    Tag[Tag["Sad"] = 1018] = "Sad";
+    Tag[Tag["Attend"] = 1019] = "Attend";
+    Tag[Tag["Skip"] = 1020] = "Skip";
+    Tag[Tag["Undecided"] = 1021] = "Undecided";
+})(Tag || (Tag = {}));
+//# sourceMappingURL=tag.js.map

package/dist/tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../src/tag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,GA4CX;AA5CD,WAAY,GAAG;IACb,eAAe;IACf,2BAAO,CAAA;IACP,+BAAS,CAAA;IACT,6BAAQ,CAAA;IACR,qCAAY,CAAA;IAEZ,cAAc;IACd,mCAAY,CAAA;IACZ,mCAAY,CAAA;IACZ,+BAAU,CAAA;IACV,+BAAU,CAAA;IACV,uCAAc,CAAA;IACd,qCAAa,CAAA;IACb,qCAAa,CAAA;IACb,qCAAa,CAAA;IACb,uCAAc,CAAA;IACd,iCAAW,CAAA;IACX,+BAAU,CAAA;IACV,+BAAU,CAAA;IACV,2CAAgB,CAAA;IAChB,+BAAU,CAAA;IAEV,aAAa;IACb,8BAAU,CAAA;IACV,4BAAS,CAAA;IACT,0CAAgB,CAAA;IAChB,gCAAW,CAAA;IACX,gCAAW,CAAA;IACX,sCAAc,CAAA;IACd,sCAAc,CAAA;IACd,gCAAW,CAAA;IACX,oCAAa,CAAA;IACb,wCAAe,CAAA;IACf,oCAAa,CAAA;IACb,kCAAY,CAAA;IACZ,gCAAW,CAAA;IACX,oCAAa,CAAA;IACb,wCAAe,CAAA;IACf,gCAAW,CAAA;IACX,8BAAU,CAAA;IACV,oCAAa,CAAA;IACb,gCAAW,CAAA;IACX,0CAAgB,CAAA;AAClB,CAAC,EA5CW,GAAG,KAAH,GAAG,QA4Cd"}