Skip to content

Commit 9ebae32

Browse files
weaverryanweaverryan
committed
[Live][Stimulus] Removing experimental & auditing internal classes
1 parent b07f864 commit 9ebae32

File tree

61 files changed

+26
-118
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

61 files changed

+26
-118
lines changed

‎src/LiveComponent/README.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,12 @@
11
# Live Components
22

3-
**EXPERIMENTAL** This component is currently experimental and is
4-
likely to change, or even change drastically.
5-
63
Live components work with the [TwigComponent](https://symfony.com/bundles/ux-twig-component/current/index.html)
74
library to give you the power to automatically update your
85
Twig components on the frontend as the user interacts with them.
96
Inspired by [Livewire](https://laravel-livewire.com/) and
107
[Phoenix LiveView](https://hexdocs.pm/phoenix_live_view/Phoenix.LiveView.html).
118

12-
Want a demo? Check out https://github.com/weaverryan/live-demo.
9+
Want a demo? Check out https://ux.symfony.com/live-component.
1310

1411
**This repository is a READ-ONLY sub-tree split**. See
1512
https://github.com/symfony/ux to create issues or submit pull requests.

‎src/LiveComponent/doc/index.rst

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,6 @@
11
Live Components
22
===============
33

4-
.. caution::
5-
6-
This component is currently experimental and is likely to change, or even
7-
change drastically.
8-
94
Live components builds on top of the `TwigComponent`_ library
105
to give you the power to automatically update your Twig components on
116
the frontend as the user interacts with them. Inspired by
@@ -3459,8 +3454,10 @@ This bundle aims at following the same Backward Compatibility promise as
34593454
the Symfony framework:
34603455
https://symfony.com/doc/current/contributing/code/bc.html
34613456

3462-
However it is currently considered `experimental`_, meaning it is not
3463-
bound to Symfony's BC policy for the moment.
3457+
For JavaScript files, the public API (i.e. documented features and exports
3458+
from the main JavaScript file) is protected by the backward compatibility
3459+
promise. However, any internal implementation in the JavaScript files
3460+
(i.e. exports from internal files) is not protected.
34643461

34653462
.. _`TwigComponent`: https://symfony.com/bundles/ux-twig-component/current/index.html
34663463
.. _TwigComponent documentation: https://symfony.com/bundles/ux-twig-component/current/index.html
@@ -3469,7 +3466,6 @@ bound to Symfony's BC policy for the moment.
34693466
.. _`Twig Component`: https://symfony.com/bundles/ux-twig-component/current/index.html
34703467
.. _`Twig Component mount documentation`: https://symfony.com/bundles/ux-twig-component/current/index.html#the-mount-method
34713468
.. _`Symfony form`: https://symfony.com/doc/current/forms.html
3472-
.. _`experimental`: https://symfony.com/doc/current/contributing/code/experimental.html
34733469
.. _`dependent form fields`: https://ux.symfony.com/live-component/demos/dependent-form-fields
34743470
.. _StimulusBundle configured in your app: https://symfony.com/bundles/StimulusBundle/current/index.html
34753471
.. _`localizes its URLs`: https://symfony.com/doc/current/translation/locale.html#translation-locale-url

‎src/LiveComponent/src/Attribute/AsLiveComponent.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,6 @@
2020
* @see https://symfony.com/bundles/ux-live-component
2121
*
2222
* @author Kevin Bond <kevinbond@gmail.com>
23-
*
24-
* @experimental
2523
*/
2624
#[\Attribute(\Attribute::TARGET_CLASS)]
2725
final class AsLiveComponent extends AsTwigComponent

‎src/LiveComponent/src/Attribute/LiveAction.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,6 @@
1515
* An attribute to register a LiveAction method.
1616
*
1717
* @see https://symfony.com/bundles/ux-live-component/current/index.html#actions
18-
*
19-
* @experimental
2018
*/
2119
#[\Attribute(\Attribute::TARGET_METHOD)]
2220
class LiveAction

‎src/LiveComponent/src/Attribute/LiveArg.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,6 @@
1717
* @see https://symfony.com/bundles/ux-live-component/current/index.html#actions-arguments
1818
*
1919
* @author Tomas Norkūnas <norkunas.tom@gmail.com>
20-
*
21-
* @experimental
2220
*/
2321
#[\Attribute(\Attribute::TARGET_PARAMETER)]
2422
final class LiveArg

‎src/LiveComponent/src/Attribute/LiveListener.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,6 @@
1818
* method and re-render the component.
1919
*
2020
* @see https://symfony.com/bundles/ux-live-component/current/index.html#listeners
21-
*
22-
* @experimental
2321
*/
2422
#[\Attribute(\Attribute::TARGET_METHOD | \Attribute::IS_REPEATABLE)]
2523
class LiveListener extends LiveAction

‎src/LiveComponent/src/Attribute/LiveProp.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,6 @@
1515
* An attribute to mark a property as a "LiveProp".
1616
*
1717
* @see https://symfony.com/bundles/ux-live-component/current/index.html#liveprops-stateful-component-properties
18-
*
19-
* @experimental
2018
*/
2119
#[\Attribute(\Attribute::TARGET_PROPERTY)]
2220
final class LiveProp

‎src/LiveComponent/src/Attribute/PostHydrate.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,6 @@
1313

1414
/**
1515
* An attribute to register a PostHydrate hook.
16-
*
17-
* @experimental
1816
*/
1917
#[\Attribute(\Attribute::TARGET_METHOD)]
2018
final class PostHydrate

‎src/LiveComponent/src/Attribute/PreDehydrate.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,6 @@
1313

1414
/**
1515
* An attribute to register a PreDehydrate hook.
16-
*
17-
* @experimental
1816
*/
1917
#[\Attribute(\Attribute::TARGET_METHOD)]
2018
final class PreDehydrate

‎src/LiveComponent/src/Attribute/PreReRender.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,6 @@
1616
*
1717
* This hook ONLY happens when rendering via HTTP: it does
1818
* not happen during the initial render of a component.
19-
*
20-
* @experimental
2119
*/
2220
#[\Attribute(\Attribute::TARGET_METHOD)]
2321
final class PreReRender

‎src/LiveComponent/src/ComponentToolsTrait.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,6 @@
1717
* Trait with shortcut methods useful for live components.
1818
*
1919
* @author Ryan Weaver <ryan@symfonycasts.com>
20-
*
21-
* @experimental
2220
*/
2321
trait ComponentToolsTrait
2422
{

‎src/LiveComponent/src/ComponentValidator.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,6 @@
1919
/**
2020
* @author Ryan Weaver <ryan@symfonycasts.com>
2121
*
22-
* @experimental
23-
*
2422
* @internal
2523
*/
2624
class ComponentValidator implements ComponentValidatorInterface, ServiceSubscriberInterface

‎src/LiveComponent/src/ComponentValidatorInterface.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,6 @@
1515

1616
/**
1717
* @author Ryan Weaver <ryan@symfonycasts.com>
18-
*
19-
* @experimental
2018
*/
2119
interface ComponentValidatorInterface
2220
{

‎src/LiveComponent/src/ComponentWithFormTrait.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,6 @@
2323

2424
/**
2525
* @author Ryan Weaver <ryan@symfonycasts.com>
26-
*
27-
* @experimental
2826
*/
2927
trait ComponentWithFormTrait
3028
{

‎src/LiveComponent/src/DefaultActionTrait.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,6 @@
1313

1414
/**
1515
* @author Kevin Bond <kevinbond@gmail.com>
16-
*
17-
* @experimental
1816
*/
1917
trait DefaultActionTrait
2018
{

‎src/LiveComponent/src/DependencyInjection/Compiler/ComponentDefaultActionPass.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,6 @@
1717
/**
1818
* @author Kevin Bond <kevinbond@gmail.com>
1919
*
20-
* @experimental
21-
*
2220
* @internal
2321
*/
2422
final class ComponentDefaultActionPass implements CompilerPassInterface

‎src/LiveComponent/src/DependencyInjection/Compiler/OptionalDependencyPass.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,6 @@
2121
/**
2222
* @author Kevin Bond <kevinbond@gmail.com>
2323
*
24-
* @experimental
25-
*
2624
* @internal
2725
*/
2826
final class OptionalDependencyPass implements CompilerPassInterface

‎src/LiveComponent/src/DependencyInjection/LiveComponentExtension.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -55,8 +55,6 @@
5555
/**
5656
* @author Kevin Bond <kevinbond@gmail.com>
5757
*
58-
* @experimental
59-
*
6058
* @internal
6159
*/
6260
final class LiveComponentExtension extends Extension implements PrependExtensionInterface

‎src/LiveComponent/src/EventListener/AddLiveAttributesSubscriber.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,6 @@
2929
*
3030
* @author Kevin Bond <kevinbond@gmail.com>
3131
*
32-
* @experimental
33-
*
3432
* @internal
3533
*/
3634
final class AddLiveAttributesSubscriber implements EventSubscriberInterface, ServiceSubscriberInterface

‎src/LiveComponent/src/EventListener/DeferLiveComponentSubscriber.php

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,11 @@
1717
use Symfony\UX\TwigComponent\Event\PostMountEvent;
1818
use Symfony\UX\TwigComponent\Event\PreRenderEvent;
1919

20+
/**
21+
* Handles the "defer" key, which causes the component to be rendered asynchronously.
22+
*
23+
* @internal
24+
*/
2025
final class DeferLiveComponentSubscriber implements EventSubscriberInterface
2126
{
2227
private const DEFAULT_LOADING_TAG = 'div';

‎src/LiveComponent/src/EventListener/InterceptChildComponentRenderSubscriber.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,8 +25,6 @@
2525
*
2626
* @author Ryan Weaver <ryan@symfonycasts.com>
2727
*
28-
* @experimental
29-
*
3028
* @internal
3129
*/
3230
class InterceptChildComponentRenderSubscriber implements EventSubscriberInterface, ServiceSubscriberInterface

‎src/LiveComponent/src/EventListener/LiveComponentSubscriber.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,6 @@
4242
* @author Kevin Bond <kevinbond@gmail.com>
4343
* @author Ryan Weaver <ryan@symfonycasts.com>
4444
*
45-
* @experimental
46-
*
4745
* @internal
4846
*/
4947
class LiveComponentSubscriber implements EventSubscriberInterface, ServiceSubscriberInterface

‎src/LiveComponent/src/EventListener/QueryStringInitializeSubscriber.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,6 @@
2020
/**
2121
* @author Nicolas Rigaud <squrious@protonmail.com>
2222
*
23-
* @experimental
24-
*
2523
* @internal
2624
*/
2725
class QueryStringInitializeSubscriber implements EventSubscriberInterface

‎src/LiveComponent/src/EventListener/ResetDeterministicIdSubscriber.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,8 +36,6 @@
3636
*
3737
* @author Ryan Weaver <ryan@symfonycasts.com>
3838
*
39-
* @experimental
40-
*
4139
* @internal
4240
*/
4341
final class ResetDeterministicIdSubscriber implements EventSubscriberInterface

‎src/LiveComponent/src/Exception/HydrationException.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,6 @@
2020
*
2121
* @author Ryan Weaver <ryan@symfonycasts.com>
2222
*
23-
* @experimental
24-
*
2523
* @internal
2624
*/
2725
class HydrationException extends BadRequestHttpException

‎src/LiveComponent/src/Form/Type/LiveCollectionType.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,6 @@
2121

2222
/**
2323
* @author Gábor Egyed <gabor.egyed@gmail.com>
24-
*
25-
* @experimental
2624
*/
2725
final class LiveCollectionType extends AbstractType
2826
{

‎src/LiveComponent/src/Hydration/DoctrineEntityHydrationExtension.php

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,11 @@
1515
use Doctrine\Persistence\ManagerRegistry;
1616
use Doctrine\Persistence\ObjectManager;
1717

18+
/**
19+
* Handles hydration of Doctrine entities.
20+
*
21+
* @internal
22+
*/
1823
class DoctrineEntityHydrationExtension implements HydrationExtensionInterface
1924
{
2025
/**

‎src/LiveComponent/src/Hydration/HydrationExtensionInterface.php

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,9 @@
1111

1212
namespace Symfony\UX\LiveComponent\Hydration;
1313

14+
/**
15+
* Interface for custom hydration of objects.
16+
*/
1417
interface HydrationExtensionInterface
1518
{
1619
/**

‎src/LiveComponent/src/LiveCollectionTrait.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,6 @@
1717

1818
/**
1919
* @author Gábor Egyed <gabor.egyed@gmail.com>
20-
*
21-
* @experimental
2220
*/
2321
trait LiveCollectionTrait
2422
{

‎src/LiveComponent/src/LiveComponentBundle.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,6 @@
1919

2020
/**
2121
* @author Kevin Bond <kevinbond@gmail.com>
22-
*
23-
* @experimental
2422
*/
2523
final class LiveComponentBundle extends Bundle
2624
{

‎src/LiveComponent/src/LiveComponentHydrator.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,6 @@
3535
/**
3636
* @author Kevin Bond <kevinbond@gmail.com>
3737
*
38-
* @experimental
39-
*
4038
* @internal
4139
*/
4240
final class LiveComponentHydrator

‎src/LiveComponent/src/LiveResponder.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,6 @@
1212
namespace Symfony\UX\LiveComponent;
1313

1414
/**
15-
* @experimental
16-
*
1715
* @author Ryan Weaver <ryan@symfonycasts.com>
1816
*/
1917
final class LiveResponder

‎src/LiveComponent/src/Metadata/LiveComponentMetadata.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,6 @@
1616
/**
1717
* @author Ryan Weaver <ryan@symfonycasts.com>
1818
*
19-
* @experimental
20-
*
2119
* @internal
2220
*/
2321
class LiveComponentMetadata

‎src/LiveComponent/src/Metadata/LiveComponentMetadataFactory.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,6 @@
2020
/**
2121
* @author Ryan Weaver <ryan@symfonycasts.com>
2222
*
23-
* @experimental
24-
*
2523
* @internal
2624
*/
2725
class LiveComponentMetadataFactory implements ResetInterface

‎src/LiveComponent/src/Metadata/LivePropMetadata.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,6 @@
1717
/**
1818
* @author Kevin Bond <kevinbond@gmail.com>
1919
*
20-
* @experimental
21-
*
2220
* @internal
2321
*/
2422
final class LivePropMetadata

‎src/LiveComponent/src/Twig/DeterministicTwigIdCalculator.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,6 @@
1717
/**
1818
* @author Ryan Weaver <ryan@symfonycasts.com>
1919
*
20-
* @experimental
21-
*
2220
* @internal
2321
*/
2422
class DeterministicTwigIdCalculator

‎src/LiveComponent/src/Twig/LiveComponentExtension.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,6 @@
1717
/**
1818
* @author Kevin Bond <kevinbond@gmail.com>
1919
*
20-
* @experimental
21-
*
2220
* @internal
2321
*/
2422
final class LiveComponentExtension extends AbstractExtension

‎src/LiveComponent/src/Twig/LiveComponentRuntime.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,6 @@
1919
/**
2020
* @author Kevin Bond <kevinbond@gmail.com>
2121
*
22-
* @experimental
23-
*
2422
* @internal
2523
*/
2624
final class LiveComponentRuntime

‎src/LiveComponent/src/Util/ChildComponentPartialRenderer.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,8 +20,6 @@
2020
/**
2121
* @author Ryan Weaver <ryan@symfonycasts.com>
2222
*
23-
* @experimental
24-
*
2523
* @internal
2624
*/
2725
class ChildComponentPartialRenderer implements ServiceSubscriberInterface

‎src/LiveComponent/src/Util/DehydratedProps.php

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,6 @@
1616
*
1717
* @author Ryan Weaver <ryan@symfonycasts.com>
1818
*
19-
* @experimental
20-
*
2119
* @internal
2220
*/
2321
class DehydratedProps

0 commit comments

Comments
 (0)