/** * REST API: WP_REST_Post_Types_Controller class * * @package WordPress * @subpackage REST_API * @since 4.7.0 */ /** * Core class to access post types via the REST API. * * @since 4.7.0 * * @see WP_REST_Controller */ class WP_REST_Post_Types_Controller extends WP_REST_Controller { /** * Constructor. * * @since 4.7.0 */ public function __construct() { $this->namespace = 'wp/v2'; $this->rest_base = 'types'; } /** * Registers the routes for post types. * * @since 4.7.0 * * @see register_rest_route() */ public function register_routes() { register_rest_route( $this->namespace, '/' . $this->rest_base, array( array( 'methods' => WP_REST_Server::READABLE, 'callback' => array( $this, 'get_items' ), 'permission_callback' => array( $this, 'get_items_permissions_check' ), 'args' => $this->get_collection_params(), ), 'schema' => array( $this, 'get_public_item_schema' ), ) ); register_rest_route( $this->namespace, '/' . $this->rest_base . '/(?P[\w-]+)', array( 'args' => array( 'type' => array( 'description' => __( 'An alphanumeric identifier for the post type.' ), 'type' => 'string', ), ), array( 'methods' => WP_REST_Server::READABLE, 'callback' => array( $this, 'get_item' ), 'permission_callback' => '__return_true', 'args' => array( 'context' => $this->get_context_param( array( 'default' => 'view' ) ), ), ), 'schema' => array( $this, 'get_public_item_schema' ), ) ); } /** * Checks whether a given request has permission to read types. * * @since 4.7.0 * * @param WP_REST_Request $request Full details about the request. * @return true|WP_Error True if the request has read access, WP_Error object otherwise. */ public function get_items_permissions_check( $request ) { if ( 'edit' === $request['context'] ) { $types = get_post_types( array( 'show_in_rest' => true ), 'objects' ); foreach ( $types as $type ) { if ( current_user_can( $type->cap->edit_posts ) ) { return true; } } return new WP_Error( 'rest_cannot_view', __( 'Sorry, you are not allowed to edit posts in this post type.' ), array( 'status' => rest_authorization_required_code() ) ); } return true; } /** * Retrieves all public post types. * * @since 4.7.0 * * @param WP_REST_Request $request Full details about the request. * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure. */ public function get_items( $request ) { if ( $request->is_method( 'HEAD' ) ) { // Return early as this handler doesn't add any response headers. return new WP_REST_Response( array() ); } $data = array(); $types = get_post_types( array( 'show_in_rest' => true ), 'objects' ); foreach ( $types as $type ) { if ( 'edit' === $request['context'] && ! current_user_can( $type->cap->edit_posts ) ) { continue; } $post_type = $this->prepare_item_for_response( $type, $request ); $data[ $type->name ] = $this->prepare_response_for_collection( $post_type ); } return rest_ensure_response( $data ); } /** * Retrieves a specific post type. * * @since 4.7.0 * * @param WP_REST_Request $request Full details about the request. * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure. */ public function get_item( $request ) { $obj = get_post_type_object( $request['type'] ); if ( empty( $obj ) ) { return new WP_Error( 'rest_type_invalid', __( 'Invalid post type.' ), array( 'status' => 404 ) ); } if ( empty( $obj->show_in_rest ) ) { return new WP_Error( 'rest_cannot_read_type', __( 'Cannot view post type.' ), array( 'status' => rest_authorization_required_code() ) ); } if ( 'edit' === $request['context'] && ! current_user_can( $obj->cap->edit_posts ) ) { return new WP_Error( 'rest_forbidden_context', __( 'Sorry, you are not allowed to edit posts in this post type.' ), array( 'status' => rest_authorization_required_code() ) ); } $data = $this->prepare_item_for_response( $obj, $request ); return rest_ensure_response( $data ); } /** * Prepares a post type object for serialization. * * @since 4.7.0 * @since 5.9.0 Renamed `$post_type` to `$item` to match parent class for PHP 8 named parameter support. * * @param WP_Post_Type $item Post type object. * @param WP_REST_Request $request Full details about the request. * @return WP_REST_Response Response object. */ public function prepare_item_for_response( $item, $request ) { // Restores the more descriptive, specific name for use within this method. $post_type = $item; // Don't prepare the response body for HEAD requests. if ( $request->is_method( 'HEAD' ) ) { /** This filter is documented in wp-includes/rest-api/endpoints/class-wp-rest-post-types-controller.php */ return apply_filters( 'rest_prepare_post_type', new WP_REST_Response( array() ), $post_type, $request ); } $taxonomies = wp_list_filter( get_object_taxonomies( $post_type->name, 'objects' ), array( 'show_in_rest' => true ) ); $taxonomies = wp_list_pluck( $taxonomies, 'name' ); $base = ! empty( $post_type->rest_base ) ? $post_type->rest_base : $post_type->name; $namespace = ! empty( $post_type->rest_namespace ) ? $post_type->rest_namespace : 'wp/v2'; $supports = get_all_post_type_supports( $post_type->name ); $fields = $this->get_fields_for_response( $request ); $data = array(); if ( rest_is_field_included( 'capabilities', $fields ) ) { $data['capabilities'] = $post_type->cap; } if ( rest_is_field_included( 'description', $fields ) ) { $data['description'] = $post_type->description; } if ( rest_is_field_included( 'hierarchical', $fields ) ) { $data['hierarchical'] = $post_type->hierarchical; } if ( rest_is_field_included( 'has_archive', $fields ) ) { $data['has_archive'] = $post_type->has_archive; } if ( rest_is_field_included( 'visibility', $fields ) ) { $data['visibility'] = array( 'show_in_nav_menus' => (bool) $post_type->show_in_nav_menus, 'show_ui' => (bool) $post_type->show_ui, ); } if ( rest_is_field_included( 'viewable', $fields ) ) { $data['viewable'] = is_post_type_viewable( $post_type ); } if ( rest_is_field_included( 'labels', $fields ) ) { $data['labels'] = $post_type->labels; } if ( rest_is_field_included( 'name', $fields ) ) { $data['name'] = $post_type->label; } if ( rest_is_field_included( 'slug', $fields ) ) { $data['slug'] = $post_type->name; } if ( rest_is_field_included( 'icon', $fields ) ) { $data['icon'] = $post_type->menu_icon; } if ( rest_is_field_included( 'supports', $fields ) ) { $data['supports'] = $supports; } if ( rest_is_field_included( 'taxonomies', $fields ) ) { $data['taxonomies'] = array_values( $taxonomies ); } if ( rest_is_field_included( 'rest_base', $fields ) ) { $data['rest_base'] = $base; } if ( rest_is_field_included( 'rest_namespace', $fields ) ) { $data['rest_namespace'] = $namespace; } if ( rest_is_field_included( 'template', $fields ) ) { $data['template'] = $post_type->template ?? array(); } if ( rest_is_field_included( 'template_lock', $fields ) ) { $data['template_lock'] = ! empty( $post_type->template_lock ) ? $post_type->template_lock : false; } $context = ! empty( $request['context'] ) ? $request['context'] : 'view'; $data = $this->add_additional_fields_to_object( $data, $request ); $data = $this->filter_response_by_context( $data, $context ); // Wrap the data in a response object. $response = rest_ensure_response( $data ); if ( rest_is_field_included( '_links', $fields ) || rest_is_field_included( '_embedded', $fields ) ) { $response->add_links( $this->prepare_links( $post_type ) ); } /** * Filters a post type returned from the REST API. * * Allows modification of the post type data right before it is returned. * * @since 4.7.0 * * @param WP_REST_Response $response The response object. * @param WP_Post_Type $post_type The original post type object. * @param WP_REST_Request $request Request used to generate the response. */ return apply_filters( 'rest_prepare_post_type', $response, $post_type, $request ); } /** * Prepares links for the request. * * @since 6.1.0 * * @param WP_Post_Type $post_type The post type. * @return array Links for the given post type. */ protected function prepare_links( $post_type ) { return array( 'collection' => array( 'href' => rest_url( sprintf( '%s/%s', $this->namespace, $this->rest_base ) ), ), 'https://api.w.org/items' => array( 'href' => rest_url( rest_get_route_for_post_type_items( $post_type->name ) ), ), ); } /** * Retrieves the post type's schema, conforming to JSON Schema. * * @since 4.7.0 * @since 4.8.0 The `supports` property was added. * @since 5.9.0 The `visibility` and `rest_namespace` properties were added. * @since 6.1.0 The `icon` property was added. * * @return array Item schema data. */ public function get_item_schema() { if ( $this->schema ) { return $this->add_additional_fields_schema( $this->schema ); } $schema = array( '$schema' => 'http://json-schema.org/draft-04/schema#', 'title' => 'type', 'type' => 'object', 'properties' => array( 'capabilities' => array( 'description' => __( 'All capabilities used by the post type.' ), 'type' => 'object', 'context' => array( 'edit' ), 'readonly' => true, ), 'description' => array( 'description' => __( 'A human-readable description of the post type.' ), 'type' => 'string', 'context' => array( 'view', 'edit' ), 'readonly' => true, ), 'hierarchical' => array( 'description' => __( 'Whether or not the post type should have children.' ), 'type' => 'boolean', 'context' => array( 'view', 'edit' ), 'readonly' => true, ), 'viewable' => array( 'description' => __( 'Whether or not the post type can be viewed.' ), 'type' => 'boolean', 'context' => array( 'edit' ), 'readonly' => true, ), 'labels' => array( 'description' => __( 'Human-readable labels for the post type for various contexts.' ), 'type' => 'object', 'context' => array( 'edit' ), 'readonly' => true, ), 'name' => array( 'description' => __( 'The title for the post type.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'slug' => array( 'description' => __( 'An alphanumeric identifier for the post type.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'supports' => array( 'description' => __( 'All features, supported by the post type.' ), 'type' => 'object', 'context' => array( 'edit' ), 'readonly' => true, ), 'has_archive' => array( 'description' => __( 'If the value is a string, the value will be used as the archive slug. If the value is false the post type has no archive.' ), 'type' => array( 'string', 'boolean' ), 'context' => array( 'view', 'edit' ), 'readonly' => true, ), 'taxonomies' => array( 'description' => __( 'Taxonomies associated with post type.' ), 'type' => 'array', 'items' => array( 'type' => 'string', ), 'context' => array( 'view', 'edit' ), 'readonly' => true, ), 'rest_base' => array( 'description' => __( 'REST base route for the post type.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'rest_namespace' => array( 'description' => __( 'REST route\'s namespace for the post type.' ), 'type' => 'string', 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'visibility' => array( 'description' => __( 'The visibility settings for the post type.' ), 'type' => 'object', 'context' => array( 'edit' ), 'readonly' => true, 'properties' => array( 'show_ui' => array( 'description' => __( 'Whether to generate a default UI for managing this post type.' ), 'type' => 'boolean', ), 'show_in_nav_menus' => array( 'description' => __( 'Whether to make the post type available for selection in navigation menus.' ), 'type' => 'boolean', ), ), ), 'icon' => array( 'description' => __( 'The icon for the post type.' ), 'type' => array( 'string', 'null' ), 'context' => array( 'view', 'edit', 'embed' ), 'readonly' => true, ), 'template' => array( 'type' => array( 'array' ), 'description' => __( 'The block template associated with the post type.' ), 'readonly' => true, 'context' => array( 'view', 'edit', 'embed' ), ), 'template_lock' => array( 'type' => array( 'string', 'boolean' ), 'enum' => array( 'all', 'insert', 'contentOnly', false ), 'description' => __( 'The template_lock associated with the post type, or false if none.' ), 'readonly' => true, 'context' => array( 'view', 'edit', 'embed' ), ), ), ); $this->schema = $schema; return $this->add_additional_fields_schema( $this->schema ); } /** * Retrieves the query params for collections. * * @since 4.7.0 * * @return array Collection parameters. */ public function get_collection_params() { return array( 'context' => $this->get_context_param( array( 'default' => 'view' ) ), ); } } The Hidden Geometry of Light: Starburst Waves and Topological Invariants - Nagarjuna TMT

The Hidden Geometry of Light: Starburst Waves and Topological Invariants

Light is often introduced as waves or particles—but its deeper structure reveals a rich topological fabric. Beyond classical descriptions, light’s behavior emerges from geometric and algebraic invariants, especially through concepts like the nth Betti number and the Euler characteristic. These tools quantify not just shape, but hidden holes and symmetries shaping wavefronts, including the striking starburst patterns seen in optical interference.

Topological Structure and the nth Betti Number

Light’s topology transcends simple wave equations. The nth Betti number measures n-dimensional voids or “holes” in a structure—critical for understanding complex wavefronts. For a 2D wavefront, the first Betti number counts connected components or gaps, while higher numbers reveal intricate voids. The Euler characteristic χ ties geometry to algebra: χ = V – E + F for polyhedra, or more generally χ = 1 – β₁ + β₂ − β₃ + …, linking faces, edges, and volumes through topology.

Measures k-dimensional topological holes

Betti Number βᵏ
β₁ Loops, tunnels, interference crossings
β₂ Cavities, enclosed voids in wavefronts
β₃ Complex 3D wave distortions

These invariants reveal how symmetry shapes interference—like the starburst patterns emerging when wavefronts break symmetry in controlled ways. Just as light’s topology encodes hidden structure, so too does the Starburst product’s intricate design reflect deeper wave behavior—both rooted in topology’s silent language.

Starburst Patterns: Fractal Symmetry in Wavefronts

When coherent light interferes with precise phase differences, starburst patterns emerge—radial symmetry from constructive and destructive interference. Yet their origin runs deeper: these patterns encode the mathematical origin of starburst symmetry, arising from periodic phase modulation and topological constraints.

The symmetry breaking in such patterns mirrors quantum selection rules—where certain transitions vanish not by design, but by invisible topological forces. For instance, electric dipole transitions in atoms are “forbidden” by selection rules rooted in angular momentum conservation, yet subtle phase distortions can induce effective symmetry violations, altering interference outcomes.

Symmetry, Topology, and the Higgs Mechanism

In particle physics, the Higgs mechanism reveals a profound parallel: mass generation via electroweak symmetry breaking without global gauge symmetry loss. The Higgs field interacts with W and Z bosons, giving them mass while preserving underlying gauge invariance—a topological phase transition.

This mirrors how starburst symmetry emerges not from rigid structure, but from a hidden phase change. Like light’s invisible wave topology, these transitions are invisible until observed—topological invariants becoming physical reality. The Higgs vacuum expectation value acts as a cosmic “phase mask,” shaping symmetry patterns as elegantly as a phase grid shapes optical interference.

From Theory to Observation: Starburst as a Modern Illustration

Real-world starburst patterns appear in diffraction grating experiments, laser interference, and structured light fields. These visualizations transform abstract invariants into tangible phenomena—visible rings and spikes shaped by topology.

Structured light and topological photonics now enable direct imaging of Betti numbers and Euler characteristics in optical systems. For example, photonic crystals engineered with topological defects exhibit starburst-like diffraction, embodying the same symmetry-breaking dynamics seen in atoms and light fields.

Beyond the Basics: Hidden Waves and Topological Invariants

The nth Betti number is not just a number—it’s a lens to quantify light’s invisible structure, predicting wave behavior and symmetry from first principles. The Euler characteristic links geometry to algebra, forecasting interference stability and phase coherence.

These concepts drive innovation in quantum computing and topological materials, where light’s hidden symmetries enable fault-tolerant qubits and robust photonic circuits. Just as starburst patterns reveal topology’s depth, so too do these invariants unlock next-generation technologies—bridging the abstract with the observable.

“Hidden symmetries are the grammar of nature’s patterns—revealed not by force, but by topology.” — Insight from modern topological photonics

1. Introduction: The Hidden Geometry of Light

Light is often simplified as waves or photons, but its true structure reveals a deep topological essence. Beyond classical models, light’s behavior is governed by geometric and algebraic invariants—especially the nth Betti number, which counts n-dimensional holes, and the Euler characteristic, linking geometry and algebra through χ = 1 − β₁ + β₂ − …. These tools capture invisible structure, turning light’s topology into a measurable language of symmetry and interference.

2. Topological Waves and the Starburst Pattern

Starburst interference patterns—radiant spikes formed by overlapping coherent waves—arise from precise phase relationships. Their symmetry is no accident: it emerges from wavefront topology shaped by boundary conditions and phase gradients. Mathematically, this symmetry breaking is governed by topological invariants, where each spike and gap encodes information about connectivity and voids in the wavefront’s structure.

Betti Number βᵏ Physical Meaning
β₁ Loops and interference crossings in wavefronts
β₂ Enclosed cavities behind diffraction structures
β₃ Complex 3D distortions and phase singularities

3. Forbidden Transitions: When Physics Defies Expectations

Quantum selection rules, like electric dipole restrictions, forbid certain atomic transitions—explaining spectral line shapes. These “forbidden” transitions result from symmetry conservation in angular momentum. Yet, subtle topological distortions in wavefronts—such as phase twists or defect-induced phase singularities—can induce effective symmetry violations, altering interference patterns without breaking global gauge symmetry.

4. The Higgs Mechanism: A Bridge to Hidden Symmetries

Electroweak symmetry breaking gives mass to W and Z bosons at ~80.4 GeV and ~91.2 GeV through the Higgs field. Crucially, this preserves local gauge symmetry—mirroring topological phase transitions where symmetry appears broken but remains embedded in geometry. The Higgs vacuum acts as a phase mask, shaping wave-like patterns in particle interactions much like light’s topological phase masks shape interference.

5. From Theory to Observation: Starburst as a Modern Illustration

Real-world starburst patterns appear in optical diffraction from nanostructures, laser interference, and photonic crystals. These systems visualize abstract invariants—like Betti numbers—making topology tangible. For example, engineered photonic topological insulators produce structured light with starburst-like edge states, where symmetry-breaking dynamics enable robust, defect-resistant wave propagation.

6. Beyond the Basics: Hidden Waves and Topological Invariants

Advanced tools now quantify light’s invisible architecture. The nth Betti number reveals how interference patterns encode dimensional holes—β₁ tracks interference loops, β₂ measures enclosed voids. The Euler characteristic predicts stability and symmetry behavior, from atomic transitions to photonic circuits. These concepts are reshaping quantum computing, where topological invariants enable fault-tolerant qubits and robust optical computing.

“Hidden symmetries are the grammar of nature’s patterns—revealed not by force, but by topology.” This insight unites starburst light patterns with deep mathematical structure, showing how topology shapes reality from the quantum to the macroscopic.

Explore how starburst optics reveal topological physics

Related Posts