@formicoidea/labre-framework-edgy 0.30.1 → 0.32.0

package/dist/translations.d.ts

@@ -0,0 +1,14 @@
+import { type TranslationKeyManifestEntry } from '@formicoidea/labre-core/std';
+/**
+ * THIS framework's contribution to the translation-key manifest.
+ *
+ * Its command labels and descriptions are built from a TEMPLATE, so the
+ * concrete keys exist nowhere but in the declarations themselves and the
+ * core manifest could not restate them even if it wanted to. The
+ * contribution therefore ships WITH the framework: in the bundled
+ * distribution `@formicoidea/labre-framework-edgy` carries it, and a host
+ * composes it into its catalogue exactly as it already composes
+ * `edgyCommands` into the command registry. See
+ * `packages/affine/all/src/translations.ts`.
+ */
+export declare const edgyTranslationEntries: TranslationKeyManifestEntry[];

package/dist/translations.js

@@ -0,0 +1,15 @@
+import { commandTranslationEntries, } from '@formicoidea/labre-core/std';
+import { edgyCommands } from './commands.js';
+/**
+ * THIS framework's contribution to the translation-key manifest.
+ *
+ * Its command labels and descriptions are built from a TEMPLATE, so the
+ * concrete keys exist nowhere but in the declarations themselves and the
+ * core manifest could not restate them even if it wanted to. The
+ * contribution therefore ships WITH the framework: in the bundled
+ * distribution `@formicoidea/labre-framework-edgy` carries it, and a host
+ * composes it into its catalogue exactly as it already composes
+ * `edgyCommands` into the command registry. See
+ * `packages/affine/all/src/translations.ts`.
+ */
+export const edgyTranslationEntries = commandTranslationEntries(edgyCommands);

package/dist/view.d.ts

@@ -1,4 +1,19 @@
 import { type ViewExtensionContext, ViewExtensionProvider } from '@formicoidea/labre-core/ext-loader';
+/**
+ * EDGY rendering — ALWAYS registered, independent of any flag. Disabling `edgy`
+ * hides only the creation tooling (see {@link EdgyViewExtension}); boards and
+ * facets already drawn must still paint, stay selectable, stay editable, keep
+ * their contextual toolbar and keep the dependency spotlight. See
+ * `docs/adr/0009`.
+ */
+export declare class EdgyRenderViewExtension extends ViewExtensionProvider {
+    name: string;
+    setup(context: ViewExtensionContext): void;
+}
+/**
+ * EDGY creation tooling — flag-gated (`edgy`): the senior toolbar button and
+ * its templates category.
+ */
 export declare class EdgyViewExtension extends ViewExtensionProvider {
     name: string;
     effect(): void;

package/dist/view.js

@@ -1,14 +1,55 @@
+import { SpotlightHostExtension } from '@formicoidea/labre-core/blocks/surface';
 import { ViewExtensionProvider, } from '@formicoidea/labre-core/ext-loader';
 import { extendTemplateCategory } from '@formicoidea/labre-core/gfx/template';
-import { effects } from './effects';
-import { edgyTemplateCategory } from './templates';
-import { EdgyFacetsRendererExtension } from './element-renderer';
-import { EdgyInteraction, EdgyView } from './element-view';
-import { EdgyNodeRendererExtension } from './node/node-renderer';
-import { EdgyNodeView } from './node/node-view';
-import { edgyToolbarExtension } from './toolbar/config';
-import { edgyNodeToolbarExtension } from './toolbar/node-config';
-import { edgySeniorTool } from './toolbar/senior-tool';
+import { CommandExtension } from '@formicoidea/labre-core/std';
+import { edgyCommandIcons, edgyCommands } from './commands.js';
+import { effects } from './effects.js';
+import { edgyTemplateCategory } from './templates/index.js';
+import { EdgyBoardRendererExtension } from './board-renderer.js';
+import { EdgyBoardInteraction, EdgyBoardView } from './board-view.js';
+import { EdgyFacetsRendererExtension } from './element-renderer.js';
+import { EdgyInteraction, EdgyView } from './element-view.js';
+import { EdgyNodeRendererExtension } from './node/node-renderer.js';
+import { EdgyNodeView } from './node/node-view.js';
+import { edgyBoardToolbarExtension, edgyToolbarExtension, } from './toolbar/config.js';
+import { edgyNodeToolbarExtension } from './toolbar/node-config.js';
+import { edgySeniorTool } from './toolbar/senior-tool.js';
+/**
+ * EDGY rendering — ALWAYS registered, independent of any flag. Disabling `edgy`
+ * hides only the creation tooling (see {@link EdgyViewExtension}); boards and
+ * facets already drawn must still paint, stay selectable, stay editable, keep
+ * their contextual toolbar and keep the dependency spotlight. See
+ * `docs/adr/0009`.
+ */
+export class EdgyRenderViewExtension extends ViewExtensionProvider {
+    constructor() {
+        super(...arguments);
+        this.name = 'affine-edgy-render-gfx';
+    }
+    setup(context) {
+        super.setup(context);
+        context.register(EdgyView);
+        context.register(EdgyFacetsRendererExtension);
+        context.register(EdgyBoardView);
+        context.register(EdgyBoardRendererExtension);
+        context.register(EdgyNodeView);
+        context.register(EdgyNodeRendererExtension);
+        if (this.isEdgeless(context.scope)) {
+            context.register(EdgyInteraction);
+            context.register(EdgyBoardInteraction);
+            context.register(edgyToolbarExtension);
+            context.register(edgyBoardToolbarExtension);
+            context.register(edgyNodeToolbarExtension);
+            // Both EDGY backgrounds grant the dependency spotlight on hover.
+            context.register(SpotlightHostExtension('edgy'));
+            context.register(SpotlightHostExtension('edgyBoard'));
+        }
+    }
+}
+/**
+ * EDGY creation tooling — flag-gated (`edgy`): the senior toolbar button and
+ * its templates category.
+ */
 export class EdgyViewExtension extends ViewExtensionProvider {
     constructor() {
         super(...arguments);
@@ -16,20 +57,17 @@ export class EdgyViewExtension extends ViewExtensionProvider {
     }
     effect() {
         super.effect();
+        // Defines the senior button and its menu — tooling-only custom elements.
         effects();
         extendTemplateCategory(edgyTemplateCategory);
     }
     setup(context) {
         super.setup(context);
-        context.register(EdgyView);
-        context.register(EdgyFacetsRendererExtension);
-        context.register(EdgyNodeView);
-        context.register(EdgyNodeRendererExtension);
         if (this.isEdgeless(context.scope)) {
-            context.register(EdgyInteraction);
             context.register(edgySeniorTool);
-            context.register(edgyToolbarExtension);
-            context.register(edgyNodeToolbarExtension);
+            // The seven EDGY commands: the sub-menu renders them, Settings ›
+            // Shortcuts finally lists them, and a host override on an id binds.
+            context.register(CommandExtension(edgyCommands, edgyCommandIcons));
         }
     }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@formicoidea/labre-framework-edgy",
   "description": "Labre edgy framework for @formicoidea/labre-core.",
-  "version": "0.30.1",
+  "version": "0.32.0",
   "type": "module",
   "sideEffects": false,
   "author": "lajola",
@@ -27,7 +27,7 @@
     "dist"
   ],
   "dependencies": {
-    "@formicoidea/labre-core": "0.30.1",
+    "@formicoidea/labre-core": "0.32.0",
     "lit": "^3.2.0"
   }
 }