@mohamedatia/fly-design-system 2.15.1 → 2.15.3

package/fesm2022/mohamedatia-fly-design-system.mjs

@@ -14,6 +14,8 @@ import { Markdown } from '@tiptap/markdown';
 import TaskList from '@tiptap/extension-task-list';
 import TaskItem from '@tiptap/extension-task-item';
 import { TiptapEditorDirective } from 'ngx-tiptap';
+import { Link } from '@tiptap/extension-link';
+import { registerCustomProtocol } from 'linkifyjs';
 import { switchMap, debounceTime, distinctUntilChanged, filter } from 'rxjs/operators';
 import Cropper from 'cropperjs';
 
@@ -2438,6 +2440,87 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.5", ngImpor
                 args: ['document:keydown.escape']
             }] } });
 
+/**
+ * Centralised registration + a non-resetting Link extension for the platform's
+ * ``flyos:`` entity deep-link scheme.
+ *
+ * WHY THIS EXISTS — Tiptap's stock ``@tiptap/extension-link`` couples two
+ * concerns onto its ``protocols`` option:
+ *   1. ``isAllowedUri`` allow-listing — read directly from ``options.protocols``
+ *      so a ``flyos:`` href survives instead of being blanked to ``href=""``.
+ *   2. linkify autolink scheme registration — done by calling linkify's global
+ *      ``registerCustomProtocol`` inside the mark's ``onCreate``, and undone by
+ *      ``reset()`` inside ``onDestroy``.
+ *
+ * linkify is a process-wide singleton that only accepts scheme registration
+ * *before* its first tokenisation. So with stock Link the SECOND editor to mount
+ * after linkify has initialised re-calls ``registerCustomProtocol`` and linkify
+ * logs:
+ *   ``linkifyjs: already initialized - will not register custom scheme "flyos" …``
+ * and worse, every editor's ``onDestroy`` ``reset()`` wipes the scheme registry
+ * for all other live editors.
+ *
+ * {@link FlyosLink} keeps concern (1) — ``protocols`` stays set, so hrefs and
+ * ``getMarkdown()`` round-trips survive — but drops the per-editor register
+ * /reset of (2). Registration is hoisted to a single {@link registerFlyosProtocol}
+ * call made once, before any editor, so the scheme is registered exactly once
+ * and never torn down.
+ *
+ * See ``skills/cross-app-deep-linking.md``.
+ */
+/** The platform entity deep-link URI scheme (``flyos:<appId>.<entity>/<id>``). */
+const FLYOS_PROTOCOL = 'flyos';
+let registered = false;
+/**
+ * Register the ``flyos`` scheme with linkify exactly once. MUST run before any
+ * Tiptap editor tokenises (i.e. at app bootstrap) because linkify rejects — and
+ * warns about — scheme registration after its singleton initialises.
+ *
+ * Idempotent: repeat calls are no-ops, so it is safe to also call defensively
+ * from an editor's constructor for consumers that don't own a shared bootstrap
+ * (e.g. a federated remote that mounts {@link FlyMarkdownEditorComponent}
+ * standalone).
+ */
+function registerFlyosProtocol() {
+    if (registered)
+        return;
+    registered = true;
+    registerCustomProtocol(FLYOS_PROTOCOL);
+}
+/**
+ * Drop-in replacement for ``@tiptap/extension-link``'s ``Link`` that keeps the
+ * ``flyos`` href allow-list but does NOT register the scheme per-editor or
+ * ``reset()`` linkify on teardown — see the module header for the full
+ * rationale. Defaults ``openOnClick`` off because ``flyos:`` is non-routable in
+ * a browser; surfaces that can launch in-shell wire their own
+ * ``editorProps.handleClick`` (see ``flyosEditorHandleClick``).
+ *
+ * Keeps the mark name ``link`` so StarterKit's link commands (``setLink`` /
+ * ``toggleLink`` / ``isActive('link')``) and markdown serialisation keep
+ * working — pair it with ``StarterKit.configure({ link: false })``.
+ */
+const FlyosLink = Link.extend({
+    addOptions() {
+        // `parent` (the base Link's addOptions) is always defined for Link.extend;
+        // the cast restores the required LinkOptions fields the optional `?.` drops.
+        return {
+            ...this.parent?.(),
+            openOnClick: false,
+            protocols: [FLYOS_PROTOCOL],
+        };
+    },
+    // Scheme registration is centralised in registerFlyosProtocol(); skipping the
+    // stock per-editor registerCustomProtocol() is what silences linkify's
+    // "already initialized" warning on the 2nd+ concurrent editor.
+    // eslint-disable-next-line @typescript-eslint/no-empty-function -- intentional no-op override
+    onCreate() { },
+    // Stock Link calls linkify reset() here, which would un-register `flyos`
+    // (and every other custom scheme) for every other live editor. Registration
+    // is process-wide and owned by registerFlyosProtocol() — never torn down.
+    // eslint-disable-next-line @typescript-eslint/no-empty-function -- intentional no-op override
+    onDestroy() { },
+});
+
 const ENTITY_LINK_LAUNCHER = new InjectionToken('ENTITY_LINK_LAUNCHER');
 const MARKDOWN_TOOLBAR_PRESETS = {
     full: [
@@ -2528,14 +2611,19 @@ class FlyMarkdownEditorComponent {
     }, ...(ngDevMode ? [{ debugName: "toolbarItems" }] : /* istanbul ignore next */ []));
     editor;
     constructor() {
+        // Register the `flyos` scheme once, before this editor tokenises. Idempotent
+        // — covered by the shell bootstrap in the desktop host, but called here too
+        // so a standalone consumer (e.g. a federated remote) is self-sufficient.
+        registerFlyosProtocol();
         this.editor = new Editor({
             extensions: [
-                StarterKit.configure({
-                    // Whitelist the platform deep-link scheme so Tiptap keeps the href
-                    // instead of blanking it; openOnClick false because flyos: is
-                    // non-routable — handleClick launches in-shell below.
-                    link: { openOnClick: false, protocols: ['flyos'] },
-                }),
+                // FlyosLink replaces StarterKit's bundled link: it keeps the `flyos:`
+                // href whitelist (so the href isn't blanked) but skips the per-editor
+                // linkify register/reset that triggers the "already initialized" warning
+                // across concurrent editors. openOnClick false because flyos: is
+                // non-routable — handleClick launches in-shell below.
+                StarterKit.configure({ link: false }),
+                FlyosLink,
                 Markdown,
                 TaskList,
                 TaskItem.configure({ nested: true }),
@@ -6544,5 +6632,5 @@ const AUDIENCE_ERROR_CODES = {
  * Generated bundle index. Do not edit.
  */
 
-export { AGENT_DRAG_MIME, AGENT_PAYLOAD_VERSION, APP_LOOKUP, AUDIENCE_ERROR_CODES, AUDIENCE_LIMITS, AUDIENCE_PRESETS, AUDIENCE_TERM_KINDS, AgentActionBus, AgentActionUnsupportedDispatchError, AgentCommandRegistry, AgentDropRegistry, AgentFlightAnimator, AgentLookupRegistry, AgentPayloadOversizeError, AudienceBuilderComponent, AuthService, ContextMenuComponent, DEFAULT_AGENT_PAYLOAD_LIMITS, DEFAULT_FLY_THEME_MODE, DS_BASELINE_LOCALES, DialogResult, ENTITY_LINK_LAUNCHER, EntityLookupComponent, FLYOS_LAUNCH_EVENT, FLYOS_REMOTE_ROUTE_EVENT, FLY_LOCALE_CATALOG, FLY_REMOTE_BASE_PATH, FLY_REMOTE_CONTEXT_EVENT, FLY_REMOTE_CONTEXT_STORE_KEY, FLY_REMOTE_ROUTES, FLY_THEME_MODE_IDS, FLY_WINDOW_HELP_HINT_EVENT, FlyAgentDraggableDirective, FlyBlockUiComponent, FlyFileUploadComponent, FlyImageUploadComponent, FlyMarkdownEditorComponent, FlyRemoteContextService, FlyRemoteRouter, FlyRemoteRouterOutletComponent, FlySecureSrcDirective, FlyThemeService, FlyWindowHelpService, FlyosPendingLaunchesGlobalKey, FlyosShellOwnsHistoryGlobalKey, I18nService, LAUNCH_CONTEXT, MARKDOWN_TOOLBAR_PRESETS, MessageBoxButtons, MessageBoxComponent, MessageBoxIcon, MessageBoxService, MockAuthService, RTL_LOCALE_SET, SHARE_ORG_CHART_SYSTEM_KEY_APPS, SHARE_ORG_CHART_SYSTEM_KEY_DEFAULT, SHARE_PANEL_DEFAULT_FILE_LEVELS, SUPPORTED_AGENT_PAYLOAD_VERSIONS, SharePanelComponent, SourceAppResolver, StandaloneWindowManagerService, TranslatePipe, WINDOW_DATA, WINDOW_HELP_HINT, WindowManagerService, findLocaleByDialect, findLocaleByPrefix, isRtlLocale, isRtlLocaleEntry, loadRemoteStyles, matchFlyRoutePattern, normalizeFlyTheme, trimAgentPayload, trimAgentString, unloadRemoteStyles, utf8ByteLength, validateAgentPayload };
+export { AGENT_DRAG_MIME, AGENT_PAYLOAD_VERSION, APP_LOOKUP, AUDIENCE_ERROR_CODES, AUDIENCE_LIMITS, AUDIENCE_PRESETS, AUDIENCE_TERM_KINDS, AgentActionBus, AgentActionUnsupportedDispatchError, AgentCommandRegistry, AgentDropRegistry, AgentFlightAnimator, AgentLookupRegistry, AgentPayloadOversizeError, AudienceBuilderComponent, AuthService, ContextMenuComponent, DEFAULT_AGENT_PAYLOAD_LIMITS, DEFAULT_FLY_THEME_MODE, DS_BASELINE_LOCALES, DialogResult, ENTITY_LINK_LAUNCHER, EntityLookupComponent, FLYOS_LAUNCH_EVENT, FLYOS_PROTOCOL, FLYOS_REMOTE_ROUTE_EVENT, FLY_LOCALE_CATALOG, FLY_REMOTE_BASE_PATH, FLY_REMOTE_CONTEXT_EVENT, FLY_REMOTE_CONTEXT_STORE_KEY, FLY_REMOTE_ROUTES, FLY_THEME_MODE_IDS, FLY_WINDOW_HELP_HINT_EVENT, FlyAgentDraggableDirective, FlyBlockUiComponent, FlyFileUploadComponent, FlyImageUploadComponent, FlyMarkdownEditorComponent, FlyRemoteContextService, FlyRemoteRouter, FlyRemoteRouterOutletComponent, FlySecureSrcDirective, FlyThemeService, FlyWindowHelpService, FlyosLink, FlyosPendingLaunchesGlobalKey, FlyosShellOwnsHistoryGlobalKey, I18nService, LAUNCH_CONTEXT, MARKDOWN_TOOLBAR_PRESETS, MessageBoxButtons, MessageBoxComponent, MessageBoxIcon, MessageBoxService, MockAuthService, RTL_LOCALE_SET, SHARE_ORG_CHART_SYSTEM_KEY_APPS, SHARE_ORG_CHART_SYSTEM_KEY_DEFAULT, SHARE_PANEL_DEFAULT_FILE_LEVELS, SUPPORTED_AGENT_PAYLOAD_VERSIONS, SharePanelComponent, SourceAppResolver, StandaloneWindowManagerService, TranslatePipe, WINDOW_DATA, WINDOW_HELP_HINT, WindowManagerService, findLocaleByDialect, findLocaleByPrefix, isRtlLocale, isRtlLocaleEntry, loadRemoteStyles, matchFlyRoutePattern, normalizeFlyTheme, registerFlyosProtocol, trimAgentPayload, trimAgentString, unloadRemoteStyles, utf8ByteLength, validateAgentPayload };
 //# sourceMappingURL=mohamedatia-fly-design-system.mjs.map