feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 25
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-a4f78808dc23a76896b451576b3b44b0d663977f2032eaed0271dd386b20c43c.yml
-openapi_spec_hash: 01f9e1ae0d635f8b874f48e3ba461476
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-021b48afe1d6e3f54c4ebe3d0da4beb3fb8b69a6d384a4aeadbc5bab7f967603.yml
+openapi_spec_hash: 2aa5b59d78c708b094acf29cc0d9a68a
 config_hash: c7b0cdaba3b9797b77efd89e1754d803

src/context/dev/resources/web.py

@@ -288,6 +288,7 @@ def extract_fonts(
     def extract_styleguide(
         self,
         *,
+        color_scheme: Literal["light", "dark"] | Omit = omit,
         direct_url: str | Omit = omit,
         domain: str | Omit = omit,
         max_age_ms: int | Omit = omit,
@@ -304,6 +305,9 @@ def extract_styleguide(
         typography, spacing, shadows, and UI components.
 
         Args:
+          color_scheme: Optional browser color scheme to emulate for websites that respond to
+              prefers-color-scheme. This value is part of the styleguide cache key.
+
           direct_url: A specific URL to fetch the styleguide from directly, bypassing domain
               resolution (e.g., 'https://example.com/design-system'). When provided, the
               styleguide is extracted from this exact URL. You must provide either 'domain' or
@@ -339,6 +343,7 @@ def extract_styleguide(
                 timeout=timeout,
                 query=maybe_transform(
                     {
+                        "color_scheme": color_scheme,
                         "direct_url": direct_url,
                         "domain": domain,
                         "max_age_ms": max_age_ms,
@@ -2316,6 +2321,7 @@ async def extract_fonts(
     async def extract_styleguide(
         self,
         *,
+        color_scheme: Literal["light", "dark"] | Omit = omit,
         direct_url: str | Omit = omit,
         domain: str | Omit = omit,
         max_age_ms: int | Omit = omit,
@@ -2332,6 +2338,9 @@ async def extract_styleguide(
         typography, spacing, shadows, and UI components.
 
         Args:
+          color_scheme: Optional browser color scheme to emulate for websites that respond to
+              prefers-color-scheme. This value is part of the styleguide cache key.
+
           direct_url: A specific URL to fetch the styleguide from directly, bypassing domain
               resolution (e.g., 'https://example.com/design-system'). When provided, the
               styleguide is extracted from this exact URL. You must provide either 'domain' or
@@ -2367,6 +2376,7 @@ async def extract_styleguide(
                 timeout=timeout,
                 query=await async_maybe_transform(
                     {
+                        "color_scheme": color_scheme,
                         "direct_url": direct_url,
                         "domain": domain,
                         "max_age_ms": max_age_ms,

src/context/dev/types/web_extract_styleguide_params.py

@@ -2,14 +2,20 @@
 
 from __future__ import annotations
 
-from typing_extensions import Annotated, TypedDict
+from typing_extensions import Literal, Annotated, TypedDict
 
 from .._utils import PropertyInfo
 
 __all__ = ["WebExtractStyleguideParams"]
 
 
 class WebExtractStyleguideParams(TypedDict, total=False):
+    color_scheme: Annotated[Literal["light", "dark"], PropertyInfo(alias="colorScheme")]
+    """
+    Optional browser color scheme to emulate for websites that respond to
+    prefers-color-scheme. This value is part of the styleguide cache key.
+    """
+
     direct_url: Annotated[str, PropertyInfo(alias="directUrl")]
     """
     A specific URL to fetch the styleguide from directly, bypassing domain

tests/api_resources/test_web.py

@@ -203,6 +203,7 @@ def test_method_extract_styleguide(self, client: ContextDev) -> None:
     @parametrize
     def test_method_extract_styleguide_with_all_params(self, client: ContextDev) -> None:
         web = client.web.extract_styleguide(
+            color_scheme="light",
             direct_url="https://example.com",
             domain="domain",
             max_age_ms=86400000,
@@ -803,6 +804,7 @@ async def test_method_extract_styleguide(self, async_client: AsyncContextDev) ->
     @parametrize
     async def test_method_extract_styleguide_with_all_params(self, async_client: AsyncContextDev) -> None:
         web = await async_client.web.extract_styleguide(
+            color_scheme="light",
             direct_url="https://example.com",
             domain="domain",
             max_age_ms=86400000,