okf 1.9.0 → 1.10.0

data/lib/okf/render/graph.rb

@@ -71,9 +71,11 @@ module OKF
       # +siblings+/+self_slug+/+hub_path+ carry the hub's bundle switcher into the
       # page (server mode only). nil — the standalone-server and `okf render`
       # default — injects an empty SIBLINGS, so the switcher never appears in a
-      # single bundle or a static file.
+      # single bundle or a static file. +search_endpoint+ rides along with them:
+      # the hub's cross-bundle /search, which only a hub can answer.
       def initialize(graph, title: nil, link: nil, layout: "cose", node_endpoint: "node", meta_endpoint: "node/meta", embed: nil,
-                     siblings: nil, self_slug: nil, hub_path: nil)
+                     siblings: nil, self_slug: nil, hub_path: nil, search_endpoint: nil,
+                     manage_root: nil, manage_token: nil)
         @graph = graph
         @title = title
         @link = link
@@ -84,6 +86,9 @@ module OKF
         @siblings = siblings
         @self_slug = self_slug
         @hub_path = hub_path
+        @search_endpoint = search_endpoint
+        @manage_root = manage_root
+        @manage_token = manage_token
       end
 
       def render
@@ -158,6 +163,45 @@ module OKF
         json_for_script(@hub_path)
       end
 
+      # The hub's cross-bundle /search, mount-relative — null everywhere else, and
+      # that null is the gate: a standalone server and a static file have no set
+      # of bundles to search, so the palette never offers concepts there.
+      def search_endpoint_json
+        json_for_script(@search_endpoint)
+      end
+
+      # Behind a hub the mark is a link back to the bundle list — "../" reaches
+      # it under any mount, because every page lives at <prefix>/b/<slug>/.
+      # Standalone and static have nowhere to go, so there it stays the plain
+      # identity badge it has always been, and an <a href> to nothing is worse
+      # than no <a> at all.
+      def rail_brand_open
+        return %(<span class="rail-brand" title=") unless @manage_root
+
+        %(<a class="rail-brand" href="../" aria-label="All bundles" title=")
+      end
+
+      def rail_brand_close
+        @manage_root ? "</a>" : "</span>"
+      end
+
+      # The hub root, mount-relative — where the Bundles panel reads /bundles and
+      # posts /registry/<verb>. Null everywhere else, and that null is the gate:
+      # a standalone server and a static file have no registry behind them, so
+      # the panel never appears there.
+      def manage_root_json
+        json_for_script(@manage_root)
+      end
+
+      # This boot's CSRF token, and only where a write could be honoured — a
+      # read-only hub bakes null, so the page holds no credential it may not use.
+      # It is no wider than the /b/ manager, which any script on this origin
+      # could already read; keeping it out of the page where it is useless is
+      # tidiness, not a boundary.
+      def manage_token_json
+        json_for_script(@manage_token)
+      end
+
       # JSON-encode for safe embedding in an inline <script>: escaping every `<` to
       # its JSON unicode escape neutralizes </script>, <!-- and <script in one
       # stroke, and the result stays valid JSON *and* JavaScript.

data/lib/okf/server/app.rb

@@ -33,9 +33,11 @@ module OKF
     class App
       # +siblings+/+self_slug+/+hub_path+ are set only when this app is hosted under
       # a hub (OKF::Server::Hub): the other bundles the in-page switcher offers, this
-      # bundle's own mount slug, and the hub root. They stay nil for a standalone
-      # server and for `okf render`, so a static file never advertises a switcher.
-      def initialize(folder, title: nil, link: nil, layout: "cose", siblings: nil, self_slug: nil, hub_path: nil)
+      # bundle's own mount slug, the hub root, and the hub's cross-bundle search
+      # route. They stay nil for a standalone server and for `okf render`, so a
+      # static file never advertises a switcher or a search it cannot answer.
+      def initialize(folder, title: nil, link: nil, layout: "cose", siblings: nil, self_slug: nil, hub_path: nil,
+                     search_endpoint: nil, manage_root: nil, manage_token: nil)
         @folder = folder
         @title = title
         @link = link
@@ -43,6 +45,9 @@ module OKF
         @siblings = siblings
         @self_slug = self_slug
         @hub_path = hub_path
+        @search_endpoint = search_endpoint
+        @manage_root = manage_root
+        @manage_token = manage_token
       end
 
       def call(env)
@@ -100,7 +105,8 @@ module OKF
       def page
         @page ||= OKF::Render::Graph.new(
           graph, title: @title || @folder.name, link: @link, layout: @layout,
-          siblings: @siblings, self_slug: @self_slug, hub_path: @hub_path
+          siblings: @siblings, self_slug: @self_slug, hub_path: @hub_path, search_endpoint: @search_endpoint,
+          manage_root: @manage_root, manage_token: @manage_token
         ).render
       end