-----------------------------------
---------------------------------------------
--                                                                          --
--                           OCARINA COMPONENTS                             --
--                                                                          --
--  O C A R I N A . B U I L D E R . C O M P O N E N T S . F E A T U R E S   --
--                                                                          --
--                                 S p e c                                  --
--                                                                          --
--               Copyright (C) 2005-2007, GET-Telecom Paris.                --
--                                                                          --
-- Ocarina  is free software;  you  can  redistribute  it and/or  modify    --
-- it under terms of the GNU General Public License as published by the     --
-- Free Software Foundation; either version 2, or (at your option) any      --
-- later version. Ocarina is distributed  in  the  hope  that it will be    --
-- useful, but WITHOUT ANY WARRANTY;  without even the implied warranty of  --
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General --
-- Public License for more details. You should have received  a copy of the --
-- GNU General Public License distributed with Ocarina; see file COPYING.   --
-- If not, write to the Free Software Foundation, 51 Franklin Street, Fifth --
-- Floor, Boston, MA 02111-1301, USA.                                       --
--                                                                          --
-- As a special exception,  if other files  instantiate  generics from this --
-- unit, or you link  this unit with other files  to produce an executable, --
-- this  unit  does not  by itself cause  the resulting  executable to be   --
-- covered  by the  GNU  General  Public  License. This exception does not  --
-- however invalidate  any other reasons why the executable file might be   --
-- covered by the GNU Public License.                                       --
--                                                                          --
--                 Ocarina is maintained by the Ocarina team                --
--                       (ocarina-users@listes.enst.fr)                     --
--                                                                          --
------------------------------------------------------------------------------

--  The core API for the feature subclause of the component types and
--  the port group types.

with Ocarina.Entities.Components;

package Ocarina.Builder.Components.Features is

   function Add_Property_Association
     (Feature              : node_id;
      Property_Association : node_id) return Boolean;

   function Add_New_Port_Spec
     (Loc               : location;
      Name              : node_id;
      Container         : node_id;
      Is_In             : Boolean;
      Is_Out            : Boolean;
      Is_Data           : Boolean;
      Is_Event          : Boolean;
      Is_Refinement     : Boolean := False;
      Associated_Entity : node_id := No_Node) return node_id;

   function Add_New_Port_Group_Spec
     (Loc           : location;
      Name          : node_id;
      Container     : node_id;
      Is_Refinement : Boolean := False) return node_id;

   function Add_New_Server_Subprogram
     (Loc           : location;
      Name          : node_id;
      Container     : node_id;
      Is_Refinement : Boolean := False) return node_id;

   function Add_New_Data_Subprogram_Spec
     (Loc           : location;
      Name          : node_id;
      Container     : node_id;
      Is_Refinement : Boolean := False) return node_id;

   function Add_New_Subcomponent_Access
     (Loc           : location;
      Name          : node_id;
      Container     : node_id;
      Is_Refinement : Boolean := False;
      Category      : Ocarina.Entities.Components.component_category;
      Is_Provided   : Boolean) return node_id;

   function Add_New_Parameter
     (Loc           : location;
      Name          : node_id;
      Container     : node_id;
      Is_In         : Boolean := True;
      Is_Out        : Boolean := True;
      Is_Refinement : Boolean := False) return node_id;

end Ocarina.Builder.Components.Features;