mxi~dZddlmZddlmZddlmZddlmZddl m Z ddl m Z erddl mZ d d Zy ) aGShared resolver for building component definitions with path validation. This module centralizes the logic for interpreting js/css inputs as inline content vs path/glob strings, validating them against a component's asset directory, and producing a BidiComponentDefinition with correct asset-relative URLs used by the server. ) annotations)Path) TYPE_CHECKING)ComponentPathUtils)BidiComponentDefinition)StreamlitAPIException)BidiComponentManagerc |j d fd }||d\}}||d\}} t||||| S)aWConstruct a definition and validate ``js``/``css`` inputs against ``asset_dir``. Parameters ---------- manager : BidiComponentManager Component manager used to resolve the component's ``asset_dir`` and related metadata. component_key : str Fully-qualified name of the component to build a definition for. html : str | None Inline HTML content to include in the definition. If ``None``, the component will not include HTML content. css : str | None Either inline CSS content or a path/glob to a CSS file inside the component's ``asset_dir``. Inline strings are kept as-is; file-backed inputs are validated and converted to an ``asset_dir``-relative URL. js : str | None Either inline JavaScript content or a path/glob to a JS file inside the component's ``asset_dir``. Inline strings are kept as-is; file-backed inputs are validated and converted to an ``asset_dir``-relative URL. Returns ------- BidiComponentDefinition A component definition with inline content preserved and file-backed entries resolved to absolute filesystem paths plus their ``asset_dir``-relative URLs. Raises ------ StreamlitAPIException If a path/glob is provided but the component has no declared ``asset_dir``, if a glob resolves to zero or multiple files, or if any resolved path escapes the declared ``asset_dir``. Notes ----- - Inline strings are treated as content (no manifest required). - Path-like strings require the component to be declared in the package manifest with an ``asset_dir``. - Globs are supported only within ``asset_dir`` and must resolve to exactly one file. - Relative paths are resolved strictly against the component's ``asset_dir`` and must remain within it after resolution. Absolute paths are not allowed. - For file-backed entries, the URL sent to the frontend is the ``asset_dir``-relative path, served under ``/_stcore/bidi-components//``. c|ytj|r|dfStdd|d|}tj|rtj|}tj ||t |jjjj}t ||fStj|t|z }tj |||j}t |jjj}t ||fS)N)NNz Component 'zG' must be declared in pyproject.toml with asset_dir to use file-backed .kind) rlooks_like_inline_contentrhas_glob_charactersresolve_glob_patternensure_within_rootstrresolve relative_toas_posixvalidate_path_securityr) valuer value_strresolvedrel_url candidateresolved_candidate asset_root component_keys l/home/htdocs/ttos/venv/lib/python3.12/site-packages/streamlit/components/v2/component_definition_resolver.py_resolve_entryz8build_definition_with_validation.._resolve_entry`sI =  7 7 >$;   'm_-&&*V1.     1 1) <)>>y*UH  1 1(JT R  "..z/A/A/CDMMOGx=') ) 11)<i0 --i$O&..0(44Z5G5G5IJSSUV%&//cssr js)namehtmlr#r$css_asset_relative_pathjs_asset_relative_path)r str | Nonerrreturnztuple[str | None, str | None])get_component_asset_rootr) managerrr&r#r$r! css_valuecss_reljs_valuejs_relrs ` @r build_definition_with_validationr1$syt11-@J"0"0$'"0 &"0H(%8Iw%bt4Hf #     '%  r"N) r,r rrr&r)r#r)r$r)r*r)__doc__ __future__rpathlibrtypingr,streamlit.components.v2.component_path_utilsr*streamlit.components.v2.component_registryrstreamlit.errorsr)streamlit.components.v2.component_managerr r1r"r r;sj# KN2Nk !kk  k  k  kkr"