ooxml-core 0.2.0

package/dist/collab/identity.d.ts

@@ -0,0 +1,48 @@
+/** Collaboration role within a session. */
+export type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
+export declare const COLLABORATION_ROLES: readonly CollaborationRole[];
+export declare function sanitizeRole(value: unknown): CollaborationRole | undefined;
+/** Whether a role may write to the shared document. */
+export declare function canWrite(role: CollaborationRole | undefined): boolean;
+/** Default palette: distinct, legible hues with white-text contrast. */
+export declare const CURSOR_PALETTE: readonly string[];
+/** Maximum characters shown in a cursor label before truncation. */
+export declare const MAX_LABEL_CHARS = 20;
+/** Deterministically pick a palette colour: the same seed always yields the same colour. */
+export declare function assignUserColor(seed: number | string, palette?: readonly string[]): string;
+/** Truncate to exactly `maxChars` characters including a trailing `...` when too long. */
+export declare function formatCursorLabel(userName: string, maxChars?: number): string;
+/** Up to two uppercase initials: first+last for multi-word names, otherwise the first two letters. */
+export declare function getUserInitials(name: string): string;
+/** A random-enough client id for a session; `crypto.randomUUID` when present. */
+export declare function createClientId(): string;
+/**
+ * Generator of collision-resistant document ids that are unique per client session, so two peers
+ * creating a paragraph/shape/row at the same time never mint the same id. `prefix` namespaces the
+ * product (`dve` for Word, `pve` for PowerPoint).
+ */
+export declare function createIdGenerator(clientId: string, prefix?: string): (kind: string) => string;
+/** The fields a connected-users list needs from a collaborator. */
+export interface RosterUserInput {
+    clientId: number | string;
+    userName: string;
+    userColor: string;
+    userAvatar?: string | undefined;
+}
+export interface RosterUser {
+    /** `'local'` for the current user, otherwise `String(clientId)`. */
+    id: string;
+    name: string;
+    initials: string;
+    color: string;
+    avatarUrl?: string;
+    isLocal: boolean;
+}
+/** Local user first, then remote users in their existing order. */
+export declare function buildRoster(params: {
+    localUserName: string;
+    localUserInitials?: string;
+    localUserColor?: string;
+    remoteUsers: readonly RosterUserInput[];
+}): RosterUser[];
+//# sourceMappingURL=identity.d.ts.map

package/dist/collab/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/collab/identity.ts"],"names":[],"mappings":"AAKA,2CAA2C;AAC3C,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,CAAC;AAEpE,eAAO,MAAM,mBAAmB,EAAE,SAAS,iBAAiB,EAI3D,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAI1E;AAED,uDAAuD;AACvD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAErE;AAED,wEAAwE;AACxE,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAS3C,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,4FAA4F;AAC5F,wBAAgB,eAAe,CAC9B,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,OAAO,GAAE,SAAS,MAAM,EAAmB,GACzC,MAAM,CAMR;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAwB,GAAG,MAAM,CAG9F;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOpD;AAED,iFAAiF;AACjF,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAOD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAO5F;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IAC1B,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,MAAM,EAAE;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,SAAS,eAAe,EAAE,CAAC;CACxC,GAAG,UAAU,EAAE,CAuBf"}