o ,&]i~@sjdZddlmZddlmZddlmZddlmZddl m Z ddl m Z er.ddl mZdddZdS)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)BidiComponentManagermanagerr component_keystrhtml str | Nonecssjsreturnrc sN|dfdd }||d d \}}||d d \}} t||||| d 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//``. valuer kindr rtuple[str | None, str | None]cs|durdSt|r|dfSdurtdd|d|}t|rFt|}tj||dt| }t||fSt |t |}tj||d|}t| }t||fS)N)NNz Component 'zG' must be declared in pyproject.toml with asset_dir to use file-backed .r) rlooks_like_inline_contentrhas_glob_charactersresolve_glob_patternensure_within_rootr resolve relative_toas_posixvalidate_path_securityr)rr value_strresolvedrel_url candidateresolved_candidate asset_rootr s/var/www/html/IGF-ODF-V3/venv/lib/python3.10/site-packages/streamlit/components/v2/component_definition_resolver.py_resolve_entry`s0       z8build_definition_with_validation.._resolve_entryrrr)namer rrcss_asset_relative_pathjs_asset_relative_pathN)rr rr rr)get_component_asset_rootr) r r r rrr' css_valuecss_reljs_valuejs_relr%r#r& build_definition_with_validation$s :$r0N) r rr r r r rr rr rr)__doc__ __future__rpathlibrtypingr,streamlit.components.v2.component_path_utilsr*streamlit.components.v2.component_registryrstreamlit.errorsr)streamlit.components.v2.component_managerrr0r%r%r%r&s