o ,&]i=@sUdZddlmZddlZddlmZddlmZmZddl m Z ddl m Z ddl mZdd lmZmZdd lmZerIdd lmZdd lmZeeZd ed<eGdddZGdddZdS)aCustom Components v2 manager and supporting orchestration. This module composes the registry, manifest handling, and file watching capabilities for Streamlit's Custom Components v2. It provides a unified interface to register components from manifests or individual definitions, query component metadata and asset paths, and react to on-disk changes by re-resolving component definitions. ) annotationsN) dataclass) TYPE_CHECKINGFinal build_definition_with_validation)ComponentFileWatcher)ComponentManifestHandler)BidiComponentDefinitionBidiComponentRegistry) get_logger)Path)ComponentManifestr_LOGGERc@s"eZdZUdZded<ded<dS) _ApiInputsa.Inputs provided via the Python API to resolve a component definition. Attributes ---------- css : str | None Inline CSS content or a path/glob to a CSS asset within ``asset_dir``. js : str | None Inline JS content or a path/glob to a JS asset within ``asset_dir``. str | NonecssjsN)__name__ __module__ __qualname____doc____annotations__rrg/var/www/html/IGF-ODF-V3/venv/lib/python3.10/site-packages/streamlit/components/v2/component_manager.pyr1s  rc@seZdZdZ   dDdEd d ZdFddZdGddZdHddZdId d!ZdJd#d$Z dKd&d'Z dLd(d)Z dMd*d+Z dNd,d-Z dMd.d/Zd0d1dOd4d5ZdMd6d7ZdPd:d;ZdQd>d?ZdRd@dAZedSdBdCZdS)TBidiComponentManagera9Manager class that composes component registry, manifest handler, and file watcher. This class provides a unified interface for working with bidirectional components while maintaining clean separation of concerns through composition. It handles the coordination and lifecycle management of all component-related functionality. Component Lifecycle ------------------- The lifecycle of a component managed by this class involves four key stages: 1. **Discovery**: On startup, ``discover_and_register_components`` scans for installed packages with component manifests (``pyproject.toml``). For each component found, a placeholder definition containing only its name and ``asset_dir`` is registered. This makes the system aware of all available installed components from the outset. 2. **Definition & Validation**: When a user's script calls the public API (e.g., ``st.components.v2.component(...)``), the manager invokes ``build_definition_with_validation``. This function is the single, centralized point for all validation. It resolves file paths, performs security checks against the component's ``asset_dir``, and produces a complete, validated ``BidiComponentDefinition``. 3. **Registration**: The validated definition is then passed to the registry's ``register`` method. This adds the complete definition, overwriting the placeholder if one existed from the discovery phase. 4. **Updating**: The ``ComponentFileWatcher`` monitors the ``asset_dir`` for changes. On a change, it triggers a re-computation of the definition using the original API inputs, runs it through the same validation logic, and updates the registry with the new definition via the stricter ``update_component`` method. Notes ----- This manager intentionally favors composition over inheritance and delegates specialized responsibilities to ``BidiComponentRegistry``, ``ComponentManifestHandler``, and ``ComponentFileWatcher``. NregistryBidiComponentRegistry | Nonemanifest_handlerComponentManifestHandler | None file_watcherComponentFileWatcher | NonereturnNonecCs<|pt|_|p t|_i|_t|_|pt|j |_ dS)aInitialize the component manager. Parameters ---------- registry : BidiComponentRegistry, optional Component registry instance. If not provided, a new one will be created. manifest_handler : ComponentManifestHandler, optional Manifest handler instance. If not provided, a new one will be created. file_watcher : ComponentFileWatcher, optional File watcher instance. If not provided, a new one will be created. N) r _registryr _manifest_handler _api_inputs threadingLock_api_inputs_lockr_on_components_changed _file_watcher)selfrrr rrr__init__ls    zBidiComponentManager.__init__ component_keystrrrrcCs>|jt||d|j|<WddS1swYdS)aRecord original API inputs for later re-resolution on file changes. Parameters ---------- component_key : str Fully-qualified component name. css : str | None Inline CSS or a path/glob to a CSS file within the component's ``asset_dir``. js : str | None Inline JavaScript or a path/glob to a JS file within the component's ``asset_dir``. )rrN)r)rr&)r,r.rrrrrrecord_api_inputss"z&BidiComponentManager.record_api_inputsmanifestr package_rootr cCs.|j||}|j|tdt|dS)aRegister components from a manifest file. This is a high-level method that processes the manifest and registers all components found within it. Parameters ---------- manifest : ComponentManifest The component manifest to process. package_root : Path Root path of the package containing the components. z&Registered %d components from manifestN)r%process_manifestr$$register_components_from_definitionsrdebuglen)r,r1r2component_definitionsrrrregister_from_manifests z+BidiComponentManager.register_from_manifest definitionr cC|j|dS)zRegister a single component definition. Parameters ---------- definition : BidiComponentDefinition The component definition to register. N)r$register)r,r9rrrr;zBidiComponentManager.registernameBidiComponentDefinition | NonecC |j|S)a%Get a component definition by name. Parameters ---------- name : str The name of the component to retrieve. Returns ------- BidiComponentDefinition or None The component definition if found; otherwise ``None``. )r$getr,r=rrrr@ zBidiComponentManager.gethtmlcCst|||||dS)agBuild a validated component definition for the given inputs. Parameters ---------- component_key : str Fully-qualified component name the definition is for. html : str | None Inline HTML content to include in the definition. css : str | None Inline CSS content or a path/glob under the component's asset_dir. js : str | None Inline JS content or a path/glob under the component's asset_dir. Returns ------- BidiComponentDefinition The fully validated component definition. )managerr.rCrrr)r,r.rCrrrrrrsz5BidiComponentManager.build_definition_with_validation Path | NonecCr?)aLGet the asset root for a manifest-backed component. Parameters ---------- name : str The name of the component to get the asset root for. Returns ------- Path or None The component's ``asset_root`` directory if found; otherwise ``None``. )r%get_asset_rootrArrrget_component_asset_roots z-BidiComponentManager.get_component_asset_rootcCr:)zUnregister a component by name. Parameters ---------- name : str The name of the component to unregister. N)r$ unregisterrArrrrHr<zBidiComponentManager.unregistercCs|jdS)z Clear all registered components.N)r$clearr,rrrrI szBidiComponentManager.clearcCs |j|}|durt|SdS)a5Get the filesystem path for a manifest-backed component. Parameters ---------- name : str The name of the component. Returns ------- str or None The component's ``asset_dir`` directory if found; otherwise ``None``. N)r%rFr/)r,r= asset_rootrrrget_component_paths z'BidiComponentManager.get_component_pathcCsP|jjr tddS|j}|j||jjr!tddStddS)z*Start file watching for component changes.z File watching is already startedNz+Started file watching for component changeszFile watching not started)r+is_watching_activerwarningr%get_asset_watch_rootsstart_file_watchingr5)r, asset_rootsrrrrP"s   z(BidiComponentManager.start_file_watchingT)rPrPboolc Csz+ddlm}|}|D]\}}|||td|j|jq |r)|WdSWdStyD}z t d|WYd}~dSd}~ww)anDiscover installed v2 components and register them. This scans installed distributions for manifests, registers all discovered components, and starts file watching for development workflows. Parameters ---------- start_file_watching : bool Whether to start file watching after components are registered. r)scan_component_manifestsz1Registered components from pyproject.toml: %s v%sz&Failed to scan component manifests: %sN) (streamlit.components.v2.manifest_scannerrSr8rr5r=versionrP ExceptionrN)r,rPrS manifestsr1r2errr discover_and_register_components3s"   z5BidiComponentManager.discover_and_register_componentscCs.|jjs tddS|jtddS)zStop file watching.zFile watching is not startedNzStopped file watching)r+rMrrNstop_file_watchingr5rJrrrrZUs   z'BidiComponentManager.stop_file_watchingcomponent_nameComponentManifest | NonecCr?)a)Get metadata for a component. Parameters ---------- component_name : str The name of the component to get metadata for. Returns ------- ComponentManifest or None The component metadata if found; otherwise ``None``. )r% get_metadata)r,r[rrrr]_rBz!BidiComponentManager.get_metadatacomponent_names list[str]c CsN|D]"}z||}|dur|j|Wqty$td|YqwdS)a]Handle change events for components' asset roots. For each component, re-resolve from stored API inputs and update the registry with the new definition if resolution succeeds. Parameters ---------- component_names : list[str] Fully-qualified component names whose watched files changed. Nz+Failed to update component after change: %s)_recompute_definition_from_apir$update_componentrVr exception)r,r^r= updated_defrrrr*ns    z+BidiComponentManager._on_components_changedc Cs|jW|j|}|dur WddS|j|}|r"|jnd}z |j|||j|jd}Wn tyQ}zt d||WYd}~WddSd}~wwWd|S1s]wY|S)aRecompute a component's definition using previously recorded API inputs. Parameters ---------- component_name : str Fully-qualified component name to recompute. Returns ------- BidiComponentDefinition | None A fully validated component definition suitable for replacing the stored entry in the registry, or ``None`` if recomputation failed or no API inputs were previously recorded. N)r.rCrrz5Skipping update for %s due to re-resolution error: %s) r)r&r@r$rCrrrrVrr5)r,r[inputs existing_def html_valuenew_defrXrrrr`s:     z3BidiComponentManager._recompute_definition_from_apicCs|jjS)zCheck if file watching is currently active. Returns ------- bool True if file watching is started, False otherwise )r+rMrJrrris_file_watching_starteds z-BidiComponentManager.is_file_watching_started)NNN)rrrrr r!r"r#)r.r/rrrrr"r#)r1rr2r r"r#)r9r r"r#)r=r/r"r>) r.r/rCrrrrrr"r )r=r/r"rE)r=r/r"r#)r"r#)r=r/r"r)rPrRr"r#)r[r/r"r\)r^r_r"r#)r[r/r"r>)r"rR)rrrrr-r0r8r;r@rrGrHrIrLrPrYrZr]r*r`propertyrhrrrrrAs0,     "    "  -r)r __future__rr' dataclassesrtypingrr5streamlit.components.v2.component_definition_resolverr.streamlit.components.v2.component_file_watcherr2streamlit.components.v2.component_manifest_handlerr *streamlit.components.v2.component_registryr r streamlit.loggerr pathlibr rTrrrrrrrrrrs"