@formicoidea/labre-core 0.47.1 → 0.48.0

package/dist/_pkgs/affine-shared/services/linked-doc-creation-service.d.ts

@@ -2,16 +2,25 @@ import type { EditorHost } from '../../std/index.js';
 import { type ExtensionType, type Store } from '../../store/index.js';
 /**
  * Creates the new doc that the linked-doc features populate (the edgeless
- * "Create linked page" / "Turn into linked page" actions). By default this is a
- * fresh in-workspace doc; a host app can override it to ALSO persist or register
- * the doc (assign a stored id, create a metadata row, attach sync) before the
- * editor writes blocks into the returned store.
+ * "Create linked page" / "Turn into linked page" actions, and the slash menu's
+ * "New Page" since 0.48, which leaves a linked-doc card where it was typed). By
+ * default this is a fresh in-workspace doc; a host app can override it to ALSO
+ * persist or register the doc (assign a stored id, create a metadata row,
+ * attach sync) before the editor writes blocks into the returned store.
  *
- * The returned `Store` must be ready for `addBlock`. `title` is forwarded so the
- * host can record it; the caller still writes the page block's own title.
+ * The returned `Store` is left UNLOADED: the caller writes its blocks in
+ * `store.load(initFn)`, and a doc that is already loaded skips `initFn`.
+ * `title` is forwarded so the host can record it; the caller still writes the
+ * page block's own title.
  */
 export interface LinkedDocCreationProvider {
     createLinkedDoc(host: EditorHost, title?: string): Store;
+    /**
+     * Whether a doc may be created from this editor at all (a host may refuse
+     * it on a doc shared with a guest, for instance). Read by the slash menu's
+     * "New Page", which hides itself on `false`. Absent means allowed (since 0.48).
+     */
+    canCreateLinkedDoc?(host: EditorHost): boolean;
 }
 export declare const LinkedDocCreationProvider: import("../../global/di/types.js").ServiceIdentifier<LinkedDocCreationProvider> & (<U extends LinkedDocCreationProvider = LinkedDocCreationProvider>(variant: import("../../global/di/types.js").ServiceVariant) => import("../../global/di/types.js").ServiceIdentifier<U>);
 /**

package/dist/_pkgs/affine-shared/services/title-band-service.d.ts

@@ -17,7 +17,7 @@ import type { ReadonlySignal } from '@preact/signals-core';
  * database cell read the same `type`, `data` and value.
  *
  * Absent, there is no band at all: no chips, no "+", no panel button, no "Not
- * shown in this document" row, and nothing else changes.
+ * shown on this page" row, and nothing else changes.
  */
 /**
  * One visible property of a page's sheet, in the order the band draws it.
@@ -103,12 +103,15 @@ export interface TitleBandService {
     collapsed$?(docId: string): ReadonlySignal<boolean>;
     setCollapsed?(docId: string, collapsed: boolean): void;
     /**
-     * The child pages this document holds but does not display. Read **in the
-     * canvas view only**, drawn in the note header as a "Not shown in this
-     * document" row of page links that open through the linked-document path
-     * (`RefNodeSlotsProvider.docLinkClicked`). In the page view the host draws
-     * that row under the title itself, so a document never shows two. Absent
-     * or empty, no row.
+     * The child pages this document holds but does not display, drawn in both
+     * views (under the title, and in the note header on the canvas) as a "Not
+     * shown on this page" row: each page is a link that opens through the
+     * linked-document path (`RefNodeSlotsProvider.docLinkClicked`; without it,
+     * no row), with a "Show here" button on a writable document that inserts
+     * an `affine:embed-linked-doc` card of it (end of the last note in the
+     * page view, centre of the visible canvas on the canvas). The library
+     * writes only that card: dropping the page from this list once it shows is
+     * the host's reading of the document. Absent or empty, no row.
      */
     notShown$?(docId: string): ReadonlySignal<readonly TitleBandNotShownPage[]>;
 }

