@shelamkoff/rector 1.0.0

package/dist/plugins/attaches/attaches.css

@@ -0,0 +1,374 @@
+/* =============================================================================
+   Attaches plugin — multi-file attachment block
+   ============================================================================= */
+
+.oe-attaches {
+  border-radius: 0.5rem;
+  overflow-anchor: none;
+  text-align: center;
+  outline: none;
+}
+
+.oe-attaches--loading { opacity: 0.6; pointer-events: none; }
+
+/* ── Dropzone (empty state) ───────────────────────────────────────────────── */
+
+.oe-attaches__select {
+  display: flex; flex-direction: column; align-items: center; gap: 0.75rem;
+  padding: 2rem;
+  border: 2px dashed var(--oe-border, #2e2e35);
+  border-radius: 0.5rem;
+  text-align: center;
+  transition: border-color 0.2s;
+}
+.oe-attaches__select:hover,
+.oe-attaches__select--dragover { border-color: var(--oe-accent, #4357b4); }
+.oe-attaches__select-icon { color: var(--oe-text-3, #5a5a64); }
+.oe-attaches__select-text { font-size: 0.8125rem; color: var(--oe-text-3, #5a5a64); line-height: 1.5; }
+.oe-attaches__select-link { background: none; border: none; padding: 0; font: inherit; color: var(--oe-accent, #4357b4); text-decoration: none; cursor: pointer; outline: none; }
+.oe-attaches__select-link:hover { text-decoration: underline; }
+.oe-attaches__select-actions { display: flex; flex-wrap: wrap; justify-content: center; gap: 0.375rem; }
+.oe-attaches__select-action {
+  display: inline-flex; align-items: center; gap: 0.375rem;
+  padding: 0.375rem 0.625rem; border: 1px solid var(--oe-border, #2e2e35);
+  border-radius: 0.375rem; background: var(--oe-surface-2, #17171a); color: var(--oe-text-2, #c4c4c4);
+  font: inherit; font-size: 0.75rem; cursor: pointer;
+}
+.oe-attaches__select-action:hover { color: var(--oe-text-1, #fff); border-color: var(--oe-border-hover, #3a3a44); }
+.oe-attaches__select-action svg { width: 14px; height: 14px; }
+
+/* ── Single file card ─────────────────────────────────────────────────────── */
+
+.oe-attaches__card {
+  display: flex; align-items: center; gap: 0.75rem;
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--oe-border, #2e2e35);
+  border-radius: 0.5rem;
+  text-align: left;
+  transition: border-color 0.15s;
+}
+.oe-attaches__card:hover { border-color: var(--oe-border-hover, #3a3a44); }
+
+/* ── Group (2+ files) ─────────────────────────────────────────────────────── */
+
+.oe-attaches__group {
+  border: 1px solid var(--oe-border, #2e2e35);
+  border-radius: 0.5rem;
+  overflow: hidden;
+  text-align: left;
+}
+
+.oe-attaches__group-header {
+  display: flex; align-items: center; gap: 0.75rem;
+  padding: 0.75rem 1rem;
+  cursor: pointer;
+  transition: background 0.12s;
+  user-select: none;
+}
+.oe-attaches__group-header:hover { background: var(--oe-card-hover, rgba(255,255,255,0.03)); }
+
+.oe-attaches__chevron {
+  appearance: none;
+  border: 0;
+  padding: 0;
+  background: transparent;
+  font: inherit;
+  cursor: pointer;
+  flex-shrink: 0;
+  color: var(--oe-text-3, #6e6e78);
+  transition: transform 0.2s;
+}
+.oe-attaches__chevron:focus-visible { outline: 2px solid var(--oe-accent, #4357b4); outline-offset: 2px; }
+.oe-attaches__chevron--open { transform: rotate(180deg); }
+
+.oe-attaches__group-body {
+  display: none;
+  border-top: 1px solid var(--oe-border, #2e2e35);
+}
+.oe-attaches__group-body--open { display: block; }
+
+/* ── Row inside group ─────────────────────────────────────────────────────── */
+
+.oe-attaches__row {
+  display: flex; align-items: center; gap: 0.5rem;
+  padding: 0.5rem 1rem 0.5rem 3rem;
+  border-bottom: 1px solid var(--oe-border, #2e2e35);
+  transition: background 0.12s;
+}
+.oe-attaches__row:last-child { border-bottom: none; }
+.oe-attaches__row:hover { background: var(--oe-card-hover, rgba(255,255,255,0.03)); }
+
+.oe-attaches__row-size {
+  flex-shrink: 0;
+  font-size: 0.75rem;
+  color: var(--oe-text-3, #6e6e78);
+}
+
+/* ── File icon ────────────────────────────────────────────────────────────── */
+
+.oe-attaches__icon {
+  position: relative; flex-shrink: 0;
+  width: 32px; height: 32px;
+  display: flex; align-items: center; justify-content: center;
+  color: var(--oe-text-3, #6e6e78);
+}
+.oe-attaches__icon svg { width: 32px; height: 32px; }
+
+.oe-attaches__ext {
+  position: absolute; bottom: -3px; left: 50%; transform: translateX(-50%);
+  padding: 0 4px; font-size: 9px; font-weight: 700; color: var(--oe-text-on-accent, #fff);
+  background: var(--oe-text-3, #6e6e78);
+  border-radius: 2px; line-height: 1.3; letter-spacing: 0.03em;
+}
+
+/* ── File info ────────────────────────────────────────────────────────────── */
+
+.oe-attaches__info { flex: 1; min-width: 0; }
+
+.oe-attaches__name {
+  font-size: 0.875rem; font-weight: 500; line-height: 1.4;
+  color: var(--oe-text-1, #f5f5f5);
+  white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
+  outline: none;
+  border-bottom: 1px solid transparent;
+  transition: border-color 0.15s;
+  cursor: text;
+}
+.oe-attaches__name:focus { border-bottom-color: var(--oe-accent, #4357b4); }
+.oe-attaches__name--static { cursor: pointer; }
+
+.oe-attaches__meta {
+  font-size: 0.75rem;
+  color: var(--oe-text-3, #6e6e78);
+  margin-top: 0.125rem;
+}
+
+/* ── Remove button ────────────────────────────────────────────────────────── */
+
+.oe-attaches__remove {
+  flex-shrink: 0; display: flex; align-items: center; justify-content: center;
+  width: 1.5rem; height: 1.5rem;
+  border: none; border-radius: 50%; background: transparent;
+  color: var(--oe-text-3, #6e6e78);
+  cursor: pointer; font-size: 1rem; line-height: 1;
+  opacity: 0; transition: opacity 0.12s, background 0.12s, color 0.12s;
+  padding: 0; outline: none;
+}
+.oe-attaches__card:hover .oe-attaches__remove,
+.oe-attaches__row:hover .oe-attaches__remove { opacity: 1; }
+.oe-attaches__remove:hover { background: rgba(248,113,113,0.15); color: var(--oe-danger, #f87171); }
+
+/* ── Action bar ───────────────────────────────────────────────────────────── */
+
+.oe-attaches__actions {
+  display: inline-flex; align-items: center; gap: 0;
+  margin-top: 0.5rem;
+  background: var(--oe-surface, #0e0e10);
+  border: 1px solid var(--oe-border, #1a1a1f);
+  border-radius: 0.5rem; padding: 0.1875rem;
+}
+
+.oe-attaches__action-btn {
+  position: relative; display: inline-flex; align-items: center; justify-content: center;
+  gap: 0.3125rem; padding: 0.3125rem 0.5rem;
+  border: none; border-radius: 0.375rem; background: transparent;
+  color: var(--oe-text-1, #fff);
+  font-size: 0.6875rem; font-weight: 500; cursor: pointer;
+  white-space: nowrap; line-height: 1; isolation: isolate;
+  font-family: inherit; outline: none; transition: color 0.15s;
+}
+.oe-attaches__action-btn::before {
+  content: ''; position: absolute; inset: 0;
+  border-radius: 0.375rem; background: var(--oe-accent, #4357b4);
+  transform: scale(0); transition: transform 0.25s cubic-bezier(0.22,1,0.36,1);
+  z-index: -1;
+}
+.oe-attaches__action-btn:hover::before { transform: scale(1); }
+
+.oe-attaches__action-btn--danger { color: var(--oe-danger, #f87171); }
+.oe-attaches__action-btn--danger::before { background: var(--oe-danger, #f87171); }
+.oe-attaches__action-btn--danger:hover { color: var(--oe-text-on-accent, #fff); }
+
+.oe-attaches__actions-sep {
+  width: 1px; height: 1.125rem;
+  background: var(--oe-border, #1a1a1f);
+  margin: 0 0.0625rem; flex-shrink: 0;
+}
+
+/* ── Settings dropdown ───────────────────────────────────────────────────── */
+
+.oe-attaches__dropdown {
+  position: relative;
+  display: inline-flex;
+}
+
+.oe-attaches__dropdown-panel {
+  display: none;
+  position: absolute;
+  bottom: calc(100% + 8px);
+  left: 50%; transform: translateX(-50%);
+  min-width: 160px;
+  padding: 0.5rem;
+  background: var(--oe-toolbar-bg, var(--oe-card, #111));
+  border: 1px solid var(--oe-toolbar-border, var(--oe-border, #1a1a1f));
+  border-radius: var(--oe-radius, 0.5rem);
+  box-shadow: var(--oe-toolbar-shadow, 0 8px 24px rgba(0,0,0,0.4));
+  z-index: 100;
+}
+.oe-attaches__dropdown--open .oe-attaches__dropdown-panel { display: block; }
+
+.oe-attaches__tpl-title {
+  font-size: 0.625rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--oe-text-3, #6e6e78);
+  padding: 0.25rem 0.375rem;
+  margin-bottom: 0.25rem;
+}
+
+.oe-attaches__tpl-grid {
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: 0.25rem;
+}
+
+.oe-attaches__tpl-btn {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.5rem;
+  border: 1px solid var(--oe-border, #2e2e35);
+  border-radius: var(--oe-radius-sm, 4px);
+  background: transparent;
+  color: var(--oe-text-3, #6e6e78);
+  cursor: pointer;
+  transition: border-color 0.15s, color 0.15s, background 0.15s;
+  outline: none;
+}
+.oe-attaches__tpl-btn:hover {
+  border-color: var(--oe-border-hover, #3a3a44);
+  color: var(--oe-text-1, #f5f5f5);
+}
+.oe-attaches__tpl-btn--active {
+  border-color: var(--oe-accent, #4357b4);
+  background: var(--oe-accent-alpha, rgba(67,87,180,0.12));
+  color: var(--oe-text-1, #f5f5f5);
+}
+
+/* ══════════════════════════════════════════════════════════════════════════
+   Variant B — Pill / chip
+   ══════════════════════════════════════════════════════════════════════════ */
+
+.oe-attaches__pills { display: flex; flex-wrap: wrap; gap: 0.375rem; }
+
+.oe-attaches__pill {
+  display: inline-flex; align-items: center; gap: 0.5rem;
+  padding: 0.375rem 0.75rem 0.375rem 0.625rem;
+  border-radius: 1.25rem;
+  background: var(--oe-surface, #0e0e10);
+  border: 1px solid var(--oe-border, #2e2e35);
+  font-size: 0.8125rem; font-weight: 500;
+  transition: border-color 0.15s, background 0.15s;
+}
+.oe-attaches__pill:hover { border-color: var(--oe-border-hover, #3a3a44); background: var(--oe-card-hover, #191919); }
+
+.oe-attaches__pill-icon { display: flex; align-items: center; color: var(--oe-text-3, #6e6e78); flex-shrink: 0; }
+
+.oe-attaches__pill .oe-attaches__name { border-bottom: none; }
+
+.oe-attaches__pill-size { font-size: 0.6875rem; color: var(--oe-text-3, #6e6e78); flex-shrink: 0; }
+
+.oe-attaches__pill .oe-attaches__remove { width: 1.25rem; height: 1.25rem; font-size: 0.875rem; }
+
+/* ══════════════════════════════════════════════════════════════════════════
+   Variant F — Notion database
+   ══════════════════════════════════════════════════════════════════════════ */
+
+.oe-attaches__notion {
+  border: 1px solid var(--oe-border, #2e2e35);
+  border-radius: 0.5rem;
+  overflow: hidden;
+  text-align: left;
+}
+
+.oe-attaches__notion-row {
+  display: flex; align-items: center; gap: 0.5rem;
+  padding: 0.5rem 1rem;
+  border-bottom: 1px solid var(--oe-border, #2e2e35);
+  transition: background 0.1s;
+}
+.oe-attaches__notion-row:last-child { border-bottom: none; }
+.oe-attaches__notion-row:hover { background: var(--oe-card-hover, rgba(255,255,255,0.03)); }
+
+.oe-attaches__notion-row .oe-attaches__name { flex: 1; border-bottom: none; }
+
+.oe-attaches__notion-tag {
+  padding: 0.125rem 0.5rem;
+  border-radius: 3px;
+  font-size: 0.6875rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.02em;
+  flex-shrink: 0;
+  background: var(--oe-card-hover, rgba(255,255,255,0.06));
+  color: var(--oe-text-2, #c4c4c4);
+}
+
+.oe-attaches__notion-size {
+  font-size: 0.75rem;
+  color: var(--oe-text-3, #6e6e78);
+  flex-shrink: 0;
+  min-width: 3rem;
+  text-align: right;
+}
+
+/* ══════════════════════════════════════════════════════════════════════════
+   Variant G — Material elevated cards
+   ══════════════════════════════════════════════════════════════════════════ */
+
+.oe-attaches__material { display: flex; flex-direction: column; gap: 0.5rem; text-align: left; }
+
+.oe-attaches__material-card {
+  display: flex; align-items: center; gap: 0.875rem;
+  padding: 0.875rem 1.125rem;
+  background: var(--oe-surface, #0e0e10);
+  border-radius: var(--oe-radius, 0.5rem);
+  box-shadow: 0 1px 3px rgba(0,0,0,0.3), 0 4px 12px rgba(0,0,0,0.15);
+  transition: box-shadow 0.2s, transform 0.15s;
+}
+.oe-attaches__material-card:hover { box-shadow: 0 2px 6px rgba(0,0,0,0.4), 0 8px 20px rgba(0,0,0,0.2); transform: translateY(-1px); }
+
+.oe-attaches__material-icon {
+  position: relative; flex-shrink: 0;
+  width: 2.25rem; height: 2.25rem;
+  display: flex; align-items: center; justify-content: center;
+  background: var(--oe-card-hover, #191919);
+  border-radius: 0.5rem;
+  color: var(--oe-text-3, #6e6e78);
+}
+.oe-attaches__material-icon svg { width: 1.25rem; height: 1.25rem; }
+
+.oe-attaches__material-card .oe-attaches__name { border-bottom: none; }
+
+/* ── Light theme fixes ────────────────────────────────────────────────────── */
+
+.oe-theme-light .oe-attaches__select { border-color: var(--oe-border, #e0e0e0); }
+.oe-theme-light .oe-attaches__card { border-color: var(--oe-border, #e0e0e0); }
+.oe-theme-light .oe-attaches__card:hover { border-color: var(--oe-border-hover, #d0d0d0); }
+.oe-theme-light .oe-attaches__group { border-color: var(--oe-border, #e0e0e0); }
+.oe-theme-light .oe-attaches__group-body { border-top-color: var(--oe-border, #e0e0e0); }
+.oe-theme-light .oe-attaches__row { border-bottom-color: var(--oe-border, #e0e0e0); }
+.oe-theme-light .oe-attaches__group-header:hover { background: var(--oe-card-hover, rgba(0,0,0,0.02)); }
+.oe-theme-light .oe-attaches__row:hover { background: var(--oe-card-hover, rgba(0,0,0,0.02)); }
+.oe-theme-light .oe-attaches__name { color: var(--oe-text-1, #1a1a1a); }
+.oe-theme-light .oe-attaches__actions { background: var(--oe-surface, #fafafa); border-color: var(--oe-border, #e0e0e0); }
+.oe-theme-light .oe-attaches__action-btn { color: var(--oe-text-1, #1a1a1a); }
+.oe-theme-light .oe-attaches__pill { background: var(--oe-surface, #fafafa); border-color: var(--oe-border, #e0e0e0); }
+.oe-theme-light .oe-attaches__pill:hover { background: var(--oe-card-hover, #f5f5f5); }
+.oe-theme-light .oe-attaches__notion { border-color: var(--oe-border, #e0e0e0); }
+.oe-theme-light .oe-attaches__notion-row { border-bottom-color: var(--oe-border, #e0e0e0); }
+.oe-theme-light .oe-attaches__notion-row:hover { background: var(--oe-card-hover, rgba(0,0,0,0.02)); }
+.oe-theme-light .oe-attaches__material-card { background: var(--oe-surface, #fff); box-shadow: 0 1px 3px rgba(0,0,0,0.08), 0 4px 12px rgba(0,0,0,0.05); }
+.oe-theme-light .oe-attaches__material-card:hover { box-shadow: 0 2px 6px rgba(0,0,0,0.1), 0 8px 20px rgba(0,0,0,0.08); }
+.oe-theme-light .oe-attaches__material-icon { background: var(--oe-card-hover, #f0f0f0); }

package/dist/plugins/attaches/index.d.ts

@@ -0,0 +1,133 @@
+import type {} from './locale/keys.js'
+/**
+ * File attachment block supporting direct uploads and consumer-defined file
+ * source actions such as a media library.
+ * @extends {BlockPluginAbstract<AttachesConfig>}
+ */
+export class Attaches extends BlockPluginAbstract<AttachesConfig> {
+    static isTextBlock: boolean;
+    static styles: string[];
+    /**
+     * Create an Attaches instance with the supplied consumer configuration.
+     * @param {AttachesConfig} [config]
+     */
+    constructor(config?: AttachesConfig);
+    type: string;
+    icon: string;
+    inlineTools: boolean;
+    /**
+     * Return the localized toolbox label for this block.
+     * @returns {string} Localized toolbox title.
+     */
+    get title(): string;
+    /**
+     * Create the editable DOM owned by this block instance.
+     * @param {Record<string, unknown>} data
+     * @param {import('../../core/types.js').BlockMutationContext} context
+     * @returns {HTMLElement}
+     */
+    render(data: Record<string, unknown>, context: import("../../core/types.js").BlockMutationContext): HTMLElement;
+    /**
+     * Serialize the current block DOM into document data.
+     * @param {HTMLElement} el
+     * @returns {{ files: FileEntry[], variant: string }}
+     */
+    save(el: HTMLElement): {
+        files: FileEntry[];
+        variant: string;
+    };
+    /**
+     * Check whether serialized data satisfies this block's schema.
+     * @param {Record<string, unknown>} data
+     * @returns {boolean}
+     */
+    validate(data: Record<string, unknown>): boolean;
+    /**
+     * Check whether the block has no meaningful user content.
+     * @param {HTMLElement} el
+     * @returns {boolean}
+     */
+    isEmpty(el: HTMLElement): boolean;
+    /**
+     * Extract neutral text that can initialize another block type.
+     * @param {HTMLElement} el
+     * @returns {{ text: string }}
+     */
+    exportData(el: HTMLElement): {
+        text: string;
+    };
+    /**
+     * Abort work and listeners owned by one rendered block.
+     * @param {HTMLElement} el
+     * @returns {void}
+     */
+    destroy(el: HTMLElement): void;
+    /**
+     * Release temporary local URLs after all block snapshots and undo history
+     * owned by this editor have become unreachable.
+     * @returns {void}
+     */
+    dispose(): void;
+    #private;
+}
+export type FileEntry = {
+    url: string;
+    name: string;
+    size: number;
+    extension: string;
+};
+export type AttachesAction = {
+    /**
+     * Plain-text label shown on the source button.
+     */
+    label: string;
+    /**
+     * Trusted application-owned icon markup. Never pass user-authored HTML.
+     */
+    icon?: string;
+    /**
+     * Opens an application-owned source and returns selected files, or `null` when selection is cancelled.
+     */
+    handler: (context: {
+        signal: AbortSignal;
+    }) => Promise<Array<{
+        url: string;
+        name: string;
+        size?: number;
+        extension?: string;
+    }> | null>;
+};
+export type AttachesConfig = {
+    /**
+     * Uploads a browser file. Without this callback the plugin creates a temporary object URL valid until the editor is destroyed.
+     */
+    uploadFile?: (file: File, context: {
+        signal: AbortSignal;
+    }) => Promise<{
+        url: string;
+        size?: number;
+    }>;
+    /**
+     * Additional file sources such as a media library.
+     */
+    actions?: AttachesAction[];
+    /**
+     * Whether the editor should load the built-in plugin stylesheet.
+     */
+    injectStyles?: boolean;
+    /**
+     * Additional or replacement stylesheet URL, depending on `injectStyles`.
+     */
+    css?: string;
+};
+export type AttachesState = {
+    data: {
+        files: FileEntry[];
+        variant: string;
+    };
+    viewController: AbortController | null;
+    taskControllers: Set<AbortController>;
+    expanded: boolean;
+    context: import("../../core/types.js").BlockMutationContext;
+};
+import { BlockPluginAbstract } from '../BlockPluginAbstract.js';