bokeh 4.0.0.dev3__tar.gz → 4.0.0.dev4__tar.gz

{bokeh-4.0.0.dev3/src/bokeh.egg-info → bokeh-4.0.0.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bokeh
-Version: 4.0.0.dev3
+Version: 4.0.0.dev4
 Summary: Interactive plots and applications in the browser from Python
 Author: Bokeh Team
 Author-email: info@bokeh.org

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/application/handlers/code.py

@@ -44,6 +44,7 @@ from typing import (
     Callable,
     ClassVar,
     Generator,
+    Sequence,
 )
 
 # Bokeh imports
@@ -88,7 +89,7 @@ class CodeHandler(Handler):
 
     _origin: ClassVar[str]
 
-    def __init__(self, *, source: str, filename: PathLike, argv: list[str] = [], package: ModuleType | None = None) -> None:
+    def __init__(self, *, source: str, filename: PathLike, argv: Sequence[str] = (), package: ModuleType | None = None) -> None:
         '''
 
         Args:
@@ -96,7 +97,7 @@ class CodeHandler(Handler):
 
             filename (str) : a filename to use in any debugging or error output
 
-            argv (list[str], optional) : a list of string arguments to make
+            argv (Sequence[str], optional) : a sequence of string arguments to make
                 available as ``sys.argv`` when the code executes
 
         '''

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/application/handlers/code_runner.py

@@ -28,7 +28,12 @@ import traceback
 from contextlib import contextmanager
 from os.path import basename
 from threading import RLock
-from typing import TYPE_CHECKING, Callable, Generator
+from typing import (
+    TYPE_CHECKING,
+    Callable,
+    Generator,
+    Sequence,
+)
 
 # Bokeh imports
 from ...util.serialization import make_globally_unique_id
@@ -66,7 +71,7 @@ class CodeRunner:
     _permanent_error_detail: str | None
     _path: PathLike
     _source: str
-    _argv: list[str]
+    _argv: Sequence[str]
     _package: ModuleType | None
     ran: bool
 
@@ -74,7 +79,7 @@ class CodeRunner:
     _error: str | None
     _error_detail: str | None
 
-    def __init__(self, source: str, path: PathLike, argv: list[str], package: ModuleType | None = None) -> None:
+    def __init__(self, source: str, path: PathLike, argv: Sequence[str], package: ModuleType | None = None) -> None:
         '''
 
         Args:
@@ -84,8 +89,8 @@ class CodeRunner:
             path (str) :
                 A filename to use in any debugging or error output
 
-            argv (list[str]) :
-                A list of string arguments to make available as ``sys.argv``
+            argv (Sequence[str]) :
+                A sequence of string arguments to make available as ``sys.argv``
                 when the code executes
 
             package (bool) :
@@ -246,7 +251,7 @@ def _hold_process_globals() -> Generator[None, None, None]:
         yield
 
 @contextmanager
-def _patch_process_state(path: PathLike, argv: list[str]) -> Generator[None, None, None]:
+def _patch_process_state(path: PathLike, argv: Sequence[str]) -> Generator[None, None, None]:
     # Simulate the sys.path behaviour described here:
     #
     # https://docs.python.org/2/library/sys.html#sys.path

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/application/handlers/directory.py

@@ -55,7 +55,7 @@ from os.path import (
     exists,
     join,
 )
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, Sequence
 
 # External imports
 from jinja2 import Environment, FileSystemLoader, Template
@@ -107,12 +107,12 @@ class DirectoryHandler(Handler):
     _static: str | None
     _template: Template | None
 
-    def __init__(self, *, filename: PathLike, argv: list[str] = []) -> None:
+    def __init__(self, *, filename: PathLike, argv: Sequence[str] = ()) -> None:
         '''
         Keywords:
             filename (str) : a path to an application directory with either "main.py" or "main.ipynb"
 
-            argv (list[str], optional) : a list of string arguments to make available as sys.argv to main.py
+            argv (Sequence[str], optional) : a sequence of string arguments to make available as sys.argv to main.py
         '''
         super().__init__()
 

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/application/handlers/notebook.py

@@ -30,7 +30,7 @@ log = logging.getLogger(__name__)
 
 # Standard library imports
 import re
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Sequence
 
 # Bokeh imports
 from ...util.dependencies import import_required
@@ -67,7 +67,7 @@ class NotebookHandler(CodeHandler):
 
     _origin = "Notebook"
 
-    def __init__(self, *, filename: PathLike, argv: list[str] = [], package: ModuleType | None = None) -> None:
+    def __init__(self, *, filename: PathLike, argv: Sequence[str] = (), package: ModuleType | None = None) -> None:
         '''
 
         Keywords:

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/application/handlers/script.py

@@ -46,7 +46,7 @@ log = logging.getLogger(__name__)
 #-----------------------------------------------------------------------------
 
 # Standard library imports
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Sequence
 
 # Bokeh imports
 from .code import CodeHandler
@@ -81,7 +81,7 @@ class ScriptHandler(CodeHandler):
 
     _origin = "Script"
 
-    def __init__(self, *, filename: PathLike, argv: list[str] = [], package: ModuleType | None = None) -> None:
+    def __init__(self, *, filename: PathLike, argv: Sequence[str] = (), package: ModuleType | None = None) -> None:
         '''
 
         Keywords:

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/application/handlers/server_lifecycle.py

@@ -23,7 +23,7 @@ log = logging.getLogger(__name__)
 
 # Standard library imports
 import os
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Sequence
 
 # Bokeh imports
 from ...util.callback_manager import _check_callback
@@ -56,14 +56,14 @@ class ServerLifecycleHandler(LifecycleHandler):
 
     '''
 
-    def __init__(self, *, filename: PathLike, argv: list[str] = [], package: ModuleType | None = None) -> None:
+    def __init__(self, *, filename: PathLike, argv: Sequence[str] = (), package: ModuleType | None = None) -> None:
         '''
 
         Keyword Args:
             filename (str) : path to a module to load lifecycle callbacks from
 
-            argv (list[str], optional) : a list of string arguments to use as
-                ``sys.argv`` when the callback code is executed. (default: [])
+            argv (Sequence[str], optional) : a sequence of string arguments to use as
+                ``sys.argv`` when the callback code is executed. (default: ())
 
         '''
         super().__init__()

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/application/handlers/server_request_handler.py

@@ -23,7 +23,7 @@ log = logging.getLogger(__name__)
 
 # Standard library imports
 import os
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Sequence
 
 # Bokeh imports
 from ...util.callback_manager import _check_callback
@@ -58,14 +58,14 @@ class ServerRequestHandler(RequestHandler):
 
     _module: ModuleType
 
-    def __init__(self, *, filename: PathLike, argv: list[str] = [], package: ModuleType | None = None) -> None:
+    def __init__(self, *, filename: PathLike, argv: Sequence[str] = (), package: ModuleType | None = None) -> None:
         '''
 
         Keyword Args:
             filename (str) : path to a module to load request handler callbacks from
 
-            argv (list[str], optional) : a list of string arguments to use as
-                ``sys.argv`` when the callback code is executed. (default: [])
+            argv (Sequence[str], optional) : a sequence of string arguments to use as
+                ``sys.argv`` when the callback code is executed. (default: ())
 
         '''
         super().__init__()

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/core/property/wrappers.py

@@ -411,8 +411,8 @@ class PropertyValueColumnData(PropertyValueDict[Sequence[Any]]):
     def __copy__(self) -> PropertyValueColumnData:
         return PropertyValueColumnData(dict(self))
 
-    def __deepcopy__(self, memodict: dict[Any, Any] = {}) -> PropertyValueColumnData:
-        return PropertyValueColumnData(copy.deepcopy(dict(self), memodict))
+    def __deepcopy__(self, memo: dict[Any, Any]) -> PropertyValueColumnData:
+        return PropertyValueColumnData(copy.deepcopy(dict(self), memo))
 
     # don't wrap with notify_owner --- notifies owners explicitly
     def update(self, *args: Any, **kwargs: Sequence[Any]) -> None:

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/layouts.py

@@ -398,7 +398,9 @@ def gridplot(
 
     return gp
 
-# XXX https://github.com/python/mypy/issues/731
+type GridChild = UIElement | None | Sequence[GridChild]
+type GridChildren = Sequence[GridChild]
+
 @overload
 def grid(children: list[UIElement | list[UIElement | list[Any]]], *, sizing_mode: SizingModeType | None = ...) -> GridBox: ...
 @overload
@@ -412,7 +414,12 @@ def grid(children: list[UIElement | None], *, sizing_mode: SizingModeType | None
 @overload
 def grid(children: str, *, sizing_mode: SizingModeType | None = ...) -> GridBox: ...
 
-def grid(children: Any = [], sizing_mode: SizingModeType | None = None, nrows: int | None = None, ncols: int | None = None) -> GridBox:
+def grid(
+    children: str | GridChildren | Row | Column = (),
+    sizing_mode: SizingModeType | None = None,
+    nrows: int | None = None,
+    ncols: int | None = None,
+) -> GridBox:
     """
     Conveniently create a grid of layoutable objects.
 
@@ -549,15 +556,18 @@ def grid(children: Any = [], sizing_mode: SizingModeType | None = None, nrows: i
         return GridBox(children=children)
 
     layout: row | col
-    if isinstance(children, list):
+    if isinstance(children, str):
+        raise NotImplementedError
+    elif isinstance(children, Sequence):
+        children = list(children)
         if nrows is not None or ncols is not None:
             N = len(children)
             if ncols is None:
                 ncols = math.ceil(N/nrows)
             layout = col([ row(children[i:i+ncols]) for i in range(0, N, ncols) ])
         else:
-            def traverse_list(children: list[LayoutDOM], level: int = 0):
-                if isinstance(children, list):
+            def traverse_list(children: Sequence[GridChild], level: int = 0):
+                if isinstance(children, Sequence) and not isinstance(children, str):
                     container = col if level % 2 == 0 else row
                     return container([ traverse_list(child, level+1) for child in children ])
                 else:
@@ -576,10 +586,8 @@ def grid(children: Any = [], sizing_mode: SizingModeType | None = None, nrows: i
                 return item
 
         layout = traverse_layout(children, top_level=True)
-    elif isinstance(children, str):
-        raise NotImplementedError
     else:
-        raise ValueError("expected a list, string or model")
+        raise ValueError("expected a sequence, string, Row or Column")
 
     grid = flatten(layout)
 

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/models/widgets/tables.py

@@ -925,6 +925,8 @@ class DataTable(TableWidget):
 
         """
 
+
+        formatters = formatters.copy()
         if isinstance(data, ColumnDataSource):
             source = data.clone()
         else:

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/palettes.py

@@ -1563,9 +1563,10 @@ def diverging_palette(palette1: Palette, palette2: Palette, n: int, midpoint: fl
     # flip palette2 so that perceptually light colors are joined
     palette2 = palette2[::-1]
 
-    # determine number of colors from each palette
+    # determine number of colors from each palette; n2 is a remainder rather than a
+    # second rounding so that the two always add up to n
     n1 = round(midpoint * n)
-    n2 = round((1 - midpoint) * n)
+    n2 = n - n1
 
     # return piecewise linear interpolation of colors
     return linear_palette(palette1, n1) + linear_palette(palette2, n2)

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/plotting/_renderer.py

@@ -192,6 +192,7 @@ def pop_visuals(glyphclass: type[Glyph], props: Attrs, *, prefix: str = "", defa
         ultimate defaults in case those can't be deduced.
     """
     defaults = defaults.copy()
+    override_defaults = override_defaults.copy()
     defaults.setdefault('text_color', 'black')
     defaults.setdefault('hatch_color', 'black')
 

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh-api.js

@@ -30,7 +30,7 @@
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 (function(root, factory) {
-  factory(root["Bokeh"], "4.0.0-dev.3");
+  factory(root["Bokeh"], "4.0.0-dev.4");
 })(this, function(Bokeh, version) {
   let define;
   return (function(modules, entry, aliases, externals) {

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh-api.min.js

@@ -30,7 +30,7 @@
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 (function(root, factory) {
-  factory(root["Bokeh"], "4.0.0-dev.3");
+  factory(root["Bokeh"], "4.0.0-dev.4");
 })(this, function(Bokeh, version) {
   let define;
   return (function(modules, entry, aliases, externals) {

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh-gl.js

@@ -30,7 +30,7 @@
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 (function(root, factory) {
-  factory(root["Bokeh"], "4.0.0-dev.3");
+  factory(root["Bokeh"], "4.0.0-dev.4");
 })(this, function(Bokeh, version) {
   let define;
   return (function(modules, entry, aliases, externals) {

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh-gl.min.js

@@ -30,7 +30,7 @@
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 (function(root, factory) {
-  factory(root["Bokeh"], "4.0.0-dev.3");
+  factory(root["Bokeh"], "4.0.0-dev.4");
 })(this, function(Bokeh, version) {
   let define;
   return (function(modules, entry, aliases, externals) {

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh-mathjax.js

@@ -30,7 +30,7 @@
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 (function(root, factory) {
-  factory(root["Bokeh"], "4.0.0-dev.3");
+  factory(root["Bokeh"], "4.0.0-dev.4");
 })(this, function(Bokeh, version) {
   let define;
   return (function(modules, entry, aliases, externals) {

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh-mathjax.min.js

@@ -30,7 +30,7 @@
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 (function(root, factory) {
-  factory(root["Bokeh"], "4.0.0-dev.3");
+  factory(root["Bokeh"], "4.0.0-dev.4");
 })(this, function(Bokeh, version) {
   let define;
   return (function(modules, entry, aliases, externals) {

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh-tables.js

@@ -30,7 +30,7 @@
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 (function(root, factory) {
-  factory(root["Bokeh"], "4.0.0-dev.3");
+  factory(root["Bokeh"], "4.0.0-dev.4");
 })(this, function(Bokeh, version) {
   let define;
   return (function(modules, entry, aliases, externals) {

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh-tables.min.js

@@ -30,7 +30,7 @@
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 (function(root, factory) {
-  factory(root["Bokeh"], "4.0.0-dev.3");
+  factory(root["Bokeh"], "4.0.0-dev.4");
 })(this, function(Bokeh, version) {
   let define;
   return (function(modules, entry, aliases, externals) {

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh-widgets.js

@@ -30,7 +30,7 @@
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 (function(root, factory) {
-  factory(root["Bokeh"], "4.0.0-dev.3");
+  factory(root["Bokeh"], "4.0.0-dev.4");
 })(this, function(Bokeh, version) {
   let define;
   return (function(modules, entry, aliases, externals) {

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh-widgets.min.js

@@ -30,7 +30,7 @@
  * THE POSSIBILITY OF SUCH DAMAGE.
  */
 (function(root, factory) {
-  factory(root["Bokeh"], "4.0.0-dev.3");
+  factory(root["Bokeh"], "4.0.0-dev.4");
 })(this, function(Bokeh, version) {
   let define;
   return (function(modules, entry, aliases, externals) {

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh.js

@@ -736,7 +736,7 @@
 },
 /* version.js */ function _(require, module, exports, __esModule, __esExport) {
     __esModule();
-    exports.version = "4.0.0-dev.3";
+    exports.version = "4.0.0-dev.4";
 },
 /* embed/index.js */ function _(require, module, exports, __esModule, __esExport) {
     __esModule();

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/server/static/js/bokeh.min.js

@@ -160,7 +160,7 @@
 function _(t,n,o,r,a){r();t(1).__exportStar(t(2),o),t(100)},
 function _(e,t,r,n,o){n(),r.__extends=i,r.__rest=c,r.__decorate=s,r.__param=u,r.__esDecorate=f,r.__runInitializers=l,r.__propKey=p,r.__setFunctionName=y,r.__metadata=d,r.__awaiter=h,r.__generator=v,r.__exportStar=b,r.__values=w,r.__read=m,r.__spread=g,r.__spreadArrays=O,r.__spreadArray=j,r.__await=P,r.__asyncGenerator=S,r.__asyncDelegator=E,r.__asyncValues=x,r.__makeTemplateObject=T,r.__importStar=R,r.__importDefault=k,r.__classPrivateFieldGet=A,r.__classPrivateFieldSet=F,r.__classPrivateFieldIn=C,r.__addDisposableResource=B,r.__disposeResources=z,r.__rewriteRelativeImportExtension=M;var a=function(e,t){return a=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(e,t){e.__proto__=t}||function(e,t){for(var r in t)Object.prototype.hasOwnProperty.call(t,r)&&(e[r]=t[r])},a(e,t)};function i(e,t){if("function"!=typeof t&&null!==t)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");function r(){this.constructor=e}a(e,t),e.prototype=null===t?Object.create(t):(r.prototype=t.prototype,new r)}function c(e,t){var r={};for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&t.indexOf(n)<0&&(r[n]=e[n]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols){var o=0;for(n=Object.getOwnPropertySymbols(e);o<n.length;o++)t.indexOf(n[o])<0&&Object.prototype.propertyIsEnumerable.call(e,n[o])&&(r[n[o]]=e[n[o]])}return r}function s(e,t,r,n){var o,a=arguments.length,i=a<3?t:null===n?n=Object.getOwnPropertyDescriptor(t,r):n;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)i=Reflect.decorate(e,t,r,n);else for(var c=e.length-1;c>=0;c--)(o=e[c])&&(i=(a<3?o(i):a>3?o(t,r,i):o(t,r))||i);return a>3&&i&&Object.defineProperty(t,r,i),i}function u(e,t){return function(r,n){t(r,n,e)}}function f(e,t,r,n,o,a){function i(e){if(void 0!==e&&"function"!=typeof e)throw new TypeError("Function expected");return e}for(var c,s=n.kind,u="getter"===s?"get":"setter"===s?"set":"value",f=!t&&e?n.static?e:e.prototype:null,l=t||(f?Object.getOwnPropertyDescriptor(f,n.name):{}),p=!1,y=r.length-1;y>=0;y--){var d={};for(var h in n)d[h]="access"===h?{}:n[h];for(var h in n.access)d.access[h]=n.access[h];d.addInitializer=function(e){if(p)throw new TypeError("Cannot add initializers after decoration has completed");a.push(i(e||null))};var v=(0,r[y])("accessor"===s?{get:l.get,set:l.set}:l[u],d);if("accessor"===s){if(void 0===v)continue;if(null===v||"object"!=typeof v)throw new TypeError("Object expected");(c=i(v.get))&&(l.get=c),(c=i(v.set))&&(l.set=c),(c=i(v.init))&&o.unshift(c)}else(c=i(v))&&("field"===s?o.unshift(c):l[u]=c)}f&&Object.defineProperty(f,n.name,l),p=!0}function l(e,t,r){for(var n=arguments.length>2,o=0;o<t.length;o++)r=n?t[o].call(e,r):t[o].call(e);return n?r:void 0}function p(e){return"symbol"==typeof e?e:"".concat(e)}function y(e,t,r){return"symbol"==typeof t&&(t=t.description?"[".concat(t.description,"]"):""),Object.defineProperty(e,"name",{configurable:!0,value:r?"".concat(r," ",t):t})}function d(e,t){if("object"==typeof Reflect&&"function"==typeof Reflect.metadata)return Reflect.metadata(e,t)}function h(e,t,r,n){return new(r||(r=Promise))(function(o,a){function i(e){try{s(n.next(e))}catch(e){a(e)}}function c(e){try{s(n.throw(e))}catch(e){a(e)}}function s(e){var t;e.done?o(e.value):(t=e.value,t instanceof r?t:new r(function(e){e(t)})).then(i,c)}s((n=n.apply(e,t||[])).next())})}function v(e,t){var r,n,o,a={label:0,sent:function(){if(1&o[0])throw o[1];return o[1]},trys:[],ops:[]},i=Object.create(("function"==typeof Iterator?Iterator:Object).prototype);return i.next=c(0),i.throw=c(1),i.return=c(2),"function"==typeof Symbol&&(i[Symbol.iterator]=function(){return this}),i;function c(c){return function(s){return function(c){if(r)throw new TypeError("Generator is already executing.");for(;i&&(i=0,c[0]&&(a=0)),a;)try{if(r=1,n&&(o=2&c[0]?n.return:c[0]?n.throw||((o=n.return)&&o.call(n),0):n.next)&&!(o=o.call(n,c[1])).done)return o;switch(n=0,o&&(c=[2&c[0],o.value]),c[0]){case 0:case 1:o=c;break;case 4:return a.label++,{value:c[1],done:!1};case 5:a.label++,n=c[1],c=[0];continue;case 7:c=a.ops.pop(),a.trys.pop();continue;default:if(!(o=a.trys,(o=o.length>0&&o[o.length-1])||6!==c[0]&&2!==c[0])){a=0;continue}if(3===c[0]&&(!o||c[1]>o[0]&&c[1]<o[3])){a.label=c[1];break}if(6===c[0]&&a.label<o[1]){a.label=o[1],o=c;break}if(o&&a.label<o[2]){a.label=o[2],a.ops.push(c);break}o[2]&&a.ops.pop(),a.trys.pop();continue}c=t.call(e,a)}catch(e){c=[6,e],n=0}finally{r=o=0}if(5&c[0])throw c[1];return{value:c[0]?c[1]:void 0,done:!0}}([c,s])}}}function b(e,t){for(var n in e)"default"===n||Object.prototype.hasOwnProperty.call(t,n)||(0,r.__createBinding)(t,e,n)}function w(e){var t="function"==typeof Symbol&&Symbol.iterator,r=t&&e[t],n=0;if(r)return r.call(e);if(e&&"number"==typeof e.length)return{next:function(){return e&&n>=e.length&&(e=void 0),{value:e&&e[n++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function m(e,t){var r="function"==typeof Symbol&&e[Symbol.iterator];if(!r)return e;var n,o,a=r.call(e),i=[];try{for(;(void 0===t||t-- >0)&&!(n=a.next()).done;)i.push(n.value)}catch(e){o={error:e}}finally{try{n&&!n.done&&(r=a.return)&&r.call(a)}finally{if(o)throw o.error}}return i}function g(){for(var e=[],t=0;t<arguments.length;t++)e=e.concat(m(arguments[t]));return e}function O(){for(var e=0,t=0,r=arguments.length;t<r;t++)e+=arguments[t].length;var n=Array(e),o=0;for(t=0;t<r;t++)for(var a=arguments[t],i=0,c=a.length;i<c;i++,o++)n[o]=a[i];return n}function j(e,t,r){if(r||2===arguments.length)for(var n,o=0,a=t.length;o<a;o++)!n&&o in t||(n||(n=Array.prototype.slice.call(t,0,o)),n[o]=t[o]);return e.concat(n||Array.prototype.slice.call(t))}function P(e){return this instanceof P?(this.v=e,this):new P(e)}function S(e,t,r){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var n,o=r.apply(e,t||[]),a=[];return n=Object.create(("function"==typeof AsyncIterator?AsyncIterator:Object).prototype),i("next"),i("throw"),i("return",function(e){return function(t){return Promise.resolve(t).then(e,u)}}),n[Symbol.asyncIterator]=function(){return this},n;function i(e,t){o[e]&&(n[e]=function(t){return new Promise(function(r,n){a.push([e,t,r,n])>1||c(e,t)})},t&&(n[e]=t(n[e])))}function c(e,t){try{(r=o[e](t)).value instanceof P?Promise.resolve(r.value.v).then(s,u):f(a[0][2],r)}catch(e){f(a[0][3],e)}var r}function s(e){c("next",e)}function u(e){c("throw",e)}function f(e,t){e(t),a.shift(),a.length&&c(a[0][0],a[0][1])}}function E(e){var t,r;return t={},n("next"),n("throw",function(e){throw e}),n("return"),t[Symbol.iterator]=function(){return this},t;function n(n,o){t[n]=e[n]?function(t){return(r=!r)?{value:P(e[n](t)),done:!1}:o?o(t):t}:o}}function x(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t,r=e[Symbol.asyncIterator];return r?r.call(e):(e=w(e),t={},n("next"),n("throw"),n("return"),t[Symbol.asyncIterator]=function(){return this},t);function n(r){t[r]=e[r]&&function(t){return new Promise(function(n,o){(function(e,t,r,n){Promise.resolve(n).then(function(t){e({value:t,done:r})},t)})(n,o,(t=e[r](t)).done,t.value)})}}}function T(e,t){return Object.defineProperty?Object.defineProperty(e,"raw",{value:t}):e.raw=t,e}r.__assign=function(){return r.__assign=Object.assign||function(e){for(var t,r=1,n=arguments.length;r<n;r++)for(var o in t=arguments[r])Object.prototype.hasOwnProperty.call(t,o)&&(e[o]=t[o]);return e},r.__assign.apply(this,arguments)},r.__createBinding=Object.create?function(e,t,r,n){void 0===n&&(n=r);var o=Object.getOwnPropertyDescriptor(t,r);o&&!("get"in o?!t.__esModule:o.writable||o.configurable)||(o={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,n,o)}:function(e,t,r,n){void 0===n&&(n=r),e[n]=t[r]};var I=Object.create?function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}:function(e,t){e.default=t},D=function(e){return D=Object.getOwnPropertyNames||function(e){var t=[];for(var r in e)Object.prototype.hasOwnProperty.call(e,r)&&(t[t.length]=r);return t},D(e)};function R(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var n=D(e),o=0;o<n.length;o++)"default"!==n[o]&&(0,r.__createBinding)(t,e,n[o]);return I(t,e),t}function k(e){return e&&e.__esModule?e:{default:e}}function A(e,t,r,n){if("a"===r&&!n)throw new TypeError("Private accessor was defined without a getter");if("function"==typeof t?e!==t||!n:!t.has(e))throw new TypeError("Cannot read private member from an object whose class did not declare it");return"m"===r?n:"a"===r?n.call(e):n?n.value:t.get(e)}function F(e,t,r,n,o){if("m"===n)throw new TypeError("Private method is not writable");if("a"===n&&!o)throw new TypeError("Private accessor was defined without a setter");if("function"==typeof t?e!==t||!o:!t.has(e))throw new TypeError("Cannot write private member to an object whose class did not declare it");return"a"===n?o.call(e,r):o?o.value=r:t.set(e,r),r}function C(e,t){if(null===t||"object"!=typeof t&&"function"!=typeof t)throw new TypeError("Cannot use 'in' operator on non-object");return"function"==typeof e?t===e:e.has(t)}function B(e,t,r){if(null!=t){if("object"!=typeof t&&"function"!=typeof t)throw new TypeError("Object expected.");var n,o;if(r){if(!Symbol.asyncDispose)throw new TypeError("Symbol.asyncDispose is not defined.");n=t[Symbol.asyncDispose]}if(void 0===n){if(!Symbol.dispose)throw new TypeError("Symbol.dispose is not defined.");n=t[Symbol.dispose],r&&(o=n)}if("function"!=typeof n)throw new TypeError("Object not disposable.");o&&(n=function(){try{o.call(this)}catch(e){return Promise.reject(e)}}),e.stack.push({value:t,dispose:n,async:r})}else r&&e.stack.push({async:!0});return t}var G="function"==typeof SuppressedError?SuppressedError:function(e,t,r){var n=new Error(r);return n.name="SuppressedError",n.error=e,n.suppressed=t,n};function z(e){function t(t){e.error=e.hasError?new G(t,e.error,"An error was suppressed during disposal."):t,e.hasError=!0}var r,n=0;return function o(){for(;r=e.stack.pop();)try{if(!r.async&&1===n)return n=0,e.stack.push(r),Promise.resolve().then(o);if(r.dispose){var a=r.dispose.call(r.value);if(r.async)return n|=2,Promise.resolve(a).then(o,function(e){return t(e),o()})}else n|=1}catch(e){t(e)}if(1===n)return e.hasError?Promise.reject(e.error):Promise.resolve();if(e.hasError)throw e.error}()}function M(e,t){return"string"==typeof e&&/^\.\.?\//.test(e)?e.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i,function(e,r,n,o,a){return r?t?".jsx":".js":!n||o&&a?n+o+"."+a.toLowerCase()+"js":e}):e}r.default={__extends:i,__assign:r.__assign,__rest:c,__decorate:s,__param:u,__esDecorate:f,__runInitializers:l,__propKey:p,__setFunctionName:y,__metadata:d,__awaiter:h,__generator:v,__createBinding:r.__createBinding,__exportStar:b,__values:w,__read:m,__spread:g,__spreadArrays:O,__spreadArray:j,__await:P,__asyncGenerator:S,__asyncDelegator:E,__asyncValues:x,__makeTemplateObject:T,__importStar:R,__importDefault:k,__classPrivateFieldGet:A,__classPrivateFieldSet:F,__classPrivateFieldIn:C,__addDisposableResource:B,__disposeResources:z,__rewriteRelativeImportExtension:M}},
 function _(e,o,s,t,l){t();const n=e(1);l("version",e(3).version),l("index",e(4).index),s.embed=n.__importStar(e(4)),s.protocol=n.__importStar(e(98));var r=e(11);l("logger",r.logger),l("set_log_level",r.set_log_level),l("settings",e(38).settings),l("Models",e(7).Models),l("documents",e(5).documents),l("safely",e(99).safely)},
-function _(n,e,i,o,v){o(),i.version="4.0.0-dev.3"},
+function _(n,e,i,o,v){o(),i.version="4.0.0-dev.4"},
 function _(e,o,t,n,r){n(),t.embed_item=async function(e,o){const t={},n=(0,c.uuid4)();t[n]=e.doc,null==o&&(o=e.target_id);const r={roots:{[e.root_id]:o},root_ids:[e.root_id],docid:n};await(0,l.defer)();const[s]=await h(t,[r]);return s},t.embed_items=async function(e,o,t,n){return await(0,l.defer)(),h(e,o,t,n)};const s=e(5),d=e(38),i=e(11),c=e(45),a=e(9),u=e(8),l=e(18),m=e(90),f=e(91),w=e(96);var g=e(90);r("add_document_standalone",g.add_document_standalone),r("index",g.index),r("add_document_from_session",e(91).add_document_from_session);var k=e(97);async function h(e,o,t,n){(0,u.isString)(e)&&(e=JSON.parse((0,c.unescape)(e)));const r={};for(const[o,t]of(0,a.entries)(e))r[o]=s.Document.from_json(t);const l=[];for(const e of o){const o=(0,w._resolve_element)(e),s=(0,w._resolve_root_elements)(e);if(null!=e.docid)l.push(await(0,m.add_document_standalone)(r[e.docid],o,s,e.use_for_title));else{if(null==e.token)throw new Error("Error rendering Bokeh items: either 'docid' or 'token' was expected.");{const r=(0,f._get_ws_url)(t,n);i.logger.debug(`embed: computed ws url: ${r}`);try{l.push(await(0,f.add_document_from_session)(r,e.token,o,s,e.use_for_title)),console.log("Bokeh items were rendered successfully")}catch(e){if(d.settings.dev)throw e;console.error("Error rendering Bokeh items:",e)}}}}return l}r("embed_items_notebook",k.embed_items_notebook),r("kernels",k.kernels)},
 function _(t,r,o,e,n){e();const s=t(1);s.__exportStar(t(6),o),s.__exportStar(t(46),o);const a=t(7),c=s.__importStar(t(57));(0,a.register_models)(c)},
 function _(e,t,s,o,i){o();const n=e(1),l=e(7),r=e(3),c=e(11),a=e(16),h=e(51),d=e(29),m=e(52),u=e(54),f=e(17),g=e(8),p=e(27),v=e(10),w=e(9),y=n.__importStar(e(49)),k=e(55),b=e(13),z=e(56),D=e(57),E=e(88),M=e(89),S=e(89),j=e(46);m.Deserializer.register("model",E.decode_def);class EventManager{document;subscribed_models=new Set;constructor(e){this.document=e}send_event(e){if(e.publish){const t=new j.MessageSentEvent(this.document,"bokeh_event",e);this.document._trigger_on_change(t)}this.document._trigger_on_event(e)}trigger(e){for(const t of this.subscribed_models)null!=e.origin&&e.origin!=t||t._process_event(e)}}s.EventManager=EventManager,s.documents=[],s.DEFAULT_TITLE="Bokeh Application";class Document{views_manager;event_manager;idle;resolver;_init_timestamp;_title;_roots;_all_models;_new_models;_all_models_freeze_count;_callbacks;_document_callbacks;_message_callbacks;_idle_roots;_interactive_timestamp;_interactive_plot;_interactive_finalize;_recompute_timeout;_system_scheme;_config;get config(){return(0,b.assert)(null!=this._config,"configuration is missing"),this._config}set config(e){this.freeze_all_models(()=>this._config=e)}constructor(e={}){s.documents.push(this),this._init_timestamp=Date.now(),this.resolver=e.resolver??new h.ModelResolver(l.default_resolver),this._title=s.DEFAULT_TITLE,this._roots=[],this._all_models=new Map,this._new_models=new Set,this._all_models_freeze_count=0,this._callbacks=new Map,this._document_callbacks=new Map,this._message_callbacks=new Map,this.event_manager=new EventManager(this),this.idle=new f.Signal0(this,"idle"),this._idle_roots=new WeakSet,this._interactive_timestamp=null,this._interactive_plot=null,this._recompute_timeout=e.recompute_timeout??3e4,null!=e.roots&&this._add_roots(...e.roots),this.on_message("bokeh_event",e=>{(0,b.assert)(e instanceof M.ModelEvent),this.event_manager.trigger(e)}),this._system_scheme=matchMedia("(prefers-color-scheme: dark)"),this.config=new D.DocumentConfig,this.set_color_scheme(this.config.color_scheme),this._system_scheme.addEventListener("change",()=>this.set_color_scheme(this.config.color_scheme)),this.config.on_change(this.config.properties.color_scheme,()=>this.set_color_scheme(this.config.color_scheme))}[p.equals](e,t){return this==e}get all_models(){return new Set(this._all_models.values())}get is_idle(){for(const e of this.roots())if(!this._idle_roots.has(e))return!1;return!0}_notified_idle=!1;notify_idle(e){!this._notified_idle&&this.roots().includes(e)&&(this._idle_roots.add(e),this.is_idle&&(c.logger.info(`document idle at ${Date.now()-this._init_timestamp} ms`),this.event_manager.send_event(new S.DocumentReady),this.idle.emit(),this._notified_idle=!0))}clear({sync:e}={}){this._push_all_models_freeze();try{for(;this._roots.length>0;)this.remove_root(this._roots[0],{sync:e});this._config=void 0}finally{this._pop_all_models_freeze()}}interactive_start(e,t=null){null==this._interactive_plot&&(this._interactive_plot=e,this._interactive_plot.trigger_event(new S.LODStart)),this._interactive_finalize=t,this._interactive_timestamp=Date.now()}interactive_stop(){null!=this._interactive_plot&&(this._interactive_plot.trigger_event(new S.LODEnd),null!=this._interactive_finalize&&this._interactive_finalize()),this._interactive_plot=null,this._interactive_timestamp=null,this._interactive_finalize=null}interactive_duration(){return null==this._interactive_timestamp?-1:Date.now()-this._interactive_timestamp}destructively_move(e){if(e===this)throw new Error("Attempted to overwrite a document with itself");e.clear({sync:!1});const{config:t}=this,s=(0,v.copy)(this._roots);this.clear({sync:!1});for(const e of[...s,t])if(null!=e.document)throw new Error(`Somehow we didn't detach ${e}`);if(0!=this._all_models.size)throw new Error(`this._all_models still had stuff in it: ${this._all_models}`);e.config=t;for(const t of s)e.add_root(t);e.set_title(this._title)}_hold_models_freeze=!1;freeze_all_models(e){this._push_all_models_freeze();try{e()}finally{this._pop_all_models_freeze()}}_push_all_models_freeze(){this._hold_models_freeze||(this._all_models_freeze_count+=1)}_pop_all_models_freeze(){this._hold_models_freeze||(this._all_models_freeze_count-=1,0===this._all_models_freeze_count&&this._recompute_all_models())}_recompute_timer=null;_cancel_recompute_all_models(){null!=this._recompute_timer&&(clearTimeout(this._recompute_timer),this._recompute_timer=null)}_schedule_recompute_all_models(){const e=this._recompute_timeout;isNaN(e)||e<=0?this._recompute_all_models():isFinite(e)&&null==this._recompute_timer&&(this._recompute_timer=setTimeout(()=>{this._recompute_all_models()},e))}_recompute_all_models(){this._cancel_recompute_all_models();let e=new Set;for(const t of this.all_roots)e=y.union(e,t.references());const t=new Set(this._all_models.values()),s=y.difference(t,e),o=y.difference(e,t),i=new Map;for(const t of e)i.set(t.id,t);for(const e of s)e.detach_document();for(const e of o)e.attach_document(this),this._new_models.add(e);this._all_models=i}partially_update_all_models(e){const t=new Set;a.HasProps._value_record_references(e,t,{recursive:!1});for(const e of t)this._all_models.has(e.id)||(e.attach_document(this),this._new_models.add(e),this._all_models.set(e.id,e));this._schedule_recompute_all_models()}get all_roots(){const e=[...this._roots];return null!=this._config&&e.push(this._config),e}roots(){return this._roots}_add_roots(...e){if(0==(e=e.filter(e=>!this._roots.includes(e))).length)return!1;this._push_all_models_freeze();try{this._roots.push(...e)}finally{this._pop_all_models_freeze()}return!0}_remove_root(e){const t=this._roots.indexOf(e);if(t<0)return!1;this._push_all_models_freeze();try{this._roots.splice(t,1)}finally{this._pop_all_models_freeze()}return!0}_set_title(e){const t=e!=this._title;return t&&(this._title=e),t}add_root(e,{sync:t}={}){if(this._add_roots(e)){const s=new j.RootAddedEvent(this,e);s.sync=t??!0,this._trigger_on_change(s)}}remove_root(e,{sync:t}={}){if(this._remove_root(e)){const s=new j.RootRemovedEvent(this,e);s.sync=t??!0,this._trigger_on_change(s)}}set_title(e,{sync:t}={}){if(this._set_title(e)){const s=new j.TitleChangedEvent(this,e);s.sync=t??!0,this._trigger_on_change(s)}}title(){return this._title}get_model_by_id(e){return this._all_models.get(e)??null}get_model_by_name(e){const t=[];for(const s of this._all_models.values())s instanceof z.Model&&s.name==e&&t.push(s);switch(t.length){case 0:return null;case 1:return t[0];default:throw new Error(`Multiple models are named '${e}'`)}}on_message(e,t){const s=this._message_callbacks.get(e);null==s?this._message_callbacks.set(e,new Set([t])):s.add(t)}remove_on_message(e,t){this._message_callbacks.get(e)?.delete(t)}_trigger_on_message(e,t){const s=this._message_callbacks.get(e);if(null!=s)for(const e of s)e(t)}on_change(e,t=!1){this._callbacks.has(e)||this._callbacks.set(e,t)}remove_on_change(e){this._callbacks.delete(e)}_trigger_on_change(e){for(const[t,s]of this._callbacks)if(!s&&e instanceof j.DocumentEventBatch)for(const s of e.events)t(s);else t(e)}_trigger_on_event(e){const t=this._document_callbacks.get(e.event_name);if(null!=t)for(const s of t)(0,k.execute)(s,this,e)}on_event(e,...t){const s=(0,g.isString)(e)?e:e.prototype.event_name,o=this._document_callbacks.get(s)??[],i=t;this._document_callbacks.set(s,[...o,...i])}to_json_string(e=!0){return JSON.stringify(this.to_json(e))}to_json(e=!0){const t=new d.Serializer({include_defaults:e}),s=t.encode(this.config),o=t.encode(this._roots);return{version:r.version,title:this._title,config:s,roots:o}}static from_json_string(e,t){const s=JSON.parse(e);return Document.from_json(s,t)}static _handle_version(e){null==e.version&&c.logger.warn("'version' field is missing");const t=e.version??"0.0.0",s=u.Version.from(t),o=u.Version.from(r.version),i=`new document using Bokeh ${t} and BokehJS ${r.version}`;(0,p.is_equal)(s,o)?c.logger.debug(i):c.logger.warn(`Bokeh/BokehJS version mismatch: ${i}`)}static from_json(e,t,s=new Map){c.logger.debug("Creating Document from JSON"),Document._handle_version(e);const o=new h.ModelResolver(l.default_resolver);if(null!=e.defs){new m.Deserializer(o).decode(e.defs,s)}const i=new Document({resolver:o});i._push_all_models_freeze();const n=e=>t?.push(e);i.on_change(n,!0);const r=new m.Deserializer(o,i._all_models,e=>e.attach_document(i)),a=r.decode(e.config,s);(0,b.assert)(a instanceof D.DocumentConfig||null==a),null!=a&&(i.config=a,i.set_color_scheme(a.color_scheme),a.on_change(a.properties.color_scheme,()=>i.set_color_scheme(a.color_scheme)));const d=r.decode(e.roots,s),u=null!=e.callbacks?r.decode(e.callbacks,s):{};i.remove_on_change(n);for(const[e,t]of(0,w.entries)(u))i.on_event(e,...t);for(const e of d)i.add_root(e);return null!=e.title&&i.set_title(e.title),i._pop_all_models_freeze(),i}replace_with_json(e,t=new Map){Document.from_json(e,void 0,t).destructively_move(this)}create_json_patch(e){for(const t of e)if(t.document!=this)throw new Error("Cannot create a patch using events from a different document");const t=new Map;for(const e of this._all_models.values())this._new_models.has(e)||t.set(e,e.ref());const s={events:new d.Serializer({references:t,binary:!0}).encode(e)};return this._new_models.clear(),s}apply_json_patch(e,t=new Map){const{_hold_models_freeze:s}=this;this._hold_models_freeze=!0;try{this._apply_json_patch(e,t)}finally{this._hold_models_freeze=s}this._schedule_recompute_all_models()}_apply_json_patch(e,t=new Map){const s=new m.Deserializer(this.resolver,this._all_models,e=>{e.attach_document(this),this._new_models.add(e),this._all_models.set(e.id,e)}).decode(e.events,t);for(const e of s)switch(e.kind){case"MessageSent":{const{msg_type:t,msg_data:s}=e;this._trigger_on_message(t,s);break}case"ModelChanged":{const{model:t,attr:s,new:o}=e;t.setv({[s]:o},{sync:!1});break}case"ColumnDataChanged":{const{model:t,attr:s,data:o,cols:i}=e;if(null!=i){const e=(0,w.dict)(o),i=(0,w.dict)(t.property(s).get_value());for(const[t,s]of i)e.has(t)||e.set(t,s)}t.setv({data:o},{sync:!1,check_eq:!1});break}case"ColumnsStreamed":{const{model:t,attr:s,data:o,rollover:i}=e,n=t.property(s);t.stream_to(n,o,i,{sync:!1});break}case"ColumnsPatched":{const{model:t,attr:s,patches:o}=e,i=t.property(s);t.patch_to(i,o,{sync:!1});break}case"RootAdded":this.add_root(e.model,{sync:!1});break;case"RootRemoved":this.remove_root(e.model,{sync:!1});break;case"TitleChanged":this.set_title(e.title,{sync:!1});break;default:throw new Error(`unknown patch event type '${e.kind}'`)}}set_color_scheme(e){const t=this._system_scheme.matches?"dark":"light",s="auto"==e?t:e;document.documentElement.style.setProperty("--bokeh-color-scheme",s)}}s.Document=Document},

{bokeh-4.0.0.dev3 → bokeh-4.0.0.dev4}/src/bokeh/sphinxext/_internal/bokeh_autodoc.py

@@ -16,7 +16,7 @@ Bokeh-specific directives when appropriate.
 # -----------------------------------------------------------------------------
 from __future__ import annotations
 
-import logging  # isort:skip
+from sphinx.util import logging  # isort:skip
 
 log = logging.getLogger(__name__)
 
@@ -25,6 +25,8 @@ log = logging.getLogger(__name__)
 # -----------------------------------------------------------------------------
 
 # Standard library imports
+from dataclasses import dataclass
+from time import perf_counter
 from typing import Any
 
 # External imports
@@ -43,6 +45,7 @@ from bokeh.model import Model
 # Bokeh imports
 from . import PARALLEL_SAFE, SphinxParallelSpec
 from .bokeh_toc import _shorten_reference_toc_titles
+from .timing import _setup_docs_profile
 
 # -----------------------------------------------------------------------------
 # Globals and constants
@@ -125,7 +128,11 @@ def setup(app: Any) -> SphinxParallelSpec:
     app.add_autodocumenter(EnumDocumenter)
     app.add_autodocumenter(PropDocumenter)
     app.add_autodocumenter(ModelDocumenter)
+    _setup_docs_profile(app)
     app.connect("env-updated", _shorten_reference_toc_titles)
+    app.connect("env-updated", _prune_empty_viewcode_modules)
+    app.connect("write-started", _cache_python_domain_fuzzy_lookups, priority=999)
+    app.connect("build-finished", _log_fuzzy_lookup_stats, priority=999)
 
     return PARALLEL_SAFE
 
@@ -133,6 +140,107 @@ def setup(app: Any) -> SphinxParallelSpec:
 # Private API
 # -----------------------------------------------------------------------------
 
+_FUZZY_LOOKUP_STATS_ATTR = "_bokeh_python_fuzzy_lookup_stats"
+
+
+@dataclass
+class _FuzzyLookupStats:
+    calls: int = 0
+    contextual: int = 0
+    fallbacks: int = 0
+    computed: int = 0
+    elapsed: float = 0.0
+
+
+def _log_fuzzy_lookup_stats(app: Any, exception: Exception | None) -> None:
+    stats = getattr(app.builder, _FUZZY_LOOKUP_STATS_ATTR, None)
+    if stats is not None:
+        reused = stats.fallbacks - stats.computed
+        reuse_percent = 100 * reused / stats.fallbacks if stats.fallbacks else 0
+        log.info(
+            f"Bokeh Python fuzzy lookups: calls={stats.calls} contextual={stats.contextual} "
+            f"suffix-computed={stats.computed} suffix-reused={reused} ({reuse_percent:.1f}%) "
+            f"compute={stats.elapsed:.3f}s",
+        )
+
+
+def _prune_empty_viewcode_modules(app: Any, env: Any) -> None:
+    """Remove unused module entries retained by parallel viewcode merges."""
+    modules = getattr(env, "_viewcode_modules", None)
+    if modules is None:
+        return
+
+    # Sphinx removes these entries while purging serial builds, but its worker
+    # merge can retain entries whose documented members were removed elsewhere.
+    for name, entry in list(modules.items()):
+        if entry and not entry[2]:
+            del modules[name]
+
+
+def _cache_python_domain_fuzzy_lookups(app: Any, builder: Any) -> None:
+    """Cache fuzzy Python-domain lookups once the object inventory is final."""
+    domain = builder.env.domains.get("py")
+    if domain is None:
+        return
+
+    find_obj = domain.find_obj
+    fallback_cache: dict[tuple[str, str | None], tuple[Any, ...]] = {}
+    objtypes_cache: dict[str | None, list[str] | None] = {}
+    stats = _FuzzyLookupStats()
+    setattr(builder, _FUZZY_LOOKUP_STATS_ATTR, stats)
+
+    def cached_find_obj(
+        env: Any,
+        modname: str | None,
+        classname: str | None,
+        name: str,
+        objtype: str | None,
+        searchmode: int = 0,
+    ) -> Any:
+        # Exact lookups are already constant-time. Fuzzy lookups scan every
+        # Python object, so repeated misses for common annotations are costly.
+        if env is not builder.env or searchmode != 1:
+            return find_obj(env, modname, classname, name, objtype, searchmode)
+
+        stats.calls += 1
+        name = name.removesuffix("()")
+        if not name:
+            return []
+
+        try:
+            objtypes = objtypes_cache[objtype]
+        except KeyError:
+            objtypes = list(domain.object_types) if objtype is None else domain.objtypes_for_role(objtype)
+            objtypes_cache[objtype] = objtypes
+
+        if objtypes is None:
+            return []
+
+        candidates = (
+            f"{modname}.{classname}.{name}" if modname and classname else None,
+            f"{modname}.{name}" if modname else None,
+            name,
+        )
+        for candidate in candidates:
+            entry = domain.objects.get(candidate)
+            if entry is not None and entry.objtype in objtypes:
+                stats.contextual += 1
+                return [(candidate, entry)]
+
+        stats.fallbacks += 1
+        key = (name, objtype)
+        try:
+            return list(fallback_cache[key])
+        except KeyError:
+            started = perf_counter()
+            result = find_obj(env, None, None, name, objtype, searchmode)
+            stats.elapsed += perf_counter() - started
+            stats.computed += 1
+            fallback_cache[key] = tuple(result)
+            return result
+
+    domain.find_obj = cached_find_obj
+
 # -----------------------------------------------------------------------------
 # Code
 # -----------------------------------------------------------------------------