package/dist/_pkgs/affine-shared/utils/model/doc.d.ts

@@ -1,5 +1,13 @@
-import type { Workspace } from '../../../store/index.js';
+import type { Store, Workspace } from '../../../store/index.js';
 export declare function createDefaultDoc(collection: Workspace, options?: {
     id?: string;
     title?: string;
-}): import("../../../store/index.js").Store;
+}): Store;
+/**
+ * The blocks of a blank page, written into an empty store: the page with its
+ * title, its surface, and one note holding an empty paragraph. Shared by
+ * `createDefaultDoc` and by the creation paths that receive their store from
+ * the host (`LinkedDocCreationProvider`), so a page opens the same whoever
+ * made it.
+ */
+export declare function writeDefaultDocBlocks(store: Store, title?: string): void;

package/dist/_pkgs/affine-shared/utils/model/doc.js

@@ -5,19 +5,29 @@ export function createDefaultDoc(collection, options = {}) {
     doc.load();
     const store = doc.getStore();
     const title = options.title ?? '';
-    const rootId = store.addBlock('affine:page', {
-        title: new Text(title),
-    });
+    writeDefaultDocBlocks(store, title);
     collection.meta.setDocMeta(doc.id, {
         title,
     });
+    // To make sure the content of new doc would not be clear
+    // By undo operation for the first time
+    store.resetHistory();
+    return store;
+}
+/**
+ * The blocks of a blank page, written into an empty store: the page with its
+ * title, its surface, and one note holding an empty paragraph. Shared by
+ * `createDefaultDoc` and by the creation paths that receive their store from
+ * the host (`LinkedDocCreationProvider`), so a page opens the same whoever
+ * made it.
+ */
+export function writeDefaultDocBlocks(store, title = '') {
+    const rootId = store.addBlock('affine:page', {
+        title: new Text(title),
+    });
     store.addBlock('affine:surface', {}, rootId);
     const noteId = store.addBlock('affine:note', {
         xywh: `[0, 0, ${DEFAULT_PAGE_BLOCK_WIDTH}, ${DEFAULT_PAGE_BLOCK_HEIGHT}]`,
     }, rootId);
     store.addBlock('affine:paragraph', {}, noteId);
-    // To make sure the content of new doc would not be clear
-    // By undo operation for the first time
-    store.resetHistory();
-    return store;
 }

package/dist/_pkgs/data-view/core/component/tags/multi-tag-select.d.ts

@@ -7,7 +7,12 @@ export type TagManagerOptions = {
     value: ReadonlySignal<string[]>;
     onChange: (value: string[]) => void;
     options: ReadonlySignal<SelectTag[]>;
-    onOptionsChange: (options: SelectTag[]) => void;
+    /**
+     * Absent, the options are fixed: the menu picks among them and offers no
+     * "Create", no option menu and no reordering (a standalone cell whose host
+     * cannot write the property's config, `standalone-cell.ts`).
+     */
+    onOptionsChange?: (options: SelectTag[]) => void;
     onComplete?: () => void;
     initialDraftText?: string;
 };
@@ -32,7 +37,7 @@ export declare class MultiTagSelect extends MultiTagSelect_base {
     accessor mode: 'multi' | 'single';
     accessor onChange: (value: string[]) => void;
     accessor onComplete: () => void;
-    accessor onOptionsChange: (options: SelectTag[]) => void;
+    accessor onOptionsChange: ((options: SelectTag[]) => void) | undefined;
     accessor options: ReadonlySignal<SelectTag[]>;
     private readonly selectedIndex$;
     accessor value: ReadonlySignal<string[]>;

package/dist/_pkgs/data-view/core/component/tags/multi-tag-select.js

@@ -77,7 +77,7 @@ class TagManager {
     constructor(ops) {
         this.ops = ops;
         this.changeTag = (option) => {
-            this.ops.onOptionsChange(this.ops.options.value.map(item => {
+            this.ops.onOptionsChange?.(this.ops.options.value.map(item => {
                 if (item.id === option.id) {
                     return {
                         ...item,
@@ -90,7 +90,7 @@ class TagManager {
         this.color$ = signal(getTagColor());
         this.createOption = () => {
             const value = this.text$.value.trim();
-            if (value === '')
+            if (value === '' || !this.ops.onOptionsChange)
                 return;
             const id = nanoid();
             this.ops.onOptionsChange([
@@ -109,7 +109,7 @@ class TagManager {
             }
         };
         this.deleteOption = (id) => {
-            this.ops.onOptionsChange(this.ops.options.value.filter(item => item.id !== id));
+            this.ops.onOptionsChange?.(this.ops.options.value.filter(item => item.id !== id));
         };
         this.filteredOptions$ = computed(() => {
             let matched = false;
@@ -129,7 +129,7 @@ class TagManager {
                     matched = true;
                 }
             }
-            if (this.text$.value && !matched) {
+            if (this.text$.value && !matched && this.ops.onOptionsChange) {
                 options.push({
                     id: 'create',
                     color: this.color$.value,
@@ -246,11 +246,16 @@ let MultiTagSelect = (() => {
     </div>`;
         }
         renderTags() {
+            const editable = !!this.onOptionsChange;
             return html `
       <div
         style="height: 0.5px;background-color: ${cssVarV2('layer/insideBorder/border')};margin: 4px 0;"
       ></div>
-      <div class="${selectOptionsTipsStyle}">Select tag or create one</div>
+      ${editable
+                ? html `<div class="${selectOptionsTipsStyle}">
+            Select tag or create one
+          </div>`
+                : nothing}
       <div data-testid="tag-option-list" class="${selectOptionsContainerStyle}">
         ${repeat(this.tagManager.filteredOptions$.value, select => select.id, (select, index) => {
                 const isSelected = index === this.selectedIndex$.value;
@@ -267,7 +272,7 @@ let MultiTagSelect = (() => {
                 };
                 return html `
               <div
-                ${!select.isCreate ? sortable(select.id) : nothing}
+                ${editable && !select.isCreate ? sortable(select.id) : nothing}
                 class="${classes}"
                 @mouseenter="${mouseenter}"
                 @click="${select.select}"
@@ -277,15 +282,17 @@ let MultiTagSelect = (() => {
                     ? html ` <div class="${selectOptionNewIconStyle}">
                         Create
                       </div>`
-                    : html `
-                        <div
-                          ${dragHandler(select.id)}
-                          class="${selectOptionDragHandlerStyle}"
-                        ></div>
-                      `}
+                    : editable
+                        ? html `
+                          <div
+                            ${dragHandler(select.id)}
+                            class="${selectOptionDragHandlerStyle}"
+                          ></div>
+                        `
+                        : nothing}
                   ${this.renderTag(select.value, select.color)}
                 </div>
-                ${!select.isCreate
+                ${editable && !select.isCreate
                     ? html ` <div
                       class="${selectOptionIconStyle}"
                       @click="${clickOption}"
@@ -445,7 +452,7 @@ let MultiTagSelect = (() => {
                 onDragEnd: evt => {
                     const over = evt.over;
                     const activeId = evt.active.id;
-                    if (over && over.id !== activeId) {
+                    if (over && over.id !== activeId && this.onOptionsChange) {
                         this.onOptionsChange(arrayMove(this.options.value, this.options.value.findIndex(v => v.id === activeId), this.options.value.findIndex(v => v.id === over.id)));
                         this.requestUpdate();
                         // const properties = this.filteredOptions$.value.map(v=>v.id);
@@ -470,7 +477,7 @@ let MultiTagSelect = (() => {
             this.#mode_accessor_storage = __runInitializers(this, _mode_initializers, 'multi');
             this.#onChange_accessor_storage = (__runInitializers(this, _mode_extraInitializers), __runInitializers(this, _onChange_initializers, void 0));
             this.#onComplete_accessor_storage = (__runInitializers(this, _onChange_extraInitializers), __runInitializers(this, _onComplete_initializers, void 0));
-            this.#onOptionsChange_accessor_storage = (__runInitializers(this, _onComplete_extraInitializers), __runInitializers(this, _onOptionsChange_initializers, void 0));
+            this.#onOptionsChange_accessor_storage = (__runInitializers(this, _onComplete_extraInitializers), __runInitializers(this, _onOptionsChange_initializers, undefined));
             this.#options_accessor_storage = (__runInitializers(this, _onOptionsChange_extraInitializers), __runInitializers(this, _options_initializers, void 0));
             this.selectedIndex$ = (__runInitializers(this, _options_extraInitializers), signal(0));
             this.#value_accessor_storage = __runInitializers(this, _value_initializers, void 0);

package/dist/_pkgs/data-view/core/effect.js

@@ -13,6 +13,7 @@ import { SelectGroupView } from './group-by/renderer/select-group.js';
 import { StringGroupView } from './group-by/renderer/string-group.js';
 import { GroupSetting } from './group-by/setting.js';
 import { AffineLitIcon, UniAnyRender, UniLit } from './index.js';
+import { StandaloneCellHost } from './property/standalone-cell.js';
 import { AnyRender } from './utils/uni-component/render-template.js';
 export function coreEffects() {
     customElements.define('affine-data-view-renderer', DataViewRootUI);
@@ -34,4 +35,5 @@ export function coreEffects() {
     customElements.define('uni-any-render', UniAnyRender);
     customElements.define('variable-ref-view', VariableRefView);
     customElements.define('affine-data-view-record-detail', RecordDetail);
+    customElements.define('dv-standalone-cell', StandaloneCellHost);
 }

package/dist/_pkgs/data-view/core/property/index.d.ts

@@ -3,4 +3,5 @@ export * from './convert.js';
 export * from './manager.js';
 export * from './property-config.js';
 export * from './renderer.js';
+export * from './standalone-cell.js';
 export * from './types.js';

package/dist/_pkgs/data-view/core/property/index.js

@@ -3,4 +3,5 @@ export * from './convert.js';
 export * from './manager.js';
 export * from './property-config.js';
 export * from './renderer.js';
+export * from './standalone-cell.js';
 export * from './types.js';

package/dist/_pkgs/data-view/core/property/standalone-cell.d.ts

@@ -0,0 +1,95 @@
+import { type GeneralServiceIdentifier } from '../../../global/di/index.js';
+import { ShadowlessElement } from '../../../std/index.js';
+import type { ExtensionType } from '../../../store/index.js';
+import { type ReadonlySignal } from '@preact/signals-core';
+import { nothing } from 'lit';
+import type { DatabaseFlags } from '../types.js';
+import type { Cell } from '../view-manager/cell.js';
+import type { PropertyMetaConfig } from './property-config.js';
+/**
+ * A cell outside any view: one property's value drawn and edited by the very
+ * cell renderer a table cell mounts (checkbox, select, multi-select, date,
+ * number, text, a link…), for a host that has a value and no table, such as
+ * the title band under a page title (ADR 0035 §11).
+ *
+ * A cell renderer is written against a `Cell` bound to a `SingleView` and a
+ * data source. Outside a view there are neither, and building a data source
+ * for one value would be a second store. What the presets actually read is
+ * small, and this seam provides exactly that and nothing more:
+ * - of the property: `name$`, `data$`, `type$`, `readonly$`, `dataUpdate`,
+ *   `renderer$`, `meta$`, and `dataCanSet`;
+ * - of the view: `featureFlags$` (the number format), `serviceGet` (the link
+ *   cell's editor host) and `readonly$`;
+ * - of the cell: `value$` and `valueSet`, with the JSON value the raw one,
+ *   which holds for every preset a standalone cell is drawn for.
+ * The rest of `SingleView` and `Row` is absent: a renderer that starts
+ * reading it fails `standalone-cell.unit.spec.ts`, which mounts every preset
+ * through this seam, rather than a host at run time.
+ */
+export interface StandaloneCellSource<RawValue = unknown, Data extends Record<string, unknown> = Record<string, unknown>> {
+    readonly propertyId: string;
+    readonly name$: ReadonlySignal<string>;
+    readonly data$: ReadonlySignal<Data>;
+    readonly value$: ReadonlySignal<RawValue | undefined>;
+    readonly readonly$: ReadonlySignal<boolean>;
+    /** A value the cell's editor commits; the host decides when it shows. */
+    valueSet(value: RawValue | undefined): void;
+    /**
+     * Writes the property's config (a select's options). Absent, the config is
+     * not the host's to write here: a select offers its options and creates,
+     * renames, recolours, reorders or deletes none.
+     */
+    dataSet?(data: Data): void;
+    /** The view's flags (`enable_number_formatting`); absent, all off. */
+    readonly featureFlags$?: ReadonlySignal<DatabaseFlags>;
+    /** What `view.serviceGet` answers; absent, nothing. */
+    serviceGet?<T>(key: GeneralServiceIdentifier<T>): T | null;
+}
+/** A `Cell` for one value outside any view, drawn with `meta`'s renderer. */
+export declare function createStandaloneCell<RawValue = unknown, Data extends Record<string, unknown> = Record<string, unknown>>(meta: PropertyMetaConfig, source: StandaloneCellSource<RawValue, Data>): Cell<RawValue, RawValue, Data>;
+/**
+ * A property type a standalone cell can be drawn with, registered by the
+ * package that owns its renderer when that package sits above the host: the
+ * database block registers its `link` cell, which the title band (a fragment
+ * the database block depends on) cannot import. The presets of this package
+ * need no registration; a host imports them.
+ */
+export declare const StandaloneCellMetaProvider: import("../../../global/di/types.js").ServiceIdentifier<PropertyMetaConfig> & (<U extends PropertyMetaConfig = PropertyMetaConfig>(variant: import("../../../global/di/types.js").ServiceVariant) => import("../../../global/di/types.js").ServiceIdentifier<U>);
+export declare function StandaloneCellMetaExtension<Type extends string, Data extends NonNullable<unknown>, RawValue, JsonValue>(meta: PropertyMetaConfig<Type, Data, RawValue, JsonValue>): ExtensionType;
+declare const StandaloneCellHost_base: typeof ShadowlessElement & import("../../../global/utils/types.js").Constructor<import("../../../global/lit/with-disposable.js").DisposableClass>;
+/**
+ * The element that hosts a standalone cell: it mounts the cell renderer the
+ * way a table cell container does and owns the same edit lifecycle
+ * (`beforeEnterEditMode`, `afterEnterEditingMode`, `beforeExitEditingMode`),
+ * so a click, Enter or Space starts the renderer's own editor: the checkbox
+ * toggles, a select pops its tag menu, the date its picker, a text its input.
+ *
+ * Leaving: a popup editor (select, date) closes itself on a click away and
+ * calls `selectCurrentCell(false)`, as in the table; an editor drawn in place
+ * (an input inside this element) leaves when the focus does, Escape included.
+ * Either way the renderer's exit hook commits, exactly once.
+ */
+export declare class StandaloneCellHost extends StandaloneCellHost_base {
+    static styles: import("lit").CSSResult;
+    private readonly _cell$;
+    private _exiting;
+    readonly isEditing$: import("@preact/signals-core").Signal<boolean>;
+    /** Opens the renderer's editor; a checkbox toggles instead. */
+    edit(): void;
+    /** Closes the editor; the renderer's exit hook commits its value. */
+    exit(): void;
+    private readonly _selectCurrentCell;
+    connectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1> | typeof nothing;
+    accessor cell: Cell;
+    /** Drawn while the value is empty and no editor is open. */
+    accessor placeholder: string;
+    /** Draws the value and opens no editor. */
+    accessor readonly: boolean;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'dv-standalone-cell': StandaloneCellHost;
+    }
+}
+export {